CodeCommit

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

Si utilizas la consola para crear o editar la canalización, CodePipeline crea una regla de CodeCommit CloudWatch eventos que inicia la canalización cuando se produce un cambio en el repositorio.

Debes 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 tu 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 a la URL de Git solo la pueden usar las CodeBuild acciones posteriores para clonar el repositorio y los metadatos de Git asociados. Si se intenta pasar una referencia a una URL de Git a una falta de 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 la fuente. En su lugar, le recomendamos que utilice CloudWatch Events 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) oMigre los canales de sondeo (CodeCommit fuente) (AWS CloudFormation plantilla).

importante

Si tiene intención de configurar una regla de CloudWatch eventos, debe configurarla PollForSourceChanges false para evitar la duplicación de ejecuciones en canalización.

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

• true: Si está configurado, CodePipeline sondea tu repositorio para ver si hay cambios en la fuente.

  nota

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

• false: Si está configurado, CodePipeline no sondea tu repositorio para ver si hay cambios en la fuente. Utilice este ajuste si pretende configurar una regla de CloudWatch eventos para detectar los cambios en la fuente.

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 CODEBUILD_CLONE_REF opción solo la pueden utilizar las acciones CodeBuild posteriores.

Si elige esta opción, tendrá que añadir el codecommit:GitPull permiso a su función de CodeBuild servicio, tal y 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 función de CodePipeline servicio, como se muestra enAgregar permisos al rol de servicio de CodePipeline. Para ver un tutorial que muestra cómo utilizar la opción Clonación completa, consulte Tutorial: Utilice un clon completo 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 ID de confirmación del código fuente se muestra CodePipeline como la revisión fuente de 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 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.

Para obtener más información sobre la diferencia entre un autor y un confirmador en Git, consulte Viewing the Commit History en Pro Git por Scott Chacon y Ben Straub.

CommitterDate

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

Para obtener más información sobre la diferencia entre un autor y un confirmador en Git, consulte Viewing the Commit History en Pro Git por Scott Chacon y Ben Straub.

Ejemplo de configuración de una acción

Ejemplo de formato de artefacto de salida predeterminado

YAML

Actions:
  - OutputArtifacts:
      - Name: Artifact_MyWebsiteStack
    InputArtifacts: []
    Name: source
    Configuration:
      RepositoryName: MyWebsite
      BranchName: main
      PollForSourceChanges: 'false'
    RunOrder: 1
    ActionTypeId:
      Version: '1'
      Provider: CodeCommit
      Category: Source
      Owner: AWS
  Name: Source

JSON

{
    "Actions": [
        {
            "OutputArtifacts": [
                {
                    "Name": "Artifact_MyWebsiteStack"
                }
            ],
            "InputArtifacts": [],
            "Name": "source",
            "Configuration": {
                "RepositoryName": "MyWebsite",
                "BranchName": "main",
                "PollForSourceChanges": "false"
            },
            "RunOrder": 1,
            "ActionTypeId": {
                "Version": "1",
                "Provider": "CodeCommit",
                "Category": "Source",
                "Owner": "AWS"
            }
        }
    ],
    "Name": "Source"
},

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"
}

Véase también

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

• Tutorial: Crear una canalización sencilla (CodeCommitrepositorio)— Este tutorial proporciona un ejemplo de archivo de especificaciones de la aplicación y un ejemplo de grupo de implementación y CodeDeploy aplicación. Utilice este tutorial para crear una canalización con una CodeCommit fuente que se despliegue en las instancias de Amazon EC2.