Riferimenti agli script helper di CloudFormation - AWS CloudFormation

Questa è la nuova Guida di riferimento ai modelli CloudFormation . Aggiorna i segnalibri e i link. Per informazioni su come iniziare CloudFormation, consulta la Guida AWS CloudFormation per l'utente.

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

Riferimenti agli script helper di CloudFormation

CloudFormation fornisce i seguenti script di helper in Python che puoi utilizzare per installare software e avviare i servizi su un’istanza Amazon EC2 creata come parte del tuo stack:

  • cfn-init: utilizzalo per recuperare e interpretare i metadati delle risorse, installare pacchetti, creare file e avviare i servizi.

  • cfn-signal: consente di inviare il segnale con CreationPolicy o WaitCondition, in modo da sincronizzare altre risorse nello stack quando la risorsa o l’applicazione del prerequisito è pronta.

  • cfn-get-metadata: utilizzalo per recuperare i metadati per una risorsa o un percorso di una chiave specifica.

  • cfn-hup: utilizzalo per verificare la presenza di aggiornamenti dei metadati ed eseguire gli hook personalizzati quando le modifiche vengono rilevate.

Puoi chiamare gli script direttamente dal tuo modello. Lo script funziona in combinazione con i metadati delle risorse definiti nello stesso modello. Gli script eseguiti sull’istanza Amazon EC2 durante il processo di creazione dello stack.

Nota

Gli script non vengono eseguiti per impostazione predefinita. Devi includere le chiamate al modello per l’esecuzione di script helper specifici.

Immagini AMI Amazon Linux

Gli script helper di CloudFormation sono preinstallati nelle immagini AMI Amazon Linux in cui sono installati script bootstrap.

  • Sulla versione più recente di AMI Amazon Linux, gli script vengono installati in /opt/aws/bin.

  • Nelle precedenti versioni di AMI Amazon Linux, il pacchetto aws-cfn-bootstrap che contiene gli script si trova nel repository Yum.

Nota

Gli script helper sono preinstallati nelle ultime versioni dell’AMI Amazon Linux e non nelle AMI ottimizzate, ad esempio ECS Optimized Image che utilizza Amazon Linux come base.

Download di pacchetti per altre piattaforme

Per le distribuzioni Linux/Unix diverse dalle immagini AMI Amazon Linux e per Microsoft Windows (2008 o versioni successive), puoi scaricare il pacchetto aws-cfn-bootstrap.

Nota

La versione 2.0–1 e versioni successive degli script helper supportano Python 3.4 e versioni successive. Se sono necessari script helper che supportano una versione precedente di Python, consulta Cronologia delle versioni per gli script helper 1.4 di CloudFormation.

Formato del file Scarica il URL

TAR.GZ

https://s3.amazonaws.com/cloudformation-examples/aws-cfn-bootstrap-py3-latest.tar.gz

Utilizza Pip di Python per installare tar.gz. Per completare l’installazione per Ubuntu, devi creare un collegamento simbolico:

ln -s /<path-to-extracted-tar>/aws-cfn-bootstrap-2.0/init/ubuntu/cfn-hup /etc/init.d/cfn-hup

ZIP

https://s3.amazonaws.com/cloudformation-examples/aws-cfn-bootstrap-py3-latest.zip

EXE

Windows a 32 bit: https://s3.amazonaws.com/cloudformation-examples/aws-cfn-bootstrap-py3-latest.exe

Windows a 64 bit: https://s3.amazonaws.com/cloudformation-examples/aws-cfn-bootstrap-py3-win64-latest.exe

Autorizzazioni per gli script helper

Per impostazione predefinita, gli script helper non richiedono credenziali, perciò non è necessario utilizzare le opzioni --access-key, --secret-key,--role o --credential-file. Tuttavia, se non viene specificata alcuna credenziale, CloudFormation verifica la sottoscrizione allo stack e limita l’ambito della chiamata allo stack a cui l’istanza appartiene.

Se scegli di specificare un’opzione, è consigliabile specificare solo una delle seguenti:

  • --role

  • --credential-file

  • --access-key insieme a --secret-key

Se specifichi un’opzione, ricorda le autorizzazioni richieste dai vari script helper:

  • cfn-signal richiede cloudformation:SignalResource

  • Tutti gli altri script helper richiedono cloudformation:DescribeStackResource

Per ulteriori informazioni sull’uso delle operazioni specifiche per CloudFormation e delle chiavi di contesto di condizione nelle policy IAM, consulta Control CloudFormation access with AWS Identity and Access Management nella Guida per l’utente di AWS CloudFormation.

Utilizzo della versione più recente

Gli script helper vengono aggiornati periodicamente. Se utilizzi gli script helper, assicurati che le istanze siano lanciate utilizzando la versione più recente degli script:

  • Includi il comando seguente nella proprietà UserData del modello prima di chiamare gli script. Questo comando garantisce l’utilizzo della versione più recente:

    yum install -y aws-cfn-bootstrap

  • Se non includi il comando yum install e utilizzi gli script cfn-init, cfn-signal o cfn-get-metadata, dovrai aggiornare manualmente gli script in ciascuna istanza Linux Amazon EC2 utilizzando questo comando:

    sudo yum install -y aws-cfn-bootstrap

    Nota

    L’esecuzione di sudo yum install -y aws-cfn-bootstrap consente di installare gli script helper dal repository yum.

  • Se non includi il comando yum install e utilizzi lo script cfn-hup, allora dovrai aggiornare manualmente lo script in ciascuna istanza Linux Amazon EC2 utilizzando questi comandi:

    sudo yum install -y aws-cfn-bootstrap

    sudo /sbin/service cfn-hup restart

    Nota

    L’esecuzione di sudo yum install -y aws-cfn-bootstrap consente di installare gli script helper dal repository yum.

  • Se utilizzi il codice sorgente per gli script in modo che funzionino con un’altra versione di Linux o un’altra piattaforma e hai creato l’archivio di trust del certificato, dovrai anche mantenere l’archivio aggiornato.

Per la cronologia della versione del pacchetto aws-cfn-bootstrap, consulta Cronologia delle versioni degli CloudFormation script di supporto.