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à.

Come funziona la sincronizzazione Git con CloudFormation

Questo argomento descrive come funziona la sincronizzazione Git e introduce i concetti chiave necessari per utilizzarla.

Come funziona la sincronizzazione Git

Per utilizzare la sincronizzazione Git, devi prima connettere un provider Git a CloudFormation utilizzando il servizio CodeConnections. Nelle procedure presenti in questa guida, la connessione viene creata tramite la console CodeConnections. In alternativa, puoi crearla anche tramite la AWS CLI. Puoi utilizzare uno dei seguenti provider Git:

Quindi, fornisci un modello CloudFormation che definisca il tuo stack e aggiungilo al tuo repository. Questo file di modello viene monitorato. CloudFormation aggiorna lo stack automaticamente quando viene eseguito il commit delle modifiche.

Nella console CloudFormation, crea un nuovo stack e scegli Sincronizza da Git per indicare a CloudFormation di usare la sincronizzazione Git. Dovrai specificare il repository e il ramo che desideri che CloudFormation monitori, nonché il modello CloudFormation nel repository che definisce lo stack.

Durante la configurazione, puoi fornire il tuo file di implementazione dello stack dal repository o fare in modo che la sincronizzazione Git ne generi uno per te. Il file di implementazione dello stack contiene parametri e valori che configurano le risorse dello stack. Questo file di implementazione dello stack viene monitorato. CloudFormation aggiorna lo stack automaticamente quando viene eseguito il commit delle modifiche.

La sincronizzazione Git crea una richiesta pull nel repository per sincronizzare lo stack con il file di modello CloudFormation e il file di implementazione dello stack. Il file di implementazione dello stack viene inviato al tuo repository dalla sincronizzazione Git se quest’ultima lo genera al posto tuo.

Unisci la richiesta pull al repository in modo che CloudFormation esegua il provisioning dello stack, lo configuri in base ai tuoi parametri di implementazione e inizi a monitorare il repository per rilevare eventuali modifiche.

Da quel momento in poi, ogni volta che apporti modifiche al tuo file modello o al file di implementazione dello stack e le esegui nel tuo repository, CloudFormation rileverà automaticamente le modifiche. Se il tuo team utilizza le richieste pull, i membri possono rivedere e approvare le modifiche prima che vengano implementate. Una volta accettata la richiesta pull, CloudFormation implementa le modifiche.

Nella console CloudFormation puoi monitorare lo stato della configurazione della sincronizzazione Git per lo stack e visualizzare una cronologia delle operazioni di commit eseguite sullo stack. La console fornisce anche strumenti per la riconfigurazione della sincronizzazione Git e la risoluzione dei problemi.

Commenti sulle richieste pull

Puoi scegliere di fare in modo che CloudFormation crei un riepilogo delle modifiche al codice nelle richieste pull tramite il servizio CodeConnections attivando l’opzione Abilita commento su richiesta pull nella console. Fornire un riepilogo delle modifiche nelle richieste pull significa che i membri del team possono facilmente esaminare e comprendere l’impatto delle modifiche proposte prima di unire la richiesta pull. Per ulteriori informazioni, consulta Abilitazione di CloudFormation per pubblicare un riepilogo delle modifiche allo stack nelle richieste pull.

File di implementazione dello stack

Un file di implementazione dello stack è in formato standard JavaScript Object Notation (JSON) o YAML e contiene i parametri e i valori che gestiscono lo stack CloudFormation. Viene monitorato per rilevare eventuali modifiche. Quando viene eseguito il commit delle modifiche al file nel repository, lo stack associato viene aggiornato automaticamente.

Il file di implementazione dello stack contiene una coppia chiave-valore e due dizionari:

Puoi fornire il tuo file di implementazione dello stack o fare in modo che la sincronizzazione Git ne crei uno per te e invii automaticamente una richiesta pull al repository. Puoi gestire i parametri e i tag modificando il file di implementazione dello stack ed eseguendo il commit delle modifiche al repository.

Di seguito è riportato l’esempio di un file di implementazione dello stack della sincronizzazione Git:

template-file-path: fargate-srvc/my-stack-template.yaml

parameters: 
    image: public.ecr.aws/lts/nginx:latest
    task_size: x-small
    max_capacity: 5
    port: 8080
    env: production
tags:
    cost-center: '123456'
    org: 'AWS'

File di modello CloudFormation

Un file di modello contiene una dichiarazione delle risorse AWS che compongono uno stack CloudFormation. Con la sincronizzazione Git, il file di modello a cui il file di implementazione dello stack fa riferimento viene archiviato nel repository Git. Puoi gestire lo stack modificando il file di modello ed eseguendo il commit delle modifiche al repository.

Per ulteriori informazioni, consulta Lavorare con i CloudFormation modelli.

Repository delle definizioni dei modelli

Il repository delle definizioni dei modelli è il repository Git collegato a CloudFormation tramite la sincronizzazione Git. Il repository viene monitorato per rilevare eventuali modifiche al modello CloudFormation e al file di implementazione dello stack. Quando esegui il commit delle modifiche al file, lo stack associato viene aggiornato automaticamente.