Agregar una acción entre regiones en CodePipeline

Inicie sesión en la consola en http://console.aws.amazon.com/codesuite/codepipeline/home.

Seleccione la canalización y, a continuación, elija Edit (Editar).

En la parte inferior del diagrama, elija + Add stage (Añadir etapa) si va a añadir una etapa nueva o elija Edit stage (Editar etapa) si desea añadir la acción a una etapa existente.

En Edit: <Stage> (Editar: <etapa>), elija + Add action group (Añadir grupo de acciones) para añadir una acción en serie. O elija + Add action (Añadir acción) para añadir una acción en paralelo.

En la página Edit action (Editar acción):

1. En Nombre de la acción, escriba el nombre de la acción entre regiones.

2. En Action provider (Proveedor de acción), elija el proveedor de la acción.

3. En Región, elija la región de AWS en la que ha creado o tiene previsto crear el recurso para la acción. Al seleccionar la región, los recursos disponibles para esa región se muestran para su selección. El campo Región designa dónde se crean los recursos de AWS para este tipo de acción y de proveedor. Este campo solo se muestra en el caso de las acciones en las que el proveedor de la acción es un Servicio de AWS. El campo Región se establece de forma predeterminada en la misma Región de AWS que la canalización.

4. En Input artifacts (Artefactos de entrada), elija la entrada apropiada de la etapa anterior. Por ejemplo, si la etapa anterior es una etapa de código fuente, elija SourceArtifact.

5. Rellene todos los campos obligatorios para el proveedor de la acción que está configurando.

6. En Output artifacts (Artefactos de salida), elija la salida apropiada para la etapa siguiente. Por ejemplo, si la etapa siguiente es una etapa de implementación, elija BuildArtifact.

7. Seleccione Guardar.

En Edit: <Stage> (Editar: <etapa>), elija Done (Listo).

Seleccione Guardar.

Inicie sesión en la consola en https://console.aws.amazon.com/codesuite/codepipeline/home.

Seleccione la canalización y, a continuación, elija Edit (Editar).

Elija Edit stage (Editar etapa).

En Edit: <Stage> (Editar: <etapa>), elija el icono para editar una acción existente.

En la página Edit action (Editar acción), realice los cambios oportunos en los campos.

En Edit: <Stage> (Editar: <etapa>), elija Done (Listo).

Seleccione Guardar.

Inicie sesión en la consola en http://console.aws.amazon.com/codesuite/codepipeline/home.

Seleccione la canalización y, a continuación, elija Edit (Editar).

Elija Edit stage (Editar etapa).

En Edit: <Stage> (Editar: <etapa>), elija el icono para eliminar una acción existente.

En Edit: <Stage> (Editar: <etapa>), elija Done (Listo).

Seleccione Guardar.

Para una canalización en RegionA, ejecute el comando get-pipeline para copiar la estructura de canalización en un archivo JSON. Por ejemplo, para una canalización denominada MyFirstPipeline, escriba el siguiente comando:

aws codepipeline get-pipeline --name MyFirstPipeline >pipeline.json

Este comando no devuelve nada, pero el archivo creado debería aparecer en el directorio en el que se ejecutó el comando.

Agregue el campo region para incorporar una nueva etapa con la acción entre regiones que incluya la región y los recursos de la acción. En el siguiente ejemplo de JSON, se agrega una etapa de implementación con una acción de implementación entre regiones, donde el proveedor es CodeDeploy, en una nueva región us-east-1.

 {
                "name": "Deploy",
                "actions": [
                    {
                        "inputArtifacts": [
                            {
                                "name": "SourceArtifact"
                            }
                        ],
                        "name": "Deploy",
                        "region": "RegionB",
                        "actionTypeId": {
                            "category": "Deploy",
                            "owner": "AWS",
                            "version": "1",
                            "provider": "CodeDeploy"
                        },
                        "outputArtifacts": [],
                        "configuration": {
                            "ApplicationName": "name",
                            "DeploymentGroupName": "name"
                        },
                        "runOrder": 1
                    }

En la estructura de la canalización, elimine el campo artifactStore y agregue la asignación de artifactStores para la nueva acción entre regiones. La asignación debe incluir una entrada para cada región de AWS en la que tenga acciones. Para cada entrada en el mapeo, los recursos deben estar en la región de AWS correspondiente. En el ejemplo siguiente, ID-A es el ID de clave de cifrado para RegionA e ID-B es el ID de clave de cifrado para RegionB.

"artifactStores":{  
   "RegionA":{  
      "encryptionKey":{  
         "id":"ID-A",
         "type":"KMS"
      },
      "location":"Location1",
      "type":"S3"
   },
   "RegionB":{  
      "encryptionKey":{  
         "id":"ID-B",
         "type":"KMS"
      },
      "location":"Location2",
      "type":"S3"
   }
}

En el ejemplo siguiente de JSON se muestra el bucket de us-west-2 como my-storage-bucket y añade el nuevo bucket de us-east-1 denominado my-storage-bucket-us-east-1.

        "artifactStores": {
            "us-west-2": {
                "type": "S3",
                "location": "my-storage-bucket"
            },
            "us-east-1": {
                "type": "S3",
                "location": "my-storage-bucket-us-east-1"
            }
        },

Si está trabajando con la estructura de la canalización recuperada mediante el comando get-pipeline, elimine las líneas metadata del archivo JSON. De lo contrario, el comando update-pipeline no puede utilizarlo. Elimine las líneas "metadata": { } y los campos "updated", "created" y "pipelineARN".

Por ejemplo, quite las siguientes líneas de la estructura:

"metadata": {  
  "pipelineArn": "arn:aws:codepipeline:region:account-ID:pipeline-name",
  "created": "date",
  "updated": "date"
  }

Guarde el archivo.

Para aplicar los cambios, ejecute el comando update-pipeline especificando el archivo JSON:

aws codepipeline update-pipeline --cli-input-json file://pipeline.json

Este comando devuelve la estructura completa de la canalización editada. El resultado es similar al siguiente.

{
    "pipeline": {
        "version": 4,
        "roleArn": "ARN",
        "stages": [
            {
                "name": "Source",
                "actions": [
                    {
                        "inputArtifacts": [],
                        "name": "Source",
                        "actionTypeId": {
                            "category": "Source",
                            "owner": "AWS",
                            "version": "1",
                            "provider": "CodeCommit"
                        },
                        "outputArtifacts": [
                            {
                                "name": "SourceArtifact"
                            }
                        ],
                        "configuration": {
                            "PollForSourceChanges": "false",
                            "BranchName": "main",
                            "RepositoryName": "MyTestRepo"
                        },
                        "runOrder": 1
                    }
                ]
            },
            {
                "name": "Deploy",
                "actions": [
                    {
                        "inputArtifacts": [
                            {
                                "name": "SourceArtifact"
                            }
                        ],
                        "name": "Deploy",
                        "region": "us-east-1",
                        "actionTypeId": {
                            "category": "Deploy",
                            "owner": "AWS",
                            "version": "1",
                            "provider": "CodeDeploy"
                        },
                        "outputArtifacts": [],
                        "configuration": {
                            "ApplicationName": "name",
                            "DeploymentGroupName": "name"
                        },
                        "runOrder": 1
                    }
                ]
            }
        ],
        "name": "AnyCompanyPipeline",
        "artifactStores": {
            "us-west-2": {
                "type": "S3",
                "location": "my-storage-bucket"
            },
            "us-east-1": {
                "type": "S3",
                "location": "my-storage-bucket-us-east-1"
            }
        }
    }
}

Después de actualizar la canalización, la acción entre regiones aparecerá en la consola.

Añada el parámetro Region al recurso ActionDeclaration en la plantilla, tal y como se muestra en este ejemplo:

ActionDeclaration:
              Type: Object
              Properties:
                ActionTypeId:
                  Type: ActionTypeId
                  Required: true
                Configuration:
                  Type: Map
                InputArtifacts:
                  Type: Array
                  ItemType:
                    Type: InputArtifact
                Name:
                  Type: String
                  Required: true
                OutputArtifacts:
                  Type: Array
                  ItemType:
                    Type: OutputArtifact
                RoleArn:
                  Type: String
                RunOrder:
                  Type: Integer
                Region:
                  Type: String

En Mappings, añada el mapa de región como se muestra en este ejemplo para una asignación denominada SecondRegionMap que asigne valores a las claves RegionA y RegionB. En el recurso Pipeline, en el campo artifactStore, agregue la asignación de artifactStores para la nueva acción entre regiones, tal y como se indica a continuación:

Mappings:
  SecondRegionMap:
    RegionA:
      SecondRegion: "RegionB"
    RegionB:
      SecondRegion: "RegionA"

...

          Properties:
            ArtifactStores:
              -
                Region: RegionB
                ArtifactStore:
                  Type: "S3"
                  Location: test-cross-region-artifact-store-bucket-RegionB
              -
                Region: RegionA
                ArtifactStore:
                  Type: "S3"
                  Location: test-cross-region-artifact-store-bucket-RegionA
            

En el siguiente ejemplo de YAML, se muestra el bucket RegionA como us-west-2 y se añade el nuevo bucket RegionB, eu-central-1:

Mappings:
  SecondRegionMap:
    us-west-2:
      SecondRegion: "eu-central-1"
    eu-central-1:
      SecondRegion: "us-west-2"

...

          Properties:
            ArtifactStores:
              -
                Region: eu-central-1
                ArtifactStore:
                  Type: "S3"
                  Location: test-cross-region-artifact-store-bucket-eu-central-1
              -
                Region: us-west-2
                ArtifactStore:
                  Type: "S3"
                  Location: test-cross-region-artifact-store-bucket-us-west-2

Guarde la plantilla actualizada en el equipo local y luego abra la consola de AWS CloudFormation.

Seleccione la pila y luego elija Create Change Set for Current Stack (Crear conjuntos de cambios para la pila actual).

Cargue la plantilla y, a continuación, consulte los cambios indicados en AWS CloudFormation. Estos son los cambios que se realizan en la pila. Debería ver los nuevos recursos en la lista.

Elija Ejecutar.