インポート・ジョブの作成

リソース・マネージャでインポート・ジョブを作成し、Terraformによってすでに管理されている既存のリソースの状態ファイルをインポートします。インポート・ジョブは、指定されたTerraform状態ファイルをスタックの現在の状態として設定します。

たとえば、インポート・ジョブを使用して、ローカルTerraform環境をResource Managerに移行します。

    1. ナビゲーション・メニューを開き、「開発者サービス」をクリックします。「Resource Manager」で、「Stacks」をクリックします。
    2. 「スタック」ページで、必要なスタックを含むコンパートメントを選択します。
    3. 目的のスタックの名前をクリックします。
    4. 「スタックの詳細」ページで、「その他のアクション」に移動して「インポート状態」を選択します。
    5. (オプション)「インポート」パネルで、ジョブのデフォルト名を編集します。機密情報を入力しないでください。
    6. アップロードするTerraform状態ファイルの選択に、スタックにインポートするTerraform状態ファイルを追加します。
      ファイルをコントロールにドラッグするか、「参照」をクリックしてファイルの場所にナビゲートします。
    7. Terraformプロバイダの構成済ソースから使用可能な最新バージョンを取得するには、「拡張オプションの表示」をクリックし、「プロバイダ・バージョンのアップグレード」を選択します。
      スタックはTerraform 0.14以降である必要があります。また、スタックが古い場合は、Terraformレジストリを使用にアップグレードする必要があります。Terraform構成のプロバイダ・バージョンが、スタックでジョブが最後に実行されてから変更された場合は、このステップが必要です。依存関係ロックファイルは、新しいスタックおよび更新されたスタックに対して自動的に管理されます。プロバイダは、Terraform構成のバージョン制約内で更新されます。
    8. (オプション)「拡張オプションの表示」をクリックし、ジョブにタグを割り当てます。
      • タグ・ネームスペース: 定義済タグを追加するには、既存のネームスペースを選択します。解放元タグを追加するには、値を空白のままにします。
      • タグ・キー: 定義済タグを追加するには、既存のタグ・キーを選択します。フリーフォーム・タグを追加するには、必要なキー名を入力します。
      • タグ値: 必要なタグ値を入力します。
      • タグの追加: 別のタグを追加する場合にクリックします。
    9. 「インポート」をクリックします。

    インポート・ジョブが作成されます。新しいジョブが「ジョブ」の下にリストされます。

  • oci resource-manager job create-import-tf-state-jobコマンドおよび必須パラメータを使用して、インポート・ジョブを実行します。

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

    CLIコマンドのパラメータおよび値の完全なリストは、リソース・マネージャ・コマンドライン・リファレンスを参照してください。

  • CreateJob操作を使用して、インポート・ジョブを作成します。

    リクエストのoperation部分の例については、CreateImportTfStateJobOperationDetailsを参照してください。

次の処理

インポート・ジョブの実行後、ジョブの詳細を取得してステータスを確認します。オプションで、Terraform状態ファイルを表示してログを表示できます。

ジョブの詳細を取得して、ジョブ・ステータス(ライフサイクル状態)をモニターします。成功(SUCCEEDED)は、ジョブが完了したことを示します。ジョブの複雑さによっては、操作に時間がかかる場合があります。ジョブの実行中または終了後に、ジョブ・ログの内容を取得できます。

Terraformの状態ファイル(ジョブの実行後のリソースの状態を示します)を表示するには、ジョブの名前をクリックして「ジョブ詳細」ページを表示し、「リソース」の下の「状態の表示」をクリックします。オプションで、「このバージョンの変更の表示」を選択します。

ジョブのログを表示するには、ジョブの名前をクリックして「ジョブ詳細」ページを開き、「リソース」の下の「ログ」をクリックします。