Multi-Account Support for Toolbelt
You can configure your Toolbelt to work with multiple Cloud 66 accounts and/or organizations using configuration profiles.
Configuration profile commands
Creates a new configuration profile
$ cx config create <name> [--org <org name>]
Switches to using the named configuration profile.
$ cx config use <name>
Renames an existing configuration profile.
$ cx config rename <old name> <new name>
Delete a configuration profile.
$ cx config delete <name>
Lists all your configuration profiles.
$ cx config list
Show the details for a profile
$ cx config show <name>
Set a configuration profile to point to an organization.
cx config update NAME [--org <org name>]
Setting up a profile:
cx config create <name>where
<name>is your chosen profile name
cx config use <name>to switch to the new profile and initialize it by running
cx 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.