Crea uno stack dal codice sorgente del repository con Git sync

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

Importante

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

Crea uno stack dal codice sorgente del repository

1. Accedi AWS Management Console e apri la AWS CloudFormation console all'indirizzo https://console.aws.amazon.com /cloudformazione.

2. Nella barra di navigazione nella parte superiore dello schermo, scegli in cui Regione AWS creare lo stack.

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

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

   1. Per Prerequisito: prepara il modello, mantieni selezionata l'opzione Scegli un modello esistente.

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

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

6. Per il file di distribuzione Stack, Creazione del file di distribuzione:

   • Se non hai creato un file di distribuzione dello stack e non lo hai aggiunto al tuo repository, scegli Crea il file utilizzando i seguenti parametri e inseriscilo nel mio repository.

   • Se hai un file di distribuzione dello stack nel tuo repository, scegli Sto fornendo il mio file nel mio repository.

7. Per Template definition repository, scegli Scegli un repository Git collegato per scegliere un repository Git già collegato oppure Collega un repository Git per collegarne uno nuovo. CloudFormation Se scegli Collega un repository Git, procedi come segue:

   1. Per Select repository provider, 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 accedere alla console Connections 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

   Git sync monitora solo il ramo selezionato per le modifiche al CloudFormation modello e ai file di distribuzione 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.

    Se CloudFormation sta generando il file per te, è qui che il file verrà salvato nel tuo repository. Se sei tu a fornire il file, questa sarà la sua posizione nel repository.

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

12. Abilita o disattiva i commenti sulla pull request:

    • Per inserire le informazioni relative ai CloudFormation post change set nelle pull request for stack updates, tieni attivo l'interruttore Enable comment on pull request.

    • Se disattivi questo interruttore, CloudFormation non descriverà le differenze tra la configurazione corrente 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, scegliete Aggiungi parametro, fornite una chiave e un valore per ogni parametro, quindi scegliete Avanti. Per ulteriori informazioni, consulta File di implementazione dello stack.

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

    1. Scegli Add parameter (Aggiungi parametro).

    2. In Chiave, inserire port.

    3. In Valore, specifica 8080.

15. (Facoltativo) Per specificare gli stack tag, scegliete Aggiungi nuovo tag, fornite una chiave e un valore per ogni tag, quindi scegliete 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 Configura le opzioni dello stack.

    Una volta completata la configurazione, scegli Avanti per continuare con la revisione e l'implementazione.

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.

    Dopo aver scelto Invia, viene creata automaticamente una pull request nel tuo repository Git. Devi unire questa pull request nel tuo repository Git per creare il tuo stack. Dopo aver creato lo stack, CloudFormation monitora il tuo repository Git per rilevare eventuali modifiche.

Aggiorna il tuo stack dal tuo repository Git

Per aggiornare lo stack, apporta le modifiche direttamente al file modello o al file di distribuzione dello stack nel tuo repository Git. Dopo aver eseguito il commit delle modifiche nel ramo monitorato, aggiorna CloudFormation automaticamente lo stack. Se utilizzi le richieste pull, una richiesta pull viene creata automaticamente nel tuo repository Git prima che lo stack venga aggiornato. Devi unire questa pull request nel tuo repository Git per aggiornare lo stack.

Nella CloudFormation console, puoi selezionare lo stack e scegliere la scheda Git sync per visualizzare informazioni sullo stato dello stack e sugli eventi di sincronizzazione. Per ulteriori informazioni, consulta Pannello di controllo dello stato di sincronizzazione Git.