tfm

HashiCorp Implementation Services (IS) has identified a need to develop a purpose built tool to assist our engagements and customers during:

• Terraform open source / community edition / core to Terraform Cloud (TFC) & Terraform Enterprise (TFE)
• TFE to TFC
• TFC to TFE
• 1 TFC Organization to another TFC Organization
• TFE Server / Organization Consolidation

Warning

This CLI does not have official support, but the code owners will work with partners and interested parties to provide assitance when possible. Check out our case studies.

Overview

This tool has been develop to assist HashiCorp Implementation Services, Partners and Customers with their migrations to HashiCorp services. Having a tool allows us the ability to offer a standardized offering to our customers.

Check out the full documentation at https://hashicorp-services.github.io/tfm/

Installation

Binaries are created as part of a release, check out the Release Page for the latest version.

Migration Type

There are differences between Terraform OSS / CE / Core migrations and Terraform Enterprise & Terraform Cloud Migrations. Accordingly this Readme has been split between two pages tfe migration and ce migration

tfm in a Pipeline

tfm can be used in a pipeline to automate migrations. There are a few considerations when using tfm in this manner.

• For source and destination credentials use environment variables from the pipeline's secrete manager or other secure means. Don't embed these credentials in tfm configuration files
• Several tfm commands require confirmation before proceeding, which are listed below. To override these in a pipeline, add the --autoapprove flag.
  • copy workspaces Only when all workspaces are going to be migrated due to no workspace list, or map defined.
  • copy workspaces --state --last
  • delete workspace
  • delete workspaces-vcs
  • nuke

Architectural Decisions Record (ADR)

An architecture decision record (ADR) is a document that captures an important architecture decision made along with its context and consequences.

This project will store ADRs in docs/ADR as a historical record.

More information about ADRs.

To build

make build-local
./tfm -v

-or-

go run . -v

To release

To create a new release of TFM

• Use GitHub Action Release tfm
• Specify a version number. Please follow semantic versioning for the release.

This action will do the following steps

• Compile TFM for Linux, Mac, Windows with amd64 and arm64 versions
• Upload the artifacts
• Create a new release + tag on the repo at the current main

Reporting Issues

If you believe you have found a defect in tfm or its documentation, use the GitHub issue tracker to report the problem to the tfm maintainers.