Данная статья предназначена для тех, кто искал подробное и понятное руководство о том, как установить Confluence с Docker Compose.

Confluence - это инструмент для совместной работы, который помогает командам эффективно сотрудничать и обмениваться знаниями.

В этом руководстве мы будем рассматривать тот случай, когда у вас уже есть сервер с установленной на нем операционной системой Ubuntu Server 20.04 LTS.

Подробно о том, как установить Ubuntu Server 20.04 LTS, вы можете прочитать в моем руководстве “Установка Ubuntu Server 20.04 LTS”.

Также на сервере должен быть установлен Docker Engine и Docker Compose.

Узнать о том, как установить Docker Engine на Ubuntu Server, вы можете, прочитав “Установка Docker Engine на Ubuntu Server”. О том, как установить Docker Compose на Ubuntu Server, вы можете прочитать в моем руководстве “Установка Docker Compose на Ubuntu Server”.

Кроме того, на сервер должен быть установлен OpenSSH, а также открыт 22 порт, чтобы иметь возможность подключаться к серверу по протоколу SSH.

Для установки OpenSSH на сервер вы можете воспользоваться командой:

sudo apt install openssh-server

Если вы планируете подключиться к серверу, используя операционную систему Windows, то можете воспользоваться PuTTY - свободно распространяемым клиентом для различных протоколов удаленного доступа, включая SSH, Telnet, rlogin.

В данном руководстве рассматривается подключение к серверу при помощи терминального эмулятора iTerm2, установленного на операционную систему macOS.

Обратите внимание, вам потребуется открыть следующие порты TCP для доступа к вашему серверу:

  • 80 - для получения бесплатного криптографического сертификата через центр сертификации Let’s Encrypt.
  • 443 - для доступа к веб-интерфейсу Confluence.

Подключаемся к серверу, на который планируется установить Confluence.

Теперь нужно создать конфигурационный файл YAML, который будет содержать все необходимые условия для работы Confluence.

Создадим конфигурационный файл YAML, воспользовавшись текстовым редактором, с помощью команды:

vim confluence-traefik-letsencrypt-docker-compose.yml

Установка Confluence с Docker Compose

Нажимаем на кнопку “i”, чтобы перейти в режим редактирования, затем вставляем следующую конфигурацию для работы Confluence.

Установка Confluence с Docker Compose

Далее вам необходимо внести изменения в конфигурацию, чтобы содержимое файла соответствовало вашим условиям. Параметры, которые требуется проверить или в которые нужно внести изменения имеют пометку “(replace with yours)”.

В данном руководстве для доступа к Confluence из сети Интернет будет использоваться субдомен confluence.heyvaldemar.net. Вам нужно будет указать ваш домен или субдомен, по которому ваш Confluence будет доступен из сети Интернет.

Обратите внимание, в данном руководстве в качестве системы для управления базами данных будет использоваться MariaDB, а в качестве reverse proxy - Traefik.

В параметре “traefik.http.middlewares.authtraefik.basicauth.users” необходимо указать имя пользователя и хэш пароля для доступа к панели управления Traefik.

Обратите внимание, для получения хэша пароля можно воспользоваться данным сервисом.

Теперь нажмите на кнопку “Esc”, чтобы выйти из режима редактирования, а затем введите “:x” и нажмите на кнопку “Enter”, чтобы сохранить изменения и выйти из редактора.

Установка Confluence с Docker Compose

Теперь запустим Confluence с помощью команды:

docker-compose -f confluence-traefik-letsencrypt-docker-compose.yml -p confluence up -d

Установка Confluence с Docker Compose

Для продолжения процесса установки Confluence необходимо с рабочей станции перейти по ссылке https://confluence.heyvaldemar.net, где confluence.heyvaldemar.net - имя моего сервера. Соответственно, вам необходимо указать имя или IP-адрес вашего сервера Confluence.

В данном руководстве рассматривается установка Confluence для продуктивной среды.

Выбираем “Production Installation” и нажимаем на кнопку “Next”.

Установка Confluence с Docker Compose

Теперь необходимо указать лицензионный ключ для Confluence.

Если у вас еще нет лицензионного ключа, то можно запросить временный ключ для ознакомления с Confluence.

В данном руководстве рассматривается установка Confluence с временным лицензионным ключом.

Нажимаем на “Get an evaluation licence”.

Установка Confluence с Docker Compose

Далее нажимаем на кнопку “Sign up for an account”, если у вас еще нет учетной записи Atlassian.

Установка Confluence с Docker Compose

На следующем шаге необходимо указать: адрес электронной почты, имя, фамилию и пароль для создания учетной Atlassian.

Нажимаем на кнопку “Sign up”.

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

Установка Confluence с Docker Compose

Если у вас уже есть учетная запись Atlassian, то в поле “Enter email” указываем адрес электронной почты, привязанной к учетной записи Atlassian, и нажимаем на кнопку “Continue”.

Установка Confluence с Docker Compose

Указываем пароль от учетной записи Atlassian и нажимаем на кнопку “Log in”.

Установка Confluence с Docker Compose

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

Нажимаем на кнопку “Generate License” для генерации временного лицензионного ключа для Confluence.

Установка Confluence с Docker Compose

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

Нажимаем на кнопку “Yes”.

Установка Confluence с Docker Compose

В поле “Confluence” вставляем ранее полученный временный лицензионный ключ и нажимаем на кнопку “Next”.

Установка Confluence с Docker Compose

Теперь необходимо настроить подключение к ранее созданной базе данных.

Выбираем “My own database” и нажимаем на кнопку “Next”.

Установка Confluence с Docker Compose

Теперь необходимо указать систему для управления базами данных и ранее созданную базу данных, которая будет использоваться для работы Confluence.

В поле “Database type” выбираем “PostgreSQL”.

В разделе “Setup type” выбираем “Simple”.

В данном руководстве база данных для работы Confluence находится на одном сервере с Confluence.

В поле “Hostname” указываем “localhost”.

В поле “Database port” указываем значение “5432”.

В данном руководстве в качестве имени базы данных для работы Confluence используется “confluencedb”.

В поле “Database name” указываем “confluencedb”.

В данном руководстве в качестве имени пользователя, обладающего правами на базу данных для работы Confluence, используется “confluencedbuser”.

В поле “Username” указываем “confluencedbuser”.

В поле “Password” указываем пароль, присвоенный пользователю “confluencedbuser”.

Нажимаем на кнопку “Test connection”.

Установка Confluence с Docker Compose

Сообщение “Success! Database connected successfully.” означает, что все данные были указаны корректно.

Нажимаем на кнопку “Next”.

Установка Confluence с Docker Compose

На следующем шаге будет возможность выбрать из нескольких вариантов: загрузить демонстрационный контент, не загружать никакого контента и начать наполнять Confluence самостоятельно или восстановить данные из резервной копии.

В данном руководстве рассматривается установка Confluence без импорта какого-либо контента.

Нажимаем на кнопку “Empty Site”.

Установка Confluence с Docker Compose

Далее можно настроить управление пользователями Confluence при помощи “Jira”.

В данном руководстве рассматривается установка Confluence без возможности управления пользователями при помощи Jira.

Нажимаем на кнопку “Manage users and groups within Confluence”.

Установка Confluence с Docker Compose

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

Нажимаем на кнопку “Next”.

Установка Confluence с Docker Compose

Все готово для использования Confluence.

Нажимаем на кнопку “Start”.

Установка Confluence с Docker Compose

Теперь можно создать первое пространство, например, для команды разработчиков, где они будут работать над своими проектами.

Указываем имя для первого пространства и нажимаем на кнопку “Continue”.

Установка Confluence с Docker Compose

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

Нажимаем на кнопку “Skip tutorial”.

Установка Confluence с Docker Compose

Наполняем страницу полезным контентом, чтобы затем опубликовать ее в новом пространстве.

Нажимаем на кнопку “Publish”.

Установка Confluence с Docker Compose

Первая страница в пространстве для разработчиков успешно создана.

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

Установка Confluence с Docker Compose

Для доступа к панели управления Traefik необходимо с рабочей станции перейти по ссылке https://traefik.confluence.heyvaldemar.net, где traefik.confluence.heyvaldemar.net — имя моего сервера. Соответственно, вам необходимо указать имя вашего сервера с установленным Traefik.

Указываем имя пользователя и пароль, заданный ранее в конфигурационном файле YAML, и нажимаем на кнопку “OK”.

Установка Confluence с Docker Compose

Добро пожаловать в панель управления Traefik.

Установка Confluence с Docker Compose

Владимир Михалев
Привет, я Владимир Михалев, но друзья зовут меня Вальдемарыч. Я обладаю практическим опытом проектирования и сопровождения различных информационных систем.