Referencia de acciones de origen de Amazon ECR - AWS CodePipeline
Tipo de acciónParámetros de configuración Artefactos de entradaArtefactos de salidaVariables de salidaPermisos del rol de servicio: acción de Amazon ECRDeclaración de acción (ejemplo de Amazon ECR)Véase también

Referencia de acciones de origen de Amazon ECR

Activa la canalización cuando se envía una nueva imagen al repositorio de Amazon ECR. Esta acción proporciona un archivo de definiciones de imagen que hace referencia al URI de la imagen que se ha enviado a Amazon ECR. Esta acción de origen se utiliza a menudo junto con otra acción de origen, como CodeCommit, para permitir una ubicación de origen para todos los demás artefactos de origen. Para obtener más información, consulte Tutorial: Crear una canalización con un origen de Amazon ECR y una implementación de ECS-to-CodeDeploy.

Cuando utiliza la consola para crear o editar la canalización, CodePipeline crea una regla de EventBridge que inicia la canalización cuando se produce un cambio en el repositorio.

nota

Para los orígenes de Amazon ECR, Amazon S3 o CodeCommit, también puede crear una anulación de origen mediante la entrada de transformación de entrada para utilizar revisionValue en EventBridge para el evento de canalización, donde revisionValue se deriva de la variable de evento de origen para la clave de objeto, confirmación o ID de imagen. Para obtener más información, consulte el paso opcional para la entrada de transformación de entrada, que se incluye en los procedimientos de acciones de origen de Amazon ECR y recursos de EventBridge, Conexión a acciones de origen de Amazon S3 con un origen habilitado para eventos o acciones de origen de CodeCommit y EventBridge.

Ya debe haber creado un repositorio de Amazon ECR y enviado una imagen antes de conectar la canalización a través de una acción de Amazon ECR.

Tipo de acción

  • Categoría: Source

  • Propietario: : AWS

  • Proveedor: ECR

  • Versión: 1

Parámetros de configuración

RepositoryName

Obligatorio: sí

El nombre del repositorio de Amazon ECR al que se envió la imagen.

ImageTag

Obligatorio: no

La etiqueta utilizada para la imagen.

nota

Si no se especifica un valor para ImageTag, el valor predeterminado es latest.

Artefactos de entrada

  • Número de artefactos: 0

  • Descripción: los artefactos de entrada no se aplican a este tipo de acción.

Artefactos de salida

Variables de salida

Cuando se configura, esta acción produce variables a las que se puede hacer referencia mediante la configuración de acción de una acción descendente en la canalización. Esta acción produce variables que se pueden ver como variables de salida, incluso si la acción no tiene un espacio de nombres. Configure una acción con un espacio de nombres para que esas variables estén disponibles para la configuración de las acciones posteriores.

Para obtener más información, consulte Referencia de variables.

RegistryId

El ID de cuenta de AWS asociado al registro que contiene el repositorio.

RepositoryName

El nombre del repositorio de Amazon ECR al que se envió la imagen.

ImageTag

La etiqueta utilizada para la imagen.

nota

La variable de salida ImageTag no se genera cuando se anula la revisión de origen

ImageDigest

El resumen sha256 del manifiesto de la imagen.

ImageURI

El URI de la imagen.

Permisos del rol de servicio: acción de Amazon ECR

Para admitir Amazon ECR, añada lo siguiente a su instrucción de política:

{
    "Effect": "Allow",
    "Action": [
        "ecr:DescribeImages"
    ],
    "Resource": "resource_ARN"
},

Para obtener más información sobre esta acción, consulte Referencia de acciones de origen de Amazon ECR.

Declaración de acción (ejemplo de Amazon ECR)

YAML
Name: Source
Actions:
  - InputArtifacts: []
    ActionTypeId:
      Version: '1'
      Owner: AWS
      Category: Source
      Provider: ECR
    OutputArtifacts:
      - Name: SourceArtifact
    RunOrder: 1
    Configuration:
      ImageTag: latest
      RepositoryName: my-image-repo

    Name: ImageSource
JSON
{
    "Name": "Source",
    "Actions": [
        {
            "InputArtifacts": [],
            "ActionTypeId": {
                "Version": "1",
                "Owner": "AWS",
                "Category": "Source",
                "Provider": "ECR"
            },
            "OutputArtifacts": [
                {
                    "Name": "SourceArtifact"
                }
            ],
            "RunOrder": 1,
            "Configuration": {
                "ImageTag": "latest",
                "RepositoryName": "my-image-repo"
            },
            "Name": "ImageSource"
        }
    ]
},

Los recursos relacionados siguientes pueden serle de ayuda cuando trabaje con esta acción.