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 Terraform local para o Resource Manager.

    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. Vá para Mais ações e selecione Importar estado.
    3. (Opcional) No painel Importar, edite o nome padrão do job. Evite digitar informações confidenciais.
    4. 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 selecionar Pesquisar e navegar até o local do arquivo.
    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. (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.
    7. Selecione 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 para o 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 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.