Skip to content

KubeKey environment verification

KubeKey environment verification is a pre-flight check performed by the KubeKey (kk) tool to ensure the target machine meets the necessary conditions for a successful Kubernetes deployment^[400-devops-06-kubernetes-k8s-learning-99k8s-all-in-one-readme.md].

Verification Process

When the kk create cluster command is executed, the tool initiates a "simple check of your environment"^[400-devops-06-kubernetes-k8s-learning-99k8s-all-in-one-readme.md]. This step occurs before the actual installation begins, scanning the system for required software and network configurations^[400-devops-06-kubernetes-k8s-learning-99k8s-all-in-one-readme.md].

Verification Checklist

The verification process inspects the following components to confirm they are available and properly configured^[400-devops-06-kubernetes-k8s-learning-99k8s-all-in-one-readme.md]:

  • Core Utilities: sudo, curl, openssl
  • Network Plugins: ebtables, socat, ipset, conntrack
  • Storage Clients: nfs client, glusterfs client
  • Runtime: Checks for docker (optional/empty in default all-in-one scenarios)
  • System Config: Static IP configuration (e.g., IPADDR, GATEWAY, DNS1) is often required for stability^[400-devops-06-kubernetes-k8s-learning-99k8s-all-in-one-readme.md].

The tool typically outputs a table summarizing the status of these items (marked as y for yes) and the local time of the check^[400-devops-06-kubernetes-k8s-learning-99k8s-all-in-one-readme.md].

Post-Verification Actions

Upon passing the initial checks, the user is prompted to confirm whether to proceed with the installation^[400-devops-06-kubernetes-k8s-learning-99k8s-all-in-one-readme.md]. The system documentation advises that before continuing, users should ensure their machines meet all requirements listed in the official KubeKey repository^[400-devops-06-kubernetes-k8s-learning-99k8s-all-in-one-readme.md].

Sources

^[400-devops-06-kubernetes-k8s-learning-99k8s-all-in-one-readme.md]