安裝 kubeadm

本頁面介紹如何安裝 kubeadm 工具包。有關在完成此安裝過程後如何使用 kubeadm 建立叢集的資訊，請參閱使用 kubeadm 建立叢集頁面。

準備工作

• 相容的 Linux 主機。Kubernetes 專案提供了基於 Debian 和 Red Hat 的 Linux 發行版以及沒有包管理器的發行版的通用說明。
• 每臺機器 2 GB 或更多記憶體（少於 2 GB 將為應用程式留下很少的空間）。
• 控制平面機器需要 2 個或更多 CPU。
• 叢集中所有機器之間完全網路連通（公共或私有網路均可）。
• 每個節點都有唯一的 hostname、MAC 地址和 product_uuid。有關更多詳細資訊，請參閱此處。
• 你的機器上需要開啟某些埠。有關更多詳細資訊，請參閱此處。

檢查作業系統版本

• Linux
• Windows

kubeadm 建立的 Kubernetes 叢集依賴於使用核心功能的軟體。此軟體包括但不限於容器執行時、kubelet 和容器網路介面外掛。

為了幫助你避免因不支援的核心版本而導致的意外錯誤，kubeadm 執行 SystemVerification 預檢檢查。如果核心版本不受支援，此檢查將失敗。

如果你知道你的核心提供了所需的功能，即使 kubeadm 不支援其版本，你也可以選擇跳過此檢查。

驗證每個節點的 MAC 地址和 product_uuid 是否唯一

• 你可以使用命令 ip link 或 ifconfig -a 獲取網路介面的 MAC 地址。
• product_uuid 可以使用命令 sudo cat /sys/class/dmi/product_uuid 檢查。

硬體裝置很可能有唯一的地址，儘管某些虛擬機器可能具有相同的值。Kubernetes 使用這些值來唯一標識叢集中的節點。如果這些值對於每個節點不唯一，則安裝過程可能會失敗。

檢查網路介面卡

如果你有多個網路介面卡，並且你的 Kubernetes 元件無法在預設路由上訪問，我們建議你新增 IP 路由，以便 Kubernetes 叢集地址透過適當的介面卡。

檢查所需埠

這些所需埠需要開啟，以便 Kubernetes 元件能夠相互通訊。你可以使用 netcat 等工具檢查埠是否開啟。例如：

nc 127.0.0.1 6443 -zv -w 2

你使用的 Pod 網路外掛可能也需要開啟某些埠。由於這因每個 Pod 網路外掛而異，請參閱外掛的文件以瞭解需要哪些埠。

Swap 配置

kubelet 的預設行為是如果節點上檢測到交換記憶體則啟動失敗。這意味著交換要麼被停用，要麼被 kubelet 容忍。

• 要容忍交換，請將 failSwapOn: false 新增到 kubelet 配置或作為命令列引數。注意：即使提供了 failSwapOn: false，工作負載預設也不會有交換訪問許可權。這可以透過在 kubelet 配置檔案中設定 swapBehavior 來更改。要使用交換，請設定除預設 NoSwap 設定之外的 swapBehavior。有關更多詳細資訊，請參閱交換記憶體管理。
• 要停用交換，可以使用 sudo swapoff -a 暫時停用交換。要使此更改在重新啟動後持久生效，請確保在 /etc/fstab、systemd.swap 等配置檔案中停用交換，具體取決於系統上的配置方式。

安裝容器執行時

要在 Pod 中執行容器，Kubernetes 使用容器執行時。

預設情況下，Kubernetes 使用容器執行時介面 (CRI) 與你選擇的容器執行時進行介面。

如果你未指定執行時，kubeadm 將自動嘗試透過掃描已知端點列表來檢測已安裝的容器執行時。

如果檢測到多個或沒有容器執行時，kubeadm 將丟擲錯誤並要求你指定要使用哪個。

有關更多資訊，請參閱容器執行時。

下表包含受支援作業系統的已知端點。

• Linux
• Windows

安裝 kubeadm、kubelet 和 kubectl

你將在所有機器上安裝這些軟體包：

• kubeadm：用於引導叢集的命令。

• kubelet：在叢集中所有機器上執行的元件，用於啟動 Pod 和容器等。

• kubectl：用於與叢集通訊的命令列工具。

kubeadm 不會為你安裝或管理 kubelet 或 kubectl，因此你需要確保它們與你希望 kubeadm 為你安裝的 Kubernetes 控制平面版本匹配。如果版本不匹配，可能會出現版本偏差，從而導致意外的、有 bug 的行為。但是，kubelet 和控制平面之間支援一個次要版本偏差，但 kubelet 版本不能超過 API 伺服器版本。例如，執行 1.7.0 的 kubelet 應該與 1.8.0 API 伺服器完全相容，但反之則不然。

有關安裝 kubectl 的資訊，請參閱安裝和設定 kubectl。

有關版本偏差的更多資訊，請參閱：

• Kubernetes 版本和版本偏差策略
• kubeadm 特定的版本偏差策略

• 基於 Debian 的發行版
• 基於 Red Hat 的發行版
• 不帶包管理器

CNI_PLUGINS_VERSION="v1.3.0"
ARCH="amd64"
DEST="/opt/cni/bin"
sudo mkdir -p "$DEST"
curl -L "https://github.com/containernetworking/plugins/releases/download/${CNI_PLUGINS_VERSION}/cni-plugins-linux-${ARCH}-${CNI_PLUGINS_VERSION}.tgz" | sudo tar -C "$DEST" -xz

DOWNLOAD_DIR="/usr/local/bin"
sudo mkdir -p "$DOWNLOAD_DIR"

CRICTL_VERSION="v1.31.0"
ARCH="amd64"
curl -L "https://github.com/kubernetes-sigs/cri-tools/releases/download/${CRICTL_VERSION}/crictl-${CRICTL_VERSION}-linux-${ARCH}.tar.gz" | sudo tar -C $DOWNLOAD_DIR -xz

RELEASE="$(curl -sSL https://dl.k8s.io/release/stable.txt)"
ARCH="amd64"
cd $DOWNLOAD_DIR
sudo curl -L --remote-name-all https://dl.k8s.io/release/${RELEASE}/bin/linux/${ARCH}/{kubeadm,kubelet}
sudo chmod +x {kubeadm,kubelet}

RELEASE_VERSION="v0.16.2"
curl -sSL "https://raw.githubusercontent.com/kubernetes/release/${RELEASE_VERSION}/cmd/krel/templates/latest/kubelet/kubelet.service" | sed "s:/usr/bin:${DOWNLOAD_DIR}:g" | sudo tee /usr/lib/systemd/system/kubelet.service
sudo mkdir -p /usr/lib/systemd/system/kubelet.service.d
curl -sSL "https://raw.githubusercontent.com/kubernetes/release/${RELEASE_VERSION}/cmd/krel/templates/latest/kubeadm/10-kubeadm.conf" | sed "s:/usr/bin:${DOWNLOAD_DIR}:g" | sudo tee /usr/lib/systemd/system/kubelet.service.d/10-kubeadm.conf

sudo systemctl enable --now kubelet

kubelet 現在每隔幾秒鐘重啟一次，因為它在崩潰迴圈中等待 kubeadm 告訴它該做什麼。

配置 cgroup 驅動程式

容器執行時和 kubelet 都有一個名為“cgroup 驅動程式”的屬性，這對於 Linux 機器上的 cgroup 管理很重要。

故障排除

如果你在使用 kubeadm 時遇到困難，請查閱我們的故障排除文件。

下一步

• 使用 kubeadm 建立叢集