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.
CodeStarSourceConnection para Bitbucket Cloud GitHub, GitHub Enterprise Server, GitLab .com y acciones GitLab autogestionadas
Las acciones de origen para las conexiones son compatibles con. AWS CodeConnections CodeConnections permite crear y administrar conexiones entre AWS recursos 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.
Puedes configurar acciones en tu canalización para usar una configuración de Git que te permita iniciar tu canalización con activadores. Para configurar la configuración de los activadores de canalización para filtrar con activadores, consulta más información enFiltra los activadores en las solicitudes de inserción o extracción de código.
nota
Esta función no está disponible en las regiones Asia Pacífico (Hong Kong), Asia Pacífico (Hyderabad), Asia Pacífico (Yakarta), Asia Pacífico (Melbourne), Asia Pacífico (Osaka), África (Ciudad del Cabo), Oriente Medio (Bahréin), Oriente Medio (), Oriente Medio (UAE), Europa (España), Europa (Zúrich), Israel (Tel Aviv) o AWS GovCloud (EE. UU. Oeste). Para hacer referencia a otras acciones disponibles, consulte Integraciones de productos y servicios con CodePipeline. Para ver consideraciones sobre esta acción en la región de Europa (Milán), consulte la nota que aparece en CodeStarSourceConnection para Bitbucket Cloud GitHub, GitHub Enterprise Server, GitLab .com y acciones GitLab autogestionadas.
Connections puede asociar tus AWS recursos a los siguientes repositorios de terceros:
-
Bitbucket Cloud (mediante la opción de proveedor de Bitbucket en la CodePipeline consola o el
Bitbucket
proveedor en la) CLInota
Puede crear conexiones a un repositorio de Bitbucket Cloud. Los tipos de proveedores de Bitbucket instalados, como Bitbucket Server, no son compatibles.
-
nota
Si utiliza un espacio de trabajo de Bitbucket, debe tener acceso de administrador para crear la conexión.
-
GitHub y GitHub Enterprise Cloud (mediante la opción de proveedor GitHub (versión 2) en la CodePipeline consola o el
GitHub
proveedor en la) CLInota
Si tu repositorio está en una GitHub organización, debes ser el propietario de la organización para crear la conexión. Si está utilizando un repositorio que no está en una organización, debe ser el propietario del repositorio.
-
GitHub Enterprise Server (mediante la opción de proveedor de GitHub Enterprise Server en la CodePipeline consola o el
GitHub Enterprise Server
proveedor en laCLI) -
GitLab.com (a través de la opción de GitLabproveedor en la CodePipeline consola o el
GitLab
proveedor en laCLI)nota
Puede crear conexiones a un repositorio en el que tenga el rol de propietario y GitLab, a continuación, la conexión se puede utilizar con el repositorio con recursos como CodePipeline: En el caso de los repositorios en grupos, no es necesario que sea el propietario del grupo.
-
Instalación autogestionada para GitLab (Enterprise Edition o Community Edition) (mediante la opción de proveedor GitLab autogestionado en la CodePipeline consola o el
GitLabSelfManaged
proveedor en la) CLI
nota
Cada conexión es compatible con todos los repositorios que tenga con ese proveedor. Solo tiene que crear una conexión nueva para cada tipo de proveedor.
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 tipos de GitHub eventos y se pueden instalar en una organización, un repositorio o una aplicación. GitHub Tu conexión instala un webhook de repositorio en tu GitHub aplicación que se suscribe a GitHub eventos de tipo push.
Después de detectar un cambio de código, tiene las siguientes opciones para pasar el código a acciones posteriores:
-
Predeterminado: al igual que otras acciones de CodePipeline código fuente existentes,
CodeStarSourceConnection
puedes generar un ZIP archivo con una copia superficial de tu confirmación. -
Clon completo: también se
CodeStarSourceConnection
puede configurar para generar una URL referencia al 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.
CodePipeline te pide que añadas la aplicación de instalación de AWS Connector a tu 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
.
nota
Para crear o asociar una política a su rol con los permisos necesarios para usar las conexiones de AWS CodeStar , consulte Referencia de permisos de conexiones. En función de cuándo se creó su función de CodePipeline servicio, es posible que necesite actualizar sus permisos para admitir AWS CodeStar las conexiones. Para obtener instrucciones, consulte Agregar permisos al rol de servicio de CodePipeline.
nota
Para utilizar las conexiones en Europa (Milán) Región de AWS, debe:
-
Instalar una aplicación específica de la región
-
Habilitar la región
Esta aplicación específica de la región está disponible en la región Europa (Milán). Se publica en el sitio del proveedor externo y es independiente de la aplicación existente que admite conexiones para otras regiones. Al instalar esta aplicación, autoriza a los proveedores externos a compartir sus datos con el servicio únicamente para esta región, y puede revocar los permisos en cualquier momento desinstalando la aplicación.
El servicio no procesará ni almacenará sus datos a menos que habilite la región. Al habilitar esta región, otorga a nuestro servicio permisos para procesar y almacenar sus datos.
Aunque la región no esté habilitada, los proveedores externos pueden compartir sus datos con nuestro servicio si la aplicación específica de la región permanece instalada, así que asegúrese de desinstalar la aplicación una vez que deshabilite la región. Para obtener más información, consulte Habilitar una región.
Temas
Tipo de acción
-
Categoría:
Source
-
Propietario:
AWS
-
Proveedor:
CodeStarSourceConnection
-
Versión:
1
Parámetros de configuración
- ConnectionArn
-
Obligatorio: sí
La conexión ARN que está configurada y autenticada para el proveedor de origen.
- FullRepositoryId
-
Obligatorio: sí
El propietario y el nombre del repositorio en el que se van a detectar los cambios de código fuente.
Ejemplo:
some-user/my-repo
importante
Debe mantener las mayúsculas y minúsculas correctas para el FullRepositoryIdvalor. Por ejemplo, si tu nombre de usuario es
some-user
y el nombre del repositorio esMy-Repo
, el valor recomendado FullRepositoryIdessome-user/My-Repo
. - BranchName
-
Obligatorio: sí
El nombre de la ramificación donde se van a detectar los cambios de origen.
- OutputArtifactFormat
-
Obligatorio: no
Especifica el formato del artefacto de salida. Puede ser
CODEBUILD_CLONE_REF
oCODE_ZIP
. Si no se especifica, el valor predeterminado esCODE_ZIP
.importante
La
CODEBUILD_CLONE_REF
opción solo la pueden utilizar las acciones CodeBuild posteriores.Si elige esta opción, tendrá que actualizar los permisos de su función de servicio de CodeBuild proyectos, tal y como se muestra en Añade CodeBuild GitClone permisos para las conexiones a Bitbucket, Enterprise Server o .com GitHub GitHub GitLab la siguiente. 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 GitHub canalización.
- DetectChanges
-
Obligatorio: no
Controla automáticamente el inicio de su canalización cuando se realiza una nueva confirmación en el repositorio y la rama configurados. Si no se especifica, el valor predeterminado es
true
y el campo no se muestra de forma predeterminada. Los valores válidos para este parámetro son:-
true
: inicia CodePipeline automáticamente tu canalización con las nuevas confirmaciones. -
false
: CodePipeline no inicia tu canalización con nuevas confirmaciones.
-
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: los artefactos generados desde el repositorio son los artefactos de salida de la acción
CodeStarSourceConnection
. El ID de confirmación del código fuente se muestra CodePipeline como la revisión de origen de la ejecución de la canalización activada. Puede configurar el artefacto de salida de esta acción en:-
Un ZIP archivo que contiene el contenido del repositorio y la ramificación configurados en la confirmación especificada como revisión de origen para la ejecución de la canalización.
-
Un JSON archivo que contiene una URL referencia al repositorio para que las acciones posteriores puedan ejecutar comandos de Git directamente.
importante
Esta opción solo la pueden utilizar las acciones CodeBuild posteriores.
Si elige esta opción, tendrá que actualizar los permisos de su función de servicio de CodeBuild proyectos, tal y como se muestra en Solución de problemas CodePipeline la siguiente. 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 GitHub canalización.
-
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.
- AuthorDate
-
Fecha en la que se creó la confirmación, en formato de marca temporal.
- BranchName
-
El nombre de la ramificación del repositorio donde se realizó el cambio de origen.
- CommitId
-
El ID de confirmación de que desencadenó la ejecución de la canalización.
- CommitMessage
-
El mensaje de descripción, si lo hay, asociado a la confirmación que desencadenó la ejecución de la canalización.
- ConnectionArn
-
La conexión ARN que está configurada y autenticada para el proveedor de origen.
- FullRepositoryName
-
El nombre del repositorio de donde se realizó la confirmación que activó la canalización.
Declaración de acciones
En el siguiente ejemplo, el artefacto de salida se establece en el ZIP formato predeterminado de CODE_ZIP
para la conexión con. ARN arn:aws:codestar-connections:region:
account-id
:connection/connection-id
Instalación de la aplicación de instalación y creación de una conexión
La primera vez que utilices la consola para añadir una nueva conexión a un repositorio de terceros, debes autorizar el CodePipeline acceso a tus 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.
Al utilizar la plantilla AWS CLI o una AWS CloudFormation plantilla, debe proporcionar la conexión ARN de una conexión que ya haya pasado por el protocolo de instalación. De lo contrario, la canalización no se activará.
nota
Para una acción de origen CodeStarSourceConnection
, no es necesario configurar un webhook ni utilizar el sondeo de forma predeterminada. La acción de conexiones gestiona automáticamente la detección de cambio de origen.
Véase también
Los recursos relacionados siguientes pueden serle de ayuda cuando trabaje con esta acción.
-
AWS:CodeStarConnections: :Conexión: la referencia de AWS CloudFormation plantilla del recurso AWS CodeStar Connections proporciona parámetros y ejemplos de conexiones en AWS CloudFormation plantillas.
-
AWS CodeStarAPIReferencia de conexiones: la APIreferencia de AWS CodeStar conexiones proporciona información de referencia para las acciones de conexión disponibles.
-
Para ver los pasos para crear una canalización con acciones de origen compatibles con las conexiones, consulte lo siguiente:
-
En el caso de Bitbucket Cloud, usa la opción Bitbucket de la consola o la
CodestarSourceConnection
acción de la. CLI Consulte Conexiones de Bitbucket Cloud. -
En el GitHub caso de GitHub Enterprise Cloud, usa la opción de GitHubproveedor de la consola o la
CodestarSourceConnection
acción de. CLI Consulte GitHub conexiones. -
En el caso de GitHub Enterprise Server, utilice la opción de proveedor de GitHub Enterprise Server de la consola o la
CodestarSourceConnection
acción deCLI. Consulte GitHub Conexiones de Enterprise Server. -
Para GitLab .com, utilice la opción de GitLabproveedor en la consola o la
CodestarSourceConnection
acción con elGitLab
proveedor enCLI. Consulte GitLabconexiones .com.
-
-
Para ver un tutorial de introducción que crea una canalización con una fuente y una CodeBuild acción de Bitbucket, consulta Cómo empezar con las conexiones.
-
Para ver un tutorial que te muestra cómo conectarte a un GitHub repositorio y cómo usar la opción de clonación completa con una CodeBuild acción posterior, consulta. Tutorial: Utilice un clon completo con una fuente de GitHub canalización