Gestione di operazioni tra regioni in una pipeline (console)Aggiunta di un'operazione tra regioni a una pipeline (CLI)Aggiunta di un'operazione tra regioni a una pipeline (AWS CloudFormation)

Aggiungere un'azione interregionale in CodePipeline

AWS CodePipeline include una serie di azioni che consentono di configurare, testare e distribuire risorse per il processo di rilascio automatico. Puoi aggiungere azioni alla tua pipeline che si trovano in una AWS regione diversa dalla tua pipeline. Quando un Servizio AWS è il provider di un'azione e questo tipo di azione/tipo di provider si trova in una AWS regione diversa dalla pipeline, si tratta di un'azione interregionale.

Nota

Le azioni interregionali sono supportate e possono essere create solo nelle regioni in cui AWS è supportata. CodePipeline Per un elenco delle AWS regioni supportate per CodePipeline, consultaQuote in AWS CodePipeline.

Puoi utilizzare la console o AWS CloudFormation aggiungere azioni interregionali nelle pipeline. AWS CLI

Nota

Alcuni tipi di azioni CodePipeline potrebbero essere disponibili solo in determinate AWS regioni. Tieni inoltre presente che potrebbero esserci AWS regioni in cui è disponibile un tipo di azione, ma non è disponibile un AWS provider specifico per quel tipo di azione.

Quando crei o modifichi una pipeline, devi disporre di un bucket di artefatti nella regione della pipeline e di un bucket di artefatti per ogni regione in cui prevedi di eseguire un'operazione. Per ulteriori informazioni sul parametro ArtifactStores, vedi CodePipeline riferimento alla struttura della tubazione.

Nota

CodePipeline gestisce la copia di artefatti da una AWS regione all'altra durante l'esecuzione di azioni interregionali.

Se si utilizza la console per creare una pipeline o azioni interregionali, i bucket di artefatti predefiniti vengono configurati nelle regioni in cui sono presenti le azioni. CodePipeline Quando utilizzi AWS CLI AWS CloudFormation, o un SDK per creare una pipeline o azioni interregionali, fornisci il bucket di artefatti per ogni regione in cui sono presenti azioni.

Nota

È necessario creare il bucket di artefatti e la chiave di crittografia nella stessa area dell'azione AWS Interregionale e nello stesso account della pipeline.

Non è possibile creare operazioni tra regioni per i seguenti tipi di operazione:

Operazioni di origine
Operazioni di terze parti
Operazioni personalizzate

Nota

Quando si utilizza Cross-region Lambda invoke action CodePipeline in, lo stato dell'esecuzione lambda che utilizza PutJobSuccessResult PutJobFailureResulte deve essere inviato alla AWS regione in cui è presente la funzione Lambda e non alla regione in cui esiste. CodePipeline

Quando una pipeline include un'azione interregionale come parte di una fase, CodePipeline replica solo gli artefatti di input dell'azione Cross-region dalla regione della pipeline alla regione dell'azione.

Nota

La regione della pipeline e la regione in cui sono gestite le risorse di rilevamento delle modifiche CloudWatch agli eventi rimangono invariate. La regione in cui è ospitata la pipeline non cambia.

Gestione di operazioni tra regioni in una pipeline (console)

Puoi utilizzare la CodePipeline console per aggiungere un'azione interregionale a una pipeline esistente. Per creare una nuova pipeline con operazioni tra regioni utilizzando la procedura guidata di creazione pipeline, consulta Creazione di una pipeline (console).

Nella console, crei un'operazione tra regioni in una fase della pipeline scegliendo il provider dell'operazione e il campo Regione che elenca le risorse create in quella regione per quel provider. Quando aggiungi un'azione interregionale, CodePipeline utilizza un bucket di artefatti separato nella regione dell'azione. Per ulteriori informazioni sui bucket di artefatti tra più regioni, consulta CodePipeline riferimento alla struttura della tubazione.

Aggiunta di un'operazione tra regioni a una fase della pipeline (console)

Utilizza la console per aggiungere un'operazione tra regioni a una pipeline.

Nota

Se la pipeline è in esecuzione quando le modifiche vengono salvate, l'esecuzione non viene portata a termine.

Per aggiungere un'operazione tra regioni

Accedi alla console all'indirizzo http://console.aws.amazon.com/codesuite/codepipeline/home.
Seleziona la pipeline, quindi scegli Edit (Modifica).
Nella parte inferiore del diagramma, scegli + Add stage (+ Aggiungi fase) se stai aggiungendo una nuova fase oppure scegli Edit stage (Modifica fase) se vuoi aggiungere l'operazione a una fase esistente.
In Edit: <Stage> (Modifica: <Fase>), scegli + Add action group (+ Aggiungi gruppo di operazioni) per aggiungere un'operazione seriale. In alternativa, scegli + Add action (+ Aggiungi operazione) per aggiungere un'operazione parallela.
Nella pagina Edit action (Modifica operazione):
1. In Nome operazione immetti un nome per l'operazione tra regioni.
2. In Azione provider (Provider operazione), scegli il provider dell'operazione.
3. In Regione, scegli la AWS regione in cui hai creato o intendi creare la risorsa per l'azione. Quando la regione viene selezionata, le risorse disponibili per la regione sono elencate per la selezione. Il campo Regione indica dove vengono create le AWS risorse per questo tipo di azione e tipo di provider. Questo campo viene visualizzato solo per le azioni in cui il fornitore dell'azione è un Servizio AWS. Per impostazione predefinita, il campo Regione è lo Regione AWS stesso della pipeline.
4. In Input artifacts (Artefatti di input) scegli l'input appropriato dalla fase precedente. Ad esempio, se la fase precedente è una fase di origine, scegli. SourceArtifact
5. Completa tutti i campi obbligatori per il provider dell'operazione che stai configurando.
6. In Output artifacts (Artefatti di output) scegli l'output appropriato per la prossima fase. Ad esempio, se la fase successiva è una fase di distribuzione, scegli BuildArtifact.
7. Selezionare Salva.
In Edit: <Stage> (Modifica: <Fase>), scegli Done (Fatto).
Selezionare Salva.

Modifica di un'operazione tra regioni in una fase della pipeline (console)

Utilizza la console per modificare un'operazione tra regioni esistente in una pipeline.

Nota

Se la pipeline è in esecuzione quando le modifiche vengono salvate, l'esecuzione non viene portata a termine.

Per modificare un'operazione tra regioni

Accedi alla console all'indirizzo https://console.aws.amazon.com/codesuite/codepipeline/home.
Seleziona la pipeline, quindi scegli Edit (Modifica).
Scegli Edit stage (Modifica fase).
In Edit: <Stage> (Modifica: <Fase>), scegli l'icona per modificare un'operazione esistente.
Nella pagina Edit action (Modifica operazione), apporta modifiche ai campi in base alle esigenze.
In Edit: <Stage> (Modifica: <Fase>), scegli Done (Fatto).
Selezionare Salva.

Eliminazione di un'operazione tra regioni da una fase della pipeline (console)

Utilizza la console per eliminare un'operazione tra regioni esistente da una pipeline.

Nota

Se la pipeline è in esecuzione quando le modifiche vengono salvate, l'esecuzione non viene portata a termine.

Per eliminare un'operazione tra regioni

Accedi alla console all'indirizzo http://console.aws.amazon.com/codesuite/codepipeline/home.
Seleziona la pipeline, quindi scegli Edit (Modifica).
Scegli Edit stage (Modifica fase).
In Edit: <Stage> (Modifica: <Fase>), scegli l'icona per eliminare un'operazione esistente.
In Edit: <Stage> (Modifica: <Fase>), scegli Done (Fatto).
Selezionare Salva.

Aggiunta di un'operazione tra regioni a una pipeline (CLI)

È possibile utilizzare il AWS CLI per aggiungere un'azione interregionale a una pipeline esistente.

Per creare un'azione interregionale in una fase di pipeline con AWS CLI, aggiungete l'azione di configurazione insieme a un campo opzionale. region Devi avere inoltre già creato un bucket di artefatti nella regione dell'operazione. Invece di fornire il parametro artifactStore della pipeline della singola regione, utilizza il parametro artifactStores per includere un elenco del bucket di artefatti di ogni regione.

Nota

In questa procedura guidata e nei relativi esempi, RegionA è la regione in cui la pipeline viene creata. Ha accesso al bucket RegionA Amazon S3 utilizzato per archiviare gli artefatti della pipeline e al ruolo di servizio utilizzato da. CodePipeline RegionB è la regione in cui vengono creati l'applicazione, CodeDeploy il gruppo di distribuzione e il ruolo di servizio utilizzati CodeDeploy da.

Prerequisiti

Devi aver creato i seguenti elementi:

Una pipeline in RegionA.
Un bucket di artefatti Amazon S3 in regionB.
Le risorse per la tua azione, ad esempio CodeDeploy l'applicazione e il gruppo di distribuzione per un'azione di distribuzione tra regioni, in RegionB.

Aggiunta di un'operazione tra regioni a una pipeline (CLI)

Usa AWS CLI per aggiungere un'azione interregionale a una pipeline.

Per aggiungere un'operazione tra regioni

Per una pipeline in RegionA, esegui il comando get-pipeline per copiare la struttura della pipeline in un file JSON. Ad esempio, per una pipeline denominata MyFirstPipeline, esegui il seguente comando:
```
aws codepipeline get-pipeline --name MyFirstPipeline >pipeline.json
```
Questo comando non restituisce alcun valore, ma nella directory in cui è stato eseguito dovrebbe comparire il file creato.

Aggiungi il campo region per aggiungere una nuova fase con l'operazione tra regioni che include la regione e le risorse per l'operazione. L'esempio JSON seguente aggiunge una fase di distribuzione con un'azione di distribuzione tra regioni in cui si trova il provider, in una nuova regione. CodeDeploy 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
                    }

Nella struttura della pipeline, rimuovi il campo artifactStore e aggiungi la mappa artifactStores per la nuova operazione tra regioni. La mappatura deve includere una voce per ogni AWS regione in cui sono presenti azioni. Per ogni voce della mappatura, le risorse devono trovarsi nella rispettiva AWS regione. Nell'esempio seguente, ID-A è l'ID della chiave di crittografia per la RegionA e ID-B è la chiave di crittografia per la 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'esempio di JSON seguente mostra il bucket us-west-2 come my-storage-bucket e aggiunge il nuovo bucket us-east-1 denominato 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"
            }
        },

Se stai utilizzando la struttura della pipeline recuperata tramite il comando get-pipeline, rimuovi le righe metadata dal file JSON. In caso contrario, il comando update-pipeline non è in grado di utilizzarlo. Rimuovi le righe "metadata": { } e i campi "created", "pipelineARN" e "updated".

Ad esempio, rimuovere dalla struttura le seguenti righe:
```
"metadata": {  
  "pipelineArn": "arn:aws:codepipeline:region:account-ID:pipeline-name",
  "created": "date",
  "updated": "date"
  }
```
Salvare il file.

Per applicare le modifiche, eseguire il comando update-pipeline, specificando il file JSON della pipeline:

Importante

Assicurarsi di includere file:// prima del nome del file. Questo è obbligatorio in questo comando.


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

Questo comando restituisce l'intera struttura della pipeline modificata. L'output è simile a quello riportato di seguito.


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

Nota

Il comando update-pipeline arresta la pipeline. Se è in corso di elaborazione una versione durante l'esecuzione del comando update-pipeline, tale elaborazione viene arrestata. Per elaborare tale versione utilizzando la pipeline aggiornata, devi avviare manualmente la pipeline. Utilizza il comando start-pipeline-execution per avviare manualmente la pipeline.

Dopo aver aggiornato la pipeline, l'azione Interregione viene visualizzata nella console.

Aggiunta di un'operazione tra regioni a una pipeline (AWS CloudFormation)

È possibile utilizzare AWS CloudFormation per aggiungere un'azione interregionale a una pipeline esistente.

Per aggiungere un'azione interregionale con AWS CloudFormation

Aggiungi il parametro Region alla risorsa ActionDeclaration nel modello, come illustrato in questo esempio:


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

In Mappings, aggiungi la mappa della regione come illustrato in questo esempio, relativo a una mappatura denominata SecondRegionMap che mappa i valori per le chiavi RegionA e RegionB. Nella risorsa Pipeline, nel campo artifactStore, aggiungi la mappa artifactStores per la nuova operazione tra regioni come segue:


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

Il seguente esempio YAML mostra il bucket della RegionA come us-west-2 e aggiunge il nuovo bucket della 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

Salva il modello aggiornato nel computer locale e quindi apri la console AWS CloudFormation .
Seleziona lo stack e scegli Create Change Set for Current Stack (Crea set di modifiche per lo stack corrente).
Carica il modello e quindi visualizza le modifiche elencate in AWS CloudFormation. Queste sono le modifiche da apportare allo stack. Le nuove risorse dovrebbero essere visibili nell'elenco.
Scegliere Execute (Esegui).

Avvertimento JavaScript è disabilitato o non è disponibile nel tuo browser.

Per usare la documentazione AWS, JavaScript deve essere abilitato. Consulta le pagine della guida del browser per le istruzioni.

Convenzioni dei documenti

Formato di dati JSON per notifiche di approvazione manuale

Utilizzo delle variabili