九章智算云

安装 kubectl

为了通过配置环境变量的方式使用弹性容器集群,需要先安装 kubectl。下面按操作系统分别给出步骤。

  • kubectl 更多安装细节,请参考官网安装工具
  • 不同系统或版本的操作界面可能会存在差异,请用户以实际操作过程中当前界面的显示内容为准。
  1. 下载最新稳定版的 kubectl 命令行工具,下载校验和文件,根据校验和验证 kubectl,验证通过显示 kubectl: OK(下图绿色高亮)。

    macOS 下载并验证 kubectl

    curl -LO "https://dl.k8s.io/release/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/darwin/amd64/kubectl"
    curl -LO "https://dl.k8s.io/release/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/darwin/amd64/kubectl.sha256"
    echo "$(cat kubectl.sha256)  kubectl" | shasum -a 256 --check

    $(curl -L -s https://dl.k8s.io/release/stable.txt) 替换为对应的版本号,例如 1.32.0

  2. (如果本地没有该目录)创建并设置 /usr/local/bin 目录的权限,然后将 kubectl 移动到 /usr/local/bin/kubectl

    创建目录并移动

    sudo mkdir -p /usr/local/bin
    sudo chmod 755 /usr/local/bin
    sudo mv ./kubectl /usr/local/bin/kubectl
    sudo chown root: /usr/local/bin/kubectl
  3. 测试已安装的 kubectl,确保是最新版本。

    kubectl version --client
  4. 删除校验和文件。

    rm kubectl.sha256

如果上述网络受限或下载太慢,可通过 Rancher 中国社区下载选项 下载对应安装包(本示例选择 darwin-amd64-v1.32.3-kubectl)。

Rancher 中国镜像下载

# 在文件上右键复制下载链接,替换 "rancher-path"
curl -LO "rancher-path"

# 移动并赋权
sudo mv darwin-amd64-v1.32.3-kubectl /usr/local/bin/kubectl
sudo chmod +x /usr/local/bin/kubectl
kubectl version --client
  1. 打开终端,下载适用于 Linux x86-64 的最新稳定版 kubectl

    Linux 安装步骤

    # k8s 官网下载
    curl -LO "https://dl.k8s.io/release/v1.32.0/bin/linux/amd64/kubectl"
    
    # 或 Rancher 中国镜像
    curl -LO "https://rancher-mirror.rancher.cn/kubectl/v1.32.3/linux-amd64-v1.32.3-kubectl"
  2. mv 把下载文件改名为 kubectl(如使用 K8s 官网下载,可跳过此步)。

    mv downloadfilename kubectl
  3. 添加执行权限并移动到系统路径。

    chmod +x kubectl
    mv kubectl /usr/local/bin
  4. 验证安装。

    kubectl version --client

以 Windows 11 安装 kubectl 为例。

  1. 在本地新建 kubectl 文件夹,打开后右键空白处选「在终端打开」,进入 PowerShell。

  2. 在终端中下载最新稳定版 kubectl(任选其一)。

    # k8s 官网
    curl.exe -LO "https://dl.k8s.io/release/v1.32.0/bin/windows/amd64/kubectl.exe"
    
    # 或 Rancher 中国镜像
    curl.exe -LO "https://rancher-mirror.rancher.cn/kubectl/v1.32.3/windows-amd64-v1.32.3-kubectl.exe"

    v1.32.0/v1.32.3 替换为所需的 kubectl 版本。

  3. 修改文件名为 kubectl.exe

    重命名 kubectl.exe

    Rename-Item -Path "my file.exe" -NewName "kubectl.exe"
  4. 设置环境变量。

    setx PATH "%PATH%;D:\kubectl"
  5. 验证安装。 SwanLab 调整后系统监控

    kubectl version --client

    设置环境变量后,可能需要打开新的 CMD/PowerShell 窗口,设置才生效。

如果没有安装 curl 工具,可以参考以下步骤完成 kubectl 安装。

  1. 下载最新版本的 kubectl,例如 windows-amd64-v1.32.3-kubectl.exe,改名为 kubectl.exe

  2. 右键点击此电脑/属性菜单项,进入系统/系统信息配置页面,点击高级系统设置链接。

  3. 系统属性页面中,点击环境变量按钮,进入环境变量配置页面。

  4. 系统变量区域,双击 Path 变量以编辑环境变量,并按照如下图所示新建相应的路径配置。新建完成后,单击确定按钮,即可完成环境变量配置操作。 Windows 配置 PATH

    D:\kubectlkubectl.exe 所在的目录。请根据实际情况修改。

最后更新于

这篇文档对你有帮助吗?