Documentação do Oracle Cloud Infrastructure

Criando um Job de Importação

Crie um job de importação no Resource Manager para importar arquivos de estado para recursos existentes já gerenciados pelo Terraform. Um job de importação define o arquivo de estado do Terraform fornecido como o estado atual da pilha.

Por exemplo, use um job de importação para migrar um ambiente local do Terraform para o Resource Manager.

    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, vá para Mais ações e selecione Importar estado.
    5. (Opcional) No painel Importar, edite o nome padrão do job. Evite inserir informações confidenciais.
    6. Para Selecionar um arquivo de estado do Terraform para fazer upload, adicione o arquivo de estado do Terraform que você deseja importar para a pilha.
      Você pode arrastar o arquivo para o controle ou clicar em Procurar e navegar até o local do arquivo.
    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. (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.
    9. Clique em Importar.

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

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

    oci resource-manager job create-import-tf-state-job --stack-id <stack_OCID> --tf-state-file <job_details>

    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 importação.

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

O Próximo

Depois de executar um job de importação, obtenha os detalhes do job para verificar seu status. Opcionalmente, você pode exibir o arquivo de estado do Terraform e exibir os logs.

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.