Automic VaultAutomic Vault

brew

tfmigrate を Homebrew, MacPorts, Nix でインストール

tfmigrate のインストール経路、実行ファイル、メタデータ、AI エージェント向けセキュリティノートを確認します。

インストール

追加のインストールコマンド

macOS

Homebrew確認済み · 100%
brew install tfmigrate

local Homebrew formula metadata

MacPorts確認済み · 94%
sudo port install tfmigrate

MacPorts ports tree · sysutils/tfmigrate/Portfile · ソース: api.github.com

Linux

Nix確認済み · 92%
nix profile install nixpkgs#tfmigrate

nixpkgs package indexes · pkgs/by-name/tf/tfmigrate/package.nix · ソース: api.github.com

概要

パッケージ概要

Terraform/OpenTofu state migration tool for GitOps

コマンドとエイリアス

  • tfmigrate

履歴

プロジェクトの歴史と使われ方

tfmigrate is a Terraform and OpenTofu state migration tool for GitOps. Its README frames Terraform state operations as code: write state moves, removals, imports, and related operations in HCL, review them in git, then plan and apply them in sequence.

プロジェクトの歴史

The project was created to address a common production Terraform problem: state manipulations are unavoidable during refactoring, but raw `terraform state` commands are error-prone and do not fit well into pull-request and CI/CD workflows. tfmigrate's README explicitly argues that state operations should be committed to git.

The tool wraps Terraform or OpenTofu under the hood rather than reimplementing their state mechanics. It supports dry-run planning with temporary local state, migration history, local/S3/GCS storage for applied migration records, monorepo-style state splits and merges, and migration files written as HCL.

Recent release notes show continuing maintenance for the changing Terraform ecosystem, including support for OpenTofu versions, Terraform 1.11 through 1.15, Terragrunt CLI redesign handling, configurable environment injection into `.tfmigrate.hcl`, and GitHub Actions and Go toolchain updates.

採用の歴史

The repository shows more than a thousand GitHub stars and is packaged by Homebrew, MacPorts, and Nix in the input metadata. That adoption profile fits a tool used by infrastructure teams with long-lived Terraform states and CI-based review.

tfmigrate's appeal is strongest for teams that already use GitOps: it lets state migrations travel with the configuration change they support, instead of being performed manually before or after a merge.

使われ方

The documented workflow is to write a migration file such as `state_mv.hcl`, run `tfmigrate plan` to verify the state operation against Terraform plan output without updating remote state, and then run `tfmigrate apply` to push the migrated state when the plan is clean.

tfmigrate can invoke `terraform`, `tofu`, or Terragrunt via `TFMIGRATE_EXEC_PATH`, and the README recommends trying the included sandbox before using the tool on production state.

パッケージ好きにとっての重要性

tfmigrate is important in package metadata because it solves a lifecycle problem that plain Terraform intentionally leaves low-level. It turns one-off state surgery into reviewable, repeatable migration files.

As a package-manager tool, it is most useful when installed in CI images and developer machines beside Terraform/OpenTofu, making the same state migration command available during local rehearsal and automated review.

タイムライン

  • 2025: v0.4.2 release notes add OpenTofu 1.9, Terraform 1.11, Terragrunt CLI redesign handling, and environment injection into `.tfmigrate.hcl`.
  • 2025: v0.4.3 release notes add OpenTofu 1.10 and Terraform 1.12 support.
  • 2025: v0.4.4 release notes add OpenTofu 1.11 and Terraform 1.14 support.
  • 2026: v0.4.5 is listed as the latest release and includes Terraform 1.15 support.

Related projects

  • Terraform and OpenTofu are the execution engines tfmigrate invokes.
  • Terragrunt is supported through `TFMIGRATE_EXEC_PATH` with version-specific guidance.
  • Digger is mentioned in recent release notes as an integration example.

セキュリティ状態

リスクレベル: グリーン

narrow executable package without higher-risk signals.

リスク分類器

リスク グリーン · 信頼度 低 · appliance

理由

  • narrow executable package without higher-risk signals

信号

  • metadata:no-higher-risk-signals

インストール挙動

  • formula メタデータに Homebrew post-install フックは記録されていません。
  • Homebrew bottle メタデータは 6 個のプラットフォームターゲットで利用できます。
  • ビルドメタデータには 1 件のビルド依存関係があります。

推奨レビュー

エージェントに無人実行させる前に、このツールが平文の認証情報を読むか、リモート状態を書き込むか、成果物を公開するか、プラグインを起動するかを確認してください。

local files

Configuration and credential file locations

These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval.

Configuration files

Config paths the tool may read or write during local use.

Unix
.tfmigrate.hcl

実行可能ファイル

インストールされる実行可能ファイル

コマンド種類公開範囲メモ
tfmigratecliグローバル実行可能ファイル

鮮度

バージョンと鮮度

これらの信号は、ページ生成時期、パッケージマネージャの活動、上流リリース比較を分けて示します。バージョン遅れは、証拠 URL と比較可能なバージョンがある場合だけ警告されます。

ページ生成日2026-07-26
マネージャ版0.4.5
マネージャ更新日2026-05-15
ローカルデータOK
上流最新
検出された最新v0.4.5

https://github.com/minamijoyo/tfmigrate

  • OK鮮度警告は生成されていません。

インストールメタデータ

パッケージメタデータ

パッケージキーbrew:tfmigrate
バージョン0.4.5
パッケージマネージャHomebrew
パッケージマネージャページhttps://formulae.brew.sh/formula/tfmigrate
ホームページhttps://github.com/minamijoyo/tfmigrate
リポジトリhttps://github.com/minamijoyo/tfmigrate
上流ドキュメントhttps://github.com/minamijoyo/tfmigrate
ライセンスMIT
ソースアーカイブhttps://github.com/minamijoyo/tfmigrate/archive/refs/tags/v0.4.5.tar.gz
最終更新2026-05-15T01:31:36+09:00
Pulseupdated
ビルド依存関係go
Bottle利用可能 (対象 arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux)
Homebrew post-install未定義
サービス宣言なし

レジストリ情報

ソースデータベース詳細

Source DatabaseHomebrew formula API
Taphomebrew/core
Full Nametfmigrate
Version Scheme0
Revision0
Head VersionHEAD
Bottle Stable Root URLhttps://ghcr.io/v2/homebrew/core
Deprecatedno
Disabledno
Keg Onlyno
URL Keys
  • head
  • stable

ソースデータベース一致

他のパッケージマネージャ記録

一致は外部パッケージマネージャインデックスから取得され、ローカルの Automic Vault パッケージリンクとは分けて表示されます。

Nix95%

tfmigrate

nix profile install nixpkgs#tfmigrate
  • normalized package name match
  • 一致条件: Tfmigrate
nixpkgs package indexes · api.github.com · nixpkgs package indexes: pkgs/by-name/tf/tfmigrate/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1
MacPorts95%

tfmigrate

sudo port install tfmigrate
  • normalized package name match
  • 一致条件: Tfmigrate
MacPorts ports tree · api.github.com · MacPorts ports tree: sysutils/tfmigrate/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1

ソース経路

リポジトリデータから生成

このページは scripts/generate-pkg-sqlite.py が生成した非公開のパッケージ SQLite アーティファクトから av-web によって提供されます。

使用ソース

  • Geiger risk classifier
  • Nucleus package database
  • av.db category and tag curation
  • cross-ecosystem install command graph
  • curated configuration and credential file locations
  • curated package history
  • external package-manager database matches
  • package relationship graph
  • package version freshness
  • package-page enrichment