Documentação do Oracle Cloud Infrastructure

Criando um Job de Aplicação

Crie um job de aplicação no Resource Manager.

Quando você cria (executa) um job de aplicação para uma pilha, o Terraform provisiona os recursos e executa as ações definidas na configuração do Terraform, aplicando o plano de execução à pilha associada para criar (ou modificar) seus recursos do Oracle Cloud Infrastructure. Recomendamos executar um job de plano (gerando um plano de execução) antes de executar um job de aplicação.

Para obter um passo a passo usando a CLI para provisionamento de nuvem em um pipeline de CI/CD, consulte IaC na Nuvem: Integrando o Terraform e o Resource Manager no seu Pipeline de CI/CD - Criando com a CLI do OCI.

Para configurações armazenadas em um sistema de controle de código-fonte, como GitHub ou GitLab, o job usa o commit mais recente. O tempo necessário para concluir um job de aplicação depende do número e do tipo de recursos de nuvem a serem criados.

    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 Aplicar.
    5. (Opcional) No painel Aplicar, edite o nome padrão do job. Evite inserir informações confidenciais.
    6. (Opcional) Para Aplicar resolução de plano de job, selecione o nome do job de plano gerado mais recentemente. Somente o job do plano gerado mais recentemente está disponível. Se nenhum job de plano tiver sido gerado para esta pilha, apenas o valor padrão estará disponível (Aprovar automaticamente). Para obter mais informações sobre Aprovar Automaticamente, consulte Opção de Aprovação Automática para o Comando Aplicar do Terraform.
    7. 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.
    8. 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.
    9. 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.
    10. 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.
    11. (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.
    12. Clique em Aplicar.

    O job de aplicação foi criado. O novo job é listado em Jobs.

  • Use o comando oci resource-manager job create-apply-job e os parâmetros necessários para executar um job de aplicação.

    oci resource-manager job create-apply-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.

    Exemplos

    Exemplo 1: Referenciar um job de plano.

    oci resource-manager job create-apply-job --execution-plan-strategy <plan_job_ocid> --stack-id <stack_ocid>

    Exemplo 2: Aprovar automaticamente (não fazer referência a um job de plano).

    oci resource-manager job create-apply-job --execution-plan-strategy AUTO_APPROVED --stack-id <stack_ocid>

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

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

O Próximo

Dependendo do número e do tipo de recursos especificados, um determinado job de aplicação pode demorar um pouco.

Depois de executar um job de aplicação, obtenha os detalhes do job para verificar seu status. Opcionalmente, você pode exibir o arquivo de estado do Terraform, exibir os logs e confirmar a existência de recursos provisionados.

Monitore o status do job (estado do ciclo de vida) obtendo os detalhes do job. Bem-sucedido (SUCCEEDED) indica que o job foi concluído. Dependendo da complexidade do job, a operação pode demorar um pouco. Enquanto o job for executado ou depois que ele for concluído, você poderá obter o conteúdo dos logs do job.

Para exibir o arquivo de estado do Terraform (mostra o estado dos seus recursos após a execução do job), clique no nome do job para exibir a página Detalhes do job e, em seguida, clique em Exibir estado sob Recursos. Opcionalmente, selecione Mostrar alterações nesta versão.

Para exibir os logs do job, clique no nome do job para abrir a página Detalhes do job e, em seguida, clique em Logs sob Recursos.

Para confirmar a existência de recursos recém-provisionados, inspecione os recursos no compartimento.