ℹ️ Góp ý cải thiện tài liệu 
Để đóng góp chỉnh sửa, nhấp vào liên kết Gửi ticket ở khung bên phải.

Kubectl là công cụ chính để tương tác với cụm Kubernetes. Tài liệu này hướng dẫn bạn cách tải về và cấu hình kubectl sao cho phù hợp với phiên bản Kubernetes mà bạn đang chạy. 

 

Cài đặt hoặc cập nhật Kubectl

Chủ đề này hướng dẫn bạn cách tải xuống và cài đặt hoặc cập nhật kubectl trên thiết bị của mình. Bạn có thể làm theo các bước bên dưới để lấy đúng phiên bản kubectl mà bạn cần.

⚠️ Lưu ý

Để đảm bảo hoạt động ổn định, phiên bản kubectl nên tương thích với phiên bản Kubernetes hiện tại đang sử dụng (±1 minor version). Ví dụ, nếu cụm Kubernetes hiện tại có version là v1.31.0, kubectl nên là v1.30.x, v1.31.x, hoặc v1.32.x.

 

Bước 1: Kiểm tra cài đặt kubectl

Xác minh xem kubectl đã được cài đặt trên thiết bị của bạn:

kubectl version --client

Nếu kubectl đã được cài đặt, lệnh trên sẽ hiển thị thông tin phiên bản, ví dụ:

Client Version: v1.31.X

Nếu không có đầu ra hoặc kubectl không được tìm thấy, tiến hành cài đặt theo các bước dưới đây.

Bước 2: Cài đặt hoặc cập nhật kubectl

Cài đặt hoặc cập nhật Kubectl trên một trong các hệ điều hành sau:

  • macOS
  • Linux (amd64)
  • Linux (arm64)
  • Windows

macOS

1. Tải xuống kubectl, chọn phiên bản phù hợp với cụm Kubernetes của bạn:

Kubernetes 1.33:

curl -O https://dl.k8s.io/release/v1.33.0/bin/darwin/amd64/kubectl

Kubernetes 1.32:

curl -O https://dl.k8s.io/release/v1.32.0/bin/darwin/amd64/kubectl

Kubernetes 1.31:

curl -O https://dl.k8s.io/release/v1.31.0/bin/darwin/amd64/kubectl

Kubernetes 1.30:

curl -O https://dl.k8s.io/release/v1.30.0/bin/darwin/amd64/kubectl

2. Cấp quyền thực thi:

chmod +x ./kubectl

3. Di chuyển kubectl vào thư mục trong PATH:

mkdir -p $HOME/bin
mv ./kubectl $HOME/bin/kubectl
export PATH=$HOME/bin:$PATH

4. Thêm vào cấu hình shell (khuyến nghị): Để sử dụng lâu dài, thêm vào tệp .bash_profile hoặc .zshrc:

echo 'export PATH=$HOME/bin:$PATH' >> ~/.bash_profile

 

Linux (amd64)

1. Tải xuống kubectl, chọn phiên bản phù hợp với cụm Kubernetes của bạn:

Kubernetes 1.33:

curl -O https://dl.k8s.io/release/v1.33.0/bin/linux/amd64/kubectl

Kubernetes 1.32:

curl -O https://dl.k8s.io/release/v1.32.0/bin/linux/amd64/kubectl

Kubernetes 1.31:

curl -O https://dl.k8s.io/release/v1.31.0/bin/linux/amd64/kubectl

Kubernetes 1.30:

curl -O https://dl.k8s.io/release/v1.30.0/bin/linux/amd64/kubectl

2. Cấp quyền thực thi:

chmod +x ./kubectl

3. Di chuyển kubectl vào thư mục trong PATH:

mkdir -p $HOME/bin
mv ./kubectl $HOME/bin/kubectl
export PATH=$HOME/bin:$PATH

4. Thêm vào cấu hình shell (khuyến nghị): Để sử dụng lâu dài, thêm vào tệp .bash_profile:

echo 'export PATH=$HOME/bin:$PATH' >> ~/.bashrc
source ~/.bashrc

 

Linux (arm64)

1. Tải xuống kubectl, chọn phiên bản phù hợp với cụm Kubernetes của bạn:

Kubernetes 1.33:

curl -O https://dl.k8s.io/release/v1.33.0/bin/linux/arm64/kubectl

Kubernetes 1.32:

curl -O https://dl.k8s.io/release/v1.32.0/bin/linux/arm64/kubectl

Kubernetes 1.31:

curl -O https://dl.k8s.io/release/v1.31.0/bin/linux/arm64/kubectl

Kubernetes 1.30:

curl -O https://dl.k8s.io/release/v1.30.0/bin/linux/arm64/kubectl

2. Cấp quyền thực thi:

chmod +x ./kubectl

3. Di chuyển kubectl vào thư mục trong PATH:

mkdir -p $HOME/bin
mv ./kubectl $HOME/bin/kubectl
export PATH=$HOME/bin:$PATH

4. Thêm vào cấu hình shell (khuyến nghị): Để sử dụng lâu dài, thêm vào tệp .bash_profile:

echo 'export PATH=$HOME/bin:$PATH' >> ~/.bashrc
source ~/.bashrc

 

Windows

1. Tải xuống kubectl, mở PowerShell và tải xuống tệp nhị phân: chọn phiên bản phù hợp với cụm Kubernetes của bạn:

Kubernetes 1.33:

curl.exe -O https://dl.k8s.io/release/v1.33.0/bin/windows/amd64/kubectl.exe

Kubernetes 1.32:

curl.exe -O https://dl.k8s.io/release/v1.32.0/bin/windows/amd64/kubectl.exe

Kubernetes 1.31:

curl.exe -O https://dl.k8s.io/release/v1.31.0/bin/windows/amd64/kubectl.exe

Kubernetes 1.30:

curl.exe -O https://dl.k8s.io/release/v1.30.0/bin/windows/amd64/kubectl.exe

2. Di chuyển kubectl vào thư mục trong PATH:

  • Tạo thư mục cho kubectl, ví dụ: C:\bin.
  • Di chuyển kubectl.exe vào thư mục:
New-Item -ItemType Directory -Force -Path C:\bin
Move-Item -Path .\kubectl.exe -Destination C:\bin\kubectl.exe
  • Thêm C:\bin vào biến môi trường PATH:
    • Mở System Properties > Environment Variables.
    • Thêm C:\bin vào biến Path của người dùng hoặc hệ thống.
  • Đóng và mở lại PowerShell để cập nhật PATH.

Bước 3: Xác minh cài đặt

Sau khi cài đặt, bạn có thể kiểm tra phiên bản kubectl:

kubectl version --client

Bước 4: Cách truy cập đếm cụm K8s