Tutorial: Crea una pipeline con AWS CloudFormation StackSets azioni di distribuzione

Per creare un ruolo di amministratore con il tuo account amministratore

• Segui le istruzioni in Impostare le autorizzazioni di base per le operazioni relative agli stack set. Il tuo ruolo deve avere un nome AWSCloudFormationStackSetAdministrationRole.

Per creare un ruolo di servizio nell'account di destinazione

• Crea un ruolo di servizio nell'account di destinazione che consideri attendibile l'account amministratore. Segui le istruzioni in Impostare le autorizzazioni di base per le operazioni di stack set. Il tuo ruolo deve avere un nome AWSCloudFormationStackSetExecutionRole.

Per creare un bucket sorgente S3

1. Accedi Console di gestione AWS e apri la console Amazon S3 all'indirizzo. https://console.aws.amazon.com/s3/

2. Seleziona Crea bucket.

3. In Nome bucket, inserisci un nome del bucket.

   In Regione, scegli la regione in cui desideri creare la pipeline. Seleziona Crea bucket.

4. Dopo aver creato il bucket, viene visualizzato un banner di successo. Scegliere Go to bucket details (Vai ai dettagli del bucket).

5. Nella scheda Properties (Proprietà) scegliere Versioning (Funzione Versioni multiple). Scegliere Enable versioning (Abilita funzione Versioni multiple), quindi scegliere Save (Salva).

Per creare AWS CloudFormation file modello

1. Scarica il seguente file modello di esempio per generare la CloudTrail configurazione per gli stack set:https://s3.amazonaws.com/cloudformation-stackset-sample-templates-us-east-1/EnableAWSCloudtrail.yml.

2. Salva il file con nome template.yml.

Per creare il file parameters.txt

1. Crea un file con i parametri per la tua distribuzione. I parametri sono valori che desideri aggiornare nel tuo stack in fase di esecuzione. Il seguente file di esempio aggiorna i parametri del modello per il set di stack per abilitare la convalida della registrazione e gli eventi globali.

   [
     {
       "ParameterKey": "EnableLogFileValidation",
       "ParameterValue": "true"
     }, 
     {
       "ParameterKey": "IncludeGlobalEvents",
       "ParameterValue": "true"
     }
   ]

2. Salva il file con nome parameters.txt.

Per creare il file accounts.txt

1. Create un file con gli account in cui desiderate creare le istanze, come mostrato nel seguente file di esempio.

   [
       "111111222222","333333444444"
   ]

2. Salva il file con nome accounts.txt.

Per creare e caricare file sorgente

1. Combina i file in un unico file ZIP. I tuoi file dovrebbero avere questo aspetto nel tuo file ZIP.

   template.yml
   parameters.txt
   accounts.txt

2. Carica il file ZIP nel tuo bucket S3. Questo file è l'elemento sorgente creato dalla procedura guidata Create Pipeline per l'azione di distribuzione in. CodePipeline

Per creare una pipeline con un'azione CloudFormationStackSet

1. Accedi Console di gestione AWS e apri la CodePipeline console all'indirizzo http://console.aws.amazon.com/codesuite/codepipeline/home.

2. Nella pagina Welcome (Benvenuto), pagina Getting started (Nozioni di base) o pagina Pipelines (Pipeline), scegli Create pipeline (Crea pipeline).

3. Nella pagina Passaggio 1: Scegli l'opzione di creazione, in Opzioni di creazione, scegli l'opzione Crea pipeline personalizzata. Scegli Avanti.

4. Nel passaggio 2: scegli le impostazioni della pipeline, in Nome della pipeline, inserisci. MyStackSetsPipeline

5. Nel tipo di pipeline, scegli V1 per gli scopi di questo tutorial. Puoi anche scegliere V2; tuttavia, tieni presente che i tipi di pipeline differiscono per caratteristiche e prezzo. Per ulteriori informazioni, consulta Tipi di pipeline.

6. In Ruolo di servizio, scegli Nuovo ruolo di servizio per consentire la creazione CodePipeline di un ruolo di servizio in IAM.

7. In Artifact store, lascia le impostazioni predefinite.

   Nota

   Non si tratta del bucket di origine per il codice sorgente, ma dell'archivio artefatti per la pipeline. È richiesto un archivio artefatti separato, ad esempio un bucket S3, per ogni pipeline. Quando crei o modifichi una pipeline, devi avere un bucket di artefatti nella regione della pipeline e un bucket di artefatti per ogni regione in cui stai eseguendo un'azione. AWS

   Per ulteriori informazioni, consulta Artefatti di input e output e CodePipeline riferimento alla struttura della pipeline.

   Scegliere Successivo.

8. Nella pagina Step 3: Add source stage, in Source provider, scegli Amazon S3.

9. In Bucket, inserisci il bucket sorgente S3 che hai creato per questo tutorial, ad esempio. BucketName Nella chiave oggetto S3, inserisci il percorso e il nome del file ZIP, ad esempio. MyFiles.zip

10. Scegli Avanti.

11. Nel passaggio 4: Aggiungi fase di compilazione, scegli Ignora fase di compilazione, quindi accetta il messaggio di avviso scegliendo nuovamente Ignora.

    Scegli Avanti.

12. Nel passaggio 5: Aggiungi fase di test, scegli Ignora fase di test, quindi accetta il messaggio di avviso scegliendo nuovamente Ignora.

    Scegli Avanti.

13. Nel passaggio 6: Aggiungere la fase di distribuzione:

    1. In Deploy provider, scegli AWS CloudFormation Stack Set.

    2. In Stack set name, inserisci un nome per lo stack set. Questo è il nome dello stack set creato dal modello.

       Nota

       Prendi nota del nome del tuo stack set. Lo utilizzerai quando aggiungerai la seconda azione StackSets di distribuzione alla pipeline.

    3. In Percorso modello, inserisci il nome dell'elemento e il percorso del file in cui hai caricato il file modello. Ad esempio, inserisci quanto segue utilizzando il nome dell'artefatto di origine predefinito. SourceArtifact

       SourceArtifact::template.yml

    4. In Destinazioni di distribuzione, inserisci il nome dell'elemento e il percorso del file in cui hai caricato il file degli account. Ad esempio, inserisci quanto segue utilizzando il nome predefinito dell'artefatto di origine. SourceArtifact

       SourceArtifact::accounts.txt

    5. In Deployment target Regioni AWS, inserisci una regione per la distribuzione dell'istanza dello stack iniziale, ad esempio. us-east-1

    6. Espandi le opzioni di distribuzione. In Parametri, inserisci il nome dell'elemento e il percorso del file in cui hai caricato il file dei parametri. Ad esempio, immettete quanto segue utilizzando il nome predefinito dell'artefatto di origine. SourceArtifact

       SourceArtifact::parameters.txt

       Per immettere i parametri come input letterale anziché come percorso di file, immettete quanto segue:

       ParameterKey=EnableLogFileValidation,ParameterValue=true
       ParameterKey=IncludeGlobalEvents,ParameterValue=true

    7. In Capabilities, scegliete CAPABILITY_IAM e CAPABILITY_NAMED_IAM.

    8. Nel modello di autorizzazione, scegliete SELF_MANAGED.

    9. In Percentuale di tolleranza agli errori, immettere. 20

    10. Nel campo Percentuale simultanea massima, immettere25.

    11. Scegli Avanti.

    12. Nella Fase 7: Revisione, scegli Crea pipeline. Viene visualizzata la pipeline.

    13. Consenti l'esecuzione della pipeline.

Per visualizzare le risorse

1. Apri la CodePipeline console all'indirizzo https://console.aws.amazon.com/codepipeline/.

2. In Pipelines (Pipeline), seleziona la pipeline e scegli View (Visualizza). Il diagramma mostra le fasi di distribuzione e di origine della pipeline.

3. Scegli l' CloudFormation azione sull'CloudFormationStackSetazione nella pipeline. Il modello, le risorse e gli eventi per il tuo stack set sono visualizzati nella CloudFormation console.

4. Nel pannello di navigazione a sinistra, scegli StackSets. Nell'elenco, scegli il nuovo set di stack.

5. Scegli la scheda Stack instances. Verifica che un'istanza di stack per ogni account fornito sia stata creata nella regione us-east-1. Verifica che lo stato di ogni istanza dello stack sia. CURRENT

Per creare un'azione successiva nella pipeline

1. Apri la CodePipeline console all'indirizzo https://console.aws.amazon.com/codepipeline/.

   In Pipelines (Pipeline), seleziona la pipeline e scegli View (Visualizza). Il diagramma mostra le fasi di distribuzione e di origine della pipeline.

2. Scegli questa opzione per modificare la pipeline. La pipeline viene visualizzata in modalità Modifica.

3. Nella fase di distribuzione, scegli Modifica.

4. Sotto l'azione di distribuzione di AWS CloudFormation Stack Set, scegli Aggiungi gruppo di azioni.

5. Nella pagina Modifica azione, aggiungi i dettagli dell'azione:

   1. In Nome azione, inserisci un nome per l'azione.

   2. In Action provider, scegli AWS CloudFormation Stack Instances.

   3. In Input artifacts, scegli. SourceArtifact

   4. In Nome dello stack set, immettete il nome dello stack set. Questo è il nome dello stack set che hai fornito nella prima azione.

   5. In Deployment targets, inserisci il nome dell'elemento e il percorso del file in cui hai caricato il file degli account. Ad esempio, inserisci quanto segue utilizzando il nome predefinito dell'artefatto di origine. SourceArtifact

      SourceArtifact::accounts.txt

   6. In Deployment target Regioni AWS, inserisci le regioni per la distribuzione delle istanze di stack rimanenti, ad esempio e come segue: us-east-2 eu-central-1

      us-east2, eu-central-1

   7. In Percentuale di tolleranza agli errori, inserisci. 20

   8. Nel campo Percentuale simultanea massima, immettere25.

   9. Selezionare Salva.

   10. Rilascia manualmente una modifica. La pipeline aggiornata viene visualizzata con due azioni nella fase di distribuzione.

Per visualizzare le risorse

1. Apri la CodePipeline console all'indirizzo https://console.aws.amazon.com/codepipeline/.

2. In Pipelines, scegli la tua pipeline, quindi scegli Visualizza. Il diagramma mostra le fasi di distribuzione e di origine della pipeline.

3. Scegli l' CloudFormation azione sull'AWS CloudFormation Stack Instancesazione nella pipeline. Il modello, le risorse e gli eventi per il tuo stack set sono visualizzati nella CloudFormation console.

4. Nel pannello di navigazione a sinistra, scegli StackSets. Nell'elenco, scegli il tuo stack set.

5. Scegli la scheda Stack instances. Verifica che tutte le istanze stack rimanenti per ogni account che hai fornito siano state create o aggiornate nelle regioni previste. Verifica che lo stato di ogni istanza dello stack siaCURRENT.

1. Apri la CodePipeline console all'indirizzo. https://console.aws.amazon.com/codepipeline/

2. In Pipelines, scegli la tua pipeline, quindi scegli Modifica. Nella fase di distribuzione, scegli Modifica.

3. Scegli di modificare l'azione AWS CloudFormation Stack Set nella pipeline. In Descrizione, sovrascrivi la descrizione esistente con una nuova descrizione per lo stack set.

4. Scegli di modificare l'azione AWS CloudFormation Stack Instances nella pipeline. In Deployment target Regioni AWS, elimina il us-east-2 valore inserito al momento della creazione dell'azione.

5. Salvare le modifiche. Scegli Release change per eseguire la pipeline.

6. Apri la tua azione in CloudFormation. Scegli la scheda delle StackSet informazioni. Nella StackSet descrizione, verifica che sia visualizzata la nuova descrizione.

7. Scegli la scheda Stack instances. In Status, verifica che lo stato delle istanze dello stack in us-east-2 sia. OUTDATED