Знакомство с Kubernetes. Часть 15: Установка и настройка kubectl

Sep 6, 2018 07:04 · 386 words · 2 minute read kubernetes

Kubectl — консольная утилита, без которой даже нельзя представить работу с кластером Kubernetes . В предыдущих статьях цикла мы неоднократно использовали данную утилиту для создания и управления объектами в кластере, получения информации и обновления интересующих нас ресурсов. Давайте разберемся с установкой и настройкой kubectl !

Существует множество способов установки консольной утилиты (в том числе и в зависимости от используемой операционной системы). Например, для “классической” установки kubectl в Ubuntu или Debian, следует воспользоваться следующими командами:

Для Ubuntu также существует вариант установки утилиты с помощью пакетного менеджера snap :

В операционных системах CentOS, RHEL или Fedora установка будет выглядеть так:

Для MacOS можно воспользоваться любым из следующих способов установки утилиты kubectl :

Даже пользователи ОС Windows могут себе позволить установку kubectl :

Помимо приведенных выше команд, установить kubectl можно и как часть Google Cloud SDK:

И воспользоваться для установки утилитой curl :

Для доступа к кластеру Kubernetes утилите kubectl необходим конфигурационный файл (по умолчанию расположен в

/.kube/config ), который создается автоматически. Подробнее о настройке доступа можно узнать здесь.

В kubectl есть отличное встроенное автодополнение для оболочек bash и zsh. Настроить его несложно — для начала нужно установить пакет bash-completion :

И добавляем автодополнение в оболочку:

Если вы в качестве оболочки используете zsh, то необходимо отредактировать файл

/.zshrc , добавив в него следующие строки:

В случае использования Oh-My-Zsh, то в файле

/.zshrc нужно отредактировать строку с плагинами, например:

Больше полезной информации об утилите kubectl и примеров можно найти по ссылке.

Install Kubernetes CLI on Windows 10

Rahil Maknojia

Read more posts by this author.

Rahil Maknojia

If you are looking to access Kubernetes Cluster from your windows machine. Look no further! I will show you how to install Kubernetes kubectl command line utility by leveraging Chocolatey installer.

Note. I will be using Windows 10 to demonstrate.

Now lets go ahead and get started by opening PowerShell as administrator and execute below command.

Now that Chocolatey has been installed, we will go ahead with Kubernetes CLI setup.

Install Kubernetes CLI

Open PowerShell as an administrator and execute below command.

You will be prompted to confirm if you want to proceed forward with the installation. Go ahead and say yes by typing Y and hit enter.

Connect to Kubernetes Cluster with Kubectl

Once you have install Kubernetes cli. Go to your Kubernetes master node and copy config file from

/.kube/config to your windows machine to any location. We will move that file to required location once we create .kube directory on windows. Follow below steps.

Open PowerShell as an administrator and execute below commands.

Above command will take you to your user home directory. In user home directory create folder called .kube . If it already exist, you can skip this step.

Once the above directory has been created, we need to copy config file from Kubernetes master node to .kube folder. Earlier I mentioned to copy config file to your windows machine. Take that file and drop it on your under

\.kube location path.

Basic operations

After you have followed steps as shown above, let’s go ahead and test connectivity with your Kubernetes cluster.

If above command returns name of the cluster, then you have applied changes successfully. Below command will get information from your master node.

For me I received following output. Yours may vary depending on your cluster configuration.

Let’s execute one more command to ensure we are successfully connected to the Kubenetes cluster.

If you received something similar to what I have received below, then you are fully connected to the cluster and you can go ahead and manage your cluster from windows machine.

If you have any questions or having trouble setting up kubernetes-cli on your windows machine. Drop in a comment below and I would be happy to help you out.

Subscribe to TEKSpace

Get the latest posts delivered right to your inbox

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

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

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

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

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

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

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

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

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

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

Сделайте двоичный файл kubectl исполняемым:

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

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

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

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

Если вы используйте Ubuntu или другой Linux-дистрибутив, в котором есть пакетный менеджер snap, kubectl доступен в виде приложения snap.

Если вы работаете в Linux и используете пакетный менеджер Homebrew, то kubectl можно установить через него.

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

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

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

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

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

Сделайте двоичный файл kubectl исполняемым:

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Основные сведения

Скрипт дополнения ввода kubectl для Bash может быть сгенерирован с помощью команды kubectl completion bash . Подключение скрипта дополнения ввода в вашу оболочку включает поддержку автозаполнения ввода для kubectl.

Однако скрипт дополнения ввода зависит от bash-completion, поэтому вам нужно сначала установить этот пакет (вы можете выполнить команду type _init_completion , чтобы проверить, установлен ли у вас уже bash-completion).

Установка bash-completion

bash-completion можно установить через многие менеджеры пакеты (см. здесь). Вы можете установить его с помощью apt-get install bash-completion или yum install bash-completion и т.д.

Приведенные выше команды создадут файл /usr/share/bash-completion/bash_completion , который является основным скриптом bash-completion. В зависимости от используемого менеджера пакетов, вы можете подключить этот файл в файле

Чтобы убедиться, что этот скрипт выполняется, перезагрузите оболочку и выполните команду type _init_completion . Если команда отработала успешно, установка сделана правильно, в противном случае добавьте следующее содержимое в файл

Перезагрузите вашу оболочку и убедитесь, что bash-completion правильно установлен, напечатав в терминале type _init_completion .

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

Теперь нужно убедиться, что скрипт дополнения ввода kubectl выполняется во всех сессиях командной оболочки. Есть два способа сделать это:

Добавьте запуск скрипта дополнения ввода в файл

Добавьте скрипт дополнения ввода в директорию /etc/bash_completion.d :

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

Оба подхода эквивалентны. После перезагрузки вашей оболочки, должны появляться дополнения ввода kubectl.

Основные сведения

Скрипт дополнения ввода kubectl для Bash может быть сгенерирован с помощью команды kubectl completion bash . Подключение скрипта дополнения ввода в вашей оболочке включает поддержку автозаполнения ввода для kubectl.

Однако скрипт дополнения ввода kubectl зависит от пакета bash-completion, который первым делом нужно установить.

Установка bash-completion

Вы можете проверить, установлен ли у вас bash-completion v2, набрав команду type _init_completion . Если он не установлен, вы можете сделать это с помощью Homebrew:

Как указано в выводе этой команды, добавьте следующий код в файл

Перезагрузите вашу командную оболочку и убедитесь, что bash-completion v2 корректно установлен, напечатав в терминале type _init_completion .

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

Теперь нужно убедиться, что скрипт дополнения ввода kubectl выполняется во всех сессиях командной оболочки. Есть два способа сделать это:

Добавьте запуск скрипта дополнения ввода в файл

Добавьте скрипт дополнения ввода в директорию /etc/bash_completion.d :

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

Если вы установили kubectl с помощью Homebrew (как описано выше), то скрипт дополнения ввода kubectl уже должен быть находится в /usr/local/etc/bash_completion.d/kubectl . В этом случае вам не нужно ничего делать.

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

Скрипт дополнения ввода kubectl для Zsh может быть сгенерирован с помощью команды kubectl completion zsh . Подключение скрипта дополнения ввода в вашу оболочку включает поддержку автозаполнения ввода для kubectl.

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

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

После перезагрузки командной оболочки должны появляться дополнения ввода kubectl.

Если появляется такая ошибка как complete:13: command not found: compdef , то добавьте следующее содержимое в начало вашего файла

Что дальше

• Установка Minikube
• Смотрите руководства по установке, чтобы узнать больше про создание кластеров.
• Learn how to launch and expose your application.
• Если у вас нет доступа к кластеру, который не создавали, посмотрите страницу Совместный доступ к кластеру.
• Read the kubectl reference docs

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

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

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

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

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

Если вы видите VMX в выводе (должен быть окрашенным), значит в вашем компьютере поддерживается виртуализация VT-x.

Чтобы проверить, поддерживается ли виртуализация в Windows 8 и выше, выполните следующую команду в Windows Terminal или в командной строке.

Если вы видите следующий вывод, значит виртуализация поддерживается в Windows.

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

Установка minikube

Установка kubectl

Убедитесь, что у вас установлен kubectl. Вы можете установить kubectl согласно инструкциям в разделе Установка и настройка kubectl.

Установка Hypervisor

Если у вас ещё не установлен гипервизор, установите один из них:

• KVM, который также использует QEMU

Minikube также поддерживает опцию —vm-driver=none , которая запускает компоненты Kubernetes на хосте, а не на виртуальной машине. Для использования этого драйвера требуется только Docker и Linux, но не гипервизор.

Если вы используете драйвер none в Debian и его производных, используйте пакеты .deb для Docker, а не snap-пакет, который не работает с Minikube. Вы можете скачать .deb -пакеты с сайта Docker.

Minikube также поддерживает vm-driver=podman , похожий на драйвер Docker. Podman, работающий с правами суперпользователя (пользователь root) — это лучший способ гарантировать вашим контейнерам полный доступ ко всем возможностям в системе.

Установка Minikube через пакет

Доступны экспериментальные пакеты для Minikube; Вы можете загрузить пакеты для Linux (AMD64) со страницы релизов Minikube на GitHub.

Используйте пакетный менеджер в вашем дистрибутиве Linux для установки нужного пакета.

Установка Minikube с помощью прямой ссылки

Вы также можете загрузить двоичный файл и использовать его вместо установки пакета:

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

Установка Minikube через Homebrew

В качестве ещё одной альтернативы вы можете установить Minikube с помощью Linux Homebrew:

Установка kubectl

Убедитесь, что у вас установлен kubectl. Вы можете установить kubectl согласно инструкциям в разделе Установка и настройка kubectl.

Установка Hypervisor

Если у вас ещё не установлен гипервизор, установите один из них:

Установка Minikube

Простейший способ установить Minikube в macOS — использовать Homebrew:

Вы также можете установить его в macOS, загрузив двоичный файл:

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

Установка kubectl

Убедитесь, что у вас установлен kubectl. Вы можете установить kubectl согласно инструкциям в разделе Установка и настройка kubectl.

Установка Hypervisor

Если у вас ещё не установлен гипервизор, установите один из них:

Установка Minikube с помощью Chocolatey

Простейший способ установить Minikube в Windows — использовать Chocolatey (запущенный с правами администратора):

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

Установка Minikube с помощью исполняемого файла установки

Для ручной установки Minikube в Windows с помощью установщика Windows, загрузите и запустите установщик minikube-installer.exe .

Установка Minikube с помощью прямой ссылки

Для ручной установки Minikube в Windows, загрузите minikube-windows-amd64 , переименуйте его в minikube.exe и добавьте его в директорию исполняемых файлов.

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

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

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

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

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

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

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

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

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