Creazione di uno stack dal codice sorgente del repository con la sincronizzazione Git - AWS CloudFormation
Creazione di uno stack dal codice sorgente del repositoryAggiornamento dello stack dal repository Git

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Creazione di uno stack dal codice sorgente del repository con la sincronizzazione Git

Questo argomento spiega come creare uno stack CloudFormation che si sincronizzi con un repository Git con la sincronizzazione Git.

Importante

Prima di continuare, completa tutti i prerequisiti indicati nella sezione precedente.

Creazione di uno stack dal codice sorgente del repository

  1. Accedere alla Console di gestione AWS e aprire la console di CloudFormation all’indirizzo https://console.aws.amazon.com/cloudformation.

  2. Sulla barra di navigazione nella parte superiore della schermata, seleziona la Regione AWS in cui creare lo stack.

  3. Nella pagina Stack scegli Crea Stack, quindi scegli Con nuove risorse (standard).

  4. Nella pagina Create stack (Crea stack), esegui le operazioni seguenti:

    1. Per Prerequisito - Prepara modello, mantieni selezionata l’opzione Scegli un modello esistente.

    2. Per Specifica modello, scegli Sincronizza da Git, quindi scegli Avanti.

  5. Nella pagina Specifica dettagli stack digita il nome dello stack in Nome stack. Il nome dello stack può includere lettere (A-Z o a-z), numeri (0-9) e trattini (-).

  6. Per File di implementazione dello stack, Creazione del file di implementazione:

    • Se non hai creato un file di implementazione corrispondente e non lo hai inserito nel repository, scegli Crea il file utilizzando i seguenti parametri e inseriscilo nel repository.

    • Se nel repository è presente un file di implementazione corrispondente, seleziona Fornisco il file nel repository.

  7. Per Repository delle definizioni dei modelli, scegli Scegli un repository Git collegato per selezionare un repository Git già collegato a CloudFormation oppure Collega un repository Git per collegarne uno nuovo. Se scegli Collega un repository Git, procedi come segue:

    1. Per Seleziona un provider di repository, scegli una delle seguenti opzioni:

      • GitHub

      • GitHub Enterprise Server

      • GitLab

      • Bitbucket

      • GitLab autogestito

    2. Per Connessione, scegli una connessione dall’elenco. Se non viene visualizzata alcuna opzione nell’elenco Connessione, scegli aggiungi una nuova connessione per andare alla Console Connessioni e creare una connessione al tuo repository.

  8. Nell’elenco Repository, seleziona il repository Git che contiene il tuo file di modello dello stack.

  9. Nell’elenco Ramo, seleziona il ramo che la sincronizzazione Git deve monitorare.

    Nota

    La sincronizzazione Git monitora solo il ramo selezionato per rilevare eventuali modifiche al modello CloudFormation e ai file di implementazione dello stack. Per qualsiasi modifica che desideri apportare al tuo stack è necessario eseguire il commit su questo ramo.

  10. Specifica il percorso completo per il Percorso del file di distribuzione, incluso il nome del file di implementazione dello stack dalla radice del ramo del repository.

    Qui verrà eseguito il commit del file nel tuo repository se a generare il file è CloudFormation. Se sei tu a fornire il file, questa sarà la sua posizione nel repository.

  11. Aggiungi un ruolo IAM. Il ruolo IAM include le autorizzazioni necessarie affinché CloudFormation sincronizzi lo stack dal repository Git. Puoi scegliere Nuovo ruolo IAM per generare un nuovo ruolo o Ruolo IAM esistente per selezionare uno già esistente dal tuo Account AWS. Se scegli di generare un nuovo ruolo, le autorizzazioni necessarie sono già incluse.

  12. Attiva o disattiva i commenti sulla richiesta pull:

    • Per fare in modo che CloudFormation pubblichi le informazioni sul set di modifiche nelle richieste pull per gli aggiornamenti dello stack, tieni attiva l’opzione Abilita commento su richieste pull.

    • Se disattivi questa opzione, CloudFormation non descriverà le differenze tra la configurazione attuale dello stack e le modifiche proposte nelle richieste pull quando i file del repository vengono aggiornati.

  13. Per il Percorso del file modello, specifica il percorso completo dalla radice del repository per il file del modello di stack.

  14. (Facoltativo) Per specificare i parametri dello stack, scegli Aggiungi parametro, fornisci una chiave e un valore per ogni parametro, quindi scegli Avanti. Per ulteriori informazioni, consulta File di implementazione dello stack.

    Ad esempio, per specificare un parametro port=8080 nel file di implementazione dello stack, procedi come segue:

    1. Scegli Add parameter (Aggiungi parametro).

    2. In Chiave, inserire port.

    3. In Valore, specifica 8080.

  15. (Facoltativo) Per aggiungere tag dello stack, scegli Aggiungi tag, fornisci una chiave e un valore di tag, quindi scegli Avanti. Per ulteriori informazioni, consulta File di implementazione dello stack.

  16. Scegli Avanti per continuare con Configura opzioni dello stack. Per informazioni sulla configurazione delle opzioni dello stack, consulta Configurazione delle opzioni dello stack.

    Una volta completata la configurazione dello stack, scegli Avanti per continuare.

  17. Controlla le impostazioni dello stack e verifica quanto segue:

    • Il modello di stack è configurato correttamente e impostato su Sincronizza da Git.

    • Il file di implementazione è configurato correttamente.

    • Il repository delle definizioni dei modelli è configurato correttamente e, in particolare, è selezionato il Repository e il Nome ramo corretto.

    • L’anteprima del file di implementazione è corretta e contiene i parametri e i valori previsti.

  18. Scegli Invia per creare lo stack.

    Quando scegli Invia viene creata automaticamente una richiesta pull nel repository Git. Per creare il tuo stack devi unire questa richiesta pull al repository Git. Dopo aver creato lo stack, CloudFormation inizia a monitorare il repository Git per rilevare eventuali modifiche.

Aggiornamento dello stack dal repository Git

Per aggiornare lo stack, esegui modifiche direttamente sul file modello o sul file di implementazione dello stack corrispondente nel repository Git. Dopo aver eseguito il commit delle modifiche al ramo monitorato, CloudFormation aggiorna automaticamente lo stack. Se utilizzi le richieste pull, prima che venga aggiornato lo stack viene creata automaticamente una richiesta pull nel repository Git. Per aggiornare lo stack devi unire questa richiesta pull al repository Git.

Nella console di CloudFormation, puoi selezionare lo stack e scegliere la scheda Sincronizzazione Git per visualizzare le informazioni sullo stato dello stack e sugli eventi di sincronizzazione. Per ulteriori informazioni, consulta Dashboard di stato della sincronizzazione Git .