Create a cluster

Prerequisites

An important prerequisite to creating a cluster is to create at least one domain to use with your clusters. See Manage domains. If you do not want to create a custom domain with your own DNS, you can always generate a shared namespace under our customer-shared domain name. See Using a Release-generated domain for more details.

Create a new cluster

To create a cluster, navigate to Configuration and then to the Clusters tab. Press Create cluster and select the existing cloud integration that you want to create the cluster in. Choose a region, an IP range, the Kubernetes version, domain to use with this cluster, and a cluster name.

Create cluster

Note that only account owners may create new clusters.

Click Create Cluster button at the bottom right. Note that only account owners may create new clusters.

This will spin up a new Kubernetes cluster in your cloud provider (for example, using EKS if you've integrated with AWS). Note that this will create compute resources in your cloud provider account, which you will be billed for.

Choosing an IP range or CIDR block

If you're not sure which IP range to use, you can choose any one from the dropdown.

Release environments run inside your cloud provider account, and these might need to connect to existing services and applications that run there. Conversely, you might need to fully isolate your Release environments from existing services.

To keep Release environments from interfering with existing applications, by default, Release selects a network address or CIDR block that is distinct from the other network addresses you use in your enterprise. If you know which CIDR block to use, go ahead and select that. Release will build a virtual private cloud (VPC) with the unique CIDR block you provide.

Managing your cluster and node groups

After creating your cluster, you'll automatically have a default node group. If you want to reduce costs (for example, if you're still experimenting with Release), you can set the minimum, maximum, and desired node size to 1 (or even 0).

Edit cluster node group

From the cluster settings page, you can also upgrade the cluster, set it as default, or add more node groups.

Choosing a node group size and type

Note that you can set a minimum and maximum number of nodes and the type of node that your cloud provider will use to host the workloads.

The size of cluster you need will depend on your application stack, use case, and team size. Unless you know for sure how many environments you will be running at once and what each workload will be, the best option is to choose the defaults (min: 3, max: 10, type: 16GiB/4 CPUs).

With Release, you can seamlessly upgrade, increase, decrease, or resize your cluster later without any interruption, so you can always change this later if you need more compute power or want to reduce your cloud bill.

Using a Release-generated domain

You can choose to use a Release-generated domain by selecting "Generate a Subdomain" when you create a cluster. This will generate a subdomain under one of our domains that will be used for the URLs generated for your environments.

Create cluster with subdomain

Creating a cluster with elevated permissions

By default, clusters are created with no extra permissions or roles. If you require elevated permissions on your cluster, you can turn on the "Use elevated permissions when creating clusters " setting on your Organization Settings page.

When this setting is on, any new clusters will be created with the AdministratorAccess role attached.

Migrating apps to a new cluster

When creating a new cluster, any existing environments will need to be recreated fresh or they will continue to try and talk to the old cluster that no longer exists.

Last updated

Was this helpful?