Skip to content

Workspace Configuration Version Commands

Managing Workspace Configuration Versions in a Workspace.

tfx workspace configuration-version list

List all Configuration Versions for a supplied Workspace.

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

Example

Terminal window
$ tfx workspace configuration-version list --name tfx-test
Using config file: /Users/tstraub/.tfx.hcl
List Configuration Versions for Workspace: tfx-test
╭─────────────────────┬─────────────┬──────────┬──────┬────────┬────────┬─────────╮
ID SPECULATIVE STATUS REPO BRANCH COMMIT MESSAGE
├─────────────────────┼─────────────┼──────────┼──────┼────────┼────────┼─────────┤
cv-TSYCiigC5yJ5BxXw true uploaded
cv-K4EwbnFK4MGG2Qs1 false uploaded
cv-LdcmfSz6PAswZo5L true uploaded
cv-VYikVwjgfHNnUYfr false uploaded
cv-LcVa2hMVZg1nAX6R false uploaded
cv-q9yhRwv73u6UFJdq false uploaded
cv-pn7T5L8J58FV5PSZ false uploaded
cv-p8XXa5rcph3W1MoF false uploaded
cv-Ud4YHRbViJyB9sqc false uploaded
cv-2C5nthzX7mAPMsue false uploaded
╰─────────────────────┴─────────────┴──────────┴──────┴────────┴────────┴─────────╯

tfx workspace configuration-version create

Create a Configuration Version for a supplied Workspace.

Example

Terminal window
$ tfx workspace configuration-version create --name tt-workspace --directory ./tt-workspace-code/
Using config file: /Users/tstraub/.tfx.hcl
Create Configuration Version for Workspace: tt-workspace
Code Directory: ./tt-workspace-code/
Upload code to Configuration Version...
Configuration Version Created
ID: cv-e83GeSpjVKXuUGmU
Speculative: false

tfx workspace configuration-version show

Show Configuration Version details for a supplied Configuration.

Example

Terminal window
$ tfx workspace configuration-version show --id cv-K4EwbnFK4MGG2Qs1
Using config file: /Users/tstraub/.tfx.hcl
Show Configuration Version for Workspace from Id: cv-K4EwbnFK4MGG2Qs1
ID: cv-K4EwbnFK4MGG2Qs1
Status: uploaded
Speculative: false

tfx workspace configuration-version download

Download the Terraform code in a Configuration Version.

Temp Folder Example

Terminal window
$ tfx workspace configuration-version download --id cv-K4EwbnFK4MGG2Qs1
Using config file: /Users/tstraub/.tfx.hcl
Downloading Configuration Version from Id: cv-K4EwbnFK4MGG2Qs1
Directory not supplied, creating a temp directory
Configuration Version Found, download started...
Status: Success
Directory: /var/folders/99/srh_6psj6g5520gwyv8v3nbw0000gn/T/slug3146610843/cv-K4EwbnFK4MGG2Qs1

Specific Folder Example

Terminal window
TODO