Creazione di associazioni che eseguono playbook Ansible

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

Nel pannello di navigazione, scegliere 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 si sceglie GitHub, immettere le informazioni sul repository nel formato seguente.

{
   "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 Extra Variables (Variabili aggiuntive), immettere le variabili per l'invio da State Manager ad Ansible in fase di runtime.

(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 Comprensioni su destinazioni e controlli di velocità nelle associazioni di State Manager.

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 istanze nodi gestiti. Per informazioni sull'utilizzo dei controlli di velocità, consultare Comprensioni su destinazioni e controlli di velocità nelle associazioni di State Manager.

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 esegue playbook Ansible eseguendo il targeting dei nodi tramite tag. Sostituisci ogni 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) GitHub fonte

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"