Как начать работу с Portainer, веб-интерфейсом для Docker

Portainer — это популярный пользовательский интерфейс Docker, который помогает визуализировать ваши контейнеры, образы, тома и сети. Portainer помогает вам контролировать ресурсы Docker на вашем компьютере, избегая длинных терминальных команд.

Portainer недавно достиг версии 2.0, в которой добавлена поддержка кластеров Kubernetes. Инструмент также поддерживает среды Docker Swarm и Azure ACI. В этом руководстве мы не будем усложнять задачу и будем использовать Portainer для управления локальной установкой Docker.

Доступны две версии программного обеспечения: бесплатная CE с открытым исходным кодом и коммерческая Business. Дополнительные возможности Business в основном сосредоточены на расширенном доступе, управлении квотами и административном контроле.

Установить Portainer

Прежде чем продолжить, убедитесь, что у вас установлен и запущен Docker. Для полной поддержки всех функций Portainer требуется Docker 19.01.

Прежде всего, вам нужно создать новый том Docker. Portainer будет использовать это для хранения своих постоянных данных. Наш будет называться portainer_data.

docker volume create portainer_data

Затем используйте Docker для запуска нового контейнера Portainer:

docker run -d -p 9000:9000 --name=portainer --restart=unless-stopped -v /var/run/docker.sock:/var/run/docker.sock -v portainer_data:/data portainer/portainer-ce

Эта команда извлечет образ porttainer/porttainer-ce и запустит из него новый контейнер. Контейнер будет отключен и запущен в фоновом режиме (-d).

Созданный ранее том монтируется в /data внутри контейнера, где Portainer хранит все данные своего приложения. Сокет Docker хоста также монтируется в контейнер, поэтому Portainer имеет доступ к экземпляру Docker на вашем компьютере. Наконец, порт 9000 на хосте привязан к порту 9000 внутри контейнера. Это порт, на котором Portainer предоставляет свой веб-интерфейс.

Первый забег

Теперь вы можете войти в Portainer, посетив http://localhost:9000 в своем браузере. Вам нужно будет установить пароль для пользователя admin при первом использовании. Затем вы попадете на главный экран.

Прежде чем начать использовать Portainer, стоит ознакомиться с собственными параметрами конфигурации приложения. Щелкните ссылку «Настройки» в левом навигационном меню. Здесь вы можете изменить настройки безопасности Portainer, установить собственный логотип приложения и отказаться от анонимного сбора статистики использования. Большинство настроек не требуют пояснений, при этом большинство из них сосредоточено на ограничении полномочий, предоставляемых пользователям без прав администратора.

Подменю «Аутентификация» на панели навигации позволяет настроить способ входа пользователей в Portainer. Portainer по умолчанию использует собственную внутреннюю систему управления пользователями, но вы можете использовать существующий сервер LDAP или поставщика OAuth. Выберите метод для использования, а затем заполните поля формы, чтобы настроить предпочитаемую систему аутентификации. При использовании встроенной базы данных пользователей вы можете использовать ссылку «Пользователи» в боковом меню, чтобы создавать дополнительных пользователей и сортировать их по командам.

Конечные точки

Portainer позволяет управлять несколькими конечными точками Docker. Для начала вы увидите одну «локальную» конечную точку, представляющую Docker Engine, работающий на вашей собственной машине.

Чтобы добавить дополнительную конечную точку, щелкните ссылку «Конечные точки» на боковой панели. Затем нажмите синюю кнопку «Добавить конечную точку». Выберите тип конечной точки, которую вы будете использовать, и укажите данные для подключения.

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

Управление контейнерами

Теперь вы готовы начать использовать Portainer для взаимодействия с Docker. На главном экране щелкните свою «локальную» конечную точку. Он будет выбран в Portainer, что даст вам доступ к полному пользовательскому интерфейсу управления. Вы попадете на простую панель инструментов, на которой будет представлен обзор ваших контейнеров, образов и томов.

Нажмите «Контейнеры» на панели инструментов или на боковой панели, чтобы открыть экран управления контейнерами. Вы увидите таблицу со всеми вашими контейнерами Docker.

Чтобы выполнить действие с контейнером, установите флажок рядом с его именем. Теперь вы можете использовать ряд кнопок в верхней части экрана, чтобы запустить, остановить, перезапустить или удалить контейнер. Контейнеры, которые в данный момент работают, будут отображаться зеленым цветом «работает», а остановленные — красным «остановлен».

Если вы используете новую установку Docker, вашим единственным контейнером может быть сам Portainer. Будьте осторожны, чтобы не остановить этот контейнер, так как он обслуживает веб-интерфейс Portainer, который вы используете!

Щелкните имя контейнера, чтобы просмотреть и изменить его сведения. Этот экран позволяет вам проверять свойства контейнера, создавать новый образ Docker из его текущего состояния и управлять его сетевыми подключениями.

В верхней части экрана вы найдете пять кнопок в разделе «Состояние контейнера», которые позволяют просматривать журналы контейнера («Журналы»), проверять его манифест Docker («Проверка»), просматривать статистику использования ресурсов («Статистика»). ), получить доступ к интерактивной консоли («Консоль») или присоединить консоль к процессу переднего плана в контейнере («Присоединить»).

Создать контейнер

Чтобы создать новый контейнер, вернитесь на экран «Контейнеры» и нажмите синюю кнопку «Добавить контейнер». Вы также можете редактировать существующий контейнер — эффективно уничтожая его и заменяя новым с измененными свойствами — с помощью кнопки «Дублировать/редактировать» на экране сведений о контейнере. Обе операции отображают один и тот же интерфейс.

Сначала введите имя для вашего нового контейнера. Затем укажите образ Docker для использования. Для общедоступных образов в Docker Hub, таких как wordpress:latest, вы можете ввести имя образа без дополнительной настройки.

Чтобы использовать изображения, хранящиеся в частном реестре, вам сначала нужно добавить данные реестра в Portainer. Щелкните ссылку «Реестры» под заголовком «Настройки» на левой боковой панели. Нажмите синюю кнопку «Добавить реестр» и укажите URL-адрес, имя пользователя и пароль вашего реестра. Затем вы сможете выбрать его в раскрывающемся списке «Реестр» на экране создания контейнера. Вы также можете использовать экран «Реестры» для установки учетных данных для подключений Docker Hub, что позволит вам извлекать частные образы и избегать ограничений скорости, применяемых к пользователям, не прошедшим проверку подлинности.

Теперь вы готовы развернуть свой контейнер, нажав кнопку «Развернуть контейнер» в нижней части формы. Прежде чем продолжить, просмотрите дополнительные настройки, которые отображаются над кнопкой. Вы можете настроить привязку портов, заставить Portainer извлекать образ перед развертыванием и выбрать автоматическое удаление контейнера при его выходе.

В нижней части экрана вы найдете пользовательский интерфейс расширенных настроек, который предлагает еще больше опций — слишком много, чтобы все здесь охватить. Они копируют всю функциональность команды CLI docker run, позволяя вам настроить команду контейнера, точку входа, тома, сетевые интерфейсы и переменные среды. Большая часть этого пользовательского интерфейса должна быть интуитивно понятной, если вы уже знакомы с возможностями Docker.

Использование стеков контейнеров

Экран создания контейнера позволяет запускать только один контейнер за раз. Portainer имеет встроенную поддержку «стеков», которые позволяют развертывать связанные контейнеры. Эта функция основана на docker-compose версии 2.

Щелкните элемент «Стеки» на панели навигации, затем нажмите кнопку «Добавить стопку». Графическое создание стеков не поддерживается — вам нужно вставить или загрузить файл docker-compose.yml. Вы также можете подключиться к репозиторию Git и напрямую использовать его docker-compose.yml.

Перед развертыванием стека вы можете установить переменные среды, которые будут доступны для контейнеров. Выберите уровень контроля доступа Portainer для применения, а затем нажмите «Развернуть стек». Portainer извлечет все изображения и создаст все контейнеры, указанные в файле Compose.

Выберите свой стек на экране «Стеки», чтобы совместно управлять его контейнерами. Вы можете остановить все контейнеры в стеке или полностью удалить стек, используя кнопки в верхней части экрана. Также есть элементы управления для дублирования стека или создания повторно используемого шаблона из его текущего состояния.

Доступ к шаблонам можно получить с экрана создания стека, и они позволяют быстро запускать новые экземпляры часто используемых сервисов. Portainer также поставляется с рядом встроенных шаблонов, доступных по ссылке «Шаблоны приложений» на панели навигации.

Удобство портье

Portainer помогает быстро создавать контейнеры Docker, управлять ими и отслеживать их. Он предоставляет графический интерфейс для команд командной строки Docker, который иногда может стать длинным и громоздким. Это также делает Docker доступным для пользователей, которые могут быть незнакомы с интерфейсами командной строки.

Помимо возможностей управления контейнерами, Portainer также обеспечивает обзор других основных ресурсов Docker. Экран «Изображения» позволяет вам просматривать, извлекать, импортировать, экспортировать и удалять изображения, доступные на вашей конечной точке. Экраны «Сети» и «Тома» действуют аналогичным образом, перечисляя соответствующие ресурсы и обеспечивая контроль над ними. Наконец, таблица Events предлагает исчерпывающий список всех действий, предпринятых движком Docker. Это может быть полезно при просмотре прошлых действий и определении того, когда определенные контейнеры были созданы или уничтожены.