Установка Rancher · 4 min read · Sep 10, 2025

Как установить Rancher на сервер Debian 12

Rancher — это платформа управления контейнерами с открытым исходным кодом, предназначенная для упрощения развертывания, управления и управления кластерами Kubernetes. В отличие от дистрибутива Kubernetes, который заменяет сам Kubernetes, Rancher выступает в качестве решения для управления, которое располагается над одним или несколькими кластерами Kubernetes, предоставляя централизованную платформу, с которой администраторы могут контролировать всю свою контейнерную инфраструктуру.

В этом руководстве вы узнаете, как установить Rancher на сервер Debian 12. Вы установите Rancher как один узел через Docker, который также развернет однопользовательский узел Kubernetes сверху.

Предварительные требования

Для начала этого руководства убедитесь, что у вас есть следующее:

  • Сервер Debian 12 с минимум 4 ГБ оперативной памяти
  • Пользователь без прав root с правами администратора

Установка Docker

Перед установкой Rancher вам нужно убедиться, что Docker установлен на вашей системе. В этом разделе вы установите Docker Engine через официальный репозиторий Docker на систему Debian.

Сначала выполните команду ниже, чтобы обновить индекс пакетов и установить такие пакеты, как ‘ca-certificates’ и ‘curl’.

sudo apt update && sudo apt install ca-certificates curl -y

Теперь выполните следующую команду, чтобы добавить GPG-ключ для репозитория Docker.

sudo install -m 0755 -d /etc/apt/keyrings  
sudo curl -fsSL https://download.docker.com/linux/debian/gpg -o /etc/apt/keyrings/docker.asc  
sudo chmod a+r /etc/apt/keyrings/docker.asc

Затем выполните следующую команду, чтобы добавить репозиторий Docker в вашу систему Debian. Это автоматически определит вашу версию Debian.

echo \  
"deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/debian \  
$(. /etc/os-release && echo "$VERSION_CODENAME") stable" | \  
sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

add repo

Теперь, когда вы добавили репозиторий Docker и GPG-ключ, выполните команду ниже, чтобы обновить индекс пакетов и установить Docker Engine на вашу систему. В этом примере вы установите Docker Engine с дополнительными пакетами, такими как Docker Compose и плагин Docker Buildx.

sudo apt update && sudo apt install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

Введите ‘Y’, чтобы продолжить установку.

install Docker

После завершения установки проверьте статус службы Docker, используя команду ‘systemctl’ ниже. Вы увидите, что Docker работает и включен на вашем Debian-машине.

sudo systemctl is-enabled docker  
sudo systemctl status docker

check docker

Наконец, вы можете выполнить команду ‘docker’ ниже, чтобы запустить контейнер ‘hello-word’.

sudo docker run hello-world

Если все прошло успешно, вы получите следующее сообщение ‘ Hello World ‘ от Docker.

Docker hello world

Установка Rancher

Теперь, когда Docker установлен, вы готовы установить Rancher. В этом разделе вы загрузите образ Rancher, а затем запустите контейнер Rancher через Docker. В этом примере мы будем использовать самоподписанные сертификаты, которые автоматически генерируются контейнером Rancher. Мы также будем использовать последнюю версию образа Rancher.

Загрузите образ Rancher, используя команду ‘docker pull’ ниже. В этом примере мы будем использовать последнюю версию Rancher.

sudo docker pull rancher/rancher:latest

Docker pull rancher

После загрузки образа Rancher выполните команду ‘docker run’, чтобы запустить Rancher. С этим контейнер Rancher будет работать в фоновом режиме и экспортировать порты 80 и 443 на хост-сервере Debian.

sudo docker run -d --restart=unless-stopped \  
-p 80:80 -p 443:443 \  
--privileged \  
rancher/rancher:latest

Проверьте статус контейнера, используя команду ниже.

sudo docker ps

В выводе ниже вы можете увидеть, что Rancher работает на порту 443. Также вы можете увидеть идентификатор контейнера и имена контейнера.

Кроме того, если у вас возникла ошибка, вы можете проверить журнал Rancher с помощью следующей команды ‘docker’.

docker ps -a  
docker log container-name or container id

Опция ‘ps -a’ покажет вам контейнеры, которые работают и завершены, а команда ‘docker log’ используется для проверки журналов контейнера.

Настройка Rancher

На этом этапе Rancher работает на вашей системе Debian как контейнер. На следующем шаге вы войдете в панель управления Rancher, чтобы увидеть однопользовательский узел Kubernetes, который работает на вашей установке Rancher.

Откройте веб-браузер и перейдите по IP-адресу вашего сервера Debian, добавив порт 8080, например https://192.168.10.41:8080/. Если ваша установка прошла успешно, вы увидите следующую страницу входа в Rancher.

Вернитесь в терминал и выполните команду ниже, чтобы получить пароль Rancher. Убедитесь, что вы заменили идентификатор контейнера на свой и скопировали свой пароль.

sudo docker logs CONTAINER ID 2>&1 | grep "Bootstrap Password:"

Теперь введите свой пароль и нажмите Войти с локальным пользователем.

login rancher

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

accept terms

Теперь вы увидите следующую панель управления Rancher. В приведенном ниже примере вы можете увидеть однопользовательский кластер Kubernetes, созданный с помощью K3s.

dashboord

Нажмите на локальный кластер Kubernetes, и вы получите больше информации о вашем кластере Kubernetes.

detailed cluster kubernetes

Доступ к кластеру Kubernetes с помощью kubectl

Сначала загрузите KubeConfig на свой локальный компьютер. С панели управления Rancher нажмите на меню файла ниже.

Установите ‘kubectl’ на свою систему с помощью команды ниже. На Debian 12 вы можете установить пакет ‘kubernetes-client‘ через APT.

sudo apt install kubernetes-client -y

install kubectl

Установите значение по умолчанию KUBECONFIG на ваш файл. В этом примере файл KubeConfig называется ‘kubeconfig.yaml’.

export KUBECONFIG=~/kubeconfig.yaml

Наконец, выполните команду ‘kubectl’ ниже, чтобы получить список подов во всех пространствах имен Kubernetes.

kubectl get pods --all-namespaces

Вы увидите, что каждый под для кластера Kubernetes под управлением Rancher работает.

check kubernetes pods via kubectl

Заключение

Поздравляем! Вы завершили установку Rancher с Docker на сервере Debian 12. Вы узнали, как настроить Rancher и создать кластер Kubernetes на его основе. Наконец, вы также узнали, как взаимодействовать с вашим кластером Kubernetes через клиент Kubernetes ‘kubectl’. Более того, вы можете развернуть свои контейнеризованные приложения в кластер Kubernetes через ‘kubectl’.

Share: X/Twitter LinkedIn

Get new posts in your inbox

No spam. Unsubscribe anytime.