Install kubectl on linux

Tasks

Step-by-step instructions for performing operations with Kubernetes.

Install and Set Up kubectl

Here are a few methods to install kubectl.

Use the Kubernetes command-line tool, kubectl, to deploy and manage applications on Kubernetes. Using kubectl, you can inspect cluster resources; create, delete, and update components; and look at your new cluster and bring up example apps.

Before you begin

Use a version of kubectl that is the same version as your server or later. Using an older kubectl with a newer server might produce validation errors.

Install kubectl binary via curl

Download the latest release with the command:

To download a specific version, replace the $(curl -s https://storage.googleapis.com/kubernetes-release/release/stable.txt) portion of the command with the specific version.

For example, to download version v1.7.0 on MacOS, type:

Make the kubectl binary executable.

Move the binary in to your PATH.

Download the latest release with the command:

To download a specific version, replace the $(curl -s https://storage.googleapis.com/kubernetes-release/release/stable.txt) portion of the command with the specific version.

For example, to download version v1.7.0 on Linux, type:

Make the kubectl binary executable.

Move the binary in to your PATH.

Download the latest release v1.7.0 from this link.

Or if you have curl installed, use this command:

To find out the latest stable version (for example, for scripting), take a look at https://storage.googleapis.com/kubernetes-release/release/stable.txt

Add the binary in to your PATH.

Download as part of the Google Cloud SDK

kubectl can be installed as part of the Google Cloud SDK.

Run the following command to install kubectl :

Install with snap on Ubuntu

kubectl is available as a snap application.

If you are on Ubuntu or one of other Linux distributions that support snap package manager, you can install with:

Run kubectl version to verify that the verison you’ve installed is sufficiently up-to-date.

Install with Homebrew on macOS

If you are on macOS and using Homebrew package manager, you can install with:

Run kubectl version to verify that the verison you’ve installed is sufficiently up-to-date.

Install with Chocolatey on Windows

If you are on Windows and using Chocolatey package manager, you can install with:

Configure kubectl to use a remote kubernetes cluster:

Edit the config file with a text editor of your choice, such as Notepad for example.

Configure kubectl

In order for kubectl to find and access a Kubernetes cluster, it needs a kubeconfig file, which is created automatically when you create a cluster using kube-up.sh or successfully deploy a Minikube cluster. See the getting started guides for more about creating clusters. If you need access to a cluster you didn’t create, see the Sharing Cluster Access document. By default, kubectl configuration is located at

Check the kubectl configuration

Check that kubectl is properly configured by getting the cluster state:

If you see a URL response, kubectl is correctly configured to access your cluster.

If you see a message similar to the following, kubectl is not correctly configured:

Enabling shell autocompletion

kubectl includes autocompletion support, which can save a lot of typing!

The completion script itself is generated by kubectl, so you typically just need to invoke it from your profile.

Common examples are provided here. For more details, consult kubectl completion -h .

On Linux, using bash

To add kubectl autocompletion to your current shell, run source .

To add kubectl autocompletion to your profile, so it is automatically loaded in future shells run:

On macOS, using bash

On macOS, you will need to install bash-completion support via Homebrew first:

Follow the “caveats” section of brew’s output to add the appropriate bash completion path to your local .bashrc.

If you’ve installed kubectl using the Homebrew instructions then kubectl completion should start working immediately.

If you have installed kubectl manually, you need to add kubectl autocompletion to the bash-completion:

The Homebrew project is independent from kubernetes, so the bash-completion packages are not guaranteed to work.

Using Oh-My-Zsh

When using Oh-My-Zsh, edit the

/.zshrc file and update the plugins= line to include the kubectl plugin.

Источник

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

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.22.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.22.0 для macOS будет выглядеть следующим образом:

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

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

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

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

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

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

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

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

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

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

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

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

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

Загрузите последнюю версию v1.22.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 вернёт ошибку:

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

Источник