Agent skill

manage-version

Terraform/Terragrunt のバージョンを管理する。「terraform バージョン」「tfenv」「tgswitch」「tf バージョン切り替え」「terraform インストール」「バージョン確認」「tf version」「terraform 1.5 にして」「tg バージョン」などで起動。

View SKILL.md on GitHub Repository
Stars 163
Forks 31

Install this agent skill to your Project

npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/data/manage-version

SKILL.md

Version Manager

tfenv/tgswitch を使用して Terraform/Terragrunt のバージョンを管理します。

対応操作

操作 トリガー例 コマンド
バージョン確認 「バージョン確認」「tf version」 terraform version
一覧表示 「インストール済み一覧」「tfenv list」 tfenv list
リモート一覧 「利用可能バージョン」「list-remote」 tfenv list-remote
インストール 「1.5.0 インストール」「install」 tfenv install
切り替え 「1.5.0 に切り替え」「use」 tfenv use

実行手順

1. ツールの確認

bash
# tfenv の確認
which tfenv && tfenv --version

# tgswitch の確認
which tgswitch && tgswitch --version

# tenv の確認（統合ツール）
which tenv && tenv --version

2. 現在のバージョン確認

Terraform:

bash
terraform version

Terragrunt:

bash
terragrunt --version

3. インストール済みバージョン一覧

tfenv:

bash
tfenv list

tgswitch:

bash
tgswitch --list-all

4. 利用可能なバージョン一覧

tfenv:

bash
tfenv list-remote | head -20

5. バージョンインストール

tfenv:

bash
tfenv install {version}
# 例: tfenv install 1.5.0
# 例: tfenv install latest

tgswitch:

bash
tgswitch {version}
# 例: tgswitch 0.50.0

6. バージョン切り替え

tfenv:

bash
tfenv use {version}
# 例: tfenv use 1.5.0

tgswitch:

bash
tgswitch {version}

tenv（統合ツール）:

bash
# Terraform バージョン切り替え
tenv tf use {version}
# 例: tenv tf use 1.5.0

# Terragrunt バージョン切り替え
tenv tg use {version}
# 例: tenv tg use 0.50.0

# インストール
tenv tf install {version}
tenv tg install {version}

# 一覧表示
tenv tf list
tenv tg list

7. 出力フォーマット

## バージョン情報

### 現在のバージョン
- Terraform: {version}
- Terragrunt: {version}

### インストール済み（Terraform）
| バージョン | 状態 |
|-----------|------|
| 1.5.0 | ✅ 使用中 |
| 1.4.6 | |
| 1.3.9 | |

### プロジェクト設定
- .terraform-version: {内容}
- .terragrunt-version: {内容}

バージョンファイル

.terraform-version

プロジェクトで使用する Terraform バージョンを固定:

1.5.0

tfenv は自動的にこのファイルを読み取ってバージョンを切り替えます。

.terragrunt-version

プロジェクトで使用する Terragrunt バージョンを固定:

0.50.0

required_version

versions.tf でバージョン制約を設定:

hcl
terraform {
  required_version = ">= 1.5.0, < 2.0.0"
}

バージョン管理ツールのインストール

tfenv

bash
# macOS
brew install tfenv

# 手動インストール
git clone https://github.com/tfutils/tfenv.git ~/.tfenv
echo 'export PATH="$HOME/.tfenv/bin:$PATH"' >> ~/.bashrc

tgswitch

bash
# macOS
brew install warrensbox/tap/tgswitch

# 手動インストール
curl -L https://raw.githubusercontent.com/warrensbox/tgswitch/release/install.sh | bash

tenv（統合ツール）

bash
# macOS
brew install tenv

# 手動インストール
curl -L https://tofuutils.github.io/tenv/install.sh | bash

注意事項

  • ✅ バージョン管理ツールを使うとプロジェクトごとにバージョンを切り替えられる
  • ✅ .terraform-version でチームでバージョンを統一
  • ✅ required_version で最低バージョンを保証
  • ⚠️ バージョンアップ時は互換性を確認

Didn't find tool you were looking for?

Be as detailed as possible for better results