<h2 id="%E6%A6%82%E8%A6%81" data-line="0" class="code-line">
<a class="header-anchor-link" href="#%E6%A6%82%E8%A6%81" aria-hidden="true"></a> 概要</h2>
<p data-line="1" class="code-line">terraformは業務で1年程使ってたのについ最近になって<strong>terraformモジュール</strong>という概念を知ったオジサンがモジュールについて改めて学習(公式doc読んだ)した時のメモ書きみたいな内容です。</p>
<p data-line="3" class="code-line">ちなみにterraformモジュールはこちらで教わりました。<br>
<a href="https://g-gen.co.jp/events/20240823_getting_started_with_terraform.html" target="_blank" rel="nofollow noopener noreferrer">【8月23日開催】Getting Started with Terraform for Google Cloud</a><br>
ありがとうございますG-genさん。(過去イベなんでその内リンク消えるかも。。)</p>
<p data-line="7" class="code-line">同様のイベントは定期的に開催してるようなので、terraformはじめの方にはおすすめです。<br>
私はG-genの関係者ではありません。</p>
<h2 id="terraform%E3%83%A2%E3%82%B8%E3%83%A5%E3%83%BC%E3%83%AB%E3%81%A8%E3%81%AF" data-line="10" class="code-line">
<a class="header-anchor-link" href="#terraform%E3%83%A2%E3%82%B8%E3%83%A5%E3%83%BC%E3%83%AB%E3%81%A8%E3%81%AF" aria-hidden="true"></a> terraformモジュールとは</h2>
<p data-line="11" class="code-line">.tfファイルで構成されるディクトリ単位で区切られた再利用可能なファイル群。<br>
また公開されてる利用可能なモジュールも沢山あって便利に活用できる。<br>
再利用可能という所で、一部のみ設定の違う同様の複数リソースを簡潔なコードで書くことができたり、"resource"ブロックをいちいち書かなくて済むようになるし、便利だから積極的に利用すると良いよ、といったもの。</p>
<p data-line="15" class="code-line">ちなみに公式docは<a href="https://developer.hashicorp.com/terraform/language/modules" target="_blank" rel="nofollow noopener noreferrer">こちらのページ</a></p>
<h2 id="%E5%85%AC%E5%BC%8Fdoc%E3%83%A1%E3%83%A2(%E3%83%A2%E3%82%B8%E3%83%A5%E3%83%BC%E3%83%AB%E3%83%96%E3%83%AD%E3%83%83%E3%82%AF%E3%80%81%E3%83%A2%E3%82%B8%E3%83%A5%E3%83%BC%E3%83%AB%E3%82%BD%E3%83%BC%E3%82%B9)" data-line="18" class="code-line">
<a class="header-anchor-link" href="#%E5%85%AC%E5%BC%8Fdoc%E3%83%A1%E3%83%A2(%E3%83%A2%E3%82%B8%E3%83%A5%E3%83%BC%E3%83%AB%E3%83%96%E3%83%AD%E3%83%83%E3%82%AF%E3%80%81%E3%83%A2%E3%82%B8%E3%83%A5%E3%83%BC%E3%83%AB%E3%82%BD%E3%83%BC%E3%82%B9)" aria-hidden="true"></a> 公式docメモ(モジュールブロック、モジュールソース)</h2>
<p data-line="19" class="code-line">terraformモジュールについて公式docのモジュールブロック、モジュールソースのページを見ながら概要を確認してきます。</p>
<h3 id="%E3%83%A2%E3%82%B8%E3%83%A5%E3%83%BC%E3%83%AB%E3%83%96%E3%83%AD%E3%83%83%E3%82%AF(%E5%91%BC%E3%81%B3%E5%87%BA%E3%81%97%E5%81%B4)" data-line="21" class="code-line">
<a class="header-anchor-link" href="#%E3%83%A2%E3%82%B8%E3%83%A5%E3%83%BC%E3%83%AB%E3%83%96%E3%83%AD%E3%83%83%E3%82%AF(%E5%91%BC%E3%81%B3%E5%87%BA%E3%81%97%E5%81%B4)" aria-hidden="true"></a> モジュールブロック(呼び出し側)</h3>
<p data-line="22" class="code-line"><a href="https://developer.hashicorp.com/terraform/language/modules/syntax" target="_blank" rel="nofollow noopener noreferrer">モジュールブロック</a>(公式doc)</p>
<p data-line="24" class="code-line">まず呼び出し側のモジュールブロックの使い方を確認。</p>
<p data-line="26" class="code-line"><strong>モジュールブロック定義の基本形</strong></p>
<div class="code-block-container"><pre><code class="code-line" data-line="27">module "servers" {
  source = "./app-cluster"

  servers = 5
}
</code></pre></div><p data-line="35" class="code-line">呼び出しについては以下のように記載されてます。<br>
この入力変数に、、、という所が結構要なわけですが気づいたら記事が長々になったので今回は割愛します。<br>
(ほんとは割愛すべきじゃないとこな気がしてますが)</p>
<blockquote data-line="38" class="code-line">
<p data-line="38" class="code-line">モジュールを呼び出すということは、そのモジュールの内容を、入力変数に特定の値を指定して構成に含めることを意味します 。モジュールはmodule、ブロックを使用して他のモジュール内から呼び出されます。</p>
</blockquote>
<p data-line="40" class="code-line"><code>main.tf</code>などこれまで<code>resource</code>ブロックをツラツラと書いているファイルにこのような<code>module</code>ブロックの定義を書く事でモジュールを呼び出すことができるようになります。<br>
(ドキュメントにこのような書き方はされてないですが、そういうことです）</p>
<p data-line="43" class="code-line"><strong>モジュールブロックの定義について(引数の説明など)</strong></p>
<ul data-line="44" class="code-line">
<li data-line="44" class="code-line">
<code>"servers"</code>の部分は任意の名前つける部分</li>
<li data-line="45" class="code-line">
<code>source</code>引数は必須。ここでlocalのモジュールのあるパスやリモートのモジュール名を指定
<ul data-line="46" class="code-line">
<li data-line="46" class="code-line">
<code>source</code>については後述のモジュールソースの部分でも詳細を記載</li>
</ul>
</li>
<li data-line="47" class="code-line">
<code>version</code>引数は省略可能だが、registryのモジュールを使う際はバージョン更新による予期せぬ挙動変更などの可能性があるので、バージョン固定で使うのが推奨のようです。</li>
<li data-line="48" class="code-line">その他の引数はモジュールごとに変わってくる。呼び出し元となるモジュールで定義してる値を使用することになります。</li>
<li data-line="49" class="code-line">
<code>for_each</code>, <code>depends_on</code>なども使えるよ、とのこと</li>
</ul>
<p data-line="51" class="code-line"><strong>モジュールブロックを使う時はterraform init</strong><br>
このモジュールブロックの追加、削除、修正などを行った際は、その後必ず<code>terrafomr init</code>を実行すること。<br>
また、利用するモジュールの最新バージョンを利用するように<code>version</code>を更新した際は<code>init</code>コマンドに<code>-upgrade</code>のオプションをつけてね、とのことです。</p>
<p data-line="55" class="code-line"><strong>モジュールブロックを削除すると、リソースは削除される</strong></p>
<blockquote data-line="56" class="code-line">
<p data-line="56" class="code-line">デフォルトでは、moduleブロックを削除すると、Terraform はそのモジュールで宣言された管理中のリソースをすべて破棄するように計画します。</p>
</blockquote>
<p data-line="58" class="code-line">でも<code>removed</code>ブロックで書き換えておく事で、実際のリソースは削除されないで済むようになるとのこと。<br>
これはちょっと頭の片隅に置いておいた方が良さそうですね。</p>
<p data-line="61" class="code-line">公式doc上ではこのほかにメタ引数、output、removedブロックなど詳細が書かれておりますが本記事では割愛とさせていただきます。(というか自分が現段階でその辺の理解追いついてない)</p>
<h3 id="%E3%83%A2%E3%82%B8%E3%83%A5%E3%83%BC%E3%83%AB%E3%82%BD%E3%83%BC%E3%82%B9(%E5%91%BC%E3%81%B3%E5%87%BA%E3%81%95%E3%82%8C%E3%82%8B%E5%81%B4)" data-line="63" class="code-line">
<a class="header-anchor-link" href="#%E3%83%A2%E3%82%B8%E3%83%A5%E3%83%BC%E3%83%AB%E3%82%BD%E3%83%BC%E3%82%B9(%E5%91%BC%E3%81%B3%E5%87%BA%E3%81%95%E3%82%8C%E3%82%8B%E5%81%B4)" aria-hidden="true"></a> モジュールソース(呼び出される側)</h3>
<p data-line="64" class="code-line"><a href="https://developer.hashicorp.com/terraform/language/modules/sources" target="_blank" rel="nofollow noopener noreferrer">モジュールソース</a>(公式doc)</p>
<p data-line="66" class="code-line">上述もしてますが、モジュール使う時は<code>terraform init</code>しようと。<br>
これでインストールするよと。</p>
<p data-line="69" class="code-line"><strong>モジュール種別</strong><br>
モジュールの<code>source</code>で指定できる種別としてはこれだけあるよと。<br>
公式docにはそれぞれのsourceの種別ごとの詳細な使い方も記載してます。</p>
<blockquote data-line="73" class="code-line">
<p data-line="73" class="code-line">ローカルパス<br>
テラフォームレジストリ<br>
GitHub<br>
ビットバケット<br>
汎用Git、Mercurialリポジトリ<br>
HTTP URL<br>
S3 バケット<br>
GCS バケット<br>
パッケージサブディレクトリ内のモジュール</p>
</blockquote>
<p data-line="83" class="code-line">ローカルのモジュールとリモートのモジュールの使い分けについて</p>
<blockquote data-line="84" class="code-line">
<p data-line="84" class="code-line">繰り返しのコード要素を分離する目的で主に使用される密接に関連するモジュールにはローカル ファイル パスを使用し、複数の呼び出し構成で共有することを目的としたモジュールにはネイティブ Terraform モジュール レジストリを使用することをお勧めします。</p>
</blockquote>
<p data-line="86" class="code-line">何となく分かるような、分からないような、、</p>
<p data-line="88" class="code-line">とりあえず今回の記事でも一部モジュール種別の定義方法について簡単に記載してこうと思います。</p>
<h4 id="%E3%83%AD%E3%83%BC%E3%82%AB%E3%83%AB" data-line="90" class="code-line">
<a class="header-anchor-link" href="#%E3%83%AD%E3%83%BC%E3%82%AB%E3%83%AB" aria-hidden="true"></a> ローカル</h4>
<p data-line="91" class="code-line"><code>./</code>または<code>../</code>で始まる必要がある。リモートのものとの区別のためで、絶対パス記法だとリモートモジュール扱いになる、といった説明があります。</p>
<h4 id="%E3%83%86%E3%83%A9%E3%83%95%E3%82%A9%E3%83%BC%E3%83%A0%E3%83%AC%E3%82%B8%E3%82%B9%E3%83%88%E3%83%AA(terraform-registry)" data-line="93" class="code-line">
<a class="header-anchor-link" href="#%E3%83%86%E3%83%A9%E3%83%95%E3%82%A9%E3%83%BC%E3%83%A0%E3%83%AC%E3%82%B8%E3%82%B9%E3%83%88%E3%83%AA(terraform-registry)" aria-hidden="true"></a> テラフォームレジストリ(Terraform Registry)</h4>
<p data-line="94" class="code-line"><a href="https://registry.terraform.io/?product_intent=terraform&amp;utm_source=WEBSITE&amp;utm_medium=WEB_IO&amp;utm_offer=ARTICLE_PAGE&amp;utm_content=DOCS" target="_blank" rel="nofollow noopener noreferrer">こちら</a>から"Browse Modules"一覧を検索できます。</p>
<p data-line="96" class="code-line">各種クラウド対応のものも配置されてるリモートのモジュールファイル一覧といったところでしょうか。</p>
<p data-line="98" class="code-line">定義の基本形は以下のような形式。</p>
<div class="code-block-container"><pre><code class="code-line" data-line="99">module "consul" {
  source = "hashicorp/consul/aws"
  version = "0.1.0"
}
</code></pre></div><p data-line="106" class="code-line"><code>source</code>の部分は<code>&lt;NAMESPACE&gt;/&lt;NAME&gt;/&lt;PROVIDER&gt;</code>という形式になってるようです。<br>
各種モジュールごとの詳細ページに正確なアドレスが定義されてます。</p>
<h4 id="github" data-line="109" class="code-line">
<a class="header-anchor-link" href="#github" aria-hidden="true"></a> GitHub</h4>
<p data-line="110" class="code-line">githubにあるモジュールの定義の基本形はこれ</p>
<div class="code-block-container"><pre><code class="code-line" data-line="111">モジュール"consul" {
  ソース= "github.com/hashicorp/example" 
}
</code></pre></div><p data-line="116" class="code-line">この記法はHTTPS 経由でクローンされるようです。<br>
SSH経由のクローンの場合は<code>source = "git@github.com:hashicorp/example.git"</code>の形式。</p>
<p data-line="119" class="code-line">ちなみにgithubにあるものも使えるものは多くあるけど、第三者によって作成されたもので信憑性が薄いモノもあるので、基本的にはterraform registryの公式のものがお勧めですよ、との話も。<br>
込み入った用途での利用時にregistryには無くて、githubに第三者による作成の丁度良いモジュールとかあるかもですね。</p>
<h4 id="s3%E3%83%90%E3%82%B1%E3%83%83%E3%83%88(aws)" data-line="122" class="code-line">
<a class="header-anchor-link" href="#s3%E3%83%90%E3%82%B1%E3%83%83%E3%83%88(aws)" aria-hidden="true"></a> S3バケット(aws)</h4>
<p data-line="123" class="code-line">awsのS3にモジュールを配置して使うことも可能。<br>
定義の基本形はこんな感じでオブジェクトURLを使うようで<code>s3::</code>のプレフィックスで識別してる。</p>
<div class="code-block-container"><pre><code class="code-line" data-line="125">module "consul" {
  source = "s3::https://s3-eu-west-1.amazonaws.com/examplecorp-terraform-modules/vpc.zip"
}
</code></pre></div><blockquote data-line="131" class="code-line">
<p data-line="131" class="code-line">注意: AWS の us-east-1 リージョンのバケットでは、ホスト名s3.amazonaws.com( ではなくs3-us-east-1.amazonaws.com) を使用する必要があります。</p>
</blockquote>
<p data-line="133" class="code-line">という注意点があるようです。</p>
<p data-line="135" class="code-line">あとはS3(aws)に接続するってことで、ローカルからS3のモジュール取得する際はAPI使用時同様<code>AWS_ACCESS_KEY_ID</code>などの変数設定やら<code>.aws/credentials</code>など設定しておいてくださいねと。</p>
<h4 id="gcs%E3%83%90%E3%82%B1%E3%83%83%E3%83%88(google-cloud)" data-line="138" class="code-line">
<a class="header-anchor-link" href="#gcs%E3%83%90%E3%82%B1%E3%83%83%E3%83%88(google-cloud)" aria-hidden="true"></a> GCSバケット(Google Cloud)</h4>
<p data-line="139" class="code-line">awsのS3同様、GCSバケットに配置も可能だよと。<br>
定義の基本形はこんな感じでオブジェクトURLを使うようで<code>gcs::</code>のプレフィックスで識別してる。</p>
<div class="code-block-container"><pre><code class="code-line" data-line="142">module "consul" {
  source = "gcs::https://www.googleapis.com/storage/v1/modules/foomodule.zip"
}
</code></pre></div><p data-line="148" class="code-line"><code>gcs::https://www.googleapis.com/storage/v1/BUCKET_NAME/PATH_TO_MODULE</code>という形式のようです。</p>
<p data-line="150" class="code-line">こちらもaws同様、Google Cloudに接続するってことで、API利用時に設定するような環境変数<code>GOOGLE_OAUTH_ACCESS_TOKEN</code>などの設定してくださいねと。(Google Cloudわからんです)</p>
<p data-line="152" class="code-line">ちなみに私が受けた<a href="https://g-gen.co.jp/events/20240823_getting_started_with_terraform.html" target="_blank" rel="nofollow noopener noreferrer">【8月23日開催】Getting Started with Terraform for Google Cloud</a>の会では、Google Cloudのcloudshellを使う事で上記のような変数設定とか不要でterraformもすぐ使えて便利、といった感じでcloudshellを用いてterraform実行のハンズオンを行ってました。</p>
<h2 id="aws%E3%81%A8google-cloud%E3%81%AEregistry" data-line="154" class="code-line">
<a class="header-anchor-link" href="#aws%E3%81%A8google-cloud%E3%81%AEregistry" aria-hidden="true"></a> awsとGoogle Cloudのregistry</h2>
<p data-line="155" class="code-line">この２大クラウドのレジストリはきっとよく使う事になると思われるので自身のためにもリンク貼り。</p>
<h3 id="aws%E3%81%AE%E3%83%AA%E3%83%A2%E3%83%BC%E3%83%88%E3%83%A2%E3%82%B8%E3%83%A5%E3%83%BC%E3%83%AB(registry)" data-line="157" class="code-line">
<a class="header-anchor-link" href="#aws%E3%81%AE%E3%83%AA%E3%83%A2%E3%83%BC%E3%83%88%E3%83%A2%E3%82%B8%E3%83%A5%E3%83%BC%E3%83%AB(registry)" aria-hidden="true"></a> awsのリモートモジュール(registry)</h3>
<p data-line="158" class="code-line">awsのリモートモジュール集の探索はこちら。<br style="display:none">
<span class="embed-block zenn-embedded zenn-embedded-card"><iframe id="zenn-embedded__29a3281d56bbd" src="https://embed.zenn.studio/card#zenn-embedded__29a3281d56bbd" data-content="https%3A%2F%2Fregistry.terraform.io%2Fsearch%2Fmodules%3Fnamespace%3Dterraform-aws-modules" frameborder="0" scrolling="no" loading="lazy"></iframe></span><a href="https://registry.terraform.io/search/modules?namespace=terraform-aws-modules" style="display:none" target="_blank" rel="nofollow noopener noreferrer">https://registry.terraform.io/search/modules?namespace=terraform-aws-modules</a></p>
<h3 id="google-cloud(registry)" data-line="161" class="code-line">
<a class="header-anchor-link" href="#google-cloud(registry)" aria-hidden="true"></a> Google cloud(registry)</h3>
<p data-line="162" class="code-line">Google cloudのリモートモジュール集の探索はこちら。<br style="display:none">
<span class="embed-block zenn-embedded zenn-embedded-card"><iframe id="zenn-embedded__236884afa0fcc" src="https://embed.zenn.studio/card#zenn-embedded__236884afa0fcc" data-content="https%3A%2F%2Fregistry.terraform.io%2Fsearch%2Fmodules%3Fnamespace%3Dterraform-google-modules" frameborder="0" scrolling="no" loading="lazy"></iframe></span><a href="https://registry.terraform.io/search/modules?namespace=terraform-google-modules" style="display:none" target="_blank" rel="nofollow noopener noreferrer">https://registry.terraform.io/search/modules?namespace=terraform-google-modules</a></p>
<p data-line="165" class="code-line"><strong>さいごに</strong><br>
そもそも当初はこの２大クラウドのregistryのモジュールを使って基本的なリソース作成を行ってみるような内容にしようと思ったのですが、入りのモジュールについての把握(ドキュメント読み)を始めたら思いのほか時間がかかってしまい記事もただの説明オンリーになってしまいました。<br>
次は実際に使ってリソース作成を試みる、という宣言で今回はこれにて終了。</p>


terraform モジュールとは（基本内容のメモ）

モジュールブロック(呼び出し側)

モジュールソース(呼び出される側)

公式docメモ(モジュールブロック、モジュールソース)

awsのリモートモジュール(registry)

Discussion