Documentação do Oracle Cloud Infrastructure

Processando um Manual

Use runbooks com o Fleet Application Management para executar operações de ciclo de vida em recursos de frota.

Importante

Se o plug-in de Gerenciamento de Aplicativos de Frota necessário para operações de ciclo de vida estiver desativado fora do Gerenciamento de Aplicativos de Frota, a operação falhará. Por exemplo, se o plug-in Fleet Application Management ou o plug-in OS Management Hub não estiver ativado em um recurso gerenciado pelo Fleet Application Management, ocorrerá um erro.

  • Na página de lista Frotas, selecione a frota com a qual você deseja trabalhar. Se precisar de ajuda para localizar a página de lista Frotas ou uma frota específica, consulte Listando Frotas.

    Na página de detalhes da frota, selecione Ações e Processar runbook.

    O processamento de um manual consiste nas seguintes páginas:

    Execute cada um dos seguintes workflows pela ordem. Você pode retornar a uma página anterior, selecionando Anterior.

    1. Adicionar runbooks

    Na página Adicionar runbooks, adicione os runbooks necessários para a frota.

    1. Em Nome, edite o nome, se necessário. Por padrão, o Fleet Application Management define um nome alfanumérico com hífen que inclui a operação do ciclo de vida, a data e a hora.
    2. Em Criar no compartimento, selecione o compartimento no qual você deseja executar o processo.
    3. Para Duração do processamento do manual, ative a alternância para incluir o tempo estimado do manual e especificar a duração.
      Observação

      Ao especificar a duração, considere o número de recursos participantes e o método (paralelo ou contínuo). Esses fatores ajudam a calcular uma duração de agendamento apropriada.
    4. Selecione Adicionar manual.
    5. No painel Adicionar runbook, selecione os runbooks a serem incluídos na frota.
      Observação

      Somente runbooks ativos são exibidos.
    6. Selecione uma versão do manual.
      Runbooks para aplicação de patches, descoberta, provisionamento e operações de ciclo de vida personalizado estão disponíveis.
    7. Selecione Adicionar manual novamente.
    8. Para adicionar runbooks de outro compartimento, selecione o compartimento e repita as etapas anteriores.
    Depois que você adiciona runbooks à frota, eles aparecem na tabela Adicionar runbook. Os runbooks são executados com base na ordem mostrada na tabela. Você pode:
    • Selecione o nome do manual para exibir mais detalhes.
    • No menu Ações na linha do manual, altere a ordem.
    Selecione Próximo para continuar.

    Marcação com Tags

    Se você tiver permissões para criar um recurso, também terá permissões para aplicar tags de formato livre a esse recurso. Para aplicar uma tag definida, você deve ter permissões para usar o namespace da tag. Para obter mais informações sobre tags, consulte Tags de Recurso. Se você não tiver certeza se deseja aplicar tags, ignore essa opção ou pergunte a um administrador. Você pode aplicar as tags posteriormente.

    Selecione Próxima para prosseguir para a próxima etapa.

    2. Parâmetros do manual

    Na página Parâmetros do manual, informe um ou mais argumentos para a tarefa do manual, se houver algum definido.

    Dependendo do manual, os parâmetros podem variar:

    • Manual de aplicação de patches ou descoberta:
      • Nome do argumento: Selecione o nome do argumento associado à tarefa.
      • Valor do argumento: Altere o valor padrão informando um valor.
      • Aplicar o mesmo valor sempre que aplicável em um runbook: Para usar o mesmo valor nas tarefas do runbook, ative essa opção. Se você não ativar a chave, especifique o nome e o valor do argumento para cada tarefa de manual.

    • Manual de provisionamento:

      Com base no manual e em suas tarefas (por exemplo, provisionando um banco de dados ou recurso do serviço Compute), o Fleet Application Management exibe campos de configuração relevantes. Você pode personalizar configurações para o recurso específico que está sendo provisionado.

      Observação

      • Você pode exibir e modificar configurações associadas a um pacote ou arquivo de configuração do Terraform (como arquivos JSON, YAML ou .tf) durante o provisionamento.
      • As configurações são apresentadas como formulários dinâmicos, preenchidos com base no conteúdo do arquivo subjacente (por exemplo, pares de chave/valor).
      • Os campos de formulário são gerados do arquivo schema.yaml no pacote Terraform. Se um valor padrão for definido no esquema, o campo será preenchido previamente. Caso contrário, o campo será exibido em branco para você concluir. Para obter mais informações sobre o arquivo schema.yaml, consulte Meta Esquema para Validação.
      Para configurar as tarefas do manual, selecione uma destas opções:
      • Selecionar existente: Selecione um item de catálogo de configuração existente. O manual usa a configuração selecionada sem alterações. Não é possível modificar a configuração nesta etapa e nenhum formulário é exibido.
      • Criar novo: Selecione Alterar para criar um item de catálogo informando valores de configuração diretamente no painel Criar item de catálogo de configuração. O painel exibe um form dinâmico renderizado do conteúdo do arquivo schema.yaml no arquivo de item do catálogo do Terraform anexado à tarefa de runbook. Essa nova configuração pode ser salva no Object Storage para uso futuro. Consulte Criando um Item de Catálogo Privado. O Fleet Application Management cria um item de catálogo e o associa à tarefa de provisionamento.
        Observação

        Os campos de configuração se adaptam com base no tipo de recurso (como banco de dados, Computação, notificações ou eventos). Por exemplo, o provisionamento de um serviço de notificação pode solicitar campos para endereços de e-mail, enquanto um manual de provisionamento de banco de dados exibe definições como "Criar Alarme Ativado" ou "Criar Evento".

        Selecione Configurar e selecionar para confirmar as alterações de configuração, criar e selecionar a configuração do manual.

    Selecione Próximo para continuar.

    3. Verificação

    Na página Revisar:
    • Revise a configuração do manual.
    • Para alterar as configurações, selecione Editar informações básicas.
    • Para modificar runbooks, selecione Editar runbooks. Para obter as descrições dos campos, consulte Criando um Manual.
    • Para alterar variáveis de entrada ou saída, selecione Editar parâmetros. Para obter as descrições dos campos, consulte Criando uma tarefa.
    • Para atualizar tags, selecione Editar tags.

    Quando tiver verificado todas as definições, selecione Criar.

    O manual começa a executar a operação selecionada e você pode exibir seu andamento na guia Processos de manual. Consulte Listando Processos de Runbook.

  • Não é possível executar esta tarefa usando a CLI.

    Para obter uma lista completa de flags e opções de variáveis para comandos da CLI do Fleet Application Management, consulte a CLI para Fleet Application Management.

  • Esta tarefa não pode ser executada com a API.