Cloud Design&Solution

Technical Blog

ホーム / 自動化 / IaC

【IaC 入門】④ Terraform の実行環境:OCI の Cloud Shell を使う

公開 更新

前回は、Terraform の仕組みと、設定ファイルの形を見ました。今回は、Terraform をどこで動かすかを取り上げます。この検証で使う OCI の Cloud Shell を開き、Terraform が使えることを確かめます。

Terraform をどこで動かすか

Terraform は1つのプログラムで、コマンドを打てる場所なら動きます。主な置き場所は次の3つです。

置き場所 向いているとき 気を付けること
手元の PC 自分のペースで試したいとき OS ごとに入れ方が違う。クラウドの認証の設定も自分で行う
作業用のサーバー チームで同じ環境を使いたいとき サーバーそのものを先に用意し、守る必要がある
クラウドのブラウザのシェル(Cloud Shell) すぐに始めたいとき 使える時間や保存できる量に上限がある

このほかに、Terraform をクラウド環境下で動かす方法もあります。

  • OCI:Resource Manager
    Terraform の設定ファイルを渡すと、OCI が Terraform を実行し、state も預かります。設定ファイルは、GitHub や GitLab などに置いたものから読み込めます。
  • AWS:CodeBuild と CodePipeline
    CodeBuild は、コマンドを実行する環境を AWS が用意するサービスで、ここで Terraform のコマンドを動かします。CodePipeline と組み合わせると、コードの変更をきっかけに、決まった手順で実行できます。

設定ファイルを Git で管理し、こうしたサービスから動かす形は、この検証を終えたあとのテーマで取り上げます。
この検証では、Cloud Shell を使います。ブラウザから実行でき、操作端末がMac でも Windows でも同じ手順になります。道具を入れる手間もありません。

置き場所と OCI の関係を図にすると、次のようになります。どこで動かしても、Terraform は OCI の API を通してリソースを作ります。

手元の PC、Cloud Shell、Resource Manager のどこで Terraform を動かしても、OCI の API を通してコンパートメントの中にリソースを作ることを示した OCI の構成図
図1 Terraform を動かす場所と OCI

OCI の Cloud Shell とは

Cloud Shell は、OCI の管理画面(コンソール)から開ける、Linux のコマンドの実行環境です。OCI の説明では、次の特徴があります。

  • Terraform、Ansible、OCI CLI、Git などが、はじめから入っている
  • OCI CLI は、認証を済ませた状態で使える。操作できる範囲は、管理者がそのユーザーに与えた権限のとおり
  • ホームディレクトリに 5GB の保存領域があり、次に開いたときも中身が残る(テナンシのホームリージョンで開いた場合)
  • テナンシの月ごとの上限の範囲で、無料で使える

一方で、次の上限があります。

  • 1回の利用は最長24時間で、60分操作しないと切れる
  • 6か月使わないと、ホームディレクトリの保存領域は削除の対象になる
  • 使うには、管理者が IAM のポリシーで Cloud Shell の利用を許可しておく必要がある

作ったファイルは、ホームディレクトリに置けば残ります。ただし、大事な設定ファイルは Git などで別の場所にも残しておくのが安全です。

Cloud Shell を開く

OCI のコンソールにログインし、画面右上の、リージョン名の右にあるアイコンを押します。出てきたメニューから「Cloud Shell」を選びます。

OCI コンソールの右上にあるアイコンを押し、メニューの Cloud Shell を選ぶところ
図2 Cloud Shell を開く

Cloud Shell の画面が開きます。

開いた直後の Cloud Shell。案内の文と、コマンドを入力する行が表示されている
図3 開いた直後の Cloud Shell

最後の行の $ のあとに、コマンドを入力します。

Terraform を確かめる

次のコマンドを実行します。

terraform version

次のように表示されれば、Terraform が使えます。

Terraform v1.5.7
on linux_arm64

on linux_arm64 は、Cloud Shell が動いている機械の種類です。OCI の説明では、リージョンで使える機械によって、ARM か x86 のどちらかになります。この表示のあとに、新しい版があるという案内が出ることがあります。この検証では、Cloud Shell に入っている v1.5.7 のまま進めます。

続けて、使えるコマンドの一覧を表示します。

terraform -help

一覧の最初に、主なコマンドとして次の5つが並びます。

Main commands:
  init          Prepare your working directory for other commands
  validate      Check whether the configuration is valid
  plan          Show changes required by the current configuration
  apply         Create or update infrastructure
  destroy       Destroy previously-created infrastructure
コマンド 役目
init 作業用のフォルダを準備する(プロバイダを取ってくる)
validate 設定ファイルの書き方に誤りがないかを確かめる
plan 何が変わるかを、実際に変える前に表示する
apply 設定ファイルのとおりにリソースを作る・変える
destroy 作ったリソースを消す

この検証で使うのは、主にこの5つです。

次回

次回は、OCI 側の準備として、作業用のコンパートメントと、Terraform から操作するための権限を整えます。

この記事の Cloud Shell の説明は、OCI の公式ドキュメント(Cloud Shell の概要)を基にしています。

あわせて読む