Declaración de canalización
La canalización y el nivel de metadatos de una canalización tienen una estructura básica que incluye los siguientes parámetros y sintaxis. El parámetro de canalización representa la estructura de las acciones y etapas que se van a realizar en la canalización.
Para obtener más información, consulte el objeto PipelineDeclaration en la Guía de la API de CodePipeline.
El siguiente ejemplo muestra la canalización y el nivel de metadatos de la estructura de la canalización tanto en JSON como en YAML para una canalización de tipo V2.
name
El nombre de la canalización. El nombre de una canalización no se puede modificar al editarla o actualizarla.
nota
Si desea cambiar el nombre de una canalización existente, puede utilizar el comando get-pipeline de la CLI para crear un archivo JSON que incluya la estructura de la canalización. A continuación, puede utilizar el comando create-pipeline de la CLI para crear una canalización con esa estructura y asignarla un nombre nuevo.
roleArn
El ARN de IAM para el rol de servicio de CodePipeline, como arn:aws:iam::80398EXAMPLE:role/CodePipeline_Service_Role.
Para usar la consola a fin de ver el ARN del rol de servicio de la canalización en lugar de la estructura JSON, elija su canalización en la consola y, a continuación, seleccione Configuración. En la pestaña General, aparecerá el campo ARN del rol de servicio.
artifactStore O artifactStores
El campo artifactStore contiene el tipo de bucket de artefactos y la ubicación de una canalización con todas las acciones en la misma región de AWS. Si añade acciones en una región diferente a la de la canalización, se utiliza la asignación de artifactStores para obtener una lista de los buckets de artefactos de cada región de AWS donde se ejecutan las acciones. Al crear o editar una canalización, debe tener un bucket de artefactos en la región de la canalización, así como un bucket de artefactos por cada región en la que tiene previsto ejecutar una acción.
nota
En la estructura de la canalización, debe incluir artifactStore o artifactStores en su canalización, pero no puede usar ambos. Si crea una acción entre regiones en la canalización, debe utilizar artifactStores.
En el siguiente ejemplo, se muestra la estructura básica de una canalización con acciones entre regiones que utiliza el parámetro artifactStores:
"pipeline": { "name": "YourPipelineName", "roleArn": "CodePipeline_Service_Role", "artifactStores": { "us-east-1": { "type": "S3", "location": "S3 artifact bucket name, such as amzn-s3-demo-bucket" }, "us-west-2": { "type": "S3", "location": "S3 artifact bucket name, such as amzn-s3-demo-bucket" } }, "stages": [ { ...
type
El tipo de ubicación del bucket de artefactos, especificado como Amazon S3.
location
El nombre del bucket de Amazon S3 que se generó automáticamente la primera vez que creó una canalización con la consola, como codepipeline-us-east-2-1234567890, o cualquier bucket de Amazon S3 que aprovisione para este fin
stages
Este parámetro contiene el nombre de cada etapa de la canalización. Para obtener más información sobre los parámetros y la sintaxis a nivel de etapa de la estructura de canalización, consulte el objeto StageDeclaration en la Guía de la API de CodePipeline.
La estructura de la canalización para las etapas debe cumplir estos requisitos:
-
La canalización debe tener dos etapas como mínimo.
-
La primera fase de una canalización debe incluir al menos una acción de origen. Solo puede incluir acciones de origen.
-
La primera etapa de la canalización es la única que puede incluir acciones de origen.
-
Al menos una etapa de cada canalización debe contener una acción que no sea de origen.
-
Los nombres de las etapas de una canalización deben ser diferentes.
-
Los nombres de las etapas no pueden editarse en la consola de CodePipeline. Si edita el nombre de una etapa mediante el uso de AWS CLI y la etapa incluye una acción con uno o más parámetros secretos (como, por ejemplo, un token de OAuth), no se conservará el valor de dichos parámetros. Tendrá que escribir manualmente el valor de los parámetros (que están enmascarados con cuatro asteriscos en el archivo JSON que devuelve la AWS CLI) e incluirlos en la estructura JSON.
version
El número de versión de una canalización se genera automáticamente y se actualiza cada vez que se actualiza la canalización.
executionMode
Puede configurar el modo de ejecución de la canalización para poder especificar el comportamiento de la canalización para ejecuciones consecutivas, como poner en cola, reemplazar o ejecutar en modo paralelo. Para obtener más información, consulte Configuración o cambio del modo de ejecución de una canalización.
pipelineType
El tipo de canalización especifica la estructura y las características disponibles en la canalización, como en el caso de una canalización de tipo V2. Para obtener más información, consulte Tipos de canalización.
variables
Las variables a nivel de canalización se definen cuando la canalización se crea y se resuelven en el tiempo de ejecución de la canalización. Para obtener más información, consulte Referencia de variables. Para ver un tutorial con una variable a nivel de canalización que se transfiere en el momento de la ejecución de la canalización, consulte Tutorial: Uso de variables a nivel de canalización.
triggers
Los desencadenadores permiten configurar la canalización para que se inicie con un tipo de evento concreto o filtrado, por ejemplo, cuando se detecta un cambio en una ramificación específica o en una solicitud de extracción. Los desencadenadores se pueden configurar para las acciones de origen con conexiones que utilizan la acción CodeStarSourceConnection en CodePipeline, como GitHub, Bitbucket y GitLab. Para obtener más información acerca de las acciones de origen que utilizan conexiones, consulte Conexión a proveedores de origen de terceros mediante CodeConnections.
Para obtener más información, consulte Automatización del inicio de las canalizaciones mediante desencadenadores y filtrado.
nota
Las acciones de origen de CodeCommit y S3 requieren un recurso de detección de cambios configurado (una regla de EventBridge) o utilizar la opción de sondear el repositorio en busca de cambios de origen. En el caso de las canalizaciones con una acción de origen de Bitbucket, GitHub o GitHub Enterprise Server, no es necesario configurar un webhook ni utilizar el sondeo de forma predeterminada. La acción de conexiones administra la detección de cambios por usted.
metadata
Los campos de metadatos de la canalización son distintos de la estructura de la canalización y no se pueden editar. Al actualizar una canalización, la fecha del campo de metadatos updated cambia automáticamente.
pipelineArn
El nombre de recurso de Amazon (ARN) de la canalización.
Para usar la consola a fin de ver el ARN de la canalización en lugar de la estructura JSON, elija su canalización en la consola y, a continuación, seleccione Configuración. En la pestaña General, aparecerá el campo ARN de la canalización.
created
Fecha y hora en que se creó la canalización.
updated
Fecha y hora en que se actualizó por última vez la canalización.
