Cómo usar el activador de Docker en Automation Pipelines para ejecutar una canalización de entrega continua

Como administrador o desarrollador de Automation Pipelines, puede utilizar el activador de Docker en Automation Pipelines. El activador de Docker ejecuta una canalización de entrega continua (Continuous Delivery, CD) independiente cada vez que se crea o se actualiza un artefacto de compilación. El activador de Docker ejecuta la canalización de entrega continua, que envía el artefacto nuevo o actualizado como una imagen de contenedor a un repositorio de Docker Hub. La canalización de entrega continua se puede ejecutar como parte de las compilaciones automatizadas.

Por ejemplo, para implementar constantemente la imagen de contenedor actualizada a través de la canalización de entrega continua, use el activador de Docker. Cuando la imagen del contenedor se carga en el registro de Docker, el webhook de Docker Hub notifica a Automation Pipelines que la imagen cambió. Esta notificación activa la canalización de entrega continua para que se ejecute con la imagen de contenedor actualizada y carga la imagen en el repositorio de Docker Hub.

Para usar el activador de Docker, debe realizar varios pasos en Automation Pipelines.

Tabla 1. Cómo usar el activador de Docker

Qué hacer...	Más información sobre esta acción...
Crear un endpoint de registro de Docker	Para que Automation Pipelines active la canalización, debe tener un endpoint de registro de Docker. Si el endpoint no existe, puede seleccionar una opción que lo cree cuando se agregue el webhook relativo al activador de Docker. El endpoint del registro de Docker incluye la URL que lleva al repositorio de Docker Hub.
Agregar parámetros de entrada a la canalización que insertan automáticamente parámetros de Docker cuando la canalización se ejecuta	Puede insertar parámetros de Docker automáticamente en la canalización. Los parámetros pueden incluir el nombre del propietario del evento de Docker, la imagen, el nombre del repositorio, el espacio de nombres del repositorio y la etiqueta. En la canalización de entrega continua se incluyen los parámetros de entrada que el webhook de Docker envía a la canalización antes de que esta se active.
Crear un webhook de Docker	Al crear el webhook de Docker en Automation Pipelines, también se crea el webhook correspondiente en Docker Hub. El webhook de Docker en Automation Pipelines se conecta a Docker Hub a través de la URL incluida en el webhook. Los webhooks se comunican entre sí y activan la canalización cuando un artefacto se crea o actualiza en Docker Hub. Si actualiza o elimina el webhook de Docker en Automation Pipelines, el webhook de Docker Hub también se actualizará o eliminará.
Agregar y configurar una tarea de Kubernetes en la canalización	Cuando se crea o se actualiza un artefacto en el repositorio de Docker Hub, la canalización se activa. A continuación, implementa el artefacto a través de la canalización en el host de Docker en el clúster de Kubernetes.
Incluir una definición de YAML local en la tarea	La definición de YAML que se aplica a la tarea de implementación incluye la imagen de contenedor de Docker. Si necesita descargar una imagen de un repositorio privado, el archivo YAML debe incluir una sección con el secreto de configuración de Docker. Consulte la parte de CD de Planificar una compilación nativa de CICD en Automation Pipelines antes de usar la plantilla de canalización inteligente

Cuando un artefacto se crea o actualiza en el repositorio de Docker Hub, el webhook de Docker Hub avisa al webhook en Automation Pipelines, lo que activa la canalización. Se producen las siguientes acciones:

1. Docker Hub envía una solicitud POST a la URL del webhook.
2. Automation Pipelines ejecuta el activador de Docker.
3. El activador de Docker inicia la canalización de entrega continua.
4. La canalización de entrega continua inserta el artefacto en el repositorio de Docker Hub.
5. Automation Pipelines activa su webhook de Docker, lo que ejecuta una canalización de entrega continua que implementa el artefacto en el host de Docker.

En este ejemplo, se crea un endpoint de Docker y un webhook de Docker en Automation Pipelines que implementan la aplicación en el clúster de Kubernetes de desarrollo. Los pasos incluyen el código de ejemplo de la carga útil que Docker envía a la URL en el webhook, el código de API que este utiliza y el código de autenticación con el token seguro.

Requisitos previos

• Compruebe que existe una canalización de entrega continua en la instancia de Automation Pipelines. Asimismo, compruebe que incluye una o varias tareas de Kubernetes que implementan la aplicación. Consulte Planificar la compilación, la integración y la distribución nativas del código en Automation Pipelines.
• Confirme que puede acceder a un clúster de Kubernetes existente donde la canalización de entrega continua puede implementar la aplicación para desarrollarla.
• Compruebe si es un miembro de un proyecto en Automation Pipelines. Si no lo es, solicite al administrador de Automation Pipelines que lo agregue como miembro de un proyecto. Consulte Cómo agregar un proyecto en Automation Pipelines.

Procedimiento

1. Cree un endpoint de registro de Docker.
   1. Haga clic en Endpoints.
   2. Haga clic en Nuevo endpoint.
   3. Comience a escribir el nombre del proyecto existente.
   4. Seleccione el tipo Registro de Docker.
   5. Introduzca un nombre pertinente.
   6. Seleccione el tipo de servidor DockerHub.
   7. Introduzca la URL que lleva al repositorio de Docker Hub.
   8. Introduzca el nombre y la contraseña que pueden acceder al repositorio.
   
2. En la canalización de entrega continua, configure las propiedades de entrada para que se inserten parámetros de Docker automáticamente cuando la canalización se ejecute.
   
3. Cree un webhook de Docker.
   1. Haga clic en Activadores > Docker.
   2. Haga clic en Nuevo webhook de Docker.
   3. Seleccione un proyecto.
   4. Introduzca un nombre pertinente.
   5. Seleccione el endpoint del registro de Docker.
      Si el endpoint no existe aún, haga clic en Crear endpoint y créelo.
   6. Seleccione la canalización con los parámetros de Docker insertados para que se active el webhook. Consulte Paso 2.
      Si la canalización se configuró con parámetros de entrada personalizados agregados, la lista Parámetros de entrada muestra parámetros y valores. Puede introducir valores para los parámetros de entrada que se transferirán a la canalización con el evento activador. También puede dejar los valores en blanco o utilizar los valores predeterminados si se definieron.

      Para obtener más información sobre los parámetros de la pestaña Entrada, consulte Planificar una compilación nativa de CICD en Automation Pipelines antes de agregar tareas manualmente.

   7. Introduzca el token de API.
      El token de API de VMware Cloud Services lo autentica para las conexiones de API externas con Automation Pipelines. Para obtener el token de API:

      1. Haga clic en Generar token.
      2. Introduzca la dirección de correo electrónico asociada con el nombre de usuario y la contraseña y haga clic en Generar.
         El token que se genera es válido durante seis meses. También se conoce como token de actualización.

         • Para mantener el token como una variable para un uso futuro, haga clic en Crear variable, introduzca un nombre para la variable y haga clic en Guardar.
         • Para conservar el token como valor de texto para usarlo en el futuro, haga clic en Copiar y pegue el token en un archivo de texto para guardarlo de forma local.

         Puede elegir entre crear una variable y almacenar el token en un archivo de texto para utilizarlo en el futuro.
      3. Haga clic en Cerrar.
   8. Introduzca la imagen de compilación.
   9. Introduzca una etiqueta.
      
   10. Haga clic en Guardar.
       La tarjeta del webhook aparece con el webhook de Docker habilitado. Si desea realizar una inserción ficticia en el repositorio de Docker Hub sin activar el webhook de Docker ni ejecutar una canalización, haga clic en Deshabilitar.
4. En la canalización de entrega continua, configure la tarea de implementación de Kubernetes.
   1. En las propiedades de la tarea de Kubernetes, seleccione el clúster de Kubernetes de desarrollo.
   2. Seleccione la acción Crear.
   3. Seleccione la Definición local del origen de la carga útil.
   4. Tras ello, seleccione el archivo YAML local.
      Por ejemplo, Docker Hub puede publicar esta definición de YAML local como la carga útil en la URL del webhook:

      {
      "callback_url": "https://registry.hub.docker.com/u/svendowideit/testhook/hook/2141b5bi5i5b02bec211i4eeih0242eg11000a/",
      "push_data": {
      "images": [
      "27d47432a69bca5f2700e4dff7de0388ed65f9d3fb1ec645e2bc24c223dc1cc3",
      "51a9c7c1f8bb2fa19bcd09789a34e63f35abb80044bc10196e304f6634cc582c",
      "..."
      ],
      "pushed_at": 1.417566161e+09,
      "pusher": "trustedbuilder",
      "tag": "latest"
      },
      "repository": {
      "comment_count": 0,
      "date_created": 1.417494799e+09,
      "description": "",
      "dockerfile": "#\n# BUILD\u0009\u0009docker build -t svendowideit/apt-cacher .\n# RUN\u0009\u0009docker run -d -p 3142:3142 -name apt-cacher-run apt-cacher\n#\n# and then you can run containers with:\n# \u0009\u0009docker run -t -i -rm -e http_proxy http://192.168.1.2:3142/ debian bash\n#\nFROM\u0009\u0009ubuntu\n\n\nVOLUME\u0009\u0009[\/var/cache/apt-cacher-ng\]\nRUN\u0009\u0009apt-get update ; apt-get install -yq apt-cacher-ng\n\nEXPOSE \u0009\u00093142\nCMD\u0009\u0009chmod 777 /var/cache/apt-cacher-ng ; /etc/init.d/apt-cacher-ng start ; tail -f /var/log/apt-cacher-ng/*\n",
      "full_description": "Docker Hub based automated build from a GitHub repo",
      "is_official": false,
      "is_private": true,
      "is_trusted": true,
      "name": "testhook",
      "namespace": "svendowideit",
      "owner": "svendowideit",
      "repo_name": "svendowideit/testhook",
      "repo_url": "https://registry.hub.docker.com/u/svendowideit/testhook/",
      "star_count": 0,
      "status": "Active"
      }
      }

      La API que crea el webhook en Docker Hub utiliza este formato: https://cloud.docker.com/v2/repositories/%3CUSERNAME%3E/%3CREPOSITORY%3E/webhook_pipeline/
      El cuerpo del código JSON se parece a este:

      {
      "name": "demo_webhook",
      "webhooks": [
      {
      "name": "demo_webhook",
      "hook_url": "http://www.google.com"
      }
      ]
      }

      Para recibir eventos del servidor de Docker Hub, el esquema de autenticación del webhook de Docker que se crea en Automation Pipelines utiliza un mecanismo de autenticación de lista de permitidos con un token de cadena aleatorio del webhook. Este mecanismo filtra los eventos en función del token seguro, que puede anexar a hook_url.
      Automation Pipelines puede comprobar cualquier solicitud procedente del servidor de Docker Hub usando el token seguro configurado. Por ejemplo: hook_url = IP:Port/pipelines/api/docker-hub-webhooks?secureToken = ""
5. Cree un artefacto de Docker en el repositorio de Docker Hub o actualice uno ya existente.
6. Para confirmar que se produjo la activación y ver la actividad en el webhook de Docker, haga clic en Activadores > Docker > Actividad.
   
7. Haga clic en Ejecuciones y observe la canalización mientras se ejecuta.
   
8. Haga clic en la etapa en ejecución y vea las tareas a medida que la canalización se ejecuta.
   

Resultados

Enhorabuena. Configure el activador de Docker para ejecutar la canalización de entrega continua de forma continua. Ahora la canalización puede cargar artefactos de Docker nuevos y actualizados en el repositorio de Docker Hub.

Qué hacer a continuación

Compruebe que el artefacto nuevo o actualizado se implementó en el host de Docker, en el clúster de Kubernetes de desarrollo.