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 a execução de 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: Integração do Terraform e do Resource Manager no Pipeline de CI/CD - Criação 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. Na página da lista Pilhas, selecione a pilha com a qual você deseja trabalhar. Se precisar de ajuda para encontrar a página da lista ou a pilha, consulte Listando Pilhas.
    2. Na página de detalhes da pilha, selecione Aplicar.
    3. (Opcional) No painel Aplicar, edite o nome padrão do job. Evite digitar informações confidenciais.
    4. (Opcional) Para Aplicar resolução de plano de job, selecione o nome do job de plano gerado mais recentemente. Somente o job de plano gerado mais recentemente está disponível. Se nenhum job de plano tiver sido gerado para essa 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.
    5. Para recuperar as versões mais recentes disponíveis na origem configurada dos provedores Terraform, selecione Mostrar opções avançadas e selecione Fazer upgrade das versões do provedor.
      A pilha deve ser o Terraform 0.14 ou posterior e, se a pilha for mais antiga, ela deverá ser submetida a upgrade para usar o Registro do Terraform. Essa etapa será obrigató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.
    6. Para gerar conteúdo de log detalhado para depuração, selecione 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 Como Depurar o Terraform.
    7. Para ajustar o número máximo de operações simultâneas à medida que o Terraform percorre o gráfico, selecione Mostrar opções avançadas e edite o valor para Número máximo de operações paralelas. (Padrão: 10.) Use essa 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.
    8. Para extrair o estado mais recente antes de executar o job, selecione Mostrar opções avançadas e selecione Atualizar estados de recursos antes de verificar diferenças.

      Utilize esta opção para atualizar primeiro o estado. Por exemplo, considere o uso dessa 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.
    9. (Opcional) Adicione uma ou mais tags ao job: Selecione Mostrar opções avançadas para mostrar opções de tag.
      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ê deverá ter permissões para usar o namespace da tag. Para obter mais informações sobre tags, consulte Tags de Recursos. Se você não tiver certeza se deseja aplicar tags, ignore esta opção ou pergunte a um administrador. Você pode aplicar tags posteriormente.
    10. Selecione 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 para o Resource Manager.

    Exemplos

    Exemplo 1: Fazer referência a 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 trabalho, a operação pode levar algum tempo. Enquanto o job é executado ou depois que ele é concluído, você pode 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), selecione o nome do job para exibir a página Detalhes do job e, em seguida, selecione Exibir estado sob Recursos. Opcionalmente, selecione Mostrar alterações nesta versão.

Para exibir os logs do job, selecione o job para abrir sua página de detalhes e, em seguida, selecione Logs em Recursos.

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