Despliegue del código

Editar en línea

La herramienta de despliegue de código se utiliza para desplegar el código fuente de la aplicación en IBM® Code Engine, lo que simplifica el proceso de despliegue y reduce el esfuerzo manual.

La herramienta de despliegue de Code proporciona un proceso de despliegue racionalizado y automatizado. Admite dos tipos de despliegue, IBM -managed y user-managed, y ofrece funciones como la recuperación del estado del proceso de despliegue, la recuperación de registros de la aplicación desplegada y la eliminación de la aplicación especificada.

Servicios y tipos de implantación admitidos

IBM -despliegue gestionado
Despliega el código de la aplicación en un entorno Code Engine gestionado por IBM, que proporciona una configuración temporal y autolimpiable. Se incluyen las siguientes características principales:
Recursos temporales
La aplicación y los recursos relacionados se limpian automáticamente tras un periodo definido dirigido a la persona desarrolladora.
Pruebas
Los usuarios de la persona desarrolladora reciben el punto final de la aplicación URL y el nombre de la aplicación para que puedan probarla cómodamente.
API Connect SaaS exclusivo
Esta función está diseñada para API Connect SaaS, agilizando los procesos de implantación y prueba.
Despliegue gestionado por el usuario
Despliegue fácilmente el código de la aplicación que utiliza la interfaz del Agente en un servicio IBM Code Engine especificado por el usuario, lo que ofrece flexibilidad y control. Se incluyen las siguientes características principales:
Recursos controlados por el usuario
Puede mantener un control total sobre el ciclo de vida y la configuración de los recursos desplegados.
Detalles del despliegue
La herramienta proporciona el punto final de la aplicación URL y el nombre de la aplicación una vez que se ha implantado correctamente.

Opciones

Despliegue del código de la aplicación
Implementar un .zip archivo que contiene el código de la aplicación para un entorno Code Engine administrado por IBM o administrado por el usuario.
  • El despliegue del código de la aplicación es una operación asíncrona.
  • Consulte el estado de despliegue por separado para obtener los resultados.
Nota:
  • Sólo se admiten archivos .zip para el despliegue. No se aceptan otros formatos.
  • El tamaño del archivo debe ser inferior a 1 MB.
  • Para obtener información sobre las comprobaciones de validación previas a la implementación básicas, consulte Comprobaciones previas a la implementación para IBM -managed Code Engine.
  • La herramienta determina la asignación de recursos para la aplicación desplegada de la siguiente manera:
    • 0.125 CPU
    • 0.5 GB de memoria
Comprobar el estado del despliegue
Recupera el estado de un despliegue basándose en el nombre de archivo .zip proporcionado por el usuario.
  • Una vez finalizado el despliegue, la herramienta muestra el estado del mismo, así como el nombre de la aplicación y el endpoint URL.
  • Para obtener más información sobre los estados de implementación, consulte Estado de implementación.
Obtener registros de la aplicación
Recupere los registros de la aplicación desplegada en Code Engine.
  • Los registros obtenidos se empaquetan en un archivo .log y se facilitan para su descarga y depuración.
Suprimir aplicación
Eliminar la aplicación y sus recursos relacionados.

Comprobaciones previas a la implantación para IBM -managed Code Engine

IBM -el motor de código gestionado realiza las comprobaciones que se llevan a cabo antes de desplegar la aplicación y sus recursos asociados.
Gestionado por IBM
Para los entornos gestionados por IBM, deben cumplirse todas las condiciones siguientes antes de iniciar una implantación.
Tabla 1. Requisitos
Comprobar Requisitos
Límite del proyecto
  • Si el proyecto para la organización proveedora existe en IBM Code Engine, la herramienta de despliegue de código utiliza el proyecto existente.
  • Si el proyecto no existe para la organización proveedora, la herramienta de despliegue de código crea un nuevo proyecto en IBM Code Engine si el número de proyectos disponibles es inferior a 20.
Estado del proyecto El proyecto no debe estar en estado de creación.
Aplicación existente El sistema impide que un usuario diferente despliegue una aplicación con el mismo archivo de código fuente .zip
Múltiples aplicaciones Sólo se permite una solicitud por proyecto.
Secreto de registro No debe existir un secreto de registro con el mismo nombre.

Convenciones de denominación para el despliegue de recursos

Para garantizar la coherencia y la trazabilidad, la herramienta de despliegue de Code sigue patrones de nomenclatura normalizados cuando crea recursos.
IBM Code Engine
Utilice las siguientes convenciones de nomenclatura al crear recursos de implantación en los servicios de IBM Code Engine :

La siguiente tabla muestra cómo se crean los recursos para una aplicación con nombre de archivo de código app-code, que es desplegada por el usuario 123 bajo la organización proveedora abc.

Tabla 2. Convenciones de nomenclatura
Tipo de recurso Formato Convenio de denominación
Proyecto aa-<provider_organization>-project
Nota: Los proyectos de IBM Code Engine se circunscriben a la organización proveedora dentro de API Connect.
 aa-abc-project
Secreto de registro <project_name>-registry-secret aa-abc-project-registry-secret
Compilación de imagen <project_name>-<application_code_file_name>-<user_id>-<resource_name> aa-abc-project-app-code-123-image-build
Ejecución de la creación de imágenes <project_name>-<application_code_file_name>-<user_id>-<resource_name> aa-abc-project-app-code-123-image-build-run
Configmap <project_name>-<application_code_file_name>-<user_id>-<resource_name> aa-abc-project-app-code-123-cm
Secreto <project_name>-<application_code_file_name>-<user_id>-<resource_name> aa-abc-project-app-code-123-secret
Aplicación <project_name>-<application_code_file_name>-<user_id>-<resource_name> aa-abc-project-app-code-123-app

Estado de despliegue

Cuando se inicia la operación de estado de despliegue, la herramienta de despliegue de código devuelve diferentes estados para identificar el progreso o el resultado del despliegue.
IBM Code Engine estado de despliegue
Los siguientes estados representan las etapas de despliegue dentro de IBM Code Engine :
Tabla 3. Estados
Etapa Descripción Estados
Creación del proyecto Proyecto y configuración secreta PENDING, IN_PROGRESS, COMPLETED, FAILED
Edificio de imágenes Creación y envío de imágenes PENDING, IN_PROGRESS, COMPLETED, FAILED
Despliegue de aplicaciones Creación de aplicaciones, mapas de configuración y secretos PENDING, IN_PROGRESS, COMPLETED, FAILED
Nota:
  • Las tres etapas se muestran para indicar las que se han completado, las que están en curso y las que aún están pendientes.
  • Si alguna parte del proceso falla, la etapa fallida muestra el estado FAILED y una razón del fallo.
  • Si todas las etapas muestran el estado COMPLETADO, la herramienta proporciona la Aplicación URL y el nombre de la Aplicación.
  • Asegúrese de que el documento fuente OpenAPI a partir del cual se generó la aplicación desplegada se actualiza ahora para utilizar la aplicación IBM Code Engine URL como valor de servers[0].url. Esto es imprescindible si la siguiente acción prevista es crear un borrador de API y publicarlo en API Connect con la herramienta « API Connect Task ».