Dubbo 3.0 fusionne les frameworks Dubbo et High-speed Service Framework (HSF). Une fois votre application HSF mise à niveau vers Dubbo 3.0, Enterprise Distributed Application Service (EDAS) offre des capacités de gouvernance des microservices étendues pour les applications Dubbo.
La mise à niveau modifie uniquement l'environnement d'exécution EDAS Container. Le code de votre application et la logique métier restent inchangés. L'exécution d'une application HSF nécessite l'application elle-même ainsi qu'EDAS Container. Ce dernier fournit un environnement Java, Ali-Tomcat et Pandora. EDAS Container V4.x fait partie de Dubbo 3.0, disponible en version commerciale. Le processus de mise à niveau définit la version de Pandora sur la V4.0.0 pour votre application HSF.
Choisissez la procédure correspondant à votre environnement de déploiement :
| Environnement de déploiement | Procédure |
|---|---|
| Cluster ECS | Mettre à jour dans un cluster ECS |
| Cluster Kubernetes (package WAR) | Mettre à jour une application déployée via WAR dans un cluster Kubernetes |
| Cluster Kubernetes (image) | Mettre à jour une application déployée via image dans un cluster Kubernetes |
Avant de commencer
Vérifiez que votre application HSF fonctionne correctement dans son environnement actuel.
Testez la mise à niveau dans un environnement hors production et vérifiez le résultat avant de l'appliquer en production.
Si vous effectuez un déploiement par image, assurez-vous que Docker est installé et que vous avez accès à un référentiel d'images tel que Alibaba Cloud Container Registry.
Mettre à jour dans un cluster ECS
Connectez-vous à la console EDAS.
Dans le volet de navigation de gauche, cliquez sur Applications.
Dans la barre de navigation supérieure, sélectionnez une région. Dans la partie supérieure de la page, sélectionnez un namespace de microservice dans la liste déroulante Applications, puis choisissez ECS Clusters dans la liste déroulante Cluster Type.
Cliquez sur le nom de l'application HSF que vous souhaitez mettre à niveau.
Sous l'onglet Basic Information, cliquez sur Upgrade/Downgrade Runtime Environment en haut à droite.
-
Dans la boîte de dialogue Upgrade/Downgrade Runtime Environment, définissez Pandora Version sur 4.0.0, configurez les autres paramètres selon vos besoins, puis cliquez sur OK.
L'application se redéploie automatiquement. Cette opération prend plusieurs minutes. Pour suivre la progression, consultez la section Afficher les détails des modifications.
Mettre à jour dans un cluster Kubernetes
EDAS prend en charge les applications HSF déployées sur des clusters Kubernetes via des packages WAR ou des images. Suivez la procédure adaptée à votre méthode de déploiement.
Mettre à jour une application déployée via WAR dans un cluster Kubernetes
Connectez-vous à la console EDAS.
Dans le volet de navigation de gauche, cliquez sur Applications.
Dans la barre de navigation supérieure, sélectionnez une région. Dans la partie supérieure de la page, sélectionnez un namespace de microservice dans la liste déroulante Applications, puis choisissez Container Service ou Serverless Kubernetes Cluster dans la liste déroulante Cluster Type.
Cliquez sur le nom de l'application HSF que vous souhaitez mettre à niveau.
En haut à droite de la page Application Overview, choisissez Deploy > Deploy.
Dans la section Phased Release de la page Select Deployment Mode, cliquez sur Start Deployment en haut à droite.
Sur la page Phased Release, définissez Application Runtime Environment sur EDAS-Container 4.0.0 [Support FatJar Deployment], configurez les autres paramètres selon vos besoins, puis cliquez sur OK. Pour plus de détails sur les autres paramètres, consultez la section Utiliser la console EDAS pour implémenter des déploiements progressifs d'applications dans des clusters Kubernetes.
L'application se redéploie automatiquement. Cette opération prend plusieurs minutes. Pour suivre la progression, consultez la section Afficher les détails des modifications.
Mettre à jour une application déployée via image dans un cluster Kubernetes
Si vous déployez votre application HSF sous forme d'image de conteneur, mettez à jour le Dockerfile pour utiliser Pandora V4.0.0, reconstruisez l'image, puis redéployez-la.
Étape 1 : Mettre à jour le Dockerfile
Ajoutez les lignes suivantes à votre Dockerfile existant pour définir la version de Pandora sur la V4.0.0 :
# Upgrade Pandora to V4.0.0 for Dubbo 3.0
ENV UPGRADED_CONTAINER_VERSION 4.0.0
RUN /home/admin/bin/upgradecontainer.shL'exemple ci-dessous présente un Dockerfile complet avec la mise à niveau appliquée. Pour plus de détails sur le Dockerfile de base, consultez la section Exemple de Dockerfile pour une application HSF.
# Base image: CentOS 7 + OpenJDK 8 + Ali-Tomcat 7 + Pandora 3.5.9
FROM apaas/edas-centos-openjdk8-alitomcat7:latest
MAINTAINER Alibaba Cloud EDAS Team<edas-dev@list.alibaba-inc.com>
ENV TZ="Asia/Shanghai"
# Application directory
ENV APP_HOME /home/admin/app/
# Option 1: Deploy a FatJar file
ARG APP_LOCATION=https://edas-hz.oss-cn-hangzhou.aliyuncs.com/prod/demo/HSF_PROVIDER.jar
# Option 2: Deploy a WAR file
#ARG APP_LOCATION=https://edas-hz.oss-cn-hangzhou.aliyuncs.com/prod/demo/HSF_PROVIDER.war
# Option 3: Deploy a local file
#ARG APP_LOCATION=/Users/username/workspace/java/demo/HSF_PROVIDER.war
ADD ${APP_LOCATION} ${APP_HOME}/
# Upgrade Pandora to V4.0.0 for Dubbo 3.0
ENV UPGRADED_CONTAINER_VERSION 4.0.0
RUN /home/admin/bin/upgradecontainer.shÉtape 2 : Construire l'image
Accédez au répertoire contenant votre Dockerfile et exécutez la commande docker build :
docker build -t <app-name>:<version> .Remplacez les espaces réservés suivants par vos valeurs :
| Espace réservé | Description | Exemple |
|---|---|---|
<app-name> |
Nom de l'image, généralement le nom de l'application | hsf-provider |
<version> |
Tag de version de l'image | 1.0.0 |
Exemple :
docker build -t hsf-provider:1.0.0 .Si votre Dockerfile porte un nom personnalisé ou se trouve dans un autre répertoire, spécifiez le chemin d'accès à l'aide de l'indicateur -f :
docker build -t <app-name>:<version> -f /path/to/custom_dockerfile .Étape 3 : Vérifier l'image locale
Exécutez la commande suivante pour confirmer que l'image a été construite :
docker images | grep <app-name>Étape 4 : Pousser l'image vers un registre
Poussez l'image vers un registre d'images de conteneurs. Nous recommandons Alibaba Cloud Container Registry. Pour obtenir des instructions, consultez la section Utiliser une instance Container Registry Enterprise Edition pour pousser et extraire des images.
Étape 5 : Déployer l'image mise à jour
Déployez l'application Dubbo 3.0 sur votre cluster Kubernetes dans EDAS en utilisant la nouvelle image. Pour obtenir des instructions, consultez la section Utiliser des images pour déployer des applications de microservices dans des clusters Kubernetes.
Vérifier le résultat
Une fois la mise à niveau terminée et l'application redémarrée, vous pouvez vérifier la fonctionnalité de gouvernance des microservices en choisissant Microservices Governance > HSF ou Microservices Governance > Dubbo dans le volet de navigation de gauche de la console EDAS. Vous pouvez également vérifier la fonctionnalité pour votre application mise à niveau.，具体操作，请参见Vue d'ensemble de l'administration des services