Skip to main content

Data Plane Configuration

The Data Plane configuration is a crucial part of the cluster setup. It defines the configuration for the data plane of the cluster.

Configuration Requirements​

  • The dataPlane configuration must contain at least one nodeGroup.
  • The nodeGroup configuration must have a valid name, minNode, maxNode, and machineTypes.
  • The instanceType must be either ondemand or spot. The default value is ondemand.
  • The availabilityZones list must be empty or contain at least one availability zone. This is optional field and not required for EKS clusters.

Node Groups​

A Node Group represents a group of nodes in the cluster. It has the following configuration options:

  • name: The name of the node group, which must be a valid DNS name.
  • minNode: The minimum number of nodes in the group.
  • maxNode: The maximum number of nodes in the group.
  • machineTypes: A list of machine types for the nodes in this group.
  • labels: A map of labels to be applied to the nodes in this group. This is optional field.
  • taints: A list of taints to be applied to the nodes in this group. This is optional field.
  • instanceType: The type of instance, which can be either ondemand or spot. The default value is ondemand.
  • availabilityZones: A list of availability zones. If empty, the platform will select the availability zones based on the region and provider.

For more information please refer the API documentation for the API Reference and look for the dataPlane section in clusterSpec false.

Example Node Group Configuration​

Here is an example of a NodeGroup configuration:

dataPlane:
  nodeGroups:
    - name: example-group
      minNode: 3
      maxNode: 5
      machineTypes: ["m5.xlarge", "m5.2xlarge"]
      labels:
        "example-label": "example-value"
      instanceType: ondemand

Supported Instance Types​

The following instance types are supported:

  • ondemand: On-demand instances. For self-hosted clusters.
  • spot: Spot instances.

Retrieving Regions and Availability Zones​

To retrieve a list of available regions and availability zones, use the astroctl cloud commands. For example, to list AWS regions:

List AWS regions
astroctl cloud aws regions list
List zones in an AWS region
astroctl cloud aws regions zones list -r us-west-2

Retrieving Machine Types​

To retrieve a list of available machine types, use the provider-specific machine command. For example, to get AWS machine types in us-west-2 with 2-4 CPUs:

astroctl cloud aws machines list -r us-west-2 --cpuMin 2 --cpuMax 4

For more information, see the cloud CLI reference.