Як встановити Portainer на Ubuntu

Portainer – це потужний інструмент управління Docker з відкритим вихідним кодом, який спрощує процес управління контейнерами, образами, мережами і томами Docker за допомогою інтуїтивно зрозумілого веб-інтерфейсу. Він надає зручний спосіб розгортання та управління контейнерними додатками, що робить його незамінним інструментом як для новачків, так і для досвідчених користувачів Docker.

Необхідні умови

Сервер під управлінням однієї з наступних операційних систем: Ubuntu і будь-який інший дистрибутив на базі Debian, наприклад Linux Mint.
Рекомендується використовувати свіжу інсталяцію ОС, щоб уникнути можливих проблем.
Базове знайомство з терміналом та інтерфейсом командного рядка.
SSH-доступ до сервера (або просто відкрийте Terminal, якщо ви перебуваєте на робочому столі).
Активне підключення до Інтернету. Інтернет-з’єднання знадобиться для завантаження необхідних пакетів і залежностей.
Система Ubuntu 24.04 з правами root або користувач із привілеями sudo.

Встановлення Portainer на Ubuntu 24.04

Крок 1. Оновлення сховища пакетів.

Для початку оновіть систему Ubuntu, щоб переконатися, що у вас є останні списки пакетів і оновлення безпеки. Відкрийте термінал і виконайте таку команду:

sudo apt update
sudo apt upgrade

Ці команди оновлять список пакетів і оновлять усі наявні пакети до останніх версій.

Далі встановіть необхідні інструменти, необхідні для додавання репозиторію Docker і встановлення Portainer. Виконайте наступну команду, щоб встановити ca-certificates, curl і gnupg:

sudo apt install ca-certificates curl gnupg

Ці інструменти будуть використовуватися в наступних кроках для безпечного завантаження та встановлення Docker і Portainer.

Крок 2. Встановлення Docker.

Перед встановленням Portainer вам необхідно встановити Docker на систему Ubuntu 24.04 LTS. Для встановлення Docker виконайте такі кроки:

По-перше, додайте офіційний GPG-ключ Docker, щоб переконатися в автентичності пакетів, які ви будете завантажувати. Виконайте такі команди:

sudo install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg

Потім додайте сховище Docker до списку джерел APT вашої системи за допомогою команди:

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

Встановивши сховище Docker, оновіть список пакетів, щоб включити в нього щойно доданий сховище:

sudo apt update

Тепер встановіть рушій Docker Engine, CLI і containerd.io за допомогою такої команди:

sudo apt install docker-ce docker-ce-cli containerd.io

Щоб переконатися, що Docker встановлено правильно, запустіть контейнер hello-world за допомогою команди:

sudo docker run hello-world

Крок 3. Встановлення Portainer.

Після встановлення Docker можна приступати до встановлення Portainer. Щоб забезпечити збереження даних для Portainer, створіть том Docker за допомогою команди:

docker volume create portainer_data

На цьому томі зберігатимуться конфігурація і дані Portainer, що дасть змогу їм зберігатися навіть у разі видалення або відтворення контейнера Portainer.

Щоб завантажити та запустити контейнер Portainer, виконайте таку команду:

docker run -d -p 8000:8000 -p 9443:9443 --name=portainer --restart=always -v /var/run/docker.sock:/var/run/docker.sock -v portainer_data:/data portainer/portainer-ce:latest

Давайте розберемо опції, які використовуються в цій команді:

-d: Запускає контейнер у від’єднаному режимі, дозволяючи йому працювати у фоновому режимі.
-p 8000:8000 -p 9443:9443: Зіставляє порти 8000 і 9443 контейнера з портами хоста, забезпечуючи доступ до веб-інтерфейсу Portainer.
–name=portainer: Присвоює контейнеру ім’я «portainer» для полегшення ідентифікації.
–restart=always: Налаштовує контейнер на автоматичний перезапуск у разі його зупинки або перезапуску демона Docker.
-v /var/run/docker.sock:/var/run/docker.sock: Монтує сокет Docker, даючи змогу Portainer керувати демоном Docker на хості.
-v portainer_data:/data: Монтує раніше створений том portainer_data в каталог /data контейнера для постійного зберігання даних.
portainer/portainer-ce:latest: Вказує образ, який буде використовуватися для контейнера, в даному випадку – остання версія Portainer Community Edition.

Крок 4. Доступ до веб-інтерфейсу Portainer

Відкрийте веб-браузер і перейдіть за такою URL-адресою:

https://[YOUR_SERVER_IP]:9443

Замініть [YOUR_SERVER_IP] на IP-адресу або ім’я хоста вашого сервера Ubuntu. Зверніть увагу, що Portainer за замовчуванням використовує HTTPS на порту 9443 для безпечного доступу.

Якщо ви не можете отримати доступ до веб-інтерфейсу Portainer, переконайтеся, що ваш брандмауер дозволяє трафік на портах 8000 і 9443. Перевірити правила брандмауера можна за допомогою команди:

sudo ufw status

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

sudo ufw allow 9000/tcp
sudo ufw allow 9443/tcp

Вітаємо! Ви успішно встановили Portainer. Для отримання додаткової допомоги або корисної інформації ми рекомендуємо вам відвідати офіційний сайт Portainer.