View a markdown version of this page

CodeCommit referencia de acción de origen - AWS CodePipeline
Tipo de acciónParámetros de configuraciónArtefactos de entradaArtefactos de salidaVariables de salidaPermisos de rol de servicio: CodeCommit acciónEjemplo de configuración de una acciónVéase también

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

CodeCommit referencia de acción de origen

Inicia la canalización cuando se realiza una nueva confirmación en el CodeCommit repositorio y la rama configurados.

Si usas la consola para crear o editar la canalización, CodePipeline crea una EventBridge regla que inicie la canalización cuando se produzca un cambio en el repositorio.

nota

En el caso de Amazon ECR, Amazon S3 o CodeCommit las fuentes, también puedes crear una anulación de fuente utilizando la entrada de transformación de entrada EventBridge para usar la entrada revisionValue en el evento de canalización, donde revisionValue se deriva de la variable de evento de origen de tu 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 y recursos de origen de Amazon ECR EventBridge, Conexión a acciones de origen de Amazon S3 con un origen habilitado para eventos o CodeCommit acciones de origen y EventBridge.

Debe haber creado ya un CodeCommit repositorio antes de conectar la canalización mediante una CodeCommit acción.

Después de detectar un cambio de código, tiene las siguientes opciones para pasar el código a acciones posteriores:

  • Predeterminado: configura la acción de CodeCommit origen para generar un archivo ZIP con una copia superficial de la confirmación.

  • Clonación completa: configura la acción de origen para generar una referencia de URL de Git al repositorio para acciones posteriores.

    Actualmente, la referencia URL de Git solo la pueden usar CodeBuild las acciones posteriores para clonar el repositorio y los metadatos de Git asociados. Si se intenta pasar una referencia de URL de Git a una URL que no se ha realizado ninguna CodeBuild acción, se produce un error.

Tipo de acción

  • Categoría: Source

  • Propietario: AWS

  • Proveedor: CodeCommit

  • Versión: 1

Parámetros de configuración

RepositoryName

Obligatorio: sí

El nombre del repositorio en el que se van a detectar los cambios de origen.

BranchName

Obligatorio: sí

El nombre de la ramificación donde se van a detectar los cambios de origen.

PollForSourceChanges

Obligatorio: no

PollForSourceChangescontrola si CodePipeline sondea el CodeCommit repositorio en busca de cambios en el código fuente. En su lugar, le recomendamos que utilice CloudWatch los eventos para detectar los cambios en la fuente. Para obtener más información sobre la configuración de CloudWatch eventos, consulte Migrar los canales de sondeo (CodeCommit fuente) (CLI) oMigrar los canales de sondeo (CodeCommit fuente) (CloudFormation plantilla).

importante

Si quieres configurar una regla de CloudWatch eventos, debes configurarla PollForSourceChanges para false evitar que se dupliquen las ejecuciones de canalización.

Los valores válidos para este parámetro son:

  • true: Si se establece, CodePipeline sondea tu repositorio para ver si hay cambios en el código fuente.

    nota

    Si lo omitesPollForSourceChanges, de CodePipeline forma predeterminada sondea tu repositorio para ver si hay cambios en el código fuente. Este comportamiento es el mismo que si se incluye PollForSourceChanges y se establece en true.

  • false: Si se establece, CodePipeline no sondea tu repositorio para ver si hay cambios en el código fuente. Usa esta configuración si quieres configurar una regla de CloudWatch eventos para detectar los cambios en el origen.

OutputArtifactFormat

Obligatorio: no

El formato del artefacto de salida. Los valores pueden ser CODEBUILD_CLONE_REF o CODE_ZIP. Si no se especifica, el valor predeterminado es CODE_ZIP.

importante

La opción CODEBUILD_CLONE_REF solo se puede utilizar en acciones de CodeBuild posteriores.

Si elige esta opción, debe agregar el codecommit:GitPull permiso a su rol de CodeBuild servicio como se muestra enAñade CodeBuild GitClone permisos para las acciones CodeCommit de origen. También debe añadir el codecommit:GetRepository permiso a su rol de CodePipeline servicio, tal y como se muestra enAñade permisos a la función de CodePipeline servicio. Para ver un tutorial que muestra cómo utilizar la opción Clonación completa, consulte Tutorial: Usa la clonación completa con una fuente de CodeCommit canalización.

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

  • Número de artefactos: 1

  • Descripción: el artefacto de salida de esta acción es un archivo ZIP que contiene el contenido del repositorio configurado y la ramificación en la confirmación especificada como la revisión de origen para la ejecución de la canalización. Los artefactos generados desde el repositorio son los artefactos de salida de la CodeCommit acción. El identificador de confirmación del código fuente se muestra CodePipeline como la revisión de origen para la ejecución de la canalización activada.

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.

CommitId

El ID de CodeCommit confirmación que activó la ejecución de la canalización. Los ID de confirmación son el volumen de dispositivo raíz completo de la confirmación.

CommitMessage

El mensaje de descripción, si lo hay, asociado a la confirmación que desencadenó la ejecución de la canalización.

RepositoryName

El nombre del CodeCommit repositorio en el que se realizó la confirmación que activó la canalización.

BranchName

El nombre de la rama del CodeCommit repositorio en el que se realizó el cambio de fuente.

AuthorDate

Fecha en la que se creó la confirmación, en formato de marca temporal.

CommitterDate

Fecha en la que se ha confirmado la confirmación, en formato de marca temporal.

Permisos de rol de servicio: CodeCommit acción

Cuando CodePipeline se ejecuta la acción, la política de funciones de CodePipeline servicio requiere los siguientes permisos, con un alcance adecuado según el ARN del recurso canalizado, a fin de mantener el acceso con los mínimos privilegios. Por ejemplo, agregue lo siguiente a su declaración de política:

JSON
{
    "Version":"2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "codecommit:CancelUploadArchive",
                "codecommit:GetBranch",
                "codecommit:GetCommit",
                "codecommit:GetRepository",
                "codecommit:GetUploadArchiveStatus",
                "codecommit:UploadArchive"
            ],
            "Resource": [
                "arn:aws:codecommit:*:111122223333:[[codecommitRepostories]]"
            ]
        }
    ]
}

Ejemplo de configuración de una acción

Ejemplo de formato de artefacto de salida predeterminado

YAML
name: Source
actionTypeId:
  category: Source
  owner: AWS
  provider: CodeCommit
  version: '1'
runOrder: 1
configuration:
  BranchName: main
  PollForSourceChanges: 'false'
  RepositoryName: MyWebsite
outputArtifacts:
  - name: Artifact_MyWebsiteStack
inputArtifacts: []
region: us-west-2
namespace: SourceVariables
JSON
{
    "name": "Source",
    "actionTypeId": {
        "category": "Source",
        "owner": "AWS",
        "provider": "CodeCommit",
        "version": "1"
    },
    "runOrder": 1,
    "configuration": {
        "BranchName": "main",
        "PollForSourceChanges": "false",
        "RepositoryName": "MyWebsite"
    },
    "outputArtifacts": [
        {
            "name": "Artifact_MyWebsiteStack"
        }
    ],
    "inputArtifacts": [],
    "region": "us-west-2",
    "namespace": "SourceVariables"
}

Ejemplo de formato de artefacto de salida de clonación

YAML
name: Source
actionTypeId:
  category: Source
  owner: AWS
  provider: CodeCommit
  version: '1'
runOrder: 1
configuration:
  BranchName: main
  OutputArtifactFormat: CODEBUILD_CLONE_REF
  PollForSourceChanges: 'false'
  RepositoryName: MyWebsite
outputArtifacts:
  - name: SourceArtifact
inputArtifacts: []
region: us-west-2
namespace: SourceVariables
JSON
{
    "name": "Source",
    "actionTypeId": {
        "category": "Source",
        "owner": "AWS",
        "provider": "CodeCommit",
        "version": "1"
    },
    "runOrder": 1,
    "configuration": {
        "BranchName": "main",
        "OutputArtifactFormat": "CODEBUILD_CLONE_REF",
        "PollForSourceChanges": "false",
        "RepositoryName": "MyWebsite"
    },
    "outputArtifacts": [
        {
            "name": "SourceArtifact"
        }
    ],
    "inputArtifacts": [],
    "region": "us-west-2",
    "namespace": "SourceVariables"
}

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