Criando um playbook do Ansible

Para criar o playbook Ansible para uso com o Schematics, siga estes pré-requisitos e as etapas gerais.

Deseja usar os playbooks do Ansible existentes para começar? Experimente um dos playbooks Ansible fornecidos IBM ou explore as coleções e funções Ansible existentes no Ansible Galaxy.

Prepare seu inventário de recursos onde pretende executar o manual Ansible. Você também pode usar os recursos integrados do Terraform do Schematics para provisionar hosts de destino. Para obter mais informações, consulte Implementação de infraestrutura com áreas de trabalho do Schematics.
Desenvolva seu manual Ansible. Utilize um dos playbooks fornecidos pela IBM ou explore as funções e coleções existentes no Ansible Galaxy. Faça referência a essas funções e coleções](/docs/schematics?topic=schematics-create-playbook#schematics-collections) em seu manual, conforme necessário.
Estabeleça um repositório GitHub ou GitLab e organize o playbook, os módulos, as funções e as coleções do Ansible de acordo com a estrutura de diretórios necessária. Uma estrutura de exemplo pode ser encontrada neste manual de exemplo.
Faça upload de seu playbook, módulos, funções e coleções do Ansible para o seu repositório do GitHub.
Crie uma ação Schematics usando o playbook carregado.

Certifique-se de que seu manual siga a estrutura necessária e faça referência a todas as funções e coleções necessárias para uma execução perfeita em Schematics. Para obter mais informações, consulte a documentação do site Ansible ou a criação do playbook.

Referenciando coleções do Ansible em seu playbook

Ansible as coleções são grupos de recursos reutilizáveis do Ansible, como playbooks, módulos e funções, que você pode instalar e usar em seu playbook. As coleções estão disponíveis no repositório Ansible Galaxy.

Semelhantes às Funções do Ansible, as coleções requerem uma estrutura de pasta específica em seu repositório do GitHub.

Siga estas etapas para usar coleções em seu playbook Schematics

Navegue pelo site Ansible Galaxy para encontrar a coleção que deseja usar em seu manual.
Crie um arquivo requirements.yml para especificar as coleções que você deseja instalar a partir do Ansible Galaxy. A estrutura do arquivo deve seguir a documentação do site Ansible. Veja um exemplo usando a coleção community.kubernetes.
```
collections:
  - name: community.kubernetes
    version: 0.9.0
```
Adicione uma pasta collections ao seu repositório GitHub, relativa ao seu playbook, e coloque o arquivo requirements.yml dentro dessa pasta.
```
├── collections
        └── requirements.yml
├── playbook.yaml
├── README.md
```
Faça referência a um recurso de sua coleção em seu playbook. Para obter mais informações, consulte a documentação do site Ansible. Certifique-se de que a estrutura de pastas do seu manual esteja de acordo com os requisitos e faça referência adequada às coleções para uma execução perfeita em Schematics.

Preparando seu Ansible Playbook para Schematics

Antes de executar seu playbook Ansible em Schematics, considere os seguintes pontos:

Armazene seu playbook Ansible em um repositório GitHub ou GitLab.
Esteja ciente das limitações ao especificar hosts de destino para seu inventário de recursos Ansible. Para obter mais informações, consulte as diretrizes sobre a criação de inventários de recursos para as ações do site Schematics.
Certifique-se de que seus playbooks sejam compatíveis com uma versão do Ansible que seja compatível com o Schematics. Para verificar as versões compatíveis, execute o comando ibmcloud schematics version comando.
Opcionalmente, explore os recursos do playbook Ansible em Schematics usando um dos playbooks Ansible fornecidos pela IBM.

Próximas etapas

Depois de entender os pré-requisitos e as etapas de preparação do seu manual Ansible, a próxima etapa é criar uma ação Schematics. Esse processo envolve a especificação de seu playbook Ansible, a configuração do inventário de recursos e a definição de quaisquer credenciais ou variáveis necessárias. Siga o guia sobre como criar uma ação Schematics para prosseguir.