Ajouter une action interrégionale dans CodePipeline

Connectez-vous à la console via http://console.aws.amazon.com/codesuite/codepipeline/home.

Sélectionnez votre pipeline, puis choisissez Modifier.

En bas du schéma, choisissez +Ajouter une étape si vous ajoutez une nouvelle étape ou Modifier l'étape si vous voulez ajouter l'action à une étape existante.

Dans Modifier : <Étape>, choisissez +Ajouter groupe d'action pour ajouter une action en série. Ou choisissez +Ajouter une action pour ajouter une action en parallèle.

Sur la page Modifier l'action :

1. Dans Nom de l'action, entrez un nom pour l'action inter-régions.

2. Dans Fournisseur d'action, choisissez le fournisseur d'action.

3. Dans Région, choisissez la AWS région dans laquelle vous avez créé ou prévoyez de créer la ressource pour l'action. Une fois la région sélectionnée, les ressources disponibles pour cette région sont répertoriées pour la sélection. Le champ Région indique l'endroit où les AWS ressources sont créées pour ce type d'action et ce type de fournisseur. Ce champ s'affiche uniquement pour les actions dont le fournisseur d'actions est un Service AWS. Le champ Région est par défaut identique Région AWS à celui de votre pipeline.

4. Dans Artefact d'entrée, choisissez l'entrée adéquate à partir de l'étape précédente. Par exemple, si l'étape précédente est une étape source, choisissez SourceArtifact.

5. Complétez tous les champs obligatoires pour le fournisseur d'action que vous configurez.

6. Dans Artefact de sortie, choisissez la sortie adaptée à la prochaine étape. Par exemple, si l'étape suivante est une phase de déploiement, choisissez BuildArtifact.

7. Choisissez Enregistrer.

Dans Modifier : <Étape>, choisissez Effectué.

Choisissez Enregistrer.

Connectez-vous à la console à l'adresse https://console.aws.amazon.com/codesuite/codepipeline/home.

Sélectionnez votre pipeline, puis choisissez Modifier.

Choisissez Modifier l'étape.

Dans Modifier : <Étape>, choisissez l'icône de modification d'une action existante.

Sur la page Modifier l'action, modifiez les champs comme il convient.

Dans Modifier : <Étape>, choisissez Effectué.

Choisissez Enregistrer.

Connectez-vous à la console via http://console.aws.amazon.com/codesuite/codepipeline/home.

Sélectionnez votre pipeline, puis choisissez Modifier.

Choisissez Modifier l'étape.

Dans Modifier : <Étape>, choisissez l'icône de suppression d'une action existante.

Dans Modifier : <Étape>, choisissez Effectué.

Choisissez Enregistrer.

Pour un pipeline dans RegionA, exécutez la commande get-pipeline afin de copier la structure de pipeline dans un fichier JSON. Par exemple, pour un pipeline nommé MyFirstPipeline, exécutez la commande suivante :

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

Cette commande ne renvoie rien, mais le fichier que vous avez créé doit apparaître dans le répertoire où vous avez exécuté la commande.

Ajoutez le champ region pour ajouter une nouvelle étape avec votre action inter-régions qui inclut la région et les ressources de votre action. L'exemple JSON suivant ajoute une phase de déploiement avec une action de déploiement entre régions où le fournisseur se trouve CodeDeploy dans une nouvelle régionus-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
                    }

Dans la structure de pipeline, supprimez le champ artifactStore et ajoutez la carte artifactStores pour votre nouvelle action inter-régions. Le mappage doit inclure une entrée pour chaque AWS région dans laquelle vous avez des actions. Pour chaque entrée du mappage, les ressources doivent se trouver dans la AWS région correspondante. Dans l'exemple ci-dessous, ID-A est l'ID de clé de chiffrement pour RegionA, et ID-B est l'ID de clé de chiffrement pour RegionB.

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

L'exemple JSON suivant présente le compartiment us-west-2 en tant que my-storage-bucket et ajoute le nouveau compartiment us-east-1 nommé 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 vous utilisez la structure de pipeline extraite à l'aide de la commande get-pipeline, supprimez les lignes metadata du fichier JSON. Sinon, la commande update-pipeline ne peut pas l'utiliser. Supprimez les lignes "metadata": { } et les champs "updated", "created" et "pipelineARN".

Par exemple, supprimez les lignes suivantes de la structure :

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

Enregistrez le fichier.

Pour appliquer les modifications, exécutez la commande update-pipeline en spécifiant le fichier JSON du pipeline :

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

Cette commande affiche toute la structure du pipeline mise à jour. La sortie est similaire à ce qui suit.

{
    "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"
            }
        }
    }
}

Une fois que vous avez mis à jour votre pipeline, l'action inter-régions s'affiche dans la console.

Ajoutez le paramètre Region à la ressource ActionDeclaration dans votre modèle, comme illustré dans l'exemple suivant :

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

Sous Mappings, ajoutez le mappage de région comme indiqué dans cet exemple pour un mappage nommé SecondRegionMap qui mappe les valeurs des clés RegionA et RegionB. Sous la ressource Pipeline, sous le champ artifactStore, ajoutez la carte artifactStores pour votre nouvelle action inter-régions, comme suit :

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
            

L'exemple YAML suivant montre le compartiment RegionA sous la forme us-west-2 et ajoute le nouveau compartiment 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

Enregistrez le modèle mis à jour sur votre ordinateur local, puis ouvrez la console AWS CloudFormation .

Choisissez votre pile, puis Créer un jeu de modifications pour la pile actuelle.

Chargez le modèle mis à jour, puis affichez les modifications répertoriées dans AWS CloudFormation. Il s'agit des modifications apportées à la pile. Vos nouvelles ressources doivent figurer dans la liste.

Sélectionnez Execute (Exécuter).