Documentação do Oracle Cloud Infrastructure

Criando um Job do Plano

Crie um job de plano no Resource Manager.

A criação (em execução) de um job de plano faz parsing da sua configuração do Terraform e a converte em um plano de execução para a pilha associada. O plano de execução lista a sequência de ações específicas planejadas para provisionar seus recursos do Oracle Cloud Infrastructure, incluindo ações esperadas após a execução de um job de aplicação. Recomendamos a execução de um job de plano (gerando um plano de execução) antes de executar um job de aplicação. O plano de execução é entregue ao job de aplicação, que executa as instruções.

Para configurações armazenadas em um sistema de controle de código-fonte, como GitHub ou GitLab, o job usa o commit mais recente.

    1. Abra o menu de navegação e clique em Serviços ao Desenvolvedor. Em Resource Manager, clique em Pilhas.
    2. Na página Pilhas, selecione o compartimento que contém a pilha desejada.
    3. Clique no nome da pilha desejada.
    4. Na página Detalhes da pilha, clique em Plano.
    5. (Opcional) No painel Plano, edite o nome padrão do job. Evite inserir informações confidenciais.
    6. Para recuperar as versões mais recentes disponíveis na origem configurada dos provedores do Terraform, clique em Mostrar opções avançadas e selecione Fazer upgrade das versões do provedor.
      A pilha deve ser Terraform 0.14 ou posterior e, se a pilha for mais antiga, ela deverá ser submetida a upgrade para usar o Registro do Terraform. Esta etapa será necessária se as versões do provedor na configuração do Terraform forem alteradas desde a última vez que um job foi executado na pilha. Os arquivos de bloqueio de dependência são gerenciados automaticamente para pilhas novas e atualizadas. Os provedores são atualizados dentro das restrições de versão da configuração do Terraform.
    7. Para gerar conteúdo de log detalhado para depuração, clique em Mostrar opções avançadas e selecione o nível de log desejado em Nível de log detalhado.
      Para obter mais informações, consulte Depurando o Terraform.
    8. Para ajustar o número máximo de operações simultâneas à medida que o Terraform percorre o gráfico, clique em Mostrar opções avançadas e edite o valor do Número máximo de operações paralelas. (Padrão: 10.) Use esta opção para acelerar o job.
      Observação

      Um valor alto pode causar limitação de recursos. Por exemplo, considere uma configuração do Terraform que defina centenas de instâncias de computação. Um job Aplicar tenta criar o maior número possível de instâncias ao mesmo tempo. Neste exemplo, um valor de 100 pode causar limitação pelo serviço Compute.
    9. Para extrair o estado mais recente antes de executar o job, clique em Mostrar opções avançadas e selecione Atualizar estados do recurso antes de verificar diferenças.

      Use esta opção para atualizar o estado primeiro. Por exemplo, considere usar essa opção com um job Aplicar que você pretende executar na infraestrutura atualizada manualmente (existente).

      Observação

      A atualização do estado pode afetar o desempenho. Se a configuração incluir vários recursos, considere não usar essa opção.
    10. (Opcional) Clique em Mostrar opções avançadas e atribua tags ao job.
      • Namespace de tag: Para adicionar uma tag definida, selecione um namespace existente. Para adicionar uma tag free-from, deixe o valor em branco.
      • Chave de tag: Para adicionar uma tag definida, selecione uma chave de tag existente. Para adicionar uma tag de formato livre, digite o nome da chave que deseja.
      • Valor da tag: Digite o valor da tag que você deseja.
      • Adicionar tag: Clique para adicionar outra tag.
    11. Clique em Planejar.

    O job do plano é criado. O novo job é listado em Jobs.

  • Use o comando oci resource-manager job create-plan-job e os parâmetros necessários para executar um job de planejamento.

    oci resource-manager job create-plan-job [OPTIONS]

    Para obter uma lista completa de parâmetros e valores para comandos da CLI, consulte a Referência de Linha de Comando do Resource Manager.

  • Use a operação CreateJob para criar um job de plano.

    Para obter um exemplo da parte operation da solicitação, consulte CreatePlanJobOperationDetails.