快捷導(dǎo)航

k3s安裝部署流程

更新時(shí)間：2026年01月07日 14:55:36 作者：兔子先生°

文章詳細(xì)介紹了如何在國內(nèi)配置K3s鏡像源、部署儀表盤、配置角色和權(quán)限、獲取儀表盤token、進(jìn)行端口轉(zhuǎn)發(fā)以及使用nerdctl和buildkitd構(gòu)建容器鏡像的方法,并附帶了注意事項(xiàng)和驗(yàn)證步驟

k3s國內(nèi)下載地址

curl -sfL https://rancher-mirror.rancher.cn/k3s/k3s-install.sh | INSTALL_K3S_MIRROR=cn sh -

配置鏡像源

tee /etc/rancher/k3s/registries.yaml <<'EOF'
mirrors:
  "docker.io":
    endpoint:
      - "https://docker.m.daocloud.io"
      - "https://docker.mirrors.ustc.edu.cn"
      - "https://hub-mirror.c.163.com"
      - "https://mirror.baidubce.com"
      - "https://docker.nju.edu.cn"
      - "https://mirrors.tuna.tsinghua.edu.cn"
      - "https://registry-1.docker.io"
EOF

部署儀表盤

kubectl apply -f https://raw.githubusercontent.com/kubernetes/dashboard/v2.7.0/aio/deploy/recommended.yaml

配置儀表盤角色

dashboard.admin-user-role.yml

apiVersion: rbac.authorization.k8s.io/v1
kind: ClusterRoleBinding
metadata:
  name: admin-user
roleRef:
  apiGroup: rbac.authorization.k8s.io
  kind: ClusterRole
  name: cluster-admin
subjects:
  - kind: ServiceAccount
    name: admin-user
    namespace: kubernetes-dashboard

dashboard.admin-user.yml

apiVersion: v1
kind: ServiceAccount
metadata:
  name: admin-user
  namespace: kubernetes-dashboard

部署用戶角色配置

kubectl create -f dashboard.admin-user.yml -f dashboard.admin-user-role.yml

獲取儀表盤 token

kubectl -n kubernetes-dashboard create token admin-user

端口轉(zhuǎn)發(fā)

–address 0.0.0.0 可以遠(yuǎn)程訪問

kubectl port-forward -n kubernetes-dashboard --address 0.0.0.0 svc/kubernetes-dashboard 8443:443

以NodePort的方式進(jìn)行暴露

直接端口轉(zhuǎn)發(fā)命令需要一直保持命令行運(yùn)行狀態(tài)，如果需要后臺(tái)需要使用 NodePort 來對(duì)外暴露服務(wù)。

apiVersion: v1
kind: Service
metadata:
  name: dashboard-nodeport
  namespace: kubernetes-dashboard
spec:
  type: NodePort
  selector:
     k8s-app: kubernetes-dashboard
  ports:
    - name: dashboard-https
      port: 443 #應(yīng)用端口
      targetPort: 8443 #pod端口
      nodePort: 30443 # 轉(zhuǎn)發(fā)端口

訪問https://192.168.204.137:30443/地址，根據(jù)自己服務(wù)器實(shí)際情況來。

安裝nerdctl + buildkitd 構(gòu)建容器鏡像

nerdctl地址：https://github.com/containerd/nerdctl/releases/download/v1.5.0/nerdctl-1.5.0-linux-amd64.tar.gz

buildkitd地址：https://github.com/moby/buildkit/releases/download/v0.12.1/buildkit-v0.12.1.linux-amd64.tar.gz

1. 安裝buildkitd

解壓縮包

tar xf buildkit-v0.12.1.linux-amd64.tar.gz

復(fù)制兩個(gè)文件夾到bin目錄下

cp bin/buildkitd bin/buildctl /usr/local/bin/

創(chuàng)建service文件

[Unit]
Description=BuildKit
Documentation=https://github.com/moby/buildkit
After=network-online.target
Wants=network-online.target

[Service]
ExecStart=/usr/local/bin/buildkitd --oci-worker=false --containerd-worker=true
User=root
Restart=always
RestartSec=5

[Install]
WantedBy=multi-user.target

啟動(dòng)buildkitd服務(wù)

systemctl daemon-reload
systemctl enable buildkitd --now
# systemctl enable buildkitd --now
# 相當(dāng)于systemctl enable buildkitd 和 systemctl start buildkitd

2. 安裝nerdctl

解壓縮

tar xf nerdctl-1.5.0-linux-amd64.tar.gz

復(fù)制到bin目錄下

mv nerdctl /usr/local/bin/

由于直接使用的k3s的容器，所以沒有/run/containerd/containerd.sock，使用nerdctl會(huì)報(bào)錯(cuò)

創(chuàng)建符號(hào)鏈接

ln -sf /run/k3s/containerd/containerd.sock /run/containerd/containerd.sock

# 驗(yàn)證鏈接
ls -la /run/containerd/containerd.sock

3. 注意事項(xiàng)

nerdctl拉取的鏡像默認(rèn)在default命名空間，這樣子k3s查詢不到，部署會(huì)有問題。

方案1：拉取的時(shí)候指定命名空間k8s.io

nerdctl -n k8s.io pull docker.1ms.run/library/nginx:alpine3.22

方案2：修改環(huán)境變量

echo 'export CONTAINERD_NAMESPACE=k8s.io' >> ~/.bashrc
source ~/.bashrc

方案3：修改nerdctl配置文件（推薦）

mkdir -p /etc/nerdctl
echo 'namespace = "k8s.io"' | tee /etc/nerdctl/nerdctl.toml

驗(yàn)證nerdctl命名空間

nerdctl info

驗(yàn)證，使用nerdctl拉取鏡像，如果在crictl查詢出來就是成功了

nerdctl pull docker.1ms.run/library/nginx:alpine3.22

總結(jié)

以上為個(gè)人經(jīng)驗(yàn)，希望能給大家一個(gè)參考，也希望大家多多支持腳本之家。

您可能感興趣的文章:

最新国产好看的视频,伊人天堂AV在线,国产Aaaaaa视频,蜜臀视频在线观看一区,人妻av色图,密臀久久久精品影片,青青视频免费观看毛片,久草在线观看视,国产三级精品色情在线