Microservices Engine:Enable MSE Microservices Governance for applications in an open source Kubernetes cluster

Paso 1: Instalar el componente ack-onepilot

1. Ejecute el siguiente comando wget para descargar el paquete de instalación de ack-onepilot:

    wget 'https://aliacs-app-catalog.oss-cn-hangzhou.aliyuncs.com/charts-incubator/ack-onepilot-4.0.1.tgz'

2. Ejecute el siguiente comando para descomprimir el paquete de instalación:

   tar xvf ack-onepilot-4.0.1.tgz                 

3. Modifique los siguientes parámetros en el archivo ack-onepilot/values.yaml dentro del directorio donde se descomprimió el paquete de instalación, según sus necesidades. A continuación, guarde el archivo ack-onepilot/values.yaml.

   registry: registry-__ACK_REGION_ID__.ack.aliyuncs.com/acs/
   cluster_id: __ACK_CLUSTER_ID__
   accessKey: __ACCESSKEY__
   accessKeySecret: __ACCESSKEY_SECRET__
   uid: "__ACK_UID__"
   region_id: __ACK_REGION_ID__

   • registry: prefijo de la dirección de imagen del componente ack-onepilot. Solo necesita reemplazar __ACK_REGION_ID__ con la dirección de imagen del piloto correspondiente.

     • Si transfiere la dirección de imagen a otro sistema de almacenamiento, debe cambiar el prefijo del registro después de la transferencia. También debe transferir las siguientes tres imágenes:

       • registry-__ACK_REGION_ID__.ack.aliyuncs.com/acs/ack-onepilot:4.0.1

       • registry-__ACK_REGION_ID__.ack.aliyuncs.com/acs/ack-onepilot-init:4.0.1

       • registry-__ACK_REGION_ID__.ack.aliyuncs.com/acs/ack-onepilot-alpine:3.18

   • cluster_id: ID del clúster de Kubernetes.

     • Si el clúster es autoadministrado y no está conectado a Container Service for Kubernetes (ACK), se recomienda especificar este parámetro con el formato <uid>-<clusterid>. El parámetro uid corresponde al ID de su cuenta de Alibaba Cloud y el parámetro clusterid es el ID único del cliente.

     • Si el clúster es un clúster ACK o un clúster administrado ACK, el valor de este parámetro es el ID del clúster.

   • accessKey y accessKeySecret: AccessKey ID y AccessKey secret de su cuenta de Alibaba Cloud. Para obtener más información sobre cómo conseguir el AccessKey ID y el AccessKey secret de su cuenta de Alibaba Cloud, consulte Obtain an AccessKey pair.

     Importante

     Si utiliza el AccessKey ID de un usuario RAM, debe asegurarse de que dicho usuario tenga asignadas las directivas AliyunARMSFullAccess y AliyunMSEFullAccess.

   • uid: ID de su cuenta de Alibaba Cloud. Para obtener el ID de su cuenta de Alibaba Cloud, coloque el puntero sobre la foto de perfil en la esquina superior derecha de la consola de administración de Alibaba Cloud.

   • region_id: ID de la región donde desea habilitar Microservices Governance para la aplicación. Para obtener más información sobre las regiones compatibles con MSE, consulte Supported regions.

4. Ejecute el siguiente comando para instalar el componente ack-onepilot:

   Importante

   Antes de ejecutar el comando, asegúrese de haber reemplazado el contenido del archivo config en el directorio ~/.kube con la configuración del clúster de Kubernetes que necesita acceder a Microservice Governance.

   helm3 upgrade --install ack-onepilot ack-onepilot --namespace ack-onepilot --create-namespace

Paso 2: Modificar el archivo YAML de la aplicación

1. Ejecute el siguiente comando para consultar la configuración de la aplicación Deployment deseada:

   ### View the configurations of the specified Deployment application.
   kubectl get deployment {Name of the Deployment application} -o yaml 

   Nota

   Si desconoce el nombre de la aplicación Deployment, ejecute el siguiente comando para ver la información de todas las aplicaciones Deployment. Luego, localice en la salida del comando la aplicación Deployment cuya configuración desea revisar y consulte dicha configuración.

   ### View the configurations of all the Deployment applications.
   kubectl get deployments --all-namespace                

2. Ejecute el siguiente comando para editar el archivo YAML de la aplicación Deployment:

   kubectl edit deployment {Name of the Deployment application} -o yaml

3. En el archivo YAML, vaya al directorio spec > template > metadata > labels y agregue el siguiente contenido:

   msePilotAutoEnable: "on" # Enable Microservices Governance of MSE.
   msePilotCreateAppName: xxx # The name of your application.
   mseNamespace: default      # The MSE namespace where your application resides. If you do not specify this parameter, the default namespace is used.

4. Después de guardar la configuración anterior, la aplicación se reinicia automáticamente y los cambios surten efecto.

   Después de dos a cinco minutos, si su aplicación aparece en la página Microservices Governance > Application Governance de la consola MSE y se reportan datos de la aplicación, significa que la conexión a MSE Microservices Governance se realizó correctamente.

Siguientes pasos

Una vez completados los pasos anteriores para sus aplicaciones desplegadas en el clúster de Kubernetes de código abierto, MSE Microservices Governance quedará habilitado. Puede iniciar sesión en la consola de MSE y utilizar MSE Microservices Governance para gestionar sus aplicaciones Spring Cloud y Dubbo.

Desinstalar el componente ack-onepilot

Si ya no necesita gestionar aplicaciones y servicios en un clúster de Kubernetes de código abierto mediante MSE Microservices Governance, puede desinstalar el componente ack-onepilot.

1. Ejecute el siguiente comando para desinstalar el componente ack-onepilot:

   helm3 uninstall --namespace ack-onepilot ack-onepilot

2. Reinicie el pod de su aplicación.