Creazione di associazioni che eseguono Ansible playbook

Apri la AWS Systems Manager console all'indirizzo https://console.aws.amazon.com/systems-manager/.

Nel riquadro di navigazione, scegli State Manager.

Selezionare State Manager poi Create Association (Crea associazione).

Per Name (Nome), specificare un nome che consente di ricordare lo scopo dell'associazione.

Nell'elenco Document (Documento) scegliere AWS-ApplyAnsiblePlaybooks.

Nella sezione Parametri, per Tipo di sorgente, scegli uno dei due GitHubo S3.

GitHub

Se lo desideri GitHub, inserisci le informazioni sul repository nel seguente formato.

{
   "owner":"user_name",
   "repository":"name",
   "path":"path_to_directory_or_playbook_to_download",
   "getOptions":"branch:branch_name",
   "tokenInfo":"{{(Optional)_token_information}}"
}

S3

Se si sceglie S3, immettere le informazioni sul percorso nel formato seguente.

{
   "path":"https://s3.amazonaws.com/path_to_directory_or_playbook_to_download"
}

Per Install Dependencies (Installa dipendenze), scegliere un'opzione.

(Facoltativo) Per Playbook File (File di playbook), immettere un nome file. Se il playbook è contenuto in un file Zip, specificare un percorso relativo al file Zip.

(Facoltativo) Per le variabili aggiuntive, inserite le variabili a cui desiderate State Manager inviarle Ansible in fase di esecuzione.

(Facoltativo) Per Check (Verifica), scegliere un'opzione.

(Facoltativo) Per Verbose (Modalità dettagliata), scegliere un'opzione.

Per Targets (Destinazioni), scegliere un'opzione. Per informazioni sull'utilizzo delle destinazioni, consultare Comprensione degli obiettivi e dei controlli tariffari nelle State Manager associazioni.

Nella sezione Specify schedule (Specifica pianificazione), scegliere On Schedule (Conforme a pianificazione) o No schedule (Nessuna pianificazione). Se si sceglie On Schedule (Conforme a pianificazione), utilizzare i pulsanti disponibili per creare una pianificazione cron o rate per l'associazione.

Nella sezione Advanced options (Opzioni avanzate), per Compliance severity (Gravità conformità), scegliere un livello di gravità per l'associazione. Il report di conformità indica se l'associazione è conforme o non conforme e il livello di gravità specificato qui. Per ulteriori informazioni, consulta Informazioni sulla conformità delle associazioni State Manager.

Nella sezione Rate control (Controllo velocità), configurare le opzioni per eseguire le associazioni di State Manager in tutto il parco nodi gestiti. Per informazioni sull'utilizzo dei controlli di velocità, consultare Comprensione degli obiettivi e dei controlli tariffari nelle State Manager associazioni.

Nella sezione Concurrency (Simultaneità) scegliere un'opzione:

Nella sezione Error threshold (Soglia di errore). scegliere un'opzione:

(Opzionale) In Output optione (Opzioni di output), per salvare l'output del comando in un file, selezionare la casella Enable writing output to S3 (Abilita scrittura in S3). Digitare i nomi del bucket e del prefisso (cartella) nelle caselle.

Scegliere Create Association (Crea associazione).

Installa e configura AWS Command Line Interface (AWS CLI), se non l'hai già fatto.

Per informazioni, consulta la pagina Installazione o aggiornamento della versione più recente di AWS CLI.

Esegui uno dei seguenti comandi per creare un'associazione che esegua i Ansible playbook prendendo di mira i nodi utilizzando i tag. Sostituisci ciascuno example resource placeholder con le tue informazioni. Il comando (A) specifica GitHub come tipo di origine. Il comando (B) specifica Amazon S3 come tipo di origine.

(A) fonte GitHub

Ecco un esempio.

aws ssm create-association --name "AWS-ApplyAnsiblePlaybooks" \
    --targets "Key=tag:OS,Values=Linux" \
    --parameters '{"SourceType":["GitHub"],"SourceInfo":["{\"owner\":\"ansibleDocumentTest\", \"repository\": \"Ansible\", \"getOptions\": \"branch:master\"}"],"InstallDependencies":["True"],"PlaybookFile":["hello-world-playbook.yml"],"ExtraVariables":["SSM=True"],"Check":["False"],"Verbose":["-v"]}' \
    --association-name "AnsibleAssociation" \
    --schedule-expression "cron(0 2 ? * SUN *)"

(B) Origine S3

Ecco un esempio.

aws ssm create-association --name "AWS-ApplyAnsiblePlaybooks" \
    --targets "Key=tag:OS,Values=Linux" \
    --parameters '{"SourceType":["S3"],"SourceInfo":["{\"path\":\"https://s3.amazonaws.com/amzn-s3-demo-bucket/playbook.yml\"}"],"InstallDependencies":["True"],"PlaybookFile":["playbook.yml"],"ExtraVariables":["SSM=True"],"Check":["False"],"Verbose":["-v"]}' \
    --association-name "AnsibleAssociation" \
    --schedule-expression "cron(0 2 ? * SUN *)"

Il sistema tenta di creare l'associazione sui nodi e di applicare immediatamente lo stato.

Eseguire il comando riportato sotto per visualizzare uno stato aggiornato dell'associazione appena creata.

aws ssm describe-association --association-id "ID"