CodeCommit referencia de acción de origen - AWS CodePipeline
Tipo de acciónParámetros de configuración Artefactos de entradaArtefactos de salidaVariables de salidaEjemplo 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 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 ZIP archivo con una copia superficial de tu confirmación.

  • Clon completo: configura la acción de origen para generar una URL referencia de Git en el repositorio para acciones posteriores.

    Actualmente, la URL referencia 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 URL referencia de Git a las no CodeBuild acciones, 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 Migre los canales de sondeo (CodeCommit fuente) (CLI) oMigre los canales de sondeo (CodeCommit fuente) (AWS CloudFormation plantilla).

importante

Si pretende 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 enAgregue 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 ZIP archivo que contiene el contenido del repositorio y la rama configurados en la confirmación especificada como 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 Referencia de variables.

CommitId

El ID de CodeCommit confirmación que activó la ejecución de la canalización. IDsLas confirmaciones son la totalidad SHA 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.

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

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. Usa este tutorial para crear una canalización con una CodeCommit fuente que se despliegue en las EC2 instancias de Amazon.