Skip to main content
Version: 1.1

Cloud Accounts and Environments

Cloud accounts are AWS accounts, GCP projects, or Azure subscriptions. If the Wayfinder administrator sets up organization account automation, Wayfinder can automatically create managed accounts, each one associated with a specific development stage. A cloud environment then is a Wayfinder-managed cloud account for a specific stage.

Cloud environments can be created in two ways:

  • When you create a cluster for a specific development stage, and choose to use a Wayfinder-managed account, Wayfinder automatically creates the account for you if one does not already exist on this cloud for that stage. This creates a cloud environment, visible in the Cloud environemnts page.

  • If you want to create a Wayfinder-managed account without creating a cluster in Wayfinder, you can do so in the Cloud environments page in the UI, or by running wf create cloudaccounts in the CLI. If you wish, you can create clusters later using this account.

This topic focuses on the second option above.


Cloud environments are associated with Wayfinder managed accounts, therefore, organization account automation must be set up in order to see cloud environments in the UI.

Create a cloud environment​

Cloud environments are cloud accounts associated with a development stage, such as production or non production. Each workspace in Wayfinder can have one cloud environment per cloud, per development stage.

You do not need to supply credentials because the Wayfinder administrator supplies these during configuration as part of Wayfinder's account automation.

To create a cloud environment/account:

  1. In the Wayfinder UI, navigate to Resources > Cloud environments.

    In this example, you can see that the Wayfinder admin has configured account automation for the AWS and Azure clouds, but not for GCP. Your workspace has created an AWS EKS non-prod cluster, but has not created an Azure cluster yet.

    cloud environments

  2. To add a managed account without creating a cluster, click the Add button to add an environment in a specific cloud:

    • Add AWS
    • Add Azure
    • Add GCP

    You'll only see the button for a cloud provider if account automation is set up for that provider, and if there is a development stage you don't already have an environment for on that provider.

  3. In the Add cloud account dialog, select a development Stage, and then click Create.

    Your environment is created and appears in the Cloud environments page.

  4. (Optional) You can create new clusters using managed accounts from this page or from the Clusters page.

    Creating a cluster from the Cloud environments page pre-populates the stage and account information in the cluster settings.


wf create cloudaccounts

Create a cluster in an existing cloud environment​

To create a cluster in an existing cloud environment:

  1. Use either of the following methods:

    • In the Resources > Cloud environments page, click Create new cluster in the environment you want to create the cluster inβ€”see the image above.

    • In the Resources > Clusters page, click New cluster. If you choose to use a Wayfinder-managed account in your selected cloud, Wayfinder uses the appropriate environment/account if one exists. If it doesn't exist, Wayfinder creates the environment, and then displays it in the Cloud environments page.

Both methods use the same Create a new cluster dialog.

Delete a cloud environment​

You cannot delete a cloud environment in Wayfinder. You must use the cloud provider's CLI or console to delete an account.