terraform-local を Homebrew, Nix でインストール

プロジェクトリンク

• ホームページ

コマンドとエイリアス

• tflocal
• tflocal.bat

プロジェクトの歴史

The localstack/terraform-local repository was created on GitHub in March 2022. Its README describes a small wrapper script that uses Terraform's override mechanism to create a temporary `localstack_providers_override.tf` file, causing AWS provider endpoints to point to LocalStack, usually at `http://localhost:4566`.

The README's changelog starts at v0.1 and records a steady series of practical compatibility fixes: custom endpoints, `-chdir` support, provider aliases, local S3 backend handling, AWS provider version compatibility, multi-account support, semantic versioning, `AWS_ENDPOINT_URL`, dry-run behavior, additional override locations, and Terraform AWS provider 6 beta support.

採用の歴史

terraform-local's adoption is tied to LocalStack's broader use as a local AWS emulator. Developers install `tflocal` when they want Terraform plans and applies to provision local AWS-like resources without rewriting normal Terraform modules for a test environment.

The input package facts list Homebrew and Nix packaging, while the official README recommends pipx and also documents virtualenv installation. That split is typical for Python CLIs that are useful both to Python package users and to infrastructure engineers who prefer system package managers.

使われ方

The main usage model is intentionally simple: run `tflocal` with the same arguments one would pass to `terraform`. The wrapper writes temporary provider override files, sets LocalStack service endpoints, and then invokes the configured Terraform command.

The README exposes most behavior through environment variables such as `DRY_RUN`, `TF_CMD`, `AWS_ENDPOINT_URL`, `S3_HOSTNAME`, `USE_EXEC`, service-specific endpoint variables, `AWS_DEFAULT_REGION`, `AWS_ACCESS_KEY_ID`, `SKIP_ALIASES`, and `ADDITIONAL_TF_OVERRIDE_LOCATIONS`.

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

terraform-local is package-nerd significant because it is deliberately a wrapper rather than a fork or provider. It preserves the user's Terraform CLI muscle memory while interposing just enough endpoint configuration to make LocalStack work as a local target.

For users curating developer machines, CI images, or reproducible test environments, `tflocal` is the installable bridge between Terraform's upstream binary and LocalStack's AWS emulation.

タイムライン

• 2022: GitHub repository created.
• 2022: README changelog records v0.1 as the initial release.
• 2023: Changelog entries added provider aliases, S3 backend support, and multi-account support.
• 2024: Changelog records semantic versioning and `AWS_ENDPOINT_URL` support in v0.16.0.
• 2025: Changelog records Terraform AWS provider 6.0.0-beta2 compatibility in v0.23.1.
• 2026: Repository remained active during research.

Related projects

• The official documentation and README tie terraform-local to LocalStack, Terraform, the Terraform AWS provider, Terraform override files, and local S3 backend workflows.

ソース

• https://api.github.com/repos/localstack/terraform-local
• https://docs.localstack.cloud/aws/integrations/infrastructure-as-code/terraform
• https://github.com/localstack/terraform-local#readme
• source_facts.package-manager