A palavra-chave loop sobre uma lista

Precisa instalar três pacotes? Escrever três tarefas quase idênticas é cansativo e propenso a erros. A palavra-chave loop permite que uma tarefa se repita sobre uma lista. 🔁

Adicione loop a uma tarefa e forneça uma lista. O Ansible executa essa tarefa uma vez para cada item, inserindo cada valor nos argumentos do módulo.

Dentro de uma tarefa com loop, o valor atual da lista fica disponível como item. Você faz referência a ele com {{ item }} onde precisar do valor.

O uso clássico: instale uma lista inteira de pacotes em uma tarefa. Cada nome é enviado ao módulo de pacotes por meio de item.

A lista não precisa estar inserida diretamente. Aponte loop para uma variável para que a mesma tarefa se adapte aos valores definidos em outro local.

Você pode encontrar playbooks mais antigos usando with_items. Ele ainda funciona, mas loop é a forma moderna e recomendada para listas simples.

Um loop executa a tarefa para cada item, portanto a saída mostra uma linha de resultado para cada iteração. Você vê exatamente quais valores foram alterados.

Usar loops não elimina a idempotência. Se um pacote já estiver presente, essa iteração informa ok; somente os pacotes novos informam changed.

Alguns módulos aceitam uma lista diretamente, o que é ainda mais rápido. Porém, loop é o padrão universal que funciona com quase qualquer módulo.

As listas não contêm apenas strings. Você pode percorrer números ou qualquer tipo de dado, e item transporta qualquer valor armazenado pela lista.

Se a lista estiver vazia, a tarefa simplesmente será executada zero vezes. Nenhum erro, nenhum problema. É perfeitamente aceitável percorrer uma variável que possa estar vazia.

Dentro de uma tarefa com loop, como você faz referência ao valor atual da lista?

Você substituiu tarefas repetitivas por um único loop, acessou cada valor por meio de item e manteve tudo idempotente. A seguir: percorrer dicionários. 🎉