Inserción de una imagen

Azure DevOps Services

Use Azure Pipelines para insertar la imagen en un registro de contenedor, como Azure Container Registry, Docker Hub o Google Container Registry. Azure Container Registry es un servicio de registro administrado basado en Docker Registry 2.0 de código abierto.

Para ver un tutorial sobre cómo compilar e insertar imágenes en un registro de contenedor, consulte Compilación e inserción de imágenes de Docker en Azure Container Registry.

Para obtener información sobre cómo compilar una imagen de contenedor para implementarla con Azure Pipelines, consulte Compilación de imágenes de contenedor para implementar aplicaciones.

Acerca de la tarea de Docker

Usará la tarea de Docker@2 para compilar o insertar imágenes de Docker, iniciar o cerrar sesión, iniciar o detener contenedores o ejecutar un comando de Docker.

La tarea usa una conexión de servicio del registro de Docker para iniciar sesión e insertar en un registro de contenedor. El proceso para crear una conexión de servicio del registro de Docker difiere en función del registro.

La conexión del servicio del registro de Docker almacena las credenciales en el registro de contenedor antes de insertar la imagen. También puede hacer referencia directamente a las conexiones de servicio en Docker sin una tarea de script adicional.

Creación de una conexión de servicio de Docker

Deberá seguir un proceso diferente para crear una conexión de servicio para Azure Container Registry, Docker Hub y Container Registry de Google.

Azure Container Registry

Con la opción Azure Container Registry, la suscripción (asociada a la identidad de Microsoft Entra del usuario que ha iniciado sesión en Azure DevOps) y el registro de contenedor dentro de la suscripción se usan para crear la conexión de servicio.

Al crear una canalización para un repositorio que contenga un Dockerfile, Azure Pipelines detectará Dockerfile en el repositorio. Para iniciar este proceso, cree una canalización y seleccione el repositorio con el Dockerfile.

1. En la pestaña Configurar, seleccione la tarea Docker - Compilar e insertar una imagen en Azure Container Registry tarea.

   

2. En Suscripción de Azure, seleccione su suscripción y, luego, elija Continuar.

3. Seleccione Registro de contenedor en el menú desplegable y, luego, rellene el campo Nombre de imagen con el nombre de la imagen de contenedor.

4. Cuando haya terminado, seleccione Validar y configurar.

   

   A medida que Azure Pipelines cree la canalización, sucederá lo siguiente:

   • Se creará una conexión de servicio del registro de Docker para permitir que la canalización inserte imágenes en el registro de contenedor.

   • Genere un archivo azure-pipelines.yml, que define la canalización.

Para obtener información general más detallada, consulte Compilación e inserción en documento de Azure Container Registry.

Docker Hub

Elija la opción Docker Hub en Conexión de servicio del registro de Docker y proporcione el nombre de usuario y la contraseña para crear una conexión de servicio de Docker.

Container Registry de Google

Para crear una conexión de servicio de Docker asociada a Container Registry de Google:

1. Abra el proyecto en la consola de GCP y, a continuación, abra Cloud Shell.

2. Para ahorrar tiempo al escribir el identificador del proyecto y las opciones de zona del motor de proceso, establezca los valores de configuración predeterminados mediante la ejecución de los siguientes comandos:

   gcloud config set project [PROJECT_NAME]
   gcloud config set compute/zone [ZONE]
   

3. Reemplace [PROJECT_NAME] por el nombre del proyecto de GCP y reemplace [ZONE] por el nombre de la zona que va a usar para crear recursos. Si no está seguro de qué zona elegir, use us-central1-a. Por ejemplo:

   gcloud config set project azure-pipelines-test-project-12345
   gcloud config set compute/zone us-central1-a
   

4. Habilite la API de Container Registry para el proyecto:

   gcloud services enable containerregistry.googleapis.com
   

5. Cree una cuenta de servicio para que Azure Pipelines publique imágenes de Docker:

   gcloud iam service-accounts create azure-pipelines-publisher --display-name "Azure Pipelines Publisher"
   

6. Asigne el rol de IAM de administración de almacenamiento a la cuenta de servicio:

   PROJECT_NUMBER=$(gcloud projects describe \
   $(gcloud config get-value core/project) \
   --format='value(projectNumber)')
   
   AZURE_PIPELINES_PUBLISHER=$(gcloud iam service-accounts list \
       --filter="displayName:Azure Pipelines Publisher" \
       --format='value(email)')
   
   gcloud projects add-iam-policy-binding \
       $(gcloud config get-value core/project) \
       --member serviceAccount:$AZURE_PIPELINES_PUBLISHER \
       --role roles/storage.admin
   

7. Genere una clave de cuenta de servicio:

   gcloud iam service-accounts keys create \
   azure-pipelines-publisher.json --iam-account $AZURE_PIPELINES_PUBLISHER
   
   tr -d '\n' < azure-pipelines-publisher.json > azure-pipelines-publisher-oneline.json
   

   Inicie el editor de código haciendo clic en el botón de la esquina superior derecha de Cloud Shell:

   

8. Abra el archivo named azure-pipelines-publisher-oneline.json. Necesitará el contenido de este archivo en uno de los pasos siguientes:

9. En la organización de Azure DevOps, seleccione Configuración del proyecto y, después, Canalizaciones:> conexiones de servicio.

10. Seleccione Nueva conexión de servicio y elija Registro de Docker.

11. En el cuadro de diálogo, escriba valores para los campos siguientes:

    • Registro de Docker:https://gcr.io/[PROJECT-ID], donde [PROJECT-ID] es el nombre del proyecto de GCP.
    • Identificador de Docker:_json_key
    • Contraseña de Docker: pegue el contenido de azure-pipelines-publisher-oneline.json.
    • Nombre de conexión de servicio:gcrServiceConnection

12. Seleccione Guardar para crear la conexión de servicio.