Enterprise Distributed Application Service:Deploy an application to a Kubernetes cluster from IntelliJ IDEA

Requisitos previos

Antes de empezar, asegúrese de contar con lo siguiente:

• Java Development Kit (JDK) 1.8 o una versión posterior

• IntelliJ IDEA 2018.3 o una versión posterior

• Una aplicación desplegada en un clúster de ACK. Para consultar las instrucciones de configuración, consulte Use an image to deploy a Java microservices application in a Kubernetes cluster

• Un par de AccessKey (AccessKey ID y AccessKey secret) correspondiente a su cuenta de Alibaba Cloud o a un usuario de Resource Access Management (RAM) con permisos de despliegue en EDAS

El servidor de plugins de JetBrains se encuentra fuera de China continental. Si no logra descargar el plugin debido a una respuesta lenta de la red, únase al grupo de DingTalk indicado al final de este tema para obtener el paquete de instalación sin conexión del soporte técnico de Alibaba Cloud Toolkit.

Si utiliza un usuario de RAM, dicho usuario debe estar sincronizado con EDAS y autorizado para desplegar aplicaciones. Consulte Authorize a RAM user for EDAS para ver las instrucciones de configuración.

Paso 1: Instalación de Alibaba Cloud Toolkit

1. Abra IntelliJ IDEA.

2. Abra la configuración del plugin:

   • macOS: Seleccione IntelliJ IDEA > Preferences > Plugins.

   • Windows: Seleccione File > Settings > Plugins.

3. En el cuadro de búsqueda, introduzca Alibaba Cloud Toolkit y haga clic en el icono de búsqueda.

4. Haga clic en Install.

   

   

5. Reinicie IntelliJ IDEA. Tras el reinicio, el icono de Alibaba Cloud Toolkit aparecerá en la barra de herramientas.

Si ya tiene instalado el plugin, actualícelo a la versión más reciente desde la misma página de configuración de Plugins .

Paso 2: Configuración de su cuenta de Alibaba Cloud

Configure su par de AccessKey para que el plugin pueda acceder a EDAS en su nombre.

1. En IntelliJ IDEA, seleccione Tools > Alibaba Cloud > Preferences.

2. En el panel de navegación izquierdo, seleccione Alibaba Cloud Toolkit > Accounts.

3. Introduzca su Access Key ID y su Access Key Secret, y luego haga clic en OK.

   

Obtención de su par de AccessKey:

• Si ya cuenta con una cuenta de Alibaba Cloud, haga clic en Get existing AK/SK en la página Accounts. Inicie sesión y recupere su AccessKey ID y AccessKey secret desde la página de gestión de AccessKey.

• Si aún no tiene una cuenta, haga clic en Sign up para crear una y, a continuación, recupere su par de AccessKey.

Si su servicio EDAS se ejecuta en Apsara Stack Enterprise, configure un endpoint antes de continuar. Consulte Configuración de un endpoint para Apsara Stack Enterprise .

Paso 3: Despliegue de la aplicación

1. En IntelliJ IDEA, seleccione Tools > Alibaba Cloud > Deploy to EDAS > EDAS for Kubernetes Application. Como alternativa, seleccione Run > Edit Configurations. En el cuadro de diálogo Run/Debug configurations, seleccione Templates > EDAS on Alibaba Cloud > EDAS for Kubernetes Application.

2. En la pestaña Settings del cuadro de diálogo Deploy to EDAS, establezca los siguientes parámetros:

   Importante

   Si la aplicación no aparece en la lista, consulte Authorize a RAM user for EDAS.

   Parámetro	Descripción
   Region	La región donde se despliega la aplicación.
   Namespace	El espacio de nombres de microservices donde se despliega la aplicación.
   Application	El nombre de la aplicación.

   

3. Seleccione un método de despliegue:

   Método	Descripción
   Maven Build	Agrega un trabajo de compilación Maven para generar el paquete de despliegue. Para proyectos multimódulo, consulte Deploy a multi-module project.
   Upload File	Carga un paquete WAR o JAR para su despliegue.
   Build Image	Compila una imagen de contenedor a partir de un Dockerfile. Establezca el Context Directory, la ruta del Dockerfile y la Version de la imagen.
   Select Image	Realiza el despliegue a partir de una imagen de contenedor existente seleccionada en la lista desplegable Select Image.

   

4. (Opcional) Haga clic en la pestaña Advanced para configurar parámetros adicionales de despliegue. Para obtener información completa sobre los parámetros, consulte la referencia de la API DeployK8sApplication.

   • Application Environment: Establece el entorno de ejecución. Especifique una nueva PackageVersion cada vez que realice un despliegue.

   • Startup Command: Especifica el comando y los argumentos que se ejecutarán al iniciar el contenedor.

   • Environments: Define las variables de entorno para la aplicación.

   • Persistence: Configura los volúmenes de almacenamiento persistente.

   • Storage: Configura el almacenamiento local.

   • Application Management: Establece los hooks del ciclo de vida y los sondeos de estado:

     Configuración	Descripción
     Poststart	Un hook del ciclo de vida del contenedor que se activa tras crear el contenedor. Si el controlador falla, el contenedor se detiene y la política de reinicio determina si debe reiniciarse.
     PreStop	Un hook del ciclo de vida del contenedor que se activa antes de eliminar un contenedor. El controlador se ejecuta antes de que la solicitud de eliminación llegue al daemon de Docker. El daemon envía una señal SIGTERM independientemente del resultado del controlador.
     Liveness	Un sondeo de estado que verifica el estado de la aplicación. Si esta no funciona correctamente, Kubernetes elimina y vuelve a crear el contenedor.
     Readiness	Un sondeo de estado que comprueba si la aplicación se ha iniciado y se ejecuta según lo esperado. Si la aplicación no puede ejecutarse correctamente, se actualiza el estado del contenedor.

   

5. Haga clic en Apply y, a continuación, en Run. Revise el registro de despliegue en la pestaña Console de IntelliJ IDEA para comprobar el resultado.

Despliegue de un proyecto multimódulo

En proyectos Maven multimódulo, el último trabajo de Maven en la sección Before launch debe compilar el submódulo que desea desplegar.

Ejemplo: El proyecto CarShop tiene la siguiente estructura:

carshop
├── itemcenter-api
├── itemcenter
├── detail

Tanto itemcenter como detail dependen de itemcenter-api. Para desplegar el submódulo itemcenter, agregue estos dos trabajos de Maven a la sección Before launch:

1. Ejecute mvn clean install en el proyecto principal CarShop.

2. Ejecute mvn clean package en el submódulo itemcenter.

Autorización de un usuario de RAM para EDAS

Si un usuario de RAM no visualiza las aplicaciones en la lista de despliegue, significa que no está sincronizado con EDAS o carece de los permisos necesarios. Elija uno de los siguientes métodos para otorgarle acceso.

Configuración de un endpoint para Apsara Stack Enterprise

Si su servicio EDAS se ejecuta en Apsara Stack Enterprise, configure un endpoint en Alibaba Cloud Toolkit antes de realizar el despliegue. Póngase en contacto con el soporte técnico de EDAS para obtener el valor del endpoint.

1. En el cuadro de diálogo Preference (Filtered), seleccione Appearance & Behavior > Endpoint.

2. Introduzca el valor del endpoint y haga clic en Apply and Close.