Multi-Account Support for Toolbelt
Overviews
You can configure your Toolbelt to work with multiple Cloud 66 accounts and/or organizations using configuration profiles.
Configuration profile commands
config create
Creates a new configuration profile
$ cx config create <name> [--org <org name>]
config use
Switches to using the named configuration profile.
$ cx config use <name>
config rename
Renames an existing configuration profile.
$ cx config rename <old name> <new name>
config delete
Delete a configuration profile.
$ cx config delete <name>
config list
Lists all your configuration profiles.
$ cx config list
config show
Show the details for a profile
$ cx config show <name>
config update
Set a configuration profile to point to an organization.
cx config update NAME [--org <org name>]
Setting up a profile:
- Run
cx config create <name>
where<name>
is your chosen profile name - Run
cx config use <name>
to switch to the new profile and initialize it by runningcx stacks list
- Authenticate using your browser (be sure to log into the correct account)
For more detailed help on installation please refer to our Getting Started guide.
You always have a default
profile which cannot be deleted or renamed.
Switching between profiles
To switch between profiles, use cx config use <name>
All commands from that point onwards will run against the <name>
profile. This is persisted between different terminal sessions until it’s changed.
Setting Profile per command
If you would like to run a command with a different profile other than the current profile, you can use the --profile
argument with all commands:
cx --profile NAME stacks list
Using profiles with organizations
When you create a profile you can specify the organization to which this new profile should be linked. For example:
cx config create hobby --org my_private_sandbox
…will create a profile named “hobby” that is linked to a Cloud 66 organization named “my_private_sandbox”.
If you’re unsure about the name of an organization you can run the cx info
command and looking at the Name
field. You can also see this by logging into your Dashboard, visiting Account Settings and clicking on Organisations in the Account panel on the left.