Acciones de CodeStarSourceConnection para Bitbucket Cloud, GitHub, GitHub Enterprise Server, GitLab.com y GitLab autoadministrado

Las acciones de origen para las conexiones son compatibles con AWS CodeConnections. CodeConnections permite crear y administrar conexiones entre recursos de AWS y repositorios de terceros, como GitHub. Inicia una canalización cuando se realiza una nueva confirmación en un repositorio de código fuente de terceros. La acción de origen recupera los cambios de código cuando se ejecuta manualmente una canalización o cuando se envía un evento webhook desde el proveedor de origen.

Puede configurar acciones en la canalización para usar una configuración de Git que permita iniciar la canalización con desencadenadores. Para configurar los desencadenadores de canalización para filtrar con ellos, consulte más información en Agregación de desencadenadores con tipos de eventos de solicitud de inserción o extracción de código.

Las conexiones pueden asociar sus recursos de AWS a los siguientes repositorios de terceros:

Las conexiones permiten que su canalización detecte los cambios de origen a través de la aplicación de instalación del proveedor externo. Por ejemplo, los webhooks se utilizan para suscribirse a los tipos de eventos de GitHub y se pueden instalar en una organización, un repositorio o una aplicación de GitHub. Su conexión instala un webhook de repositorio en su aplicación de GitHub que se suscribe a los eventos de tipo push de GitHub.

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

CodePipeline le pide que añada la aplicación de instalación de AWS Connector a su cuenta de terceros al crear una conexión. Debe haber creado ya su cuenta y repositorio de proveedor externo para poder conectarse a través de la acción CodeStarSourceConnection.

Tipo de acción

Parámetros de configuración

Artefactos de entrada

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.

Permisos del rol de servicio: acción de CodeConnections

En el caso de CodeConnections, el siguiente permiso es necesario para crear canalizaciones con un origen que utilice una conexión, como Bitbucket Cloud.

{
    "Effect": "Allow",
    "Action": [
        "codeconnections:UseConnection"
    ],
    "Resource": "resource_ARN"
},

Para obtener más información sobre los permisos de IAM para las conexiones, consulte Referencia de permisos de conexiones.

Declaración de acciones

En el siguiente ejemplo, el artefacto de salida se establece en el formato ZIP predeterminado de CODE_ZIP para la conexión con ARN arn:aws:codestar-connections:region:account-id:connection/connection-id.

YAML

Name: Source
Actions:
  - InputArtifacts: []
    ActionTypeId:
      Version: '1'
      Owner: AWS
      Category: Source
      Provider: CodeStarSourceConnection
    OutputArtifacts:
      - Name: SourceArtifact
    RunOrder: 1
    Configuration:
      ConnectionArn: "arn:aws:codestar-connections:region:account-id:connection/connection-id"
      FullRepositoryId: "some-user/my-repo"
      BranchName: "main"
      OutputArtifactFormat: "CODE_ZIP"
    Name: ApplicationSource

JSON

{
    "Name": "Source",
    "Actions": [
        {
            "InputArtifacts": [],
            "ActionTypeId": {
                "Version": "1",
                "Owner": "AWS",
                "Category": "Source",
                "Provider": "CodeStarSourceConnection"
            },
            "OutputArtifacts": [
                {
                    "Name": "SourceArtifact"
                }
            ],
            "RunOrder": 1,
            "Configuration": {
                "ConnectionArn": "arn:aws:codestar-connections:region:account-id:connection/connection-id",
                "FullRepositoryId": "some-user/my-repo",
                "BranchName": "main",
                "OutputArtifactFormat": "CODE_ZIP"
            },
            "Name": "ApplicationSource"
        }
    ]
},

Instalación de la aplicación de instalación y creación de una conexión

La primera vez que utilice la consola para añadir una nueva conexión a un repositorio de terceros, debe autorizar el acceso de CodePipeline a sus repositorios. Elegirá y creará una aplicación de instalación que le ayude a conectarse a la cuenta en la que ha creado su repositorio de código de terceros.

Cuando utilice la AWS CLI o una plantilla de CloudFormation, deberá proporcionar el ARN de conexión de una conexión que ya haya superado el protocolo de instalación. De lo contrario, la canalización no se activará.

Véase también

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