Release Commands

Manage Terraform Enterprise and Replicated releases and binaries needed for airgap installations.

These commands are typically used for those running the Self-Managed Terraform Enterprise platform, and do not apply to Terraform Cloud.

Note: These commands do not communicate with Terraform Enterprise but leverage the replicated REST endpoints.

Authentication

Authentication for tfx release tfe Commands do not use an API Token, rather a "License Id" and "Password", these values are given to Customers after purchasing Terraform Enterprise.

There is no authentication needed for tfx release replicated Commands.

tfx release tfe list

List available Terraform Enterprise releases.

--max-items defaults to 10, setting this to a higher number will retrieve more items.

Note: Only releases you are licensed for will show up in this list (typically starting with the latest available version on the date of the purchase).

Example

$ tfx release tfe list
Using config file: /Users/tstraub/.tfx.hcl
List Available Terraform Enterprise Releases 
╭──────────┬───────────┬──────────┬───────────────────────╮
│ SEQUENCE │ LABEL     │ REQUIRED │ RELEASE DATE          │
├──────────┼───────────┼──────────┼───────────────────────┤
│      651 │ v202208-2 │ false    │ Fri Aug 12 16:12 2022 │
│      647 │ v202208-1 │ false    │ Wed Aug 10 20:57 2022 │
│      642 │ v202207-2 │ true     │ Fri Jul 15 19:07 2022 │
│      641 │ v202207-1 │ false    │ Wed Jul 13 18:29 2022 │
│      636 │ v202206-1 │ false    │ Wed Jun 15 17:06 2022 │
│      619 │ v202205-1 │ false    │ Tue May 17 19:58 2022 │
│      610 │ v202204-2 │ true     │ Wed Apr 20 22:47 2022 │
│      609 │ v202204-1 │ false    │ Tue Apr 19 16:10 2022 │
│      607 │ v202203-1 │ false    │ Wed Mar 23 18:22 2022 │
│      599 │ v202202-1 │ false    │ Wed Feb 23 18:18 2022 │
╰──────────┴───────────┴──────────┴───────────────────────╯

tfx release tfe show

Show details of a Terraform Enterprise release, including release notes.

Example:

$ tfx release tfe show -r 651
Using config file: /Users/tstraub/.tfx.hcl
Show Release details for Terraform Enterprise: 651
Release Sequence: 651
Label:            v202208-2
Release Date:     Fri Aug 12 16:12 2022
Required:         false
Release Notes:    
# TFE Release v202208-2

CHANGES SINCE v202208-1:

<redacted>

tfx release tfe download

Download a Terraform Enterprise airgap binary to a directory of your choice (defaults to local directory).

Note: This file is at least 1GB in size, this command can take a while, but a status will print progress.

Example:

$ tfx release tfe download -r 651
Using config file: /Users/tstraub/.tfx.hcl
Download Release binary for Terraform Enterprise: 651
Downloading from URL: <redacted>
Download Started: ./tfe-651.release
 Download Status: (1.10%) of 1.3G
 Download Status: (2.55%) of 1.3G
 Download Status: (3.83%) of 1.3G
 Download Status: (5.09%) of 1.3G
 ...
 Download Status: (98.09%) of 1.3G
 Download Status: (99.48%) of 1.3G
Release Downloaded! 

tfx release replicated list

List available Replicated releases.

--max-items defaults to 10, setting this to a higher number will retrieve more items.

Note: This file is at least 1GB in size, this command can take a while, but a status will print progress.

Example:

$ tfx release replicated list
Using config file: /Users/tstraub/.tfx.hcl
List Available Replicated Releases 
╭─────────┬─────────────────────────────────╮
│ VERSION │ PUBLISHED DATE                  │
├─────────┼─────────────────────────────────┤
│ 2.53.7  │ Fri, 24 Jun 2022 00:00:00 -0800 │
│ 2.53.6  │ Thu, 31 Mar 2022 00:00:00 -0800 │
│ 2.53.5  │ Thu, 17 Mar 2022 00:00:00 -0800 │
│ 2.53.4  │ Sat, 12 Mar 2022 00:00:00 -0800 │
│ 2.53.3  │ Fri, 11 Mar 2022 01:00:00 -0800 │
│ 2.53.2  │ Fri, 19 Nov 2021 12:00:00 -0800 │
│ 2.53.1  │ Thu, 23 Sep 2021 12:00:00 -0800 │
│ 2.53.0  │ Tue, 10 Aug 2021 12:00:00 -0800 │
│ 2.52.0  │ Thu, 20 May 2021 12:00:00 -0800 │
│ 2.51.3  │ Tue, 30 Mar 2021 12:00:00 -0800 │
╰─────────┴─────────────────────────────────╯

tfx release replicated download

Download a Replicated release binary to a directory of your choice (defaults to local directory).

Example:

$tfx release replicated download -v 2.53.7
Using config file: /Users/tstraub/.tfx.hcl
Download Release binary for Replicated: 2.53.7
Downloading from URL: https://s3.amazonaws.com/replicated-airgap-work/stable/replicated-2.53.7%2B2.53.7%2B2.53.7.tar.gz
Download Started: ./replicated-2.53.7.targz
 Download Status: (1.65%) of 1G
 Download Status: (3.57%) of 1G
 Download Status: (5.27%) of 1G
 Download Status: (7.09%) of 1G
 ...
 Download Status: (95.65%) of 1G
 Download Status: (97.07%) of 1G
 Download Status: (98.83%) of 1G
Release Downloaded!