CodePipeline referencia de estructura de tubería

origen

Compilación

Prueba

Implementación

Aprobación

Invocación

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 se pueden editar en la CodePipeline consola. Si edita el nombre de una etapa con AWS CLI, y la etapa contiene una acción con uno o más parámetros secretos (como un token de OAuth), el valor de esos parámetros secretos no se conserva. Debes introducir manualmente el valor de los parámetros (que están enmascarados por cuatro asteriscos en el JSON devuelto por el AWS CLI) e incluirlos en la estructura JSON.

El artifactStore campo contiene el tipo de depósito de artefactos y la ubicación de una canalización con todas las acciones en la misma región. AWS Si añades acciones en una región diferente a la de tu proceso, el artifactStores mapeo se utiliza para mostrar el depósito de artefactos de cada AWS región en la que 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.

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 codepipeline-us-east-1-1234567890"
            },
            "us-west-2": {
                "type": "S3",
                "location": "S3 artifact bucket name, such as codepipeline-us-west-2-1234567890"
            }
        },
        "stages": [
            {

...

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.

El nombre de una canalización no se puede modificar al editarla o actualizarla.

Los nombres de las acciones de una etapa deben ser diferentes.

El artefacto de entrada de una acción debe coincidir exactamente con el artefacto de salida declarado en una acción anterior. Por ejemplo, si una acción anterior incluye la siguiente declaración:

"outputArtifacts": [
    {
    "MyApp"
    }
],

y no hay otros artefactos de salida, el artefacto de entrada de una acción posterior debe ser:

"inputArtifacts": [
    {
    "MyApp"
    }
],

Esto es así para todas las acciones, ya estén en la misma etapa o en etapas posteriores, pero el artefacto de entrada no debe ser necesariamente la siguiente acción en de una secuencia estricta cuyo origen es la acción que proporcionó el artefacto de salida. Las acciones en paralelo pueden declarar distintos paquetes de artefactos de salida que, a su vez, consumen las siguientes y distintas acciones.

Los nombres de los artefactos de salida deben ser diferentes en una canalización. Por ejemplo, una canalización puede incluir una acción con un artefacto de salida que se llame "MyApp" y otra acción con un artefacto de salida llamado "MyBuiltApp". Sin embargo, una canalización no puede incluir dos acciones que tengan un artefacto de salida denominado "MyApp".

Las acciones entre regiones utilizan el campo Region para designar la región de AWS en la que se van a crear las acciones. Los AWS recursos creados para esta acción deben crearse en la misma región proporcionada en el region campo. No puede crear acciones entre regiones para los siguientes tipos de acciones:

Las acciones se pueden configurar con variables. Utilice el campo namespace para establecer el espacio de nombres y la información de variables para las variables de ejecución. Para obtener información de referencia acerca de las variables de ejecución y las variables de salida de acción, consulte Variables.

La única cadena de versión válida para todos los tipos de acción admitidos actualmente es AWS, ThirdParty o Custom. Para obtener más información, consulta la referencia CodePipeline de la API.

El valor predeterminado runOrder para una acción es 1. El valor deber ser un entero positivo (número natural). No se pueden usar fracciones, decimales, números negativos ni el número cero Para especificar una secuencia de acciones en serie, utilice el número más pequeño para la primera acción y números mayores para las acciones subsiguientes. Para especificar acciones en paralelo, utilice el mismo entero para cada acción que quiera ejecutar en paralelo. En la consola, puede especificar una secuencia en serie para una acción seleccionando Añadir grupo de acciones en el nivel de la etapa en la que desea que se ejecute, o puede especificar una secuencia paralela seleccionando Añadir acción. Grupo de acciones hace referencia al orden de ejecución de una o más acciones en el mismo nivel.

Por ejemplo, para que tres acciones se ejecuten en secuencia en una etapa, asigne a la primera acción el valor runOrder 1, a la segunda acción el valor runOrder 2 y a la tercera el valor runOrder 3. Si quiere que la segunda y tercera acciones se ejecuten en paralelo, asigne a la primera acción el valor runOrder 1 y a la segunda y tercera el valor runOrder 2.

Cuando se utiliza un bucket de Amazon S3 como ubicación de implementación, también se especifica una clave de objeto. Una clave de objeto puede ser un nombre de archivo (objeto) o una combinación de un prefijo (ruta de carpeta) y el nombre del archivo. Puede utilizar variables para especificar el nombre de la ubicación que desea que utilice la canalización. Las acciones de implementación de Amazon S3 admiten el uso de las siguientes variables en las claves de objeto de Amazon S3.

Estas son las actionTypeId categorías válidas para CodePipeline:

Aquí se proporcionan algunos tipos de proveedores y opciones de configuración.

Los tipos de proveedor válidos para una categoría de acción dependen de la categoría. Por ejemplo, para un tipo de acción de código fuente, un tipo de proveedor válido sería S3, GitHub, CodeCommit o Amazon ECR. Este ejemplo muestra la estructura de una acción de código fuente con S3 como proveedor:

"actionTypeId": {
  "category": "Source",
  "owner": "AWS",
  "version": "1",
  "provider": "S3"},

Cada acción debe tener una configuración de acción válida que depende del tipo de proveedor de dicha acción. En la tabla siguiente se incluyen los elementos de configuración de acción necesarios para cada tipo de proveedor válido:

Agregue el parámetro PollForSourceChanges al archivo JSON o la plantilla de AWS CloudFormation .

Cree recursos de detección de cambios (regla de CloudWatch eventos, según corresponda).

Establecer el parámetro PollForSourceChanges en false.

El parámetro PollForSourceChanges no se utiliza para las acciones de origen de Amazon ECR.