Cài đặt bộ công cụ

• 1: Cài đặt và cấu hình kubectl
• 2: Cài đặt và cấu hình kubectl trên Linux
• 3: Cài đặt Minikube

1 - 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ạn 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.32.0 trên Linux, hãy nhập như sau:

   curl -LO https://dl.k8s.io/release/v1.32.0/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.32.0 trên macOS, gõ:

   curl -LO https://dl.k8s.io/release/v1.32.0/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.32.0 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.32.0/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>]
   

   Lưu ý:

   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
   

   Lưu ý:

   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
   

   Lưu ý:

   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

Tiếp theo là gì

• 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

2 - Cài đặt và cấu hình kubectl trên Linux

Trước khi bạn bắt đầu

Bạn cần sử dụng phiên bản kubectl có chênh lệch không quá một phiên bản phụ (minor) so với Kubernetes cluster của bạn. Ví dụ: Một kubectl phiên bản v1.32 có thể tương tác với các control plane phiên bản v1.31, v1.32 và v1.33. Việc sử dụng kubectl với phiên bản mới nhất và chênh lệch không quá một phiên bản phụ sẽ giúp tránh các sự cố ngoài dự kiến.

Cài đặt kubectl trên Linux

Bạn có thể cài đặt kubectl trên Linux bằng các phương pháp sau:

• Cài đặt tệp binary kubectl bằng curl trên Linux
• Cài đặt bằng trình quản lý gói của hệ điều hành
• Cài đặt bằng các trình quản lý gói khác

Cài đặt tệp binary kubectl bằng curl trên Linux

1. Tải xuống phiên bản mới nhất bằng lệnh:

   • x86-64
   • ARM64

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

   
      curl -LO "https://dl.k8s.io/release/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/linux/arm64/kubectl"
      

   Lưu ý:

   Để tải một phiên bản cụ thể, hãy thay thế phiên bản cụ thể vào câu lệnh sau $(curl -L -s https://dl.k8s.io/release/stable.txt).

   Ví dụ, để tải phiên bản 1.32.0 với Linux x86-64, gõ:

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

   Đối với Linux ARM64:

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

2. Xác minh tệp binary (bước này không bắt buộc)

   Tải xuống tệp checksum của kubectl:

   • x86-64
   • ARM64

   
      curl -LO "https://dl.k8s.io/release/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/linux/amd64/kubectl.sha256"
      

   
      curl -LO "https://dl.k8s.io/release/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/linux/arm64/kubectl.sha256"
      

   Xác minh tệp binary kubectl với tệp checksum:

   echo "$(cat kubectl.sha256)  kubectl" | sha256sum --check
   

   Nếu hợp lệ, kết quả sẽ là:

   kubectl: OK
   

   Nếu việc kiểm tra thất bại, bạn sẽ nhận được thông báo:

   kubectl: FAILED
   sha256sum: WARNING: 1 computed checksum did NOT match
   

   Lưu ý:

   Bạn cần phải tải tệp binary và checksum cùng một phiên bản.

3. Cài đặt kubectl

   sudo install -o root -g root -m 0755 kubectl /usr/local/bin/kubectl
   

   Lưu ý:

   Nếu bạn không có quyền root, bạn có thể cài kubectl vào thư mục ~/.local/bin:

   chmod +x kubectl
   mkdir -p ~/.local/bin
   mv ./kubectl ~/.local/bin/kubectl
   # Thêm ~/.local/bin vào $PATH
   

4. Kiểm tra phiên bản đã cài đặt:

   kubectl version --client
   

   Hoặc để xem chi tiết hơn:

   kubectl version --client --output=yaml
   

Cài đặt bằng trình quản lý gói của hệ điều hành

• Dùng APT (Debian/Ubuntu)
• Dùng YUM (Red Hat/CentOS)
• Dùng Zypper (SUSE)

sudo apt-get update
sudo apt-get install -y apt-transport-https ca-certificates curl gnupg

sudo mkdir -p -m 755 /etc/apt/keyrings
curl -fsSL https://pkgs.k8s.io/core:/stable:/v1.32/deb/Release.key | sudo gpg --dearmor -o /etc/apt/keyrings/kubernetes-apt-keyring.gpg
sudo chmod 644 /etc/apt/keyrings/kubernetes-apt-keyring.gpg

echo 'deb [signed-by=/etc/apt/keyrings/kubernetes-apt-keyring.gpg] https://pkgs.k8s.io/core:/stable:/v1.32/deb/ /' | sudo tee /etc/apt/sources.list.d/kubernetes.list
sudo chmod 644 /etc/apt/sources.list.d/kubernetes.list

sudo apt-get update
sudo apt-get install -y kubectl

Cài đặt bằng các trình quản lý gói khác

• Snap
• Homebrew

snap install kubectl --classic
kubectl version --client

brew install kubectl
kubectl version --client

Xác minh cấu hình kubectl

Để kubectl có thể tìm kiếm và truy cập vào Kubernetes cluster, nó cần một tệp kubeconfig, được tạo tự động khi chúng ta tạo một cluster bằng kube-up.sh hoặc khi triển khai thành công cluster Minikube.
Mặc định, thông tin cấu hình của kubectl được định nghĩa trong ~/.kube/config.

Chúng ta có thể kiểm tra xem kubectl đã được cấu hình đúng chưa bằng cách kiểm tra thông tin của cluster:

kubectl cluster-info

Nếu bạn thấy kết quả trả về là một đường dẫn, thì kubectl đã được cấu hình đúng để truy cập cluster của chúng ta.

Nếu bạn thấy thông báo tương tự như dưới đây, điều đó có nghĩa kubectl chưa được cấu hình đúng hoặc không thể kết nối tới Kubernetes cluster.

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

Thông báo trên, được kubectl trả về, mong bạn kiểm tra lại đường dẫn (bao host và port) tới cluster đã đúng hay chưa

Ví dụ, nếu bạn đang dự định tạo một Kubernetes cluster trên máy tính cá nhân, bạn sẽ cần cài đặt một công cụ như Minikube trước, sau đó chạy lại các lệnh đã nêu ở trên.

Nếu lệnh kubectl cluster-info trả về đường dẫn nhưng bạn vẫn không thể truy cập vào cluster, hãy kiểm tra cấu hình kỹ hơn bằng lệnh sau:

kubectl cluster-info dump

Xử lý lỗi 'No Auth Provider Found'

Ở phiên bản 1.26 của Kubernetes, kubectl đã loại bỏ tính năng xác thực tích hợp sẵn cho các dịch vụ Kubernetes được quản lý bởi các nhà cung cấp đám mây dưới đây. Các nhà cung cấp này đã phát hành plugin kubectl để hỗ trợ xác thực dành riêng cho nền tảng của họ. Tham khảo tài liệu hướng dẫn của nhà cung cấp để biết thêm thông tin:

• Azure AKS: kubelogin plugin
• Google Kubernetes Engine: gke-gcloud-auth-plugin

(Lưu ý: cùng một thông báo lỗi cũng có thể xuất hiện vì các lý do khác không liên quan đến sự thay đổi này.)

Các cấu hình và plugin tùy chọn của kubectl

Bật tự động hoàn tất trong shell

kubectl hỗ trợ Bash, Zsh, Fish và PowerShell. Xem hướng dẫn đầy đủ:

• Bash
• Fish
• Zsh

sudo apt-get install bash-completion

sudo yum install bash-completion

source /usr/share/bash-completion/bash_completion

type _init_completion

```bash
echo 'source <(kubectl completion bash)' >>~/.bashrc
```

```bash
kubectl completion bash | sudo tee /etc/bash_completion.d/kubectl > /dev/null
sudo chmod a+r /etc/bash_completion.d/kubectl
```

echo 'alias k=kubectl' >>~/.bashrc
echo 'complete -o default -F __start_kubectl k' >>~/.bashrc

source ~/.bashrc

kubectl completion fish

kubectl completion fish | source

kubectl completion zsh

source <(kubectl completion zsh)

autoload -Uz compinit
compinit

Cài đặt plugin kubectl convert

Đây là một plugin của kubectl, cho phép bạn chuyển đổi các tệp manifest giữa các phiên bản API khác nhau.
Điều này đặc biệt hữu ích khi bạn muốn cập nhật manifest sang phiên bản API mới hơn còn được hỗ trợ, khi cập nhật phiên bản mới cho Kubernetes.

Để biết thêm thông tin, vui lòng truy cập:
migrate to non deprecated apis

1. Tải xuống binary mới nhất:

   • x86-64
   • ARM64

   
      curl -LO "https://dl.k8s.io/release/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/linux/amd64/kubectl-convert"
      

   
      curl -LO "https://dl.k8s.io/release/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/linux/arm64/kubectl-convert"
      

   Validate the kubectl-convert binary against the checksum file:

   echo "$(cat kubectl-convert.sha256) kubectl-convert" | sha256sum --check
   

   If valid, the output is:

   kubectl-convert: OK
   

   If the check fails, sha256 exits with nonzero status and prints output similar to:

   kubectl-convert: FAILED
   sha256sum: WARNING: 1 computed checksum did NOT match
   

   Lưu ý:

   Download the same version of the binary and checksum.

2. Cài đặt plugin kubectl-convert:

   sudo install -o root -g root -m 0755 kubectl-convert /usr/local/bin/kubectl-convert
   

3. Xác minh plugin đã cài thành công:

   kubectl convert --help
   

4. Dọn các tệp cài đặt sau khi hoàn tất:

   rm kubectl-convert kubectl-convert.sha256
   

Tiếp theo là gì

Xem thêm tại Bước tiếp theo.

3 - Cài đặt Minikube

Tài liệu này sẽ hướng dẫn các bạn cách cài đặt Minikube, một công cụ chạy một Kubernetes cluster chỉ gồm một node trong một máy ảo (VM) trên máy tính của bạn.

Trước khi bạn bắt đầu

• Linux
• macOS
• Windows

grep -E --color 'vmx|svm' /proc/cpuinfo

sysctl -a | grep -E --color 'machdep.cpu.features|VMX' 

systeminfo

Hyper-V Requirements:     VM Monitor Mode Extensions: Yes
                          Virtualization Enabled In Firmware: Yes
                          Second Level Address Translation: Yes
                          Data Execution Prevention Available: Yes

Hyper-V Requirements:     A hypervisor has been detected. Features required for Hyper-V will not be displayed.

Cài đặt minikube

• Linux
• macOS
• Windows

curl -Lo minikube https://storage.googleapis.com/minikube/releases/latest/minikube-linux-amd64 \
  && chmod +x minikube

sudo mkdir -p /usr/local/bin/
sudo install minikube /usr/local/bin/

brew install minikube

brew install minikube

curl -Lo minikube https://storage.googleapis.com/minikube/releases/latest/minikube-darwin-amd64 \
  && chmod +x minikube

sudo mv minikube /usr/local/bin

choco install minikube

Dọn dẹp local state

Nếu bạn đã cài Minikube trước đó, và chạy:

minikube start

và tiếp đó minikube start trả về lỗi:

machine does not exist

thì tiếp theo bạn cần xóa bỏ local state của minikube:

minikube delete

Tiếp theo là gì

• Chạy Kubernetes trên local thông qua Minikube