Dubbo 3.0 es la fusión de los frameworks Dubbo y High-speed Service Framework (HSF). Después de actualizar su aplicación HSF a Dubbo 3.0, Enterprise Distributed Application Service (EDAS) ofrece capacidades ampliadas de gobernanza de microservices para las aplicaciones Dubbo.
La actualización solo modifica el entorno de ejecución EDAS Container. El código de su aplicación y la lógica de negocio permanecen sin cambios. Para ejecutar una aplicación HSF, se requiere la aplicación y EDAS Container. Este último proporciona un entorno Java, Ali-Tomcat y Pandora. EDAS Container V4.x forma parte de Dubbo 3.0, cuya versión comercial ya está disponible. Durante el proceso de actualización, se establece la versión de Pandora en V4.0.0 para su aplicación HSF.
Elija el procedimiento que corresponda a su entorno de despliegue:
|
Entorno de despliegue |
Procedimiento |
|
Clúster ECS |
|
|
Clúster Kubernetes (paquete WAR) |
Actualizar una aplicación desplegada con WAR en un clúster Kubernetes |
|
Clúster Kubernetes (imagen) |
Actualizar una aplicación desplegada con imagen en un clúster Kubernetes |
Antes de empezar
Compruebe que su aplicación HSF se ejecuta correctamente en el entorno actual.
Pruebe la actualización en un entorno que no sea de producción y compruebe el resultado antes de aplicarla en producción.
Si realiza el despliegue mediante una imagen, asegúrese de tener instalado Docker y acceso a un repositorio de imágenes como Alibaba Cloud Container Registry.
Actualizar en un clúster ECS
Inicie sesión en la consola de EDAS.
En el panel de navegación izquierdo, haga clic en Applications.
En la barra de navegación superior, seleccione una región. En la parte superior de la página, seleccione un espacio de nombres de microservices en la lista desplegable Applications y, a continuación, seleccione ECS Clusters en la lista desplegable Cluster Type.
Haga clic en el nombre de la aplicación HSF que desea actualizar.
En la pestaña Basic Information, haga clic en Upgrade/Downgrade Runtime Environment en la esquina superior derecha.
-
En el cuadro de diálogo Upgrade/Downgrade Runtime Environment, establezca Pandora Version en 4.0.0, configure los demás parámetros según sus necesidades y haga clic en OK.
La aplicación se vuelve a desplegar automáticamente. Este proceso tarda varios minutos. Para supervisar el progreso, consulte View change details.
Actualizar en un clúster Kubernetes
EDAS admite aplicaciones HSF desplegadas en clústeres Kubernetes mediante paquetes WAR o imágenes. Siga el procedimiento que corresponda a su método de despliegue.
Actualizar una aplicación desplegada con WAR en un clúster Kubernetes
Inicie sesión en la consola de EDAS.
En el panel de navegación izquierdo, haga clic en Applications.
En la barra de navegación superior, seleccione una región. En la parte superior de la página, seleccione un espacio de nombres de microservices en la lista desplegable Applications y, a continuación, seleccione Container Service o Serverless Kubernetes Cluster en la lista desplegable Cluster Type.
Haga clic en el nombre de la aplicación HSF que desea actualizar.
En la esquina superior derecha de la página Application Overview, elija Deploy > Deploy.
En la sección Phased Release de la página Select Deployment Mode, haga clic en Start Deployment en la esquina superior derecha.
En la página Phased Release, establezca Application Runtime Environment en EDAS-Container 4.0.0 [Support FatJar Deployment], configure los demás parámetros según sus necesidades y haga clic en OK. Para obtener más información sobre los demás parámetros, consulte Use the EDAS console to implement phased releases of applications in Kubernetes clusters.
La aplicación se vuelve a desplegar automáticamente. Este proceso tarda varios minutos. Para supervisar el progreso, consulte View change details.
Actualizar una aplicación desplegada con imagen en un clúster Kubernetes
Si despliega su aplicación HSF como una imagen de contenedor, actualice el Dockerfile para usar Pandora V4.0.0, vuelva a compilar la imagen y realice un nuevo despliegue.
Paso 1: Actualizar el Dockerfile
Agregue las siguientes líneas a su Dockerfile existente para establecer la versión de Pandora en 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.shA continuación se muestra un ejemplo de un Dockerfile completo con la actualización aplicada. Para obtener más información sobre el Dockerfile base, consulte Example of the Dockerfile for an HSF application.
# 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.shPaso 2: Compilar la imagen
Vaya al directorio que contiene su Dockerfile y ejecute el comando docker build:
docker build -t <app-name>:<version> .Reemplace los siguientes marcadores de posición con sus valores:
|
Marcador de posición |
Descripción |
Ejemplo |
|
|
Nombre de la imagen, generalmente el nombre de la aplicación |
|
|
|
Etiqueta de versión de la imagen |
|
Ejemplo:
docker build -t hsf-provider:1.0.0 .Si su Dockerfile tiene un nombre personalizado o se encuentra en otro directorio, especifique la ruta con la marca -f:
docker build -t <app-name>:<version> -f /path/to/custom_dockerfile .Paso 3: Comprobar la imagen local
Ejecute el siguiente comando para confirmar que la imagen se compiló correctamente:
docker images | grep <app-name>Paso 4: Enviar la imagen a un registro
Envíe la imagen a un registro de imágenes de contenedores. Se recomienda utilizar Alibaba Cloud Container Registry. Para consultar las instrucciones, consulte Use a Container Registry Enterprise Edition instance to push and pull images.
Paso 5: Desplegar la imagen actualizada
Despliegue la aplicación Dubbo 3.0 en su clúster Kubernetes dentro de EDAS mediante la nueva imagen. Para consultar las instrucciones, consulte Use images to deploy microservices applications in Kubernetes clusters.
Comprobar el resultado
Una vez finalizada la actualización y reiniciada la aplicación, puede revisar la función de gobernanza de microservices. Para ello, vaya a Microservices Governance > HSF o Microservices Governance > Dubbo en el panel de navegación izquierdo de la consola de EDAS. También puede comprobar esta función en su aplicación actualizada. Para conocer el procedimiento detallado, consulte Overview of service administration.