Skip to content

Comments

doc: add components api doc#85

Merged
bcho merged 2 commits intomainfrom
hbc/components-api
Feb 20, 2026
Merged

doc: add components api doc#85
bcho merged 2 commits intomainfrom
hbc/components-api

Conversation

@bcho
Copy link
Member

@bcho bcho commented Feb 17, 2026

This pull request proposes a new components organization process for managing the flex node lifecycle (baking/bootstrapping/updating etc).

The new node join process can be completed by a single command on a user provided configuration file:

aks-flex-node apply -f <config.json>

Sample configuration:

[
  {
    "metadata": {
      "type": "aks.flex.components.linux.v20260301.ConfigureBaseOS",
      "name": "configure-base-os"
    },
    "spec": {}
  },
  {
    "metadata": {
      "type": "aks.flex.components.cri.v20260301.DownloadCRIBinaries",
      "name": "download-cri-binaries"
    },
    "spec": {
      "containerd_version": "2.0.4",
      "runc_version": "1.2.5"
    }
  },
  {
    "metadata": {
      "type": "aks.flex.components.kubebins.v20260301.DownloadKubeBinaries",
      "name": "download-kube-binaries"
    },
    "spec": {
      "kubernetes_version": "1.32.3"
    }
  },
  {
    "metadata": {
      "type": "aks.flex.components.cri.v20260301.StartContainerdService",
      "name": "start-containerd-service"
    },
    "spec": {}
  },
  {
    "metadata": {
      "type": "aks.flex.components.kubeadm.v20260301.KubadmNodeJoin",
      "name": "kubeadm-node-join"
    },
    "spec": {
      "control_plane": {
        "server": "https://<fqdn>:443",
        "certificate_authority_data": "<ca>"
      },
      "kubelet": {
        "bootstrap_auth_info": {
          "token": "<bootstrap-token>"
        },
        "node_labels": {
          "kubernetes.azure.com/managed": "false",
          "kubernetes.azure.com/cluster": "<cluster-info>"
        }
      }
    }
  }
]

A full implementation of this design can be found in #83 (demo has been shared internally).

Related:

@bcho bcho merged commit dd1a6fd into main Feb 20, 2026
22 of 24 checks passed
@bcho bcho deleted the hbc/components-api branch February 20, 2026 04:37
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants