トラブルシューティング

サポートチャネルの紹介

Terraformを使用する際に問題が発生した場合や、質問がある場合に利用できるサポートチャネルを紹介します。適切なチャネルを選択することで、効率的に問題を解決できます。

最終更新: 2026/2/3

サポートチャネルの紹介

公式ドキュメント

Terraform Documentation

最も基本的で重要な情報源です。

URL: https://developer.hashicorp.com/terraform/docs

内容:

Terraformの基本概念
言語仕様（HCL）
CLIコマンドリファレンス
プロバイダーの使用方法
ベストプラクティス

活用方法:

検索機能を使用して関連トピックを探す
各プロバイダーのドキュメントを参照
チュートリアルで実践的な学習

Terraform Tutorials

ステップバイステップのチュートリアルが提供されています。

URL: https://developer.hashicorp.com/terraform/tutorials

主なチュートリアル:

Get Started - AWS
Get Started - Azure
Get Started - Google Cloud
Configuration Language
Modules
State Management
Cloud Integration

Terraform Registry

プロバイダーとモジュールのドキュメントが集約されています。

URL: https://registry.terraform.io/

活用方法:

プロバイダーのドキュメントを検索
公開されているモジュールを探す
リソースとデータソースのリファレンスを確認

コミュニティサポート

HashiCorp Discuss

HashiCorp公式のコミュニティフォーラムです。

URL: https://discuss.hashicorp.com/c/terraform-core/

特徴:

HashiCorpのエンジニアが参加
活発なコミュニティ
過去の質問と回答を検索可能

利用方法:

アカウントを作成
質問を投稿する前に既存のトピックを検索
質問する際は、エラーメッセージや設定ファイルを含める

GitHub Issues

Terraformのバグ報告や機能リクエストはGitHubで管理されています。

URL: https://github.com/hashicorp/terraform/issues

利用シーン:

バグを発見した場合
新機能のリクエスト
既知の問題を確認

注意事項:

質問はDiscussフォーラムを使用
バグ報告には再現手順を含める
既存のIssueを検索してから新規作成

Stack Overflow

プログラミング全般の質問サイトですが、Terraformの質問も多数あります。

URL: https://stackoverflow.com/questions/tagged/terraform

タグ:

terraform
terraform-provider-aws
terraform-provider-azure
terraform-provider-google

活用方法:

質問する前に既存の回答を検索
質問にはterraformタグを付ける
コードと設定ファイルを含める

プロバイダー固有のサポート

商用サポート

Terraform Cloud

Terraform Cloudの有料プランでは、サポートが含まれています。

URL: https://www.hashicorp.com/products/terraform/pricing

サポート内容:

Team & Governance: ビジネスアワーサポート
Business: 24/7サポート

HashiCorp Enterprise Support

大規模な組織向けのエンタープライズサポートです。

特徴:

専任のサポートエンジニア
SLA保証
トレーニングとコンサルティング

学習リソース

公式ブログ

HashiCorpの公式ブログでは、新機能やベストプラクティスが紹介されています。

URL: https://www.hashicorp.com/blog/products/terraform

YouTube

HashiCorpの公式YouTubeチャンネルでは、チュートリアルやウェビナーが公開されています。

URL: https://www.youtube.com/@HashiCorp

効果的な質問の仕方

質問に含めるべき情報

Terraformのバージョン

terraform version

プロバイダーのバージョン

terraform {
  required_providers {
    aws = {
      source  = "hashicorp/aws"
      version = "~> 5.0"
    }
  }
}

エラーメッセージ

Error: creating EC2 Instance: UnauthorizedOperation: You are not authorized
to perform this operation.

関連する設定ファイル

resource "aws_instance" "web" {
  ami           = "ami-xxxxx"
  instance_type = "t2.micro"
}

実行したコマンド

terraform init
terraform plan
terraform apply

期待される動作と実際の動作

期待: EC2インスタンスが作成される
実際: 認証エラーが発生

質問のテンプレート

## 環境
- Terraform バージョン: 1.7.0
- プロバイダー: AWS 5.31.0
- OS: macOS 14.0

## 問題の説明
EC2インスタンスを作成しようとすると、認証エラーが発生します。

## 設定ファイル
```hcl
resource "aws_instance" "web" {
  ami           = "ami-xxxxx"
  instance_type = "t2.micro"
}

エラーメッセージ

Error: creating EC2 Instance: UnauthorizedOperation

試したこと

AWS認証情報を確認
IAMポリシーを確認

期待される動作

EC2インスタンスが正常に作成される


## トラブルシューティングのチェックリスト

質問する前に、以下を確認してください。

- [ ] 公式ドキュメントを確認した
- [ ] エラーメッセージで検索した
- [ ] `terraform validate`を実行した
- [ ] `terraform fmt`を実行した
- [ ] ログレベルをDEBUGに設定して確認した
- [ ] 既存のIssueやフォーラムの投稿を検索した

## セキュリティに関する報告

セキュリティの脆弱性を発見した場合は、公開せずに報告してください。

**報告先**: [https://www.hashicorp.com/security](https://www.hashicorp.com/security)

**注意事項**:
- 公開のIssueやフォーラムには投稿しない
- 詳細な再現手順を含める
- 影響範囲を明記する

## 次のステップ

サポートチャネルを理解したら、継続的な学習について学びましょう。

- [継続的な学習リソース](../next_steps/continuous_learning.md)

## 参考リンク

- [Terraform Documentation](https://developer.hashicorp.com/terraform/docs)
- [HashiCorp Discuss](https://discuss.hashicorp.com/c/terraform-core/)
- [Terraform GitHub](https://github.com/hashicorp/terraform)
- [Stack Overflow - Terraform](https://stackoverflow.com/questions/tagged/terraform)