tfctl profile profiles

The tfctl profile profiles command group manages the set of named tfctl profiles.

Usage

$ tfctl profile profiles <subcommand> [options]

Description

The tfctl profile profiles command group manages the set of named tfctl profiles. You can create new profiles using tfctl profile profiles create and activate existing profiles using tfctl profile profiles activate. To manage a specific profile, refer to tfctl profile subcommands.

A profile is a collection of properties that configure the behavior of tfctl. Profiles allow you to maintain the same settings across command executions, and multiple profiles allow you to switch between organizations and instances. You can also use profiles to manage multiple Terraform organizations across multiple instances of HCP Terraform or Terraform Enterprise.

To run a single command against a profile other than the active profile, run the command with the --profile Global flag.

Subcommands

activate - Activate an existing profile
create - Create a new configuration profile
delete - Delete an existing configuration profile
list - List existing configuration profiles
rename - Rename an existing profile

Examples

The following examples demonstrate common profile management workflows.

Create a new profile

The following example creates a new profile with the specified name and activates it. Replace <PROFILE_NAME> with a valid profile name.

$ tfctl profile profiles create <PROFILE_NAME>

List existing profiles

The following example displays all configured profiles with their details.

$ tfctl profile profiles list

Activate a profile by name

The following example activates a profile by name. Replace <PROFILE_NAME> with the name of the profile to activate.

$ tfctl profile profiles activate <PROFILE_NAME>