Criação de uma ação usando o Console

Crie uma ação “ Schematics ” e especifique o playbook “ Ansible ” que você deseja executar nos seus recursos do Cloud.

1. Faça login no console IBM Cloud.

2. Clique no ícone Menu, > Platform Automation > Schematics > Ansible e navegue até Criar playbook.

   • Crie um manual.

     1. Digite um nome de playbook e uma descrição para sua ação. O nome pode ter até 128 caracteres de comprimento e pode incluir caracteres alfanuméricos, espaços, traços e sublinhados.
     2. Insira a URL do repositório GitHub ou GitLab em que o seu playbook do Ansible está armazenado. A URL pode apontar para a ramificação principal, qualquer outra ramificação ou um subdiretório. Se o seu repositório armazena vários playbooks, deve-se selecionar o playbook que deseja executar. Uma ação do Schematics pode apontar para um playbook de cada vez. Para executar vários playbooks, deve-se criar uma ação separada para cada um.

     Se você não tiver um manual, experimente um de seus manuais de amostra.

     3. Opcional: insira a Filial (opcional) e a Pasta (opcional).
     4. Opcional: se você deseja usar um repositório GitHub privado, insira seu token de acesso pessoal. O token de acesso pessoal é usado para autenticar o repositório GitHub privado para acessar o seu playbook do Ansible. Para obter mais informações sobre como criar um token de acesso, consulte a seção “Criação de um token de acesso pessoal para a CLI ”.

     Para obter mais informações, consulte as extensões de arquivo permitidas e bloqueadas para clonagem a partir do repositório Git. Para validar e clonar o modelo com segurança, você pode clicar em “ Open reference picker ” para selecionar sua referência de chave do Secrets Manager. Para obter mais informações, consulte a seção sobre como criar uma instância do Secrets Manager.

   • Informações Adicionais

     1. Opcional: insira as Sinalizações que você deseja incluir à sua ação. As tags ajudam na pesquisa rápida da sua ação.
     2. Selecione o Grupo de recursos no qual você deseja criar a ação.
     3. Selecione o Local onde deseja criar a ação. O local determina onde a sua ação é executada e os dados de ação são armazenados. Você pode escolher uma geografia, como Dallas, ou Frankfurt. Se você selecionar uma geografia, o Schematics decidirá sobre um local dentro desta geografia com base na disponibilidade. Tenha certeza de que seja possível armazenar os seus dados de ação neste local já que não será possível mudar o local após a ação ser criada. Para obter mais informações, consulte Onde as informações são armazenadas? Certifique-se de que a localização da sua ação seja independente da localização do seu recurso na nuvem onde você deseja executar o seu playbook “ Ansible ”.

   • Escolher um inventário Você pode definir os grupos de hosts nos quais deseja executar seu playbook “ Ansible ”.

     1. Clique em Criar inventário.

     2. Digite um nome para o seu inventário.

     3. Escolha o tipo de conexão como SSH ou WinRM, dependendo dos requisitos de seu host remoto. O padrão é SSH.

        O tipo de conexão é compatível com SSH e WinRM para conexão com hosts remotos. Para SSH, certifique-se de que o acesso ao host Bastion esteja configurado. WinRM é usado para se conectar a hosts remotos do Windows. Atualmente, o WinRM é compatível apenas com o sistema Windows por meio do endereço público IPs e não oferece suporte ao acesso por meio de um host bastion.

     4. Verifique seu location e selecione o Resource group onde deseja criar o inventário.

     5. Clique em Criar grupo de hosts.

     6. Insira um nome para o seu grupo de hosts e selecione a área de trabalho do Schematics que provisionou os hosts de destino que você deseja incluir em seu grupo de hosts.

     7. Opcional: clique em Incluir consulta para incluir outra condição à sua consulta e limite o número de hosts de destino que são incluídos em seu grupo de hosts. É possível escolher identificar os seus hosts usando o nome do recurso ou uma tag. Para obter mais informações, consulte consultas de recurso suportadas.

     8. Clique em Add another condition (Adicionar outra condição ) e repita as etapas 6 a 8 para adicionar mais grupos de hosts.

     9. Opcional: Clique na guia Definir manualmente para definir os hosts e o grupo de hosts nos quais seu playbook opera.

     10. Insira os detalhes do host usando o formato de arquivo.ini na opção File (Arquivo).

     11. A partir da lista de tabelas, selecione os grupos de hosts que deseja incluir em seu inventário de recursos.

     12. Clique em Create inventory (Criar inventário) para definir um arquivo de inventário que define os hosts e o grupo de hosts nos quais seu playbook opera.

3. Na tabela de inventário de recursos, selecione um inventário de recursos existente e clique no ícone Editar.

   • Clique em Manage Credentials (Gerenciar credenciais ) para configurar as credenciais do inventário. Para obter mais informações, consulte Gerenciamento de credenciais.
   • Clique em Manage Variables (Gerenciar variáveis ) para configurar as variáveis do inventário. Para obter mais informações, consulte Gerenciamento de variáveis.
   • Clique em Excluir para remover o inventário.

4. Clique em Criar. Sua ação é criada com o estado “ Normal ” (Em andamento), e você é direcionado para a seção “Detalhes ”.

5. Clique em Check action (Verificar ação) para verificar se as tarefas que você está tentando executar e seus recursos estão vinculados ao seu playbook. É possível monitorar a seção Histórico de ações para visualizar os resultados nos logs. Essa verificação confere se as tarefas que você está tentando executar e se os seus recursos estão vinculados corretamente ao seu manual.

   Não é possível excluir ou parar uma tarefa em execução de sua ação do Schematics. Para alterar sua ação, aguarde até que a tarefa seja concluída, altere suas configurações e, em seguida, clique em “Verificar ação” ou “Executar ação” novamente.

6. Clique em Executar ação para executar a ação. É possível monitorar o progresso de uma ação revisando os logs na página Tarefas. A cada 30 seconds os logs da tarefa são automaticamente atualizados.

Criação de uma ação usando a CLI

1. Em sua interface CLI local, configure o plug-in Schematics.
2. Crie uma ação usando o comando ibmcloud schematics action create.
3. Crie um inventário usando o comando ibmcloud schematics inventory create.
4. Verifique os registros para confirmar que a criação foi bem-sucedida.

Criação de uma ação usando a API

1. Recupere seu token de acesso ao IAM e autentique-se com Schematics.
2. Opcional: Crie uma ação enviando uma solicitação POST.
3. Crie um inventário enviando uma solicitação POST.
4. Verifique o status da resposta para confirmar que a criação foi bem-sucedida.