Avisi cloud logo
Kubernetes

Create an AME node pool

Create a new AME node pool using the Avisi Cloud Console, Terraform or with acloud (CLI).

Create a new node pool with the Avisi Cloud Console

To begin, access the cluster where you intend to create a new node pool. This can be done by navigating to the “Clusters” view and selecting the desired cluster.

Overview of all clusters in your environment

In the selected cluster, you can navigate to the "Node Pools" tab, which can be found underneath the "Cluster" tab.

Rectangle

On the node pools overview page, you can add a new node pool by clicking the “Add Node Pool” button located in the top-right corner of the node pools card. Clicking this button will open a configuration modal where you can customize the node pool settings according to your requirements.

Rectangle

In this configuration modal you can configure the following:

  • Pool name: name of the node pool, which is used to configure the Kubernetes node role label for each node within this pool.

  • Node type: the type (machine or instance type) of the virtual machine within a cloud provider This represents the size (i.e., 8 GB of memory) of a virtual machine.

  • Autoscaling: a feature that allows a cluster to automatically increase or decrease the number of nodes in response to demand.

  • Node pool size: defines the number of nodes inside your node pool. When autoscaling is enabled, this input will transform into two fields: "Min pool size" and "Max pool size." This will allow you to set the boundaries for the autoscaling.

  • Auto-healing: auto-healing will allow the automatic replacement of unhealthy nodes inside the node pool.

  • Automatic node reboots: automatic node reboots allow automatic node reboots if required due to system patches.

  • Upgrade strategy: The upgrade strategy has the following options:

    • Replace: surge style upgrades where nodes are replaced;
    • In-place: nodes perform in-place upgrades after being drained;
    • In-place (without Drain): nodes perform in-place upgrades without draining;
    • Replace minor, in-place patch: performs minor version upgrades by replacing nodes; applies patch updates in place after draining nodes;
    • Replace minor, in-place patch (without drain): performs minor version upgrades by replacing nodes; applies patch updates in place without draining nodes.
  • Labels and Annotations: these are applied to the node within Kubernetes and can be used for scheduling decisions or automation tasks or scripts.

  • Taints: these are applied to the nodes within Kubernetes and can be used to restrict the node to only run certain workloads.

After creating the node pool, it will appear on the node pool overview page in the Avisi Cloud Console.

Create a new node pool with Terraform

You can create a node pool in Terraform. See the examples for more details.

# Example worker node pool that will be provisioned for the created cluster
resource "acloud_nodepool" "workers" {
  environment           = "example-environment-slug"
  cluster               = "example-cluster-slug"
  name                  = "workers"
  node_size             = "t3.small"
  node_count            = 1
  node_auto_replacement = false
  upgrade_strategy      = "REPLACE_MINOR_INPLACE_PATCH"
  annotations = {
    "myannotation" = "test"
  }
  labels = {
    "role" = "worker"
  }
}

Create a new node pool with acloud (CLI)

You can create a basic node pool using the CLI tool acloud:

acloud node-pools create \
  --name=workers-a \
  --cluster=example-aws-cluster \
  --node-auto-replacement=true \
  --node-count=2 \
  --node-type="t3.small"

Next get the node pools using:

acloud node-pools get --cluster=example-cluster

On this page