Nutanix

Currently the machine-controller implementation of Nutanix supports the Prism v3 API to create Machines.

Prerequisites

The nutanix provider assumes several things to be pre-existing. You need:

Credentials and access information for a Nutanix Prism Central instance (endpoint, port, username and password).
The name of a Nutanix cluster to create the VMs for Machines on.
The name of a subnet on the given Nutanix cluster that the VMs’ network interfaces will be created on.
An image name that will be used to create the VM for (must match the configured operating system).
Optional: The name of a project that the given credentials have access to, to create the VMs in. If none is provided, the VMs are created without a project.

Configuration Options

An example MachineDeployment can be found here.

Sample machinedeployment.yaml

apiVersion: v1
kind: Secret
metadata:
  # If you change the namespace/name, you must also
  # adjust the rbac rules
  name: machine-controller-nutanix
  namespace: kube-system
type: Opaque
stringData:
  password: << NUTANIX_PASSWORD >>
---
apiVersion: "cluster.k8s.io/v1alpha1"
kind: MachineDeployment
metadata:
  name: nutanix-machinedeployment
  namespace: kube-system
spec:
  paused: false
  replicas: 1
  strategy:
    type: RollingUpdate
    rollingUpdate:
      maxSurge: 1
      maxUnavailable: 0
  minReadySeconds: 0
  selector:
    matchLabels:
      foo: bar
  template:
    metadata:
      labels:
        foo: bar
    spec:
      providerSpec:
        value:
          sshPublicKeys:
            - "<< YOUR_PUBLIC_KEY >>"
          cloudProvider: "nutanix"
          cloudProviderSpec:
            # Can also be set via the env var 'NUTANIX_USERNAME' on the machine-controller
            username: "<< NUTANIX_USERNAME >>"
            # Can also be set via the env var 'NUTANIX_ENDPOINT' on the machine-controller
            # example: 'your-nutanix-host' or '10.0.1.5'. No protocol or port should be passed.
            endpoint: "<< NUTANIX_ENDPOINT >>"
            # Can also be set via the env var 'NUTANIX_PORT' on the machine-controller
            # if not set, defaults to 9440 (default Nutanix port)
            port: "<< NUTANIX_PORT >>"
            # Optional: Allow insecure connections to endpoint if no valid TLS certificate is presented
            allowInsecure: true
            # Can also be set via the env var 'NUTANIX_PASSWORD' on the machine-controller
            password:
              secretKeyRef:
                namespace: kube-system
                name: machine-controller-nutanix
                key: password
            # Can also be set via the env var 'NUTANIX_CLUSTER_NAME' on the machine-controller
            # this refers to a Nutanix cluster, not a Kubernetes cluster
            clusterName: nutanix-cluster
            # Optional: Sets the project that the VM is deployed into. If none is provided, the VM will be created without a project
            projectName: project1
            # Sets the subnet that the VM is connected to. Must exist in the given Nutanix cluster
            subnetName: subnet1
            # Optional: Sets multiple additional subnets that the VM is connected to. Must exist in the given Nutanix cluster
            # additionalSubnetNames:
            #   - subnet2
            #   - subnet3
            # Provides the image used to create the VM
            imageName: ubuntu-20.04
            # Sets the vCPU count for this VM
            cpus: 2
            # Sets the CPU cores per vCPUs
            cpuCores: 1
            # Memory configuration in MiB
            memoryMB: 2048
            # Optional: Enable Nutanix' CPU passthrough feature
            #cpuPassthrough: true
            # Optional: Set up system disk size in GB. If not set, will be based on image size.
            # Cannot be smaller than the image size.
            diskSize: 20
          operatingSystem: "ubuntu"
          operatingSystemSpec:
            distUpgradeOnBoot: false
            disableAutoUpdate: true
      versions:
        kubelet: 1.30.5