インフラ自動化の第一歩!Terraformをローカル環境にセットアップする方法
![](https://saito-tech.jpn.org/wp-content/uploads/2024/08/terraform-setup1.webp)
![ブログ運営者](https://saito-tech.jpn.org/wp-content/uploads/2024/02/saito_icon1.png)
閲覧いただきありがとうございます!"さいとう"と申します。わたしは異業種・未経験からIT業界に転職し、現在インフラエンジニアとしてクラウド環境の設計や構築・運用の支援を行っています。
現在、AWSのインフラをマネージメントコンソールを使って構築している方の中には、コードを使ってインフラを構築してみたいと考えている方も多いのではないでしょうか。これがいわゆるIaC(Infrastructure as Code)と呼ばれる手法です。
IaCを活用することで、手動操作によるミスを減らし、インフラの再現性や自動化を高めることができます。AWSで利用できるIaCツールとしては、AWSの公式ツールであるAWS CDK(Cloud Development Kit)やAWS CloudFormationがありますが、それに加えて非常に人気が高いのがTerraformです。
Terraformはクラウドプロバイダーに依存せず、多くのプラットフォームに対応している点が特徴で、柔軟かつ強力なインフラ自動化ツールとして、広く利用されています。今回の記事では、このTerraformを使ってAWSリソースを構築するための環境準備について紹介します。
Terraformを使用するためのセットアップ手順、初期設定、そして基本的な操作方法について詳しく解説します。これを読めば、実際にTerraformを用いてAWSインフラをコードで管理するための第一歩を踏み出すことができるでしょう。
インフラエンジニアとして、またはクラウド環境を効率的に管理したい方にとって、IaCのスキルは今後ますます重要になっていきます。この機会にTerraformを学び、インフラの自動化を進めていきましょう。この記事が、Terraformを活用したインフラ管理の基礎を理解するための助けとなれば幸いです。
AWSでTerraformを使う準備
■Terraformとは
![](https://saito-tech.jpn.org/wp-content/uploads/2024/08/terraform-setup2.webp)
Terraform は、クラウドおよびオンプレミスのリソースを安全かつ効率的に構築、変更、バージョン管理できるコードツールとしてのインフラストラクチャです。公式webサイトより
●Terraformを利用するメリット
わたしがTerraformを利用していて感じたメリットを3つ紹介します。
- Terraformで利用する言語"HCL言語"がわかりやすい
- コードでインフラを構築するので、そのままドキュメントとしても使える
- 一回書けば、再利用できて作業時間が減る
■前提条件
今回の記事では、Terraformを利用するための環境準備を紹介します。
以下が前提条件です。
- AWSアカウントを持っている
- ローカルPCのOSがWindows
- Visual Studio Code(VS Code)インストール済み
■Terraform用IAMユーザー作成
まずはAWSアカウントでTerraform用のIAMユーザーを作成します。
↓サービス検索窓で[IAM]と検索します。
![](https://saito-tech.jpn.org/wp-content/uploads/2024/08/terraform-setup3.webp)
↓左のナビゲーションペインから[Users]をクリックし、[Add users]を押します。
![](https://saito-tech.jpn.org/wp-content/uploads/2024/08/terraform-setup4.webp)
↓必要事項を入力し、[Next]をクリックします。
![](https://saito-tech.jpn.org/wp-content/uploads/2024/08/terraform-setup5.webp)
↓与える権限は任意で設定してください。
![](https://saito-tech.jpn.org/wp-content/uploads/2024/08/terraform-setup6.webp)
↓内容に問題なければ、[Create user]をクリックします。
![](https://saito-tech.jpn.org/wp-content/uploads/2024/08/terraform-setup7.webp)
↓
![](https://saito-tech.jpn.org/wp-content/uploads/2024/08/terraform-setup8.webp)
↓作成したIAMユーザーの[Security credentials]タブをクリックし、[Create access key]を押します。
![](https://saito-tech.jpn.org/wp-content/uploads/2024/08/terraform-setup9.webp)
↓[Command Line Interface]を選択し、[Next]をクリックします。
![](https://saito-tech.jpn.org/wp-content/uploads/2024/08/terraform-setup10.webp)
↓[Description tag value]に任意の文字を入力し、[Create access key]を押します。
![](https://saito-tech.jpn.org/wp-content/uploads/2024/08/terraform-setup11.webp)
↓表示された[Access key]・[Secret access key]をメモするか、csvファイルをダウンロードしておいてください。
![](https://saito-tech.jpn.org/wp-content/uploads/2024/08/terraform-setup12.webp)
IAMユーザー作成は以上です。
■AWS CLIインストール
AWS CLIをインストールします。
↓AWS公式ドキュメントにアクセスし、インストーラをダウンロードします。
![](https://saito-tech.jpn.org/wp-content/uploads/2024/08/terraform-setup13.webp)
↓
![](https://saito-tech.jpn.org/wp-content/uploads/2024/08/terraform-setup14.webp)
↓ダウンロードしたファイルをクリックします。
![](https://saito-tech.jpn.org/wp-content/uploads/2024/08/terraform-setup15.webp)
↓環境に合わせて設定してください。
![](https://saito-tech.jpn.org/wp-content/uploads/2024/08/terraform-setup16.webp)
↓
![](https://saito-tech.jpn.org/wp-content/uploads/2024/08/terraform-setup17.webp)
↓
![](https://saito-tech.jpn.org/wp-content/uploads/2024/08/terraform-setup18.webp)
↓インストールが完了しましたら、PowerShellで以下のコマンドを実行してください。
aws --version
![](https://saito-tech.jpn.org/wp-content/uploads/2024/08/terraform-setup19.webp)
↓以下のコマンドで、初期設定を行います。–profileオプションは名前付きプロファイル作成の設定です。
aws configure --profile terraform
【実行結果】
PS C:\Users> aws configure --profile terraform
AWS Access Key ID [None]: <アクセスキー>
AWS Secret Access Key [None]: <シークレットアクセスキー>
Default region name [None]: ap-northeast-1
Default output format [None]: json
![](https://saito-tech.jpn.org/wp-content/uploads/2024/08/terraform-setup20.webp)
AWS CLIインストールは以上です。
■Gitインストール
GitBashを利用するために、Gitをインストールします。
↓公式webサイトにアクセスし、環境に合わせたインストーラをダウンロードしてください。
![](https://saito-tech.jpn.org/wp-content/uploads/2024/08/terraform-setup21.webp)
↓
![](https://saito-tech.jpn.org/wp-content/uploads/2024/08/terraform-setup22.webp)
↓ダウンロードが完了したら、設定ウィザードを起動しましょう。
![](https://saito-tech.jpn.org/wp-content/uploads/2024/08/terraform-setup23.webp)
↓任意の設定で進めてください。
![](https://saito-tech.jpn.org/wp-content/uploads/2024/08/terraform-setup24.webp)
↓
![](https://saito-tech.jpn.org/wp-content/uploads/2024/08/terraform-setup25.webp)
↓インストールが完了したら、PowerShellで以下のコマンドを実行しください。
git version
![](https://saito-tech.jpn.org/wp-content/uploads/2024/08/terraform-setup26.webp)
Gitインストールは以上です。
■Terraformインストール
本命のTerraformをインストールしていきます。今回はTerraformのバージョン管理ができる"tfenv"を利用して、Terraformをインストールしましょう。
↓エクスプローラーで自身のユーザーディレクトリにアクセスし、右クリックで[Git Bash Here]をクリックしてください。
![](https://saito-tech.jpn.org/wp-content/uploads/2024/08/terraform-setup27.webp)
↓https://github.com/tfutils/tfenv でクローンするURLを確認します。
![](https://saito-tech.jpn.org/wp-content/uploads/2024/08/terraform-setup28.webp)
↓GitBashコマンドラインで以下のコマンドを実行してください。
git clone https://github.com/tfutils/tfenv.git .tfenv
![](https://saito-tech.jpn.org/wp-content/uploads/2024/08/terraform-setup29.webp)
↓リポジトリをクローン出来たことを確認します。
![](https://saito-tech.jpn.org/wp-content/uploads/2024/08/terraform-setup30.webp)
↓次にパスを設定します。先ほどのディレクトリで右クリックを押し、[新規作成]→[テキストドキュメント]をクリックします。
![](https://saito-tech.jpn.org/wp-content/uploads/2024/08/terraform-setup31.webp)
↓ドキュメント名を以下の名前で作成します。
.bashrc
![](https://saito-tech.jpn.org/wp-content/uploads/2024/08/terraform-setup32.webp)
↓ドキュメントを環境に合わせて以下のように編集してください。
export PATH=$PATH:/<.tfenv配下のbinフォルダ絶対パス>
![](https://saito-tech.jpn.org/wp-content/uploads/2024/08/terraform-setup33.webp)
↓ドキュメントが作成できたら、右クリックから[Git Bash Here]を押して再起動します。
![](https://saito-tech.jpn.org/wp-content/uploads/2024/08/terraform-setup34.webp)
↓
![](https://saito-tech.jpn.org/wp-content/uploads/2024/08/terraform-setup35.webp)
↓以下のコマンドを実行し、パスが通ることを確認してください。
tfenv
![](https://saito-tech.jpn.org/wp-content/uploads/2024/08/terraform-setup36.webp)
↓次にTerraformをインストールしますので、インストール可能なバージョンを確認します。
tfenv list-remote
![](https://saito-tech.jpn.org/wp-content/uploads/2024/08/terraform-setup37.webp)
↓
![](https://saito-tech.jpn.org/wp-content/uploads/2024/08/terraform-setup38.webp)
↓今回は最新バージョンがアルファ版とベータ版なので、一つ前のバージョンをインストールします。
![](https://saito-tech.jpn.org/wp-content/uploads/2024/08/terraform-setup39.webp)
↓以下のコマンドを実行してください。
tfenv install 1.4.6
![](https://saito-tech.jpn.org/wp-content/uploads/2024/08/terraform-setup40.webp)
↓
![](https://saito-tech.jpn.org/wp-content/uploads/2024/08/terraform-setup41.webp)
↓インストールが完了したら、以下のコマンドで使用するTerraformのバージョンを指定します。
tfenv use 1.4.6
![](https://saito-tech.jpn.org/wp-content/uploads/2024/08/terraform-setup42.webp)
↓
![](https://saito-tech.jpn.org/wp-content/uploads/2024/08/terraform-setup43.webp)
↓以下のコマンドで指定したバージョンのTerraformが設定されているか確認します。
terraform version
![](https://saito-tech.jpn.org/wp-content/uploads/2024/08/terraform-setup44.webp)
Terraformインストールは以上です。
■VSCode設定
さいごに、Visual Studio CodeにTerraformの拡張機能をインストールと、ターミナルのデフォルトシェルを変更します。Terraformの拡張機能は構文チェックをしてくれる便利機能が使えるのでオススメです。
↓VSCodeを起動し、左の拡張機能アイコンをクリックし、検索窓で[terraform]と検索します。
![](https://saito-tech.jpn.org/wp-content/uploads/2024/08/terraform-setup45.webp)
↓[HashiCorp Terraform]をクリックし、[インストール]を押します。
![](https://saito-tech.jpn.org/wp-content/uploads/2024/08/terraform-setup46.webp)
プラグインインストールは以上です。つぎにデフォルトシェルを変更しま
↓[File]→[Preferences]→[Settings]をクリックします。
![](https://saito-tech.jpn.org/wp-content/uploads/2024/08/terraform-setup55.webp)
↓検索窓で[terminal intergrated shell windows]と検索します。
![](https://saito-tech.jpn.org/wp-content/uploads/2024/08/terraform-setup56.webp)
↓[Default Profile Windows]を[Git Bash]に変更し、VSCodeを開きなおしましょう
![](https://saito-tech.jpn.org/wp-content/uploads/2024/08/terraform-setup57.webp)
Terraformを利用するための環境構築が完了しました。
■動作確認
Terraformを使ってAWSリソースを構築する環境が整いました。試しにTerraformを使って、EC2インスタンス起動してみましょう。
↓自身のドキュメントディレクトリ配下に[terraform]フォルダを作成します。
![](https://saito-tech.jpn.org/wp-content/uploads/2024/08/terraform-setup47.webp)
↓
![](https://saito-tech.jpn.org/wp-content/uploads/2024/08/terraform-setup48.webp)
↓VSCodeで作成した[terraform]フォルダを開きます。
![](https://saito-tech.jpn.org/wp-content/uploads/2024/08/terraform-setup49.webp)
↓[ファイル作成]アイコンをクリックし、[main.tf]と名前を付けます。
![](https://saito-tech.jpn.org/wp-content/uploads/2024/08/terraform-setup50.webp)
↓
![](https://saito-tech.jpn.org/wp-content/uploads/2024/08/terraform-setup51.webp)
↓[main.tf]に以下のドキュメントを貼り付けます。amiはマネコンで確認し、任意のamiを設定しください。
provider "aws" {
profile = "terraform"
region = "ap-northeast-1"
}
resource "aws_instance" "test_ec2" {
ami = "ami-0f9816f78187c68fb"
instance_type = "t2.micro"
}
![](https://saito-tech.jpn.org/wp-content/uploads/2024/08/terraform-setup52.webp)
↓[Terminal]→[New Terminal]をクリックします。
![](https://saito-tech.jpn.org/wp-content/uploads/2024/08/terraform-setup53.webp)
↓ターミナルで作業ディレクトリを初期化するコマンドを実行します。
terraform init
![](https://saito-tech.jpn.org/wp-content/uploads/2024/08/terraform-setup54.webp)
↓[Terraform has been successfully initialized!]と表示されればOKです。
![](https://saito-tech.jpn.org/wp-content/uploads/2024/08/terraform-setup59.webp)
↓つぎにコードをきれいに整えてくれるコマンドを実行します。
terraform fmt
![](https://saito-tech.jpn.org/wp-content/uploads/2024/08/terraform-setup60.webp)
↓
![](https://saito-tech.jpn.org/wp-content/uploads/2024/08/terraform-setup61.webp)
↓リソースを作成するまえに、何が作られるか確認できる[plan]を実行します。
terraform plan
![](https://saito-tech.jpn.org/wp-content/uploads/2024/08/terraform-setup62.webp)
↓EC2インスタンスが一つ作られることが確認できます。
![](https://saito-tech.jpn.org/wp-content/uploads/2024/08/terraform-setup63.webp)
↓さいごにAWSリソースを作成するコマンド[apply]を実行します。planで何が作られるか確認したので、実行確認を求められない[-auto-approve]オプションを付けます。
terraform apply -auto-approve
![](https://saito-tech.jpn.org/wp-content/uploads/2024/08/terraform-setup64.webp)
↓
![](https://saito-tech.jpn.org/wp-content/uploads/2024/08/terraform-setup65.webp)
↓作成されたかマネージメントコンソールで確認しましょう。
![](https://saito-tech.jpn.org/wp-content/uploads/2024/08/terraform-setup66.webp)
EC2インスタンスが作成されたのが確認できました。動作確認は以上です。
[terraform destroy]でリソースを消すことができますので、実施してみてください。
まとめ
今回の記事では、Terraformを利用するための「環境準備」について紹介しました。これでTerraformを使用してAWSインフラをコードで管理するための基盤が整いました。環境構築が完了したことで、これからは実際にTerraformを使ってさまざまなAWSリソースを構築することが可能です。
Terraformは、コードでインフラを定義することにより、インフラ管理の効率化や再現性の向上を実現します。単純なリソースの作成から、複雑なアーキテクチャのデプロイまで、柔軟に対応できるため、これからのインフラ運用において非常に強力なツールとなるでしょう。
次のステップとして、実際にAWSのさまざまなアーキテクチャを試し、コード化してみてください。例えば、VPCの作成や、EC2インスタンスのデプロイ、さらにはRDSの構築や負荷分散の設定など、実践的なシナリオを通じてTerraformの使い方を学んでいくことができます。
また、Terraformの強力な機能である状態管理や、モジュール化、変数の活用など、より高度な使い方にも挑戦してみましょう。これにより、大規模なインフラ管理でも効率的に対応できるようになります。
Terraformを使いこなすことで、インフラの自動化と効率化が進み、より信頼性の高い運用が可能になります。ぜひ、今回の環境準備をもとに、実際のプロジェクトでTerraformを活用してみてください。
参考リンク:Terraform公式webサイト
ディスカッション
コメント一覧
まだ、コメントがありません