Skip to main content

How do I create an Environment using new Infrastructure?

Prerequisites


What are Environments in Wayfinder?

You need to tell Wayfinder which environment (cluster) will host your application.

In this article, you'll create new infrastructure if you require a specific cluster configuration that doesn't already exist or if you need an isolated cluster for this environment.


CLI Commands

FORMAT

wf create appenv --app APP-NAME --env ENV-NAME --cluster CLUSTER-NAME --plan CLUSTERPLAN --stage STAGE --region REGION

EXAMPLE

Wayfinder Create an Environment
wf create appenv --app app1 --env demo1 --cluster aks-2eqk9 --plan aks-playground --stage nonprod --region uksouth

EXPLANATION

In the above example, you've created an environment called demo1 and specified that it is part of the existing app1 application in the nonprod stage. You've further specified Wayfinder to create new infrastructure (aks-2eqk9 cluster) using the spec outlined in aks-playground. The cluster's region is set to uksouth.


Web Interface Instructions



Screenshot(s)
New Environment
New Environment

Steps

  • Expand Workspaces > Your-Workspace-Name, and then navigate to Applications
  • Select your Application
  • Click the Step 3 - Create and Environment OR +Create > Environment button
  • Fill in the details:
    • Provide a name for your environment e.g. demo1
    • Use new infra: Wayfinder creates a new cluster with an auto-generated name and then creates a namespace on that new cluster. Select one of the existing environments.
  • Select a stage
  • Select the region
  • Click the Create Environment button

What comes next?

Deploy your App using Wayfinder (without CI/CD):

Deploy your app with GitHub integration:



Troubleshooting

Why aren't there any environments to choose from?

Your Wayfinder administrator needs to make environments available to you using Cluster Plans. See Configuration.