Uso del servicio Amazon ECR en AWS Cloud9

Creación de un Dockerfile

1. Para navegar hasta el directorio en el que desea almacenar el Dockerfile, elija la opción Toggle Tree (Alternar árbol) en la barra de navegación izquierda de su IDE de AWS Cloud9.

2. Cree un nuevo archivo llamado Dockerfile.

   nota

   El IDE de AWS Cloud9 puede solicitarle que seleccione un tipo o una extensión de archivo. Si esto ocurre, seleccione plaintext. AWS Cloud9 IDE tiene una extensión "dockerfile". Sin embargo, no recomendamos usarla. Esto se debe a que la extensión puede provocar conflictos con determinadas versiones de Docker u otras aplicaciones asociadas.

Edición de su Dockerfile mediante el IDE de AWS Cloud9

Si el Dockerfile tiene una extensión de archivo, abra el menú contextual (haga clic con el botón derecho) del archivo y elimine la extensión de archivo. Un Dockerfile con extensiones podría provocar conflictos con determinadas versiones de Docker u otras aplicaciones asociadas.

Después de eliminar la extensión de archivo del Dockerfile:

1. Abra el Dockerfile vacío directamente en el IDE de AWS Cloud9.

2. Copie el contenido del siguiente ejemplo en su Dockerfile.

   ejemplo Plantilla de imagen de Dockerfile

   
   FROM ubuntu:22.04
   
   # Install dependencies
   RUN apt-get update && \
    apt-get -y install apache2
   
   # Install apache and write hello world message
   RUN echo 'Hello World!' > /var/www/html/index.html
   
   # Configure apache
   RUN echo '. /etc/apache2/envvars' > /root/run_apache.sh && \
    echo 'mkdir -p /var/run/apache2' >> /root/run_apache.sh && \
    echo 'mkdir -p /var/lock/apache2' >> /root/run_apache.sh && \ 
    echo '/usr/sbin/apache2 -D FOREGROUND' >> /root/run_apache.sh && \ 
    chmod 755 /root/run_apache.sh
   
   EXPOSE 80
   
   CMD /root/run_apache.sh           
               

   Se trata de un archivo Dockerfile que utiliza una imagen de Ubuntu 22.04. Las instrucciones RUN actualizan las memorias caché de paquete. Instale algunos paquetes de software para el servidor web y, a continuación, escriba el contenido "Hello World!" en la raíz de documentos del servidor web. La instrucción EXPOSE expone el puerto 80 en el contenedor y la instrucción CMD inicia el servidor web.

3. Guarde el archivo Dockerfile.

Creación de una imagen a partir del Dockerfile

1. Para navegar al directorio que contiene su Dockerfile, utilice la CLI de Docker o una CLI que esté integrada con su instancia de Docker.

2. Para crear la imagen que está definida en su Dockerfile, ejecute el comando Docker build desde el mismo directorio que el Dockerfile.

   
             docker build -t hello-world .
           

3. Ejecute el comando docker images para comprobar que la imagen se creó correctamente.

   docker images --filter reference=hello-world

   El resultado es el siguiente.

   
   REPOSITORY          TAG                 IMAGE ID            CREATED             SIZE
   hello-world         latest              e9ffedc8c286        4 minutes ago       241MB
             

4. Para ejecutar la imagen recién creada basada en Ubuntu 22.04, use el comando echo.

   nota

   Este paso no es necesario para crear o insertar su imagen. Sin embargo, puede ver cómo funciona la imagen del programa cuando se ejecuta.

   
   FROM ubuntu:22.04
   CMD ["echo", "Hello from Docker in Cloud9"]
           

   A continuación, ejecute y cree el dockerfile. Debe ejecutar este comando en el mismo directorio que el dockerfile.

   
   docker build -t hello-world .
   docker run --rm hello-world

   El resultado es el siguiente.

   Hello from Docker in Cloud9

   Para obtener más información sobre el comando Docker run, consulte Docker run reference (Referencia de Docker run) en el sitio web de Docker.

Creación de un nuevo repositorio de Amazon ECR

1. En la barra de navegación del IDE de AWS Cloud9, elija el icono del kit de herramientas de AWS.

2. Expanda el menú del Explorador de AWS.

3. Busque el valor predeterminado de Región de AWS asociado a su Cuenta de AWS. A continuación, selecciónelo para ver una lista de los servicios que se encuentran a través del IDE de AWS Cloud9.

4. Abra el menú contextual (haga clic con el botón derecho) de la opción ECR para iniciar el proceso Create new repository (Creación de nuevo repositorio). A continuación, seleccione Create Repository (Crear repositorio).

5. Para completar el proceso, siga las indicaciones.

6. Una vez completado el proceso, puede acceder a su nuevo repositorio desde la sección ECR del menú del Explorador de AWS.

Autenticación de Docker con su registro predeterminado

Se requiere autenticación para intercambiar datos entre las instancias de Amazon ECR y Docker. Para autenticar Docker con su registro:

1. Abra un terminal en su IDE de AWS Cloud9.

2. Utilice el método get-login-password para autenticarse en su registro de ECR privado e introduzca su región junto con su ID de Cuenta de AWS.

   aws ecr get-login-password \
       --region <region> \
   | docker login \
       --username AWS \
       --password-stdin <aws_account_id>.dkr.ecr.<region>.amazonaws.com

   importante

   En el comando anterior, reemplace region y AWS_account_id con información que sea específica de su Cuenta de AWS. Un valor region válido es us-east-1.

Etiquetado e inserción de una imagen en el repositorio

Después de autenticar Docker con su instancia de AWS, inserte una imagen en su repositorio.

1. Use el comando de imágenes de Docker para ver las imágenes que ha almacenado localmente e identifique la que desea etiquetar.

   docker images

   El resultado es el siguiente.

   
   REPOSITORY          TAG                 IMAGE ID            CREATED             SIZE
   hello-world         latest              e9ffedc8c286        4 minutes ago       241MB
             

2. Etiquete su imagen Docker con el comando Docker tag.

   docker tag hello-world:latest AWS_account_id.dkr.ecr.region.amazonaws.com/hello-world:latest

3. Inserte la imagen etiquetada en su repositorio con el comando Docker push.

   importante

   Asegúrese de que el nombre del repositorio local sea el mismo que el del repositorio de AWS Amazon EC2. En este ejemplo, ambos repositorios se deben llamar hello-world. Para obtener más información sobre cómo insertar imágenes con docker, consulte Inserción de una imagen de Docker.

   docker push AWS_account_id.dkr.ecr.region.amazonaws.com/hello-world:latest

   El resultado es el siguiente.

   
   The push refers to a repository [AWS_account_id.dkr.ecr.region.amazonaws.com/hello-world] (len: 1)
   e9ae3c220b23: Pushed
   a6785352b25c: Pushed
   0998bf8fb9e9: Pushed
   0a85502c06c9: Pushed
   latest: digest: sha256:215d7e4121b30157d8839e81c4e0912606fca105775bb0636b95aed25f52c89b size: 6774
             

Extracción de una imagen de Amazon ECR

• Puede extraer una imagen en su instancia local del comando Docker tag.

  docker pull AWS_account_id.dkr.ecr.region.amazonaws.com/hello-world:latest

  El resultado es el siguiente.

  
  azonaws.com/hello-world:latest
  latest: Pulling from hello-world
  Digest: sha256:e02c521fd65eae4ef1acb746883df48de85d55fc85a4172a09a124b11b339f5e
  Status: Image is up to date for 922327013870.dkr.ecr.us-west-2.amazonaws.com/hello-world.latest
            

Eliminación de una imagen de su repositorio de Amazon ECR

Hay dos métodos para eliminar una imagen desde el IDE de AWS Cloud9. El primer método consiste en utilizar el Explorador de AWS.

1. Desde el Explorador de AWS, expanda el menú ECR.

2. Expanda el repositorio del que desea eliminar una imagen.

3. Abra el menú contextual (haga clic con el botón derecho) de la etiqueta de imagen que está asociada a la imagen que desea eliminar.

4. Para eliminar todas las imágenes almacenadas que están asociadas a esa etiqueta, elija Delete Tag... (Eliminar etiqueta...).

Eliminación de una imagen mediante AWS CLI

• También puede eliminar una imagen de su repositorio con el comando AWS ecr batch-delete-image.

  aws ecr batch-delete-image \
        --repository-name hello-world \
        --image-ids imageTag=latest
          

  El resultado es el siguiente.

  
  {
      "failures": [],
      "imageIds": [
          {
              "imageTag": "latest",
              "imageDigest": "sha256:215d7e4121b30157d8839e81c4e0912606fca105775bb0636b95aed25f52c89b"
          }
      ]
  }
            

Eliminación de un repositorio desde la instancia de Amazon ECR

Hay dos métodos para eliminar un repositorio desde el IDE de AWS Cloud9. El primer método consiste en utilizar el Explorador de AWS:

1. Desde el Explorador de AWS, expanda el menú ECR.

2. Abra el menú contextual (haga clic con el botón derecho) del repositorio que desea eliminar.

3. Elija Delete Repository... (Eliminar repositorio...).

Eliminación de un repositorio de Amazon ECR desde AWS CLI

• Puede eliminar un repositorio con el comando AWS ecr delete-repository.

  nota

  Normalmente no puede eliminar un repositorio sin eliminar primero las imágenes que contiene. Sin embargo, si agrega la marca --force, puede eliminar un repositorio y todas sus imágenes en un solo paso.

  
          aws ecr delete-repository \
        --repository-name hello-world \
        --force
          

  El resultado es el siguiente.

  --repository-name hello-world --force
  {
      "repository": {
          "repositoryUri": "922327013870.dkr.ecr.us-west-2.amazonaws.com/hello-world", 
          "registryId": "922327013870", 
          "imageTagMutability": "MUTABLE", 
          "repositoryArn": "arn:aws:ecr:us-west-2:922327013870:repository/hello-world", 
          "repositoryName": "hello-world", 
          "createdAt": 1664469874.0
      }
  }