# TerraformのWorkspaceで複数環境を切り替える方法

## 目次
1. はじめに
2. Terraform Workspaceとは
3. Workspaceの利点と用途
4. Workspaceの基本操作
   1. Workspaceの一覧表示
   2. Workspaceの作成
   3. Workspaceの切り替え
   4. Workspaceの削除
5. 実践：複数環境の切り替え
   1. 環境変数の設定と適用
   2. プロジェクト例：開発・本番環境の使い分け
6. トラブルシューティング
7. まとめ

## 1. はじめに
Terraformは、インフラストラクチャをコードとして管理するツールであり、一貫性と自動化を支える重要な役割を担っています。本記事では、特に環境の管理に焦点を当て、TerraformのWorkspace機能を用いてどのように複数環境を切り替えるかについて詳しく解説します。

## 2. Terraform Workspaceとは
TerraformのWorkspaceは、同一のTerraform設定で複数の分離された状態（state）を管理するための機能です。この機能を活用することで、開発環境と本番環境など、異なる環境を簡単に切り替えつつ管理が可能となります。

## 3. Workspaceの利点と用途
- 環境間の状態を分離して管理できるため、誤った環境に対する操作を防ぎやすくなります。
- 同じインフラ構成を手間なく分けて適用できるため、開発から本番への移行がスムーズになります。
- 環境ごとのリソースの管理や設定変更を容易に行うことができます。

## 4. Workspaceの基本操作

### 4-1. Workspaceの一覧表示
現在のワークスペースを表示し、利用可能なワークスペースを確認するには、以下のコマンドを使用します。
![img](/mosaic-code.jpg)

### 4-2. Workspaceの作成
新しいワークスペースを作成するには、以下のコマンドを実行します。例えば `dev` 環境を追加する場合：
![img](/mosaic-code.jpg)

### 4-3. Workspaceの切り替え
既存のワークスペースに切り替えるには、以下のコマンドを使います。例えば、本番環境 `production` に切り替えるには：
![img](/mosaic-code.jpg)

### 4-4. Workspaceの削除
不要となったワークスペースを削除するには、次の手順を使用します。現在のワークスペースは削除できないため、別のワークスペースに切り替えてから削除してください。
![img](/mosaic-code.jpg)

## 5. 実践：複数環境の切り替え

### 5-1. 環境変数の設定と適用
ワークスペースを利用して環境毎に別の設定を反映させたい場合、Terraformの設定ファイル（例: `vars.tf`）で環境変数を使用します。例えば、開発環境用と本番環境用の変数定義を切り替えることができます。

![img](/mosaic-code.jpg)

### 5-2. プロジェクト例：開発・本番環境の使い分け
具体的に異なるリソースサイズを持つ開発環境と本番環境をTerraformで作成する例を以下に示します。この種の設定は、`terraform.tfvars`ファイルで環境ごとの詳細な設定を保持することで実現可能です。

![img](/mosaic-code.jpg)

## 6. トラブルシューティング
- ワークスペースの切り替えに失敗した場合、適切な切り替え権限やスペルミスを確認してください。
- 不要なリソースの漏れがないかを確認するため、常に `terraform plan` で詳細を確認する習慣をつけましょう。

## 7. まとめ
Terraformのワークスペースを活用することで、異なる実行環境の構築と管理が容易になります。これにより、環境間の重複問題や誤操作の防止につながり、チーム全体で一貫したインフラ管理が可能です。次回は、環境間でのリソース共有と秘密情報の取り扱いについてさらに深堀りしていきます。 [cv:issue_marketplace_engineer]

# TerraformのWorkspaceで複数環境を切り替える方法

## 目次
1. はじめに
2. Terraform Workspaceとは
3. Workspaceの利点と用途
4. Workspaceの基本操作
   1. Workspaceの一覧表示
   2. Workspaceの作成
   3. Workspaceの切り替え
   4. Workspaceの削除
5. 実践：複数環境の切り替え
   1. 環境変数の設定と適用
   2. プロジェクト例：開発・本番環境の使い分け
6. トラブルシューティング
7. まとめ

## 1. はじめに
Terraformは、インフラストラクチャをコードとして管理するツールであり、一貫性と自動化を支える重要な役割を担っています。本記事では、特に環境の管理に焦点を当て、TerraformのWorkspace機能を用いてどのように複数環境を切り替えるかについて詳しく解説します。

## 2. Terraform Workspaceとは
TerraformのWorkspaceは、同一のTerraform設定で複数の分離された状態（state）を管理するための機能です。この機能を活用することで、開発環境と本番環境など、異なる環境を簡単に切り替えつつ管理が可能となります。

## 3. Workspaceの利点と用途
- 環境間の状態を分離して管理できるため、誤った環境に対する操作を防ぎやすくなります。
- 同じインフラ構成を手間なく分けて適用できるため、開発から本番への移行がスムーズになります。
- 環境ごとのリソースの管理や設定変更を容易に行うことができます。

## 4. Workspaceの基本操作

### 4-1. Workspaceの一覧表示
現在のワークスペースを表示し、利用可能なワークスペースを確認するには、以下のコマンドを使用します。
```bash
terraform workspace list
```

### 4-2. Workspaceの作成
新しいワークスペースを作成するには、以下のコマンドを実行します。例えば `dev` 環境を追加する場合：
```bash
terraform workspace new dev
```

### 4-3. Workspaceの切り替え
既存のワークスペースに切り替えるには、以下のコマンドを使います。例えば、本番環境 `production` に切り替えるには：
```bash
terraform workspace select production
```

### 4-4. Workspaceの削除
不要となったワークスペースを削除するには、次の手順を使用します。現在のワークスペースは削除できないため、別のワークスペースに切り替えてから削除してください。
```bash
terraform workspace delete obsolete_workspace
```

## 5. 実践：複数環境の切り替え

### 5-1. 環境変数の設定と適用
ワークスペースを利用して環境毎に別の設定を反映させたい場合、Terraformの設定ファイル（例: `vars.tf`）で環境変数を使用します。例えば、開発環境用と本番環境用の変数定義を切り替えることができます。

```hcl
variable "instance_type" {
  description = "Type of instance to use"
  default     = "t2.micro"

  dev     = "t2.small"
  prod    = "t2.large"
}

provider "aws" {
  region = var.region
}
```

### 5-2. プロジェクト例：開発・本番環境の使い分け
具体的に異なるリソースサイズを持つ開発環境と本番環境をTerraformで作成する例を以下に示します。この種の設定は、`terraform.tfvars`ファイルで環境ごとの詳細な設定を保持することで実現可能です。

```bash
# dev環境に切り替え
terraform workspace select dev

# 開発リソースの計画を立てる
terraform plan -var-file=dev.tfvars

# 本番環境に切り替え
terraform workspace select production

# 本番リソースの計画を立てる
terraform plan -var-file=prod.tfvars
```

## 6. トラブルシューティング
- ワークスペースの切り替えに失敗した場合、適切な切り替え権限やスペルミスを確認してください。
- 不要なリソースの漏れがないかを確認するため、常に `terraform plan` で詳細を確認する習慣をつけましょう。

## 7. まとめ
Terraformのワークスペースを活用することで、異なる実行環境の構築と管理が容易になります。これにより、環境間の重複問題や誤操作の防止につながり、チーム全体で一貫したインフラ管理が可能です。次回は、環境間でのリソース共有と秘密情報の取り扱いについてさらに深堀りしていきます。 

TerraformのWorkspaceで複数環境を切り替える方法

目次

続きを読むには単価診断を受けてください（30秒）