Установка инструментов

• 1: Установка и настройка kubectl
• 2: Установка Minikube

1 - Установка и настройка kubectl

Инструмент командной строки Kubernetes kubectl позволяет запускать команды для кластеров Kubernetes. Вы можете использовать kubectl для развертывания приложений, проверки и управления ресурсов кластера, а также для просмотра логов. Полный список возможных операций для kubectl смотрите в Обзоре kubectl.

Подготовка к работе

Используемая вами мажорная версия kubectl не должна отличаться от той, которая используется в кластере. Например, версия v1.2 может работать с версиями v1.1, v1.2 и v1.3. Использование последней версии kubectl поможет избежать непредвиденных проблем.

Установка kubectl в Linux

Установка бинарного файла kubectl с помощью curl в Linux

1. Загрузите последнюю версию с помощью команды:

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

   Чтобы загрузить определенную версию, вставьте в фрагмент команды $(curl -LS https://dl.k8s.io/release/stable.txt) нужную версию.

   Например, команда загрузки версии 1.31.0 для Linux будет выглядеть следующим образом:

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

2. Сделайте бинарный файл kubectl исполняемым:

   chmod +x ./kubectl
   

3. Переместите бинарный файл в директорию из переменной окружения PATH:

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

4. Убедитесь, что установлена последняя версия:

   kubectl version --client
   

Установка с помощью встроенного пакетного менеджера

• Ubuntu, Debian или HypriotOS
• CentOS, RHEL или 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

sudo 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
sudo yum install -y kubectl

Установка с помощью стороннего пакетного менеджера

• Snap
• Homebrew

snap install kubectl --classic

kubectl version

brew install kubectl

kubectl version

Установка kubectl в macOS

Установка бинарного файла kubectl с помощью curl в macOS

1. Загрузите последнюю версию:

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

   Чтобы загрузить определенную версию, вставьте в фрагмент команды $(curl -LS https://dl.k8s.io/release/stable.txt) нужную версию.

   Например, команда загрузки версии 1.31.0 для macOS будет выглядеть следующим образом:

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

2. Сделайте бинарный файл kubectl исполняемым:

   chmod +x ./kubectl
   

3. Переместите бинарный файл в директорию из переменной окружения PATH:

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

4. Убедитесь, что установлена последняя версия:

   kubectl version --client
   

Установка с помощью Homebrew в macOS

Если вы используете macOS и Homebrew, то kubectl можно установить с помощью пакетного менеджера Homebrew.

1. Выполните команду установки:

   brew install kubectl
   

   Или:

   brew install kubernetes-cli
   

2. Убедитесь, что установлена последняя версия:

   kubectl version --client
   

Установка с помощью Macports в macOS

Если вы используйте macOS и Macports, то kubectl можно установить с помощью пакетного менеджера Macports.

1. Выполните команду установки:

   sudo port selfupdate
   sudo port install kubectl
   

2. Убедитесь, что установлена последняя версия:

   kubectl version --client
   

Установка kubectl в Windows

Установка бинарного файла kubectl с помощью curl в Windows

1. Загрузите последнюю версию 1.31.0 по этой ссылке.

   Либо, если у вас установлен curl, выполните команду ниже:

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

   Последнюю стабильную версию (например, при написании скриптов) вы можете узнать из файла по ссылке https://dl.k8s.io/release/stable.txt.

2. Переместите бинарный файл в директорию из переменной окружения PATH:

3. Убедитесь, что версия kubectl соответствует загружённой:

   kubectl version --client
   

Установка с помощью Powershell из PSGallery

Если вы работаете в Windows и используете менеджер пакетов Powershell Gallery, вы можете установить и обновить kubectl с помощью Powershell.

1. Выполните команды по установке (обязательно укажите DownloadLocation):

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

   Примечание:

   Если вы не укажете DownloadLocation, то kubectl будет установлен во временную директорию пользователя.

   Установщик создаст $HOME/.kube вместе с конфигурационным файлом.

2. Убедитесь, что установлена последняя версия:

   kubectl version --client
   

   Примечание:

   Обновить kubectl можно путём выполнения двух команд, перечисленных в шаге 1.

Установка в Windows с помощью Chocolatey или Scoop

Для установки kubectl в Windows вы можете использовать либо менеджер пакетов Chocolatey, либо установщик в командной строке Scoop.

• choco
• scoop

choco install kubernetes-cli

scoop install kubectl

1. Убедитесь, что установлена последняя версия:

   kubectl version --client
   

2. Перейдите в домашнюю директорию:

   cd %USERPROFILE%
   

3. Создайте директорию .kube:

   mkdir .kube
   

4. Перейдите в созданную только что директорию .kube:

   cd .kube
   

5. Настройте kubectl, чтобы было возможно использовать удаленный кластер Kubernetes:

   New-Item config -type file
   

   Примечание:

   Отредактируйте конфигурационный файл, используя ваш любимый текстовый редактор или обычный Notepad.

Установка kubectl из SDK Google Cloud

Вы можете использовать kubectl из SDK Google Cloud, который использует этот CLI-инструмент.

1. Установите Google Cloud SDK.

2. Выполните команду для установки kubectl:

   gcloud components install kubectl
   

3. Убедитесь, что установлена последняя версия:

   kubectl version --client
   

Проверка конфигурации kubectl

Чтобы kubectl мог найти и получить доступ к кластеру Kubernetes, нужен файл kubeconfig, который создаётся автоматически при создании кластера с помощью скрипта kube-up.sh или при успешном развертывании кластера Minikube. По умолчанию конфигурация kubectl находится в ~/.kube/config.

Посмотрите на состояние кластера, чтобы убедиться, что kubectl правильно сконфигурирован:

kubectl cluster-info

Если вы видите URL в ответ, значит kubectl корректно настроен для работы с вашим кластером.

Если вы видите сообщение следующего содержания, то значит kubectl настроен некорректно или не может подключиться к кластеру Kubernetes:

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

Например, если вы собираетесь запустить кластер Kubernetes на своем ноутбуке (локально), вам потребуется сначала установить специальный для этого инструмент, например Minikube, а затем снова выполнить указанные выше команды.

Если команда kubectl cluster-info возвращает URL в ответ, но вы не можете подключиться к своему кластеру, чтобы убедиться, что он правильно настроен, воспользуйтесь этой командой:

kubectl cluster-info dump

Дополнительная конфигурация kubectl

Включение автодополнения ввода shell

kubectl поддерживает автодополнение (автозаполнение) ввода в Bash и Zsh, которое сэкономит вам много времени на набор команд.

Ниже приведены инструкции по настройке автодополнения для Bash (для Linux и macOS) и Zsh.

• Bash в Linux
• Bash в 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

Что дальше

• Установка Minikube.
• Смотрите руководства по установке, чтобы узнать больше про создание кластеров.
• Научитесь запускать и делать доступным приложение.
• Если вам нужен доступ к кластеру, созданный не вами, посмотрите страницу Configure Access to Multiple Clusters.
• Читайте референсную документацию kubectl.

2 - Установка Minikube

На этой странице рассказано, как установить Minikube, инструмент для запуска одноузлового кластера Kubernetes на виртуальной машине в персональном компьютере.

Подготовка к работе

• 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.

Установка 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

Проверка установки

Чтобы убедиться в том, что гипервизор и Minikube были установлены корректно, выполните следующую команду, которая запускает локальный кластер Kubernetes:

minikube start --vm-driver=<driver_name>

После того, как команда minikube start отработала успешно, выполните команду для проверки состояния кластера:

minikube status

Если ваш кластер запущен, то в выводе команды minikube status должно быть что-то вроде этого:

host: Running
kubelet: Running
apiserver: Running
kubeconfig: Configured

Теперь, когда вы убедились, что Minikube работает с выбранным вами гипервизором, вы можете продолжить использовать Minikube или остановить кластер. Чтобы остановить кластер выполните команду ниже:

minikube stop

Очистка локального состояния

Если вы уже установили Minikube, то выполните следующую команду:

minikube start

В таком случае команда minikube start вернёт ошибку:

machine does not exist

Чтобы исправить это, нужно очистить локальное состояние:

minikube delete

Что дальше

• Локальный запуск Kubernetes при помощи Minikube