Cài đặt và cấu hình kubectl

Công cụ command-line trong Kubernetes, kubectl, cho phép bạn thực thi các câu lệnh trong Kubernetes clusters. Bạn có thể sử dụng kubectl để triển khai các ứng dụng, theo dõi và quản lý tài nguyên của cluster, và xem log. Để biết các thao tác của kubectl, truy cập tới Tổng quan về kubectl.

Trước khi bắt đầu

Bạn cần phải sử dụng phiên bản kubectl sai lệch không quá một phiên bản với version của cluster. Ví dụ, một client v1.2 nên được hoạt động với master v1.1, v1.2 và v1.3. Sử dụng phiên bản mới nhất của kubectl giúp tránh được các vấn đề không lường trước được.

Cài đặt kubectl trên Linux

Cài đặt kubectl binary với curl trên Linux

1. Tải về phiên bản mới nhất với câu lệnh:

   curl -LO https://dl.k8s.io/release/`curl -LS https://dl.k8s.io/release/stable.txt`/bin/linux/amd64/kubectl
   

   Để tải về phiên bản cụ thể, hãy thay thế phần $(curl -LS https://dl.k8s.io/release/stable.txt) trong câu lệnh với một phiên bản cụ thể.

   Ví dụ như, để tải về phiên bản 1.28.4 trên Linux, hãy nhập như sau:

   curl -LO https://dl.k8s.io/release/v1.28.4/bin/linux/amd64/kubectl
   

2. Tạo kubectl binary thực thi.

   chmod +x ./kubectl
   

3. Đưa bản binary vào biến môi trường PATH của bạn.

   sudo mv ./kubectl /usr/local/bin/kubectl
   

4. Kiểm tra chắc chắn rằng phiên bản bạn cài là mới nhất:

   kubectl version
   

Cài đặt kubectl sử dụng trình quản lý gói

• Ubuntu, Debian or HypriotOS
• CentOS, RHEL or Fedora

sudo apt-get update && sudo apt-get install -y apt-transport-https
curl -s https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo apt-key add -
echo "deb https://apt.kubernetes.io/ kubernetes-xenial main" | sudo tee -a /etc/apt/sources.list.d/kubernetes.list
sudo apt-get update
sudo apt-get install -y kubectl

cat <<EOF > /etc/yum.repos.d/kubernetes.repo
[kubernetes]
name=Kubernetes
baseurl=https://packages.cloud.google.com/yum/repos/kubernetes-el7-x86_64
enabled=1
gpgcheck=1
repo_gpgcheck=1
gpgkey=https://packages.cloud.google.com/yum/doc/rpm-package-key.gpg
EOF
yum install -y kubectl

Cài đặt với snap

Nếu bạn đang sử dụng Ubuntu hoặc distro Linux khác hỗ trợ trình quản lý gói snap, thì kubectl đã có sẵn trong snap.

1. Chuyển sang user snap và thực thi câu lệnh cài đặt:

   sudo snap install kubectl --classic
   

2. Kiểm tra phiên bản bạn vừa cài là mới nhất:

   kubectl version
   

Cài đặt kubectl trên macOS

Cài đặt kubectl binary với curl trên macOS

1. Tải về phiên bản mới nhất:

   curl -LO "https://dl.k8s.io/release/$(curl -LS https://dl.k8s.io/release/stable.txt)/bin/darwin/amd64/kubectl"
   

   Để tải về phiên bản cụ thể, hãy thay thế phần $(curl -LS https://dl.k8s.io/release/stable.txt) trong câu lệnh với phiên bản cụ thể.

   Ví dụ, để tải về phiên bản 1.28.4 trên macOS, gõ:

   curl -LO https://dl.k8s.io/release/v1.28.4/bin/darwin/amd64/kubectl
   

2. Tạo kubectl binary thực thi.

   chmod +x ./kubectl
   

3. Đưa bản binary vào biến môi trường PATH của bạn.

   sudo mv ./kubectl /usr/local/bin/kubectl
   

4. Kiểm tra chắc chắn rằng phiên bản bạn cài là mới nhất:

   kubectl version
   

Cài đặt với Homebrew trên macOS

Nếu bạn đang trên macOS và sử dụng trình quản lý gói Homebrew, bạn có thể cài đặt kubectl với Homebrew.

1. Chạy câu lệnh cài đặt:

   brew install kubectl 
   

   hoặc

   brew install kubernetes-cli
   

2. Kiểm tra chắc chắn rằng phiên bản bạn cài là mới nhất:

   kubectl version
   

Cài đặt với Macports trên macOS

Nếu bạn đang trên macOS và sử dụng trình quản lý gói Macports, bạn có thể cài đặt kubectl với Macports.

1. Chạy câu lệnh cài đặt:

   sudo port selfupdate
   sudo port install kubectl
   

2. Kiểm tra chắc chắn rằng phiên bản bạn cài là mới nhất:

   kubectl version
   

Cài đặt kubectl trên Windows

Cài đặt kubectl binary với curl trên Windows

1. Tải về phiên bản mới nhất 1.28.4 từ đường dẫn này.

   Hoặc nếu bạn đã cài đặt curl, hãy sử dụng câu lệnh sau:

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

   Để tìm ra phiên bản ổn định mới nhất, hãy xem https://dl.k8s.io/release/stable.txt.

2. Đưa bản binary vào biến môi trường PATH của bạn.

3. Kiểm tra chắn chắn phiên bản kubectl giống với bản đã tải về:

   kubectl version
   

Cài đặt với Powershell từ PSGallery

Nếu bạn đang ở trên Windows và sử dụng trình quản lý gói Powershell Gallery, bạn có thể cài đặt và cập nhật kubectl với Powershell.

1. Thực thi các câu lệnh cài đặt sau (hãy đảm bảo bạn tự định nghĩa DownloadLocation):

   Install-Script -Name install-kubectl -Scope CurrentUser -Force
   install-kubectl.ps1 [-DownloadLocation <path>]
   

   Ghi chú: Nếu bạn không định nghĩa DownloadLocation, kubectl sẽ được cài đặt ở thư mục temp của user.

   Bản cài đặt sẽ tạo ra $HOME/.kube và hướng dẫn để tạo ra file cấu hình

2. Kiểm tra chắc chắn rằng phiên bản bạn cài là mới nhất:

   kubectl version
   

   Ghi chú: Cập nhật của bản cài đặt sẽ được thực hiện khi chạy lại các câu lệnh từ bước 1.

Cài đặt trên Windows sử dụng Chocolatey hoặc Scoop

Để cài đặt kubectl trên Windows bạn có thể sử dụng trình quản lý gói Chocolatey hoặc bộ cài đặt câu lệnh Scoop.

• choco
• scoop

choco install kubernetes-cli

scoop install kubectl

```
kubectl version
```

3. Di chuyển tới thư mục home của bạn:

   cd %USERPROFILE%
   

4. Tạo thư mục .kube:

   mkdir .kube
   

5. Di chuyển tới thư mục .kube bạn vừa mới tạo:

   cd .kube
   

6. Cấu hình kubectl để sử dụng Kubernetes cluster từ xa:

   New-Item config -type file
   

   Ghi chú: Chỉnh sửa file cấu hình với trình soạn thảo văn bản, như là Notepad.

Tải xuống từ một phần của Google Cloud SDK

Bạn có thể cài đặt kubectl từ một phần của Google Cloud SDK.

1. Cài đặt Google Cloud SDK.

2. Thực thi câu lệnh cài đặt kubectl:

   gcloud components install kubectl
   

3. Kiểm tra chắc chắn rằng phiên bản bạn cài là mới nhất:

   kubectl version
   

Xác minh cấu hình kubectl

Để kubectl tìm kiếm và truy cập Kubernetes cluster, nó cần một kubeconfig file, được tự động tạo ra khi bạn tạo mới một cluster sử dụng kube-up.sh hoặc triển khai thành công một Minikube cluster. Mặc định thì cấu hình của kubectl được xác định tại ~/.kube/config.

Kiểm tra kubectl được cấu hình đúng bằng việc xem trạng thái của cluster:

kubectl cluster-info

Nếu bạn trông thấy một URL phản hồi, thì kubectl đã được cấu hình đúng để truy cập vào cluster của bạn.

Nếu bạn trông thấy một tin nhắn tương tự bên dưới, thì kuberctl chưa được cấu hình đúng hoặc chưa thể kết nối với Kubernetes cluster.

The connection to the server <server-name:port> was refused - did you specify the right host or port?

Ví dụ như, nếu bạn đang định chạy một Kubernetes cluster trên laptop của bạn (locally), bạn sẽ cần một công cụ như Minikube được cài trước đó và chạy lại các câu lệnh bên trên.

Nếu kubectl cluster-info trả về url nhưng bạn không thể truy cập vào cluster của bạn, thì hãy kiểm tra nó đã được cấu hình đúng hay chưa, bằng cách:

kubectl cluster-info dump

Các lựa chọn cấu hình kubectl

Kích hoạt shell autocompletion

kubectl cung cấp autocompletion hỗ trợ cho Bash and Zsh, giúp bạn giảm thiểu việc phải gõ nhiều câu lệnh.

Bên dưới đâu là các bước để thiết lập autocompletion cho Bash (bao gồm sự khác nhau giữa Linux và macOS) và Zsh.

• Bash trên Linux
• Bash trên macOS
• Zsh

source /usr/share/bash-completion/bash_completion

brew install bash-completion@2

export BASH_COMPLETION_COMPAT_DIR="/usr/local/etc/bash_completion.d"
[[ -r "/usr/local/etc/profile.d/bash_completion.sh" ]] && . "/usr/local/etc/profile.d/bash_completion.sh"

source <(kubectl completion zsh)

echo 'alias k=kubectl' >>~/.zshrc
echo 'compdef __start_kubectl k' >>~/.zshrc

autoload -Uz compinit
compinit

Có gì tiếp theo

• Cài đặt Minikube
• Xem hướng dẫn bắt đầu để biết thêm về việc tạo cluster.
• Tìm hiểu cách khởi chạy và hiển thị ứng dụng của bạn.
• Nếu bạn cần quyền truy cập vào một cluster mà bạn không tạo, hãy xem tài liệu Sharing Cluster Access.
• Đọc tài liệu tham khảo của kubectl