Despliegue en un grupo de instancias
Cree un pipeline para desplegar artefactos en grupos de instancias.
Requisitos
Los requisitos para desplegar artefactos en un grupo de instancias son los siguientes:
- Un pipeline de despliegue, un entorno de grupo de instancias en el que realizar el despliegue y artefactos. Los artefactos pueden estar definidos en línea o localizados en Artifact Registry.
El despliegue de DevOps soporta el despliegue de varios artefactos en una etapa. Para el despliegue de grupos de instancias, un archivo de configuración de despliegue define los comandos y ejecuta pasos para descargar el artefacto del paquete de aplicación de Artifact Registry especificado y colocarlo en el sistema de archivos de la instancia informática de destino. Consulte Archivo de configuración de despliegue.
- El plugin Comando de ejecución de la instancia informática debe estar activado en la instancia y el plugin se debe estar ejecutando. Para activar el plugin, siga estos pasos:
- En la consola, abra el menú de navegación y haga clic en Recursos informáticos. En Recursos informáticos, haga clic en Instancias.
- Seleccione una instancia del grupo de instancias en el que realizar el despliegue. Nota
DevOps solo soporta despliegues de grupos de instancias en Oracle Linux y CentOS. - Haga clic en el separador Oracle Cloud Agent.
-
Para el plugin Comando de ejecución de la instancia informática, cambie el conmutador Activar plugin a Activado.
El cambio tarda hasta 10 minutos en surtir efecto.
Atención
La funcionalidad que depende del plugin, como la supervisión, la escala automática, el despliegue o la gestión del sistema operativo no funciona cuando el plugin está desactivado.Atención
Para desplegar aplicaciones mediante el plugin Comando de ejecución de la instancia informática, debe configurar y mantener correctamente las políticas de privilegio mínimo. Para obtener más información, consulte Ejecución de comandos en una instancia.Para obtener información sobre la gestión de plugins, consulte Gestión de plugins con Oracle Cloud Agent. Para solucionar problemas, consulte Solución de problemas de Oracle Cloud Agent.
- Permiso para ejecutar comandos en la instancia. Consulte la política de Identity and Access Management (IAM) necesaria.
Para crear grupos dinámicos y políticas para pipelines de despliegue, consulte Políticas de pipeline de despliegue. Para obtener más información, consulte Políticas de IAM de DevOps.
Para acceder a DevOps mediante la consola de Oracle Cloud, la API de REST y la CLI, consulte Acceso a DevOps.
- Abra el menú de navegación y haga clic en Servicios para desarrolladores. En DevOps, haga clic en Proyectos.
- Seleccione un proyecto y un pipeline de despliegue.
- Para agregar una etapa al pipeline, haga clic en el icono + y seleccione Agregar etapa.
- Para el tipo de etapa, seleccione Desplegar grupo de instancias y, a continuación, haga clic en Siguiente.
- Introduzca un nombre y una descripción para la etapa. La adición de una descripción es opcional.
- En Entorno, seleccione un grupo de instancias existente.
- Haga clic en Seleccionar artefacto y seleccione los artefactos de configuración de despliegue de grupos de instancias disponibles para desplegar.
El archivo de configuración de despliegue define los artefactos que se van a descargar en la instancia y la ubicación en la que se deben copiar los artefactos. Para obtener más información, consulte Archivo de configuración de despliegue.
- (Opcional) Haga clic en Seleccionar artefacto para agregar más artefactos que se descargan en las instancias informáticas durante el despliegue.
Estos artefactos adicionales no se deben definir en línea.
- (Opcional) Haga clic en Seleccionar equilibrador de carga. El equilibrador de carga debe estar disponible en la consola.
- Seleccione la región y el compartimento del equilibrador de carga.
- Seleccione un equilibrador de carga de la lista disponible.
El equilibrador de carga distribuye el tráfico de producción durante el despliegue. Para obtener más información, consulte Gestión de equilibradores de carga.
- Para agregar un listener al equilibrador de carga, haga clic en Seleccionar listener.
Los listeners comprueban el tráfico entrante en la dirección IP del equilibrador de carga. Para obtener más información, consulte Gestión de listeners.
- Para realizar un rollback automático a la última versión correcta si falla la validación, seleccione Sí. Para obtener más información, consulte Realización de un rollback de un despliegue.
- La política de implementación controla la velocidad y el comportamiento de la implementación de la instancia en el entorno de destino. Seleccione una de las opciones siguientes:
- Despliegue por porcentaje: introduzca el valor de porcentaje entre 1 y 100. Este valor controla el porcentaje máximo de instancias desplegadas, o que no se están ejecutando, a la vez.
- Anular por recuento: introduzca el valor de recuento. Este valor controla el número máximo de instancias desplegadas, o que no se están ejecutando, a la vez.
- (Opcional) En Retraso entre lotes, introduzca una duración en segundos.
- (Opcional) La política de fallos define los criterios de fallos de una etapa. Se puede definir según el número de hosts informáticos que fallan en un grupo de instancias. Seleccione una de las opciones siguientes:
- Ninguna.
- Error por porcentaje: introduzca el valor de porcentaje entre 1 y 100. Este valor define el porcentaje de hosts informáticos que fallan, tras lo cual falla la etapa.
- Error por recuento: introduzca el valor de recuento. Este valor define el número de hosts informáticos que fallan, tras el cual falla la etapa.
- (Opcional) Para agregar etiquetas al pipeline, haga clic en Mostrar opciones de etiquetado. El etiquetado es un sistema de metadatos que permite organizar los recursos del arrendamiento y realizar su seguimiento.
Si tiene permisos para crear un recurso, también los tiene para agregarle etiquetas de formato libre.
Para agregar una etiqueta definida, debe tener permisos para utilizar el espacio de nombres de etiqueta.
Para obtener más información, consulte Etiquetas de recurso.
- Para agregar la etapa al pipeline, haga clic en Agregar.
Una vista previa de etapa proporciona una instantánea de la configuración.
Agregue más etapas de forma secuencial o en paralelo al pipeline, según sea necesario. Para desplegar la salida de creación en el entorno de destino, ejecute el pipeline de despliegue. Puede agregar 100 etapas paralelas al pipeline de despliegue, pero el plugin Ejecutar comando solo soporta cinco comandos en una instancia. Por lo tanto, debe tener suficientes instancias para ejecutar 100 despliegues de grupos de instancias paralelas.
Para disparar automáticamente un despliegue desde el pipeline de creación, puede agregar una etapa Despliegue de disparador al pipeline de creación.
Para crear una etapa de grupo de instancias, ejecute el comando
create-deploy-compute-instance-group-stage
:oci devops deploy-stage create-deploy-compute-instance-group-stage
Parámetros necesarios para el comando
create-deploy-compute-instance-group-stage
:--compute-instance-group-environment-id
--deployment-spec-artifact-id
--rollout-policy
--pipeline-id
--stage-predecessor-collection
Para obtener todos los comandos para
deploy-stage
:oci devops deploy-stage -h
Para obtener ayuda para el comando
create-deploy-compute-instance-group-stage
:oci devops deploy-stage create-deploy-compute-instance-group-stage -h
Para crear una etapa de despliegue de grupo de instancias para el pipeline, utilice la operación
CreateDeployStage
. Para el atributodeployStageType
, especifique el valorCOMPUTE_INSTANCE_GROUP_ROLLING_DEPLOYMENT
.