1. はじめに

Oracle Cloud Infrastructureの構築自動化にTerraformは欠かせない。しかし初心者にハードルは高いし、いちいちtfファイルを作るのは面倒だ。そんなとき以下のブログでエクスポート機能があることを発見。

Create Terraform recipes for OCI in minutes!

簡単に言えば、現在のコンパートメント情報を抜き出してtfファイルを作成する機能だ。そこで実際に触ってみた。

マニュアルの記述はこちら。
Discovering Terraform resources in an Oracle Cloud Infrastructure compartment

2020/08/05追記：Resource Managerにエクスポート機能（Resource Discovery）が搭載されました。そのため管理コンソールからtfファイルをエクスポートできます。詳しくは以下のページを参照。

1-1. TL;DR

TerraformはOracle Cloud InfrastructureのInfrastructure as Codeに欠かせない
GitHubのサンプルから手で作るのは大変
terraform-provider-oci 3.50からエクスポート機能が使えるようになった

1-2. 対象環境/前提条件

Oracle Cloud Infrastructure
OCI CLIがセットアップしてあること
Linux/Mac OS（これ以外のOSでも動くハズだがテストしていない）

2. 事前準備

事前準備では、OCI CLIが利用可能なことを確認し、最新のterraform-provider-ociをインストールする。

2-1. OCI CLIの動作確認

OCI CLIがセットアップ済みであることを確認する。次のように表示されればOKだ。表示されないときは下記リンクを参考にセットアップすること。

$ oci os ns get
{
  "data": "nrvcrx1bzia3"
}

7系LinuxにPython3＋OCI CLIをインストールする&2020/2/13以降はOCI CLIがサポートするPythonのバージョンが3.5+になる件

2-2. terraform-provider-ociのインストール

terraform-provider-ociを入手するには以下の方法がある。今回は、わかりやすいWebページからダウンロードする方法を採用する。

Webページからダウンロード
terraform initを実行（.terraform/plugins配下にダウンロードされる）
yumでインストール

2.https://releases.hashicorp.com/terraform-provider-oci/ にアクセスし、最新バージョンをクリックする。

3.プラットフォームごとのモジュールが公開されている。今回はOracle Linux 7を使用するのでlinux_amd64をダウンロードする。Mac OSではdarwin_amd64をダウンロードする。

4.ダウンロードしたファイルを解凍する。

$ unzip terraform-provider-oci_3.67.0_linux_amd64.zip
Archive:  terraform-provider-oci_3.67.0_linux_amd64.zip
  inflating: terraform-provider-oci_v3.67.0_x4

5./usr/local/binにコピーする。

sudo cp terraform-provider-oci_v3.67.0_x4 /usr/local/bin/terraform-provider-oci

6.確認のためオプション無しで実行する。次のように表示されれば準備は完了だ。

$ terraform-provider-oci
2020/03/25 01:51:31 [INFO] terraform-provider-oci 3.67.0
2020/03/25 01:51:31 Executable runs in Terraform plugin mode by default. For additional usage options, please run with the '-help' flag.
This binary is a plugin. These are not meant to be executed directly.
Please execute the program that consumes these plugins, which will
load any plugins automatically

2. tfファイルをエクスポートする

エクスポート時に指定するのは「コンパートメント名」と「出力先ディレクトリ」だ。

terraform-provider-oci -command=export -compartment_name=＜コンパートメント名＞ -output_path=＜出力先ディレクトリ＞

2.実行結果は次のとおり。出力が止まったままになり不安になるが、最低5分くらいは待ってほしい。最後に「COMPLETED」と表示されれば終了だ。

$ terraform-provider-oci -command=export -compartment_name=work01 -output_path=./myrecipe
2020/03/25 01:54:43 [INFO] terraform-provider-oci 3.67.0
2020/03/25 01:54:43 [INFO] resolved compartment name 'work01' to compartment id 'ocid1.compartment.oc1..aaaaaaaaw5syvmuwyecuglndoy6anakd57l5yg6tbrysgfc3hvsxbz4evrmq'
2020/03/25 01:54:43 Running export command
2020/03/25 01:54:43 [INFO] resource discovery: visiting oci_identity_compartment.export
2020/03/25 01:54:43 [INFO] discovering resources with data source 'oci_identity_availability_domains'
2020/03/25 01:54:43 [INFO] resource discovery: visiting oci_identity_availability_domain.export_VPoc-AP-TOKYO-1-AD-1
2020/03/25 01:54:43 [INFO] discovering resources with data source 'oci_core_boot_volumes'
2020/03/25 01:54:43 [INFO] adding datasource query attribute 'availability_domain' from parent attribute 'name'
2020/03/25 01:54:43 [INFO] resource discovery: visiting oci_identity_compartment.export
2020/03/25 01:54:43 [INFO] discovering resources with data source 'oci_core_cpes'
★中略★
2020/03/25 01:56:53 [INFO] ===> Generating resource 'oci_identity_tag_default.export_tag_default_2'
Found 1 'availability_domain' resources. Generated under './myrecipe/availability_domain.tf'
Found 12 'core' resources. Generated under './myrecipe/core.tf'
Found 0 'database' resources. Generated under './myrecipe/database.tf'
Found 0 'load_balancer' resources. Generated under './myrecipe/load_balancer.tf'
Found 2 'object_storage' resources. Generated under './myrecipe/object_storage.tf'
Found 5 'tagging' resources. Generated under './myrecipe/tagging.tf'

=== COMPLETED ===

3.出力されたファイルは次のとおり。サイズが63bytesのものは、コメントだけで中身はない。core.tfには、ネットワークとComputeが混在しているので、実際には分割して運用した方がいいだろう。

$ ls -l myrecipe/
合計 40
-rw-rw-r--. 1 opc opc   201  3月 25 01:56 availability_domain.tf
-rw-rw-r--. 1 opc opc 13907  3月 25 01:56 core.tf
-rw-rw-r--. 1 opc opc    63  3月 25 01:56 database.tf
-rw-rw-r--. 1 opc opc    63  3月 25 01:56 load_balancer.tf
-rw-rw-r--. 1 opc opc   809  3月 25 01:56 object_storage.tf
-rw-rw-r--. 1 opc opc  1584  3月 25 01:56 tagging.tf
-rw-rw-r--. 1 opc opc   170  3月 25 01:56 vars.tf

4.上記以外のオプションやIAM関連などの出力方法はマニュアルを読んでほしい。

Discovering Terraform resources in an Oracle Cloud Infrastructure compartment

3. tfファイルの活用方法

生成したtfファイルは、そのままTerraformで使ってもいいし、Resource Managerを使う方法もある。

Resource Managerで使用する方法は、冒頭で紹介したブログからリンクしているYouTube: Create Terraform recipes for OCI in minutes!の3:47付近で解説されている。

zipで圧縮してResourceManagerのStackにアップロード

$ cd myrecipe
$ zip myrecipe.zip *

terraform-provider-ociのエクスポート機能がとても便利