Get startedSign in

Provision a workload cluster

Using a self-service PR automation to provision your first workload cluster

Overview

Now that you have a management cluster and your SCM connected, you can test-out our self-service provisioning using PR Automations and our terraform management system called Stacks. At a high level, this is going to:

  • utilize a PR Automation (PRA) to instantiate a few CRDs into folders syncable by the root service-of-services in the bootstrap folder
  • The InfrastructureStack CRD created by the PRA will create a terraform stack referencing code in the terraform/modules/clusters/aws folder to provision a new cluster. Your management cluster should already have been configured with sufficient IAM perms to create this cluster. Any future commits to that folder will also be tracked and generate new terraform runs to sync in changes to the desired infrastructure.
Warning:

This Guide will not work properly unless you've finished the tutorial Integrate with your Source Control Provider.

Enable the cluster-creator PR Automation

There should be a crd at bootstrap/pr-automation/cluster-creator.yaml which will create the PRA that drives this tutorial. By default it references a github SCMConnection crd, you'll need to have created that fully, and eventually the operator will also create the PR Automation in our API, and it will be visible in the UI as well.

If it's not showing, navigate to the apps service, and you can filter on PrAutomation resources. You should be able to see error messages in the YAML explaining what the operator is tripping on.

Create a Workload Cluster

Now that PR Automation is configured, we should be able to spawn our cluster seamlessly. The steps are:

  • Navigate to https://{your-console-domain}/pr/automations
  • Click Create a PR on the cluster-creator Automation Row
    cluster-creator pr button
  • Fill in the Required Fields
    • Name: The Name of the Cluster
    • Cloud: Cloud Provider to Deploy the Cluster (Dropdown Menu)
    • Fleet: The Fleet to Associate the cluster (this is arbitrary but can help you group like clusters)
    • Tier: The Tier to Place the Cluster (dev/staging/prod)
      cluster-creator modal 0
  • Click Next
  • Enter the Name of the Branch to Create the PR
    cluster-creator modal 1
  • Click Create
    • Optionally view the PR that was created
      cluster-creator modal 2
  • Merge the PR