Используемые термины: Portainer , Docker .
Данная инструкция может послужить в качестве шпаргалки по развертыванию Portainer в докер-контейнере.
Создание файла docker-compose
Описание сценария запуска Portainer
Запуск контейнера
Установка приложения в веб-интерфейсе
Подключение удаленного docker хоста
Файл docker-compose
Создадим каталог, где будем размещать файлы приложения:
mkdir /opt/portainer
Перейдем в него:
cd /opt/portainer
Создадим docker-compose файл:
vi docker-compose.yml
- —
- services:
- portainer:
- image: portainer/portainer-ce:latest
- container_name: portainer
- hostname: portainer
- restart: unless-stopped
- environment:
- TZ: «Europe/Moscow»
- volumes:
- — /var/run/docker.sock:/var/run/docker.sock
- — ./portainer_data:/data
- ports:
- — «9000:9000»
Описание сценария
На что стоит обратить особое внимание:
| Строки | Описание |
|---|---|
| 6 | Для развертывания мы берем образ portainer/portainer-ce (community edition) последней версии. |
| 7, 8 | Задаем для удобства имя контейнера и hostname. |
| 9 | Наш контейнер должен автоматически запускаться, если не был выключен явно. |
| 10 — 11 | Задаем системную переменную, указал часовой пояс. |
| 12 — 14 | Монтируем внутрь контейнера: — файл /var/run/docker.sock. Необходимо, чтобы сервис, запущенный в контейнере взаимодействовал с докер-системой хоста. — каталог portainer_data. Будет находится в текущей папке. Нужен для хранения данных, которые мы не хотим потерять, когда контейнер будет перезагружен. |
| 15 — 16 | Делаем так, чтобы наш контейнер слушал на внешнем порту 9000. |
* примеры работы с docker-compose можно увидеть в инструкции Шпаргалка по работе с docker-compose .
Запуск и проверка
Запустим контейнер с помощью docker-compose:
docker-compose up -d
Для проверки можно попробовать отправить http-запрос из консоли:
curl http://127.0.0.1:9000
Мы должны увидеть html-разметку. Значит, портал слушает и отвечает.
Идем дальше.
Веб установка
Для работы Portainer необходимо инициализировать настройки. В браузере переходимо на портал, например, http://192.168.100.15:9000 — должна открыться стартовая страница, где от нас потребуется ввести логин и пароль, которые мы хотим использовать для входа в систему под администратором:
Если мы задержимся с ответом, система выдаст сообщение о необходимости перезапустить сервис:
Вводим команду:
docker-compose restart
И возвращаемся к процедуре веб-установки.
Установка и запуск Portainer завершены.
Настройка удаленного docker хоста
Дополнительно рассмотрим добавление в Portainer хоста Docker, который расположен на другом сервере.
В веб-интерфейса переходимо в раздел Environment-related — Environments :
Справа сверху кликаем по:
Выбираем Docker Standalone :
Запускаем мастер настройки:
Выбираем, что будем подключаться к удаленному docker хосту с помощью агента:
Мы получим команду для запуска docker-контейнера с агентом:
Мы можем скопировать и запустить контейнер portainer-агента на хосте, которым хотим управлять:
docker run -d
-p 9001:9001
—name portainer_agent
—restart=always
-v /var/run/docker.sock:/var/run/docker.sock
-v /var/lib/docker/volumes:/var/lib/docker/volumes
-v /:/host
portainer/agent:2.21.3
По умолчанию, portainer предлагает запустить агента на порту 9001. Если на удаленном хосте данный порт уже занят, необходимо поменять строку:
docker run -d
-p 9002:9001
…* в данном примере мы сделаем так, что агент будет слушать на порту 9002 .
Однако, для продуктивной среды рекомендую использовать docker-compose. Для начала создадим каталог для хранения файлов агента и перейдем в него:
mkdir /opt/portainer_agent
cd /opt/portainer_agent
Создаем docker-compose файл:
vi docker-compose.yml
—
services:
portainer-agent:
image: portainer/agent:2.21.3
container_name: portainer-agent
hostname: portainer-agent
restart: unless-stopped
environment:
TZ: «Europe/Moscow»
volumes:
— /var/run/docker.sock:/var/run/docker.sock
— /var/lib/docker/volumes:/var/lib/docker/volumes
— /:/host
ports:
— «9001:9001»
* обратите внимание, что мы указали версию агента, которую нам выдал портал портейнера.
Для запуска контейнера с агентом вводим:
docker-compose up -d
Проверить статус сервиса можно командой:
docker-compose ps -a
Возвращаемся к веб-интерфейсу Portainer. Продолжая настраивать агента, вводим имя хоста и указываем, как подключиться к агенту:
* в нашем примере мы запустили агента на сервере 192.168.100.16 и порту 9002 .
Кликаем по Connect :
Подключение агента завершено.
Список подключенных хостов docker можно посмотреть на домашней странице. Там же можно выбрать нужный для управления его docker инфраструктурой.
