Documentação do Oracle Cloud Infrastructure

Criando um Job de Destruição

Crie um job de destruição no Resource Manager para liberar (arrastar para baixo) recursos associados a uma pilha e limpar a tenancy. Os recursos liberados são eventualmente excluídos pelo serviço OCI relacionado. Por exemplo, uma instância de computação liberada é eventualmente excluída pelo serviço OCI Compute.

O histórico e o estado do job da pilha permanecem após a execução de um job de destruição. Você pode monitorar o status e revisar os resultados de um job de destruição inspecionando os arquivos de log da pilha.

O job de destruição está disponível quando existem recursos que foram criados pela pilha.

Observação

Recomendamos a execução de um job de destruição antes da exclusão de uma pilha para liberar primeiro os recursos associados. Quando você exclui uma pilha, o arquivo de estado associado também é excluído; portanto, você perderá o controle do estado de seus recursos associados. A limpeza de recursos associados a uma pilha excluída pode ser difícil sem o arquivo de estado, especialmente quando esses recursos estão distribuídos em vários compartimentos. Para evitar uma remoção difícil posteriormente, recomendamos que você libere os recursos associados primeiro, executando um job de destruição. Se a pilha não tiver recursos associados, um job de destruição não estará disponível. Você pode excluir com segurança essa pilha sem se preocupar com arquivos de estado ausentes.

Não é possível recuperar dados de recursos destruídos.

    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 Destruir.
    5. (Opcional) No painel Destruir, 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 Destruir.

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

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

    oci resource-manager job create-destroy-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 destruição.

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

O Próximo

Depois de executar um job de destruiçã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 exclusão dos recursos. Você também pode recriar recursos destruídos.

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 exclusão dos recursos, inspecione os recursos no compartimento.

Para recriar os recursos de uma pilha depois que os recursos forem destruídos, execute um job de aplicação. Os novos recursos diferem dos recursos destruídos anteriormente por seus OCIDs exclusivos e outros metadados.