Enterprise Distributed Application Service:DeployK8sApplication

El script que se ejecuta antes de detener el contenedor. Ejemplo: {"tcpSocket":{"host":"", "port":8080}}. Para eliminar esta configuración, establezca el parámetro en {}. Si no establece este parámetro, la configuración se ignora.

Las variables de entorno para el despliegue. El valor debe ser una matriz JSON de objetos. Se admiten tres tipos de variables de entorno: regulares, ConfigMap de Kubernetes y Secret de Kubernetes. El formato para una variable de entorno regular es el siguiente:

{"name":"x", "value": "y"}

Una variable de entorno ConfigMap inyecta el valor de una clave específica de un ConfigMap en las variables de entorno del contenedor. El formato es el siguiente:

{ "name": "x2", "valueFrom": { "configMapKeyRef": { "name": "my-config", "key": "y2" } } }

Una variable de entorno Secret inyecta el valor de una clave específica de un Secret en las variables de entorno del contenedor. El formato es el siguiente:

{ "name": "x3", "valueFrom": { "secretKeyRef": { "name": "my-secret", "key": "y3" } } }

La etiqueta de la imagen.

El intervalo mínimo para un despliegue por fases de pods. Para obtener más información, consulte minReadySeconds.

El comando de inicio del contenedor.

El ID de la aplicación. Obtenga el ID mediante la operación ListApplication. Para obtener más información, consulte ListApplication.

El script que se ejecuta después de que se inicia el contenedor. Ejemplo: {"exec":{"command":["cat","/etc/group"]}}. Para eliminar esta configuración, establezca el parámetro en {}. Si no establece este parámetro, la configuración se ignora.

El sondeo de preparación para el contenedor. Si el sondeo falla, el tráfico del servicio de Kubernetes no se enruta al contenedor. Ejemplo: {"failureThreshold": 3,"initialDelaySeconds": 5,"successThreshold": 1,"timeoutSeconds": 1,"httpGet": {"path": "/consumer","port": 8080,"scheme": "HTTP","httpHeaders": [{"name": "test","value": "testvalue"}]}}. Para eliminar esta configuración, establezca el parámetro en "" o {}. Si no establece este parámetro, la configuración se ignora.

El sondeo de actividad para el contenedor. Ejemplo: {"failureThreshold": 3,"initialDelaySeconds": 5,"successThreshold": 1,"timeoutSeconds": 1,"tcpSocket":{"host":"", "port":8080}}. Para eliminar esta configuración, establezca el parámetro en "" o {}. Si no establece este parámetro, la configuración se ignora.

Los argumentos para el comando de inicio del contenedor. El valor debe ser una matriz JSON de cadenas, como ["Argumento 1", "Argumento 2"]. Para borrar los argumentos, establezca el parámetro en una matriz JSON vacía "[]".

El número de instancias de la aplicación. El valor mínimo es 0.

La URL completa de la imagen. Este parámetro sobrescribe el parámetro ImageTag.

El límite de CPU para la instancia de la aplicación durante la ejecución. Unidad: núcleos. Un valor de 0 significa que no hay límite.

El límite de memoria para la instancia de la aplicación durante la ejecución. Unidad: MB. Un valor de 0 significa que no hay límite.

La cuota de CPU que se solicita para la instancia de la aplicación durante la ejecución. Se recomienda establecer este parámetro. Unidad: núcleos. Un valor de 0 significa que no hay límite.

La cuota de memoria que se solicita para la instancia de la aplicación durante la ejecución. Se recomienda establecer este parámetro. Unidad: MB. Un valor de 0 significa que no hay solicitud.

El ID del sistema de archivos Apsara File Storage NAS (NAS) que se va a montar. El sistema de archivos NAS debe estar en la misma región que el clúster. Debe tener una cuota de destino de montaje disponible, o su destino de montaje debe estar en un vSwitch de la VPC. Si no establece este parámetro pero existe el campo `mountDescs`, se compra automáticamente un sistema de archivos NAS y se monta en un vSwitch de la VPC de forma predeterminada.

Las configuraciones de montaje, que son una cadena JSON serializada. Ejemplo: [{"nasPath": "/k8s","mountPath": "/mnt"},{"nasPath": "/files","mountPath": "/app/files"}]. En este ejemplo, `nasPath` es la ruta de almacenamiento de archivos y `mountPath` es la ruta en el contenedor donde se monta el sistema de archivos.

El tipo de almacenamiento del sistema de archivos NAS. Valores válidos:

• NAS de uso general: `Capacity` y `Performance`

• NAS extremo: `standard` y `advance`

Actualmente, solo se admite el tipo `Performance`.

La configuración para montar un archivo del host en un contenedor. Ejemplo: [{"type":"","nodePath":"/localfiles","mountPath":"/app/files"},{"type":"Directory","nodePath":"/mnt","mountPath":"/app/storage"}]. En este ejemplo, `nodePath` es la ruta del host, `mountPath` es la ruta en el contenedor y `type` es el tipo de montaje.

La URL del paquete de despliegue. Configure este parámetro para aplicaciones desplegadas mediante un paquete FatJar o WAR.

El número de versión del paquete de despliegue. Este parámetro es obligatorio para paquetes WAR y FatJar. Puede definir el significado del número de versión.

La versión de JDK de la que depende el paquete de despliegue. Valores válidos: Open JDK 7, Open JDK 8 o Custom OpenJDK. Este parámetro no se admite para despliegues basados en imágenes. Si utiliza Custom OpenJDK, también debe configurar el campo `UserBaseImageUrl`.

La versión de Tomcat de la que depende el paquete de despliegue. Este parámetro se aplica a aplicaciones Spring Cloud y Dubbo desplegadas mediante paquetes WAR. No se admite para despliegues basados en imágenes.

La versión de EDAS Container de la que depende el paquete de despliegue. Este parámetro se aplica a aplicaciones HSF desplegadas mediante paquetes WAR. No se admite para despliegues basados en imágenes.

El formato de codificación URI. Formatos admitidos: ISO-8859-1, GBK, GB2312 y UTF-8.

Especifica si se debe habilitar `useBodyEncodingForURI`.

La política de despliegue por fases.

• Ejemplo 1: Despliegue por fases con una instancia canary, seguido de dos lotes, procesamiento por lotes automático y un intervalo de 1 minuto. {"type":"GrayBatchUpdate","batchUpdate":{"batch":2,"releaseType":"auto","batchWaitTime":1},"grayUpdate":{"gray":1}}

• Ejemplo 2: Despliegue por fases con una instancia canary, seguido de dos lotes y procesamiento por lotes manual. {"type":"GrayBatchUpdate","batchUpdate":{"batch":2,"releaseType":"manual"},"grayUpdate":{"gray":1}}

• Ejemplo 3: Despliegue por fases en dos lotes, con procesamiento por lotes automático y un intervalo de 0 minutos. {"type":"BatchUpdate","batchUpdate":{"batch":2,"releaseType":"auto","batchWaitTime":0}}

El requisito mínimo de recursos de CPU. Unidad: núcleos. Un valor de 0 significa que no hay límite.

La cantidad máxima de CPU que se puede utilizar. Unidad: núcleos. Un valor de 0 significa que no hay límite.

Los volúmenes de datos.

El ID de la versión del paquete de despliegue.

La descripción del registro de cambios.

El tipo de entorno de ejecución del contenedor:

• `runc`: entorno de ejecución de contenedor regular.

• `runv`: contenedor en sandbox.

Este parámetro se aplica solo a clústeres que utilizan contenedores en sandbox.

Especifica si se deben distribuir las instancias de la aplicación en varias zonas. `true` indica que sí, y otros valores indican que no.

El periodo de tiempo de espera para el despliegue de un solo lote. Unidad: segundos.

Especifica si se debe conectar a Application High Availability Service (AHAS).

La configuración del contenedor Tomcat. Establezca en "" o "{}" para eliminar la configuración:

• `useDefaultConfig`: Especifica si se debe utilizar una configuración personalizada. Si es `true`, no se utiliza la configuración personalizada. Si es `false`, se utiliza la configuración personalizada. Si no utiliza una configuración personalizada, los siguientes ajustes de parámetros no surten efecto.

• `contextInputType`: La ruta de acceso de la aplicación.

  • `war`: No necesita introducir una ruta personalizada. La ruta de acceso es el nombre del paquete WAR.

  • `root`: No necesita introducir una ruta personalizada. La ruta de acceso es `/`.

  • `custom`: Debe introducir una ruta personalizada en el parámetro `contextPath` a continuación.

• `contextPath`: La ruta personalizada. Este parámetro es obligatorio solo cuando `contextInputType` se establece en `custom`.

• `httpPort`: El número de puerto. El rango válido es de 1024 a 65535. Los puertos menores que 1024 requieren permisos de root. Dado que el contenedor está configurado con permisos de administrador, especifique un número de puerto mayor que 1024. Si no configura esto, el puerto predeterminado es 8080.

• `maxThreads`: El tamaño del pool de conexiones. El valor predeterminado es 400.

  Nota

  Esta configuración afecta significativamente al rendimiento de la aplicación. Configúrela bajo supervisión profesional.

• `uriEncoding`: El formato de codificación para Tomcat. Valores válidos: UTF-8, ISO-8859-1, GBK y GB2312. Si no establece esto, el valor predeterminado es ISO-8859-1.

• `useBodyEncoding`: Especifica si se debe utilizar BodyEncoding para las URL.

• `useAdvancedServerXml`: Especifica si se debe utilizar la configuración avanzada para personalizar el archivo `server.xml`. Si los tipos y valores de parámetros anteriores no satisfacen sus necesidades, puede utilizar la configuración avanzada para editar directamente el archivo `Server.xml` de Tomcat.

• `serverXml`: El contenido del archivo de texto personalizado `server.xml` en la configuración avanzada. Esto surte efecto cuando `useAdvancedServerXml` es `true`.

Los parámetros de inicio de Java. Puede configurar memoria, aplicación, política de recolección de basura (GC), herramientas, registro y descubrimiento de servicios, y ajustes personalizados. Configurar correctamente estos parámetros ayuda a reducir la sobrecarga de GC, acortar el tiempo de respuesta del servidor y mejorar el rendimiento. El parámetro es una cadena JSON. `original` es el valor de configuración y `startup` es el parámetro de inicio. El sistema concatena automáticamente todos los valores de `startup` como parámetros de inicio de Java para la aplicación. Establezca en "" o "{}" para eliminar la configuración.

La configuración de Logstore. Establezca en "" o "{}" para eliminar la configuración:

• `Configs`:

  • `type`: El tipo de recolección. `file` para tipo de archivo, `stdout` para tipo de salida estándar.

  • `Logstore`: El nombre del Logstore. Asegúrese de que el nombre del Logstore sea único dentro del mismo clúster. El nombre debe seguir estas reglas:

    • Solo puede contener letras minúsculas, números, guiones (-) y guiones bajos (_).

    • Debe comenzar y terminar con una letra minúscula o un número.

    • El nombre debe tener entre 3 y 63 caracteres. Si se deja vacío, el sistema genera un nombre automáticamente.

  • `LogDir`: Si el tipo es salida estándar, la ruta de recolección es `stdout.log`. Si el tipo es archivo, esta es la ruta del archivo a recolectar. Se admiten comodines. La ruta de recolección debe coincidir con la expresión regular: ^/(.+)/(.*)^/$.

Especifica si se deben distribuir las instancias de la aplicación en varios nodos. `true` indica que sí, y otros valores indican que no.

La política de control de tráfico para el despliegue por fases.

Configura montajes de PersistentVolumeClaim (PVC) de Kubernetes. Esto permite montar un volumen PVC de Kubernetes en un directorio específico del contenedor. Los parámetros para `PvcMountDescs` son los siguientes:

• `pvcName`: El nombre del volumen PVC. El volumen PVC ya debe existir y estar en estado Bound.

• `mountPaths`: Una lista de directorios de montaje. Puede configurar múltiples directorios de montaje. Cada directorio de montaje admite los siguientes dos parámetros:

  • `mountPath`: La ruta de montaje. Una ruta absoluta en el contenedor que comienza con una barra diagonal (/).

  • `readOnly`: El modo de montaje. `true` para solo lectura, `false` para lectura y escritura. El valor predeterminado es `false`.

Configura montajes de ConfigMap y Secret de Kubernetes. Esto permite montar un ConfigMap o Secret en un directorio específico del contenedor. Los parámetros para `ConfigMountDescs` son los siguientes:

• `name`: El nombre del ConfigMap o Secret.

• `type`: El tipo de configuración. Se admiten `ConfigMap` y `Secret`.

• `mountPath`: La ruta de montaje. Una ruta absoluta en el contenedor que comienza con una barra diagonal (/).

Configura variables de entorno del tipo `EnvFrom` de Kubernetes. Esto monta un ConfigMap o Secret especificado en un directorio. Cada clave corresponde a un archivo en el directorio, y el contenido del archivo es el valor de la clave.

Los parámetros para `EnvFroms` son los siguientes.

• `configMapRef`: Una referencia a un ConfigMap. Este campo incluye el siguiente parámetro:

  • `name`: El nombre del ConfigMap.

• `secretRef`: Una referencia a un Secret. Este campo incluye el siguiente parámetro:

  • `name`: El nombre del Secret.

Configura los montajes emptyDir de Kubernetes. Esto permite montar un volumen emptyDir en un directorio específico del contenedor. Los parámetros para EmptyDirs son los siguientes:

• mountPath: La ruta de montaje del contenedor. Es obligatoria.

• readOnly: Especifica si el volumen es de solo lectura. Opcional. true para solo lectura, false para lectura y escritura. El valor predeterminado es false.

• subPathExpr: La expresión de subdirectorio. Opcional.

La configuración de afinidad de pods. Esto surte efecto solo cuando tanto DeployAcrossNodes como DeployAcrossZones son false.

La configuración de tolerancia de programación de pods. Esto surte efecto solo cuando tanto DeployAcrossNodes como DeployAcrossZones son false.

El número de paquete de compilación para EDAS Container:

• Si no necesita cambiar la versión de EDAS Container durante el despliegue, puede dejar este parámetro sin establecer.

• Para actualizar la versión de EDAS Container de la aplicación objetivo durante este despliegue, debe establecer este parámetro.

Puede obtener el número de dos maneras:

• Llame a la operación ListBuildPack para consultar la lista de versiones de contenedor. Para obtener más información, consulte ListBuildPack.

• Obténgalo de la columna Número de paquete de compilación en la tabla Guía de versiones. Por ejemplo, 59 indica EDAS Container 3.5.8.

Las anotaciones para el pod de la aplicación.

Las etiquetas para el pod de la aplicación.

Especifica si se debe habilitar la protección contra envíos vacíos:

• true: Habilitar la protección contra envíos vacíos.

• false: No habilitar la protección contra envíos vacíos.

Especifica si se debe habilitar la regla de inicio gradual:

• true: Habilitar la regla de inicio gradual.

• false: No habilitar la regla de inicio gradual.

La duración de la precarga del servicio. Unidad: segundos. El valor oscila entre 0 y 86400.

La latencia de registro del servicio. Unidad: segundos. El valor oscila entre 0 y 86400.

La curva de precarga del servicio. El valor oscila entre 0 y 20. El valor predeterminado es 2, que es adecuado para escenarios generales de precarga. Esto indica que la curva de recepción de tráfico del proveedor de servicios sigue una curva cuadrática durante el periodo de precarga.

Especifica si se debe habilitar el modo de despliegue continuo gradual para completar el registro del servicio antes de que el sondeo de preparación tenga éxito:

• true: Este interruptor proporciona una verificación de estado para la aplicación en el puerto 55199 y la ruta /health sin intrusión. Cuando se completa el registro del servicio, la interfaz devuelve 200. De lo contrario, devuelve 500.

• false: No proporciona una interfaz para que la aplicación verifique si el registro del servicio está completo.

Especifica si se debe habilitar el modo de despliegue continuo gradual para completar la precarga del servicio antes de que el sondeo de preparación tenga éxito:

• true: Este interruptor proporciona una verificación de estado para la aplicación en el puerto 55199 y la ruta /health sin intrusión. Cuando se completa la precarga del servicio, la interfaz devuelve 200. De lo contrario, devuelve 500.

• false: No proporciona una interfaz para que la aplicación verifique si la precarga del servicio está completa.

El límite superior del requisito de recursos de almacenamiento temporal. Unidad: GB. Un valor de 0 significa que no hay límite.

El requisito mínimo de recursos de almacenamiento temporal. Unidad: GB. Un valor de 0 significa que no hay límite.

Establece un contenedor sidecar para el pod de la aplicación. La configuración del contenedor está en formato YAML. El valor es la configuración YAML codificada en base64 del contenedor sidecar.

Establece un contenedor de inicialización para el pod de la aplicación. La configuración del contenedor está en formato YAML. El valor es la configuración YAML codificada en base64 del contenedor de inicialización.

Al utilizar un entorno de ejecución JDK personalizado, debe configurar la dirección de la imagen base. Esta dirección debe ser accesible públicamente. El servidor de EDAS extrae esta imagen para compilar la imagen de la aplicación.

El ID de la política de reglas de despliegue canary.

El periodo de tiempo de espera para la detención gradual de la aplicación. Unidad: segundos.

La arquitectura de plataforma objetivo para la imagen. Esto es válido al desplegar con un archivo WAR o JAR. Ejemplos:

• Para especificar la arquitectura x86-64: linux/amd64

• Para especificar la arquitectura ARM 64: linux/arm64

• Para compilar una imagen de doble arquitectura: linux/amd64,linux/arm64

• Si no introduce un valor, se utiliza la arquitectura predeterminada.

El sondeo de inicio se puede utilizar para realizar comprobaciones de actividad en contenedores de inicio lento y evitar que se finalicen antes de que estén en funcionamiento. Ejemplo: {"failureThreshold": 3,"initialDelaySeconds": 5,"successThreshold": 1,"timeoutSeconds": 1,"httpGet": {"path": "/consumer","port": 8080,"scheme": "HTTP","httpHeaders": [{"name": "test","value": "testvalue"}]}}.

Para eliminar esta configuración, establezca el parámetro en "" o {}. Si no establece este parámetro, la configuración se ignora.

Establece la versión del agente personalizado de Application Real-Time Monitoring Service (ARMS) que se va a montar en la aplicación.

Establece la propiedad SecurityContext para el contenedor del pod de la aplicación. El valor es la configuración YAML codificada en base64 de SecurityContext.