快速入門指南
先決條件
兩個(gè)節(jié)點(diǎn)不能有相同的主機(jī)名竟坛。
如果您的所有節(jié)點(diǎn)都有相同的主機(jī)名,請使用--with-node-id選項(xiàng)為每個(gè)節(jié)點(diǎn)添加一個(gè)隨機(jī)后綴涎跨,或者為您添加到集群的每個(gè)節(jié)點(diǎn)設(shè)計(jì)一個(gè)獨(dú)特的名稱崭歧,用--node-name或$K3S_NODE_NAME傳遞。
操作系統(tǒng)
K3s 應(yīng)該可以運(yùn)行在幾乎所有類型的 Linux 主機(jī)上驾荣。
K3s 在以下操作系統(tǒng)及其后續(xù)非主要版本中得到官方支持和測試:
Ubuntu 16.04 (amd64)
Ubuntu 18.04 (amd64)
Raspbian Buster*
- 如果您使用的是 Raspbian Buster, 請按照這些步驟切換到傳統(tǒng)的 iptables播掷。
如果您使用的是Alpine Linux,請按照這些步驟進(jìn)行額外的設(shè)置歧匈。
硬件
硬件要求根據(jù)您部署的規(guī)模而變化。這里列出了最低建議勘究。
內(nèi)存: 最低 512MB(建議至少為 1GB)
CPU: 最低 1
安裝腳本
本指南將幫助您使用默認(rèn)選項(xiàng)快速啟動(dòng)集群斟冕。安裝部分將詳細(xì)介紹如何設(shè)置 K3s。
K3s 提供了一個(gè)安裝腳本景描,可以方便的在 systemd 或 openrc 的系統(tǒng)上將其作為服務(wù)安裝秀撇。這個(gè)腳本可以在 https://get.k3s.io 獲得。要使用這種方法安裝 K3s呵燕,只需運(yùn)行:
curl -sfL https://get.k3s.io | sh -
國內(nèi)用戶,可以使用以下方法加速安裝:
curl -sfL http://rancher-mirror.cnrancher.com/k3s/k3s-install.sh | INSTALL_K3S_MIRROR=cn sh -
運(yùn)行此安裝后:
K3s 服務(wù)將被配置為在節(jié)點(diǎn)重啟后或進(jìn)程崩潰或被殺死時(shí)自動(dòng)重啟氧苍。
將安裝其他實(shí)用程序泛范,包括kubectl, crictl, ctr, k3s-killall.sh 和 k3s-uninstall.sh
將kubeconfig文件寫入到/etc/rancher/k3s/k3s.yaml,由 K3s 安裝的 kubectl 將自動(dòng)使用該文件
要在工作節(jié)點(diǎn)上安裝并將它們添加到集群澄干,請使用K3S_URL和K3S_TOKEN環(huán)境變量運(yùn)行安裝腳本柠傍。這是顯示如何加入工作者節(jié)點(diǎn)的示例:
curl -sfL https://get.k3s.io | K3S_URL=https://myserver:6443 K3S_TOKEN=mynodetoken K3S_NODE_NAME=NAME sh -
提示
國內(nèi)用戶,可以使用以下方法加速安裝:
curl -sfL http://rancher-mirror.cnrancher.com/k3s/k3s-install.sh | INSTALL_K3S_MIRROR=cn K3S_URL=https://myserver:6443 K3S_TOKEN=mynodetoken K3S_NODE_NAME=NAME sh -
設(shè)置K3S_URL參數(shù)會(huì)使 K3s 以 worker 模式運(yùn)行从媚。K3s agent 將在所提供的 URL 上向監(jiān)聽的 K3s 服務(wù)器注冊患整。K3S_TOKEN使用的值存儲(chǔ)在你的服務(wù)器節(jié)點(diǎn)上的:
cat /var/lib/rancher/k3s/server/node-token
注意:每臺(tái)計(jì)算機(jī)必須具有唯一的主機(jī)名喷众。如果您的計(jì)算機(jī)沒有唯一的主機(jī)名紧憾,請傳遞K3S_NODE_NAME環(huán)境變量,并為每個(gè)節(jié)點(diǎn)提供一個(gè)有效且唯一的主機(jī)名憔四。
卸載K3s
如果您使用安裝腳本安裝了 K3s般眉,那么在安裝過程中會(huì)生成一個(gè)卸載 K3s 的腳本。
卸載 K3s 會(huì)刪除集群數(shù)據(jù)和所有腳本柿汛。要使用不同的安裝選項(xiàng)重新啟動(dòng)集群埠对,請使用不同的標(biāo)志重新運(yùn)行安裝腳本。
要從 server 節(jié)點(diǎn)卸載 K3s鸠窗,請運(yùn)行:
/usr/local/bin/k3s-uninstall.sh
要從 agent 節(jié)點(diǎn)卸載 K3s,請運(yùn)行:
/usr/local/bin/k3s-agent-uninstall.sh
拓展閱讀
經(jīng)過讀者閱讀發(fā)現(xiàn)了一個(gè)小問題躁绸,總結(jié)如下:
# 查看控制平面的token
cat /var/lib/rancher/k3s/server/node-token
# 國外網(wǎng)絡(luò)添加邊緣節(jié)點(diǎn)
curl -sfL https://get.k3s.io | K3S_URL=https://myserver:6443 K3S_TOKEN=mynodetoken K3S_NODE_NAME=NAME sh -
# 國內(nèi)網(wǎng)絡(luò)添加邊緣節(jié)點(diǎn)(經(jīng)過反復(fù)測試發(fā)現(xiàn)國內(nèi)網(wǎng)絡(luò)存在問題臣嚣,沒辦法深入源碼分析吧!少年)
curl -sfL http://rancher-mirror.cnrancher.com/k3s/k3s-install.sh | INSTALL_K3S_MIRROR=cn K3S_URL=https://myserver:6443 K3S_TOKEN=mynodetoken K3S_NODE_NAME=NAME sh -