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
CreationPolicyoWaitCondition, 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.
Argomenti
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-bootstrapche 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 |
Utilizza Pip di Python per installare
|
|
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-keyinsieme a--secret-key
Se specifichi un’opzione, ricorda le autorizzazioni richieste dai vari script helper:
-
cfn-signalrichiedecloudformation: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à
UserDatadel 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 installe utilizzi gli scriptcfn-init,cfn-signalocfn-get-metadata, dovrai aggiornare manualmente gli script in ciascuna istanza Linux Amazon EC2 utilizzando questo comando:sudo yum install -y aws-cfn-bootstrapNota
L’esecuzione di
sudo yum install -y aws-cfn-bootstrapconsente di installare gli script helper dal repositoryyum. -
Se non includi il comando
yum installe utilizzi lo scriptcfn-hup, allora dovrai aggiornare manualmente lo script in ciascuna istanza Linux Amazon EC2 utilizzando questi comandi:sudo yum install -y aws-cfn-bootstrapsudo /sbin/servicecfn-huprestartNota
L’esecuzione di
sudo yum install -y aws-cfn-bootstrapconsente di installare gli script helper dal repositoryyum. -
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.