ARTICLE · INTELLIGENCE

战地情报 · 详情页

来自尧图项目组的一线实战观察与深度解析

linux安装k3s教程

linux安装k3s教程

linux安装k3s教程

下载文件

  • 从github release页面下载对应项目
  • k3s-airgap-images-amd64.tar
  • k3s-selinux-1.6-1.el9.noarch.rpm(自己下载对应版本安装包)
  • install.sh
  • k3s
  • container-selinux-2.245.0-1.el9.noarch.rpm(自己下载对应版本安装包)
    注意
    「宿主機啟用了 SELinux(處於 Enforcing 狀態)」的情況下才需要安装container-selinux、k3s-selinux-*.noarch.rpm

安装流程

  1. 离线安装两个rpm包(如果没有开启SELinux可跳过)
# 查看是否可以开启 SELinuxgetenforce# 安装SELinux离线包 k3s-selinux-1.6-1.el9.noarch.rpm、container-selinux-2.245.0-1.el9.noarch.rpmsudodnf localinstall *.rpm--disablerepo=* --skip-broken-y
  1. 配置文件與權限,首先,我們需要將 k3s 二進制檔案移動到系統的環境變量目錄中,並賦予其可執行權限。
# 1. 將 k3s 執行檔複製到系統的 bin 目錄下sudocpk3s /usr/local/bin/# 2. 為 k3s 檔案賦予可執行權限sudochmod+x /usr/local/bin/k3s
  1. 導入離線鏡像,K3s 在啟動時會檢查特定的目錄。如果該目錄下存在鏡像壓縮包,它會自動將其導入到內置的容器運行時(Containerd)中。
# 3. 創建 K3s Agent 存放鏡像的專用目錄sudomkdir-p/var/lib/rancher/k3s/agent/images/# 4. 将離線鏡像包複製到該目錄下sudocpk3s-airgap-images-amd64.tar.gz /var/lib/rancher/k3s/agent/images/
  1. 執行腳本完成安裝,有了二進制檔案和鏡像後,我們就可以執行 install.sh 進行安裝了。這裡必須加上 INSTALL_K3S_SKIP_DOWNLOAD=true 參數,明確告知腳本跳過線上地下載。
# 5. 為安裝腳本賦予可執行權限(如果之前沒有賦予的話)chmod+x install.sh# 6. 宣告跳過下載,執行本地安裝INSTALL_K3S_SKIP_DOWNLOAD=true ./install.sh
  1. 配置環境變量與集群權限,安裝完成後,為了能更方便地在終端直接使用 kubectl 命令,我們需要配置環境變量並調整憑證文件的讀取權限
# 7. 將 /usr/local/bin 臨時加入環境變量(若想永久生效可寫入 ~/.bashrc)exportPATH=$PATH:/usr/local/bin# 8. 修改 K3s 憑證檔案的權限,確保目前非 root 用戶也能讀取集群狀態sudochmod644/etc/rancher/k3s/k3s.yaml
  1. 驗證安裝結果,最後,執行 kubectl 命令驗證集群是否成功運行,並檢查節點狀態:
# 9. 查看集群節點狀態kubectl get nodes

将k3s路径永久写入系统配置(一劳永逸)

如果方法一在重启服务器或新建 SSH 连接后失效了,说明你的 Linux 系统的PATH确实没有默认包含/usr/local/bin。请按照以下步骤将其永久写入全局配置:

  1. 执行以下命令,将路径追加到系统的全局 profile 中:

    echo'export PATH=\$PATH:/usr/local/bin'|sudotee-a/etc/profile

    (注:修改系统全局配置文件时,请谨慎操作)

  2. 刷新系统全局配置,使其立刻生效:

    source/etc/profile
  3. 验证是否成功:
    现在断开 SSH 重新连接,或者直接在当前窗口输入:

    k3s--version

    只要能正常打印出版本号,就说明已经完美搞定了。

RELATED READING

延伸阅读

更多一线实战笔记与深度复盘,助您持续精进