Установка Confluence с Docker Compose
Данная статья предназначена для тех, кто искал подробное и понятное руководство о том, как установить Confluence с Docker Compose.
Confluence - это инструмент для совместной работы, который помогает командам эффективно сотрудничать и обмениваться знаниями.
В этом руководстве мы будем рассматривать тот случай, когда у вас уже есть сервер с установленной на нем операционной системой Ubuntu Server 22.04 LTS.
Подробно о том, как установить Ubuntu Server 22.04 LTS, вы можете прочитать в моем руководстве “Установка Ubuntu Server 22.04 LTS”.
Также на сервере должен быть установлен Docker Engine и Docker Compose.
Узнать о том, как установить Docker Engine на Ubuntu Server, вы можете, прочитав “Установка Docker Engine и Docker Compose на Ubuntu Server”.
Кроме того, на сервер должен быть установлен OpenSSH, а также открыт 22 порт, чтобы иметь возможность подключаться к серверу по протоколу SSH.
Для установки OpenSSH на сервер вы можете воспользоваться командой:
sudo apt install openssh-server
Если вы планируете подключиться к серверу, используя операционную систему Windows, то можете воспользоваться PuTTY или MobaXterm.
В данном руководстве рассматривается подключение к серверу при помощи терминального эмулятора iTerm2, установленного на операционную систему macOS.
Обратите внимание, вам потребуется открыть следующие порты TCP для доступа к вашему серверу:
- TCP порт 80 - для получения бесплатного криптографического сертификата через центр сертификации Let’s Encrypt.
- TCP порт 443 - для доступа к веб-интерфейсу Confluence.
Подключаемся к серверу, на который планируется установить Confluence.
Теперь нужно создать конфигурационный файл YAML, который будет содержать все необходимые условия для работы Confluence.
Создадим конфигурационный файл YAML, воспользовавшись текстовым редактором, с помощью команды:
vim confluence-traefik-letsencrypt-docker-compose.yml
Нажимаем на кнопку “i”, чтобы перейти в режим редактирования, затем вставляем следующую конфигурацию для работы Confluence.
Далее вам необходимо внести изменения в конфигурацию, чтобы содержимое файла соответствовало вашим условиям. Параметры, которые требуется проверить или в которые нужно внести изменения имеют пометку “(replace with yours)”.
В данном руководстве для доступа к Confluence из сети Интернет будет использоваться субдомен confluence.heyvaldemar.net. Вам нужно будет указать ваш домен или субдомен, по которому ваш Confluence будет доступен из сети Интернет.
Обратите внимание, в данном руководстве в качестве системы для управления базами данных будет использоваться PostgreSQL, а в качестве reverse proxy - Traefik.
В параметре “traefik.http.middlewares.authtraefik.basicauth.users” необходимо указать имя пользователя и хэш пароля для доступа к панели управления Traefik.
Обратите внимание, для получения хэша пароля можно воспользоваться данным сервисом.
Теперь нажмите на кнопку “Esc”, чтобы выйти из режима редактирования, а затем введите “:x” и нажмите на кнопку “Enter”, чтобы сохранить изменения и выйти из редактора.
Теперь запустим Confluence с помощью команды:
docker compose -f confluence-traefik-letsencrypt-docker-compose.yml -p confluence up -d
Для продолжения процесса установки Confluence необходимо с рабочей станции перейти по ссылке https://confluence.heyvaldemar.net, где confluence.heyvaldemar.net - имя моего сервера. Соответственно, вам необходимо указать имя вашего сервера Confluence.
В данном руководстве рассматривается установка Confluence для продуктивной среды.
Выбираем “Production Installation” и нажимаем на кнопку “Next”.
Теперь необходимо указать лицензионный ключ для Confluence.
Если у вас еще нет лицензионного ключа, то можно запросить временный ключ для ознакомления с Confluence.
В данном руководстве рассматривается установка Confluence с временным лицензионным ключом.
Нажимаем на “Get an evaluation licence”.
Далее нажимаем на кнопку “Sign up for an account”, если у вас еще нет учетной записи Atlassian.
На следующем шаге необходимо указать: адрес электронной почты, имя, фамилию и пароль для создания учетной Atlassian.
Нажимаем на кнопку “Sign up”.
Обратите внимание, вы получите письмо на указанный при регистрации адрес электронной почты. В письме вы найдете ссылку для завершения регистрации.
Если у вас уже есть учетная запись Atlassian, то в поле “Enter email” указываем адрес электронной почты, привязанной к учетной записи Atlassian, и нажимаем на кнопку “Continue”.
Указываем пароль от учетной записи Atlassian и нажимаем на кнопку “Log in”.
На следующем шаге необходимо указать, для какого продукта вам требуется временный лицензионный ключ, а также название вашей организации.
Нажимаем на кнопку “Generate License” для генерации временного лицензионного ключа для Confluence.
Далее нужно подтвердить, что временный лицензионный ключ для Confluence будет установлен на ваш сервер.
Нажимаем на кнопку “Yes”.
В поле “Confluence” вставляем ранее полученный временный лицензионный ключ и нажимаем на кнопку “Next”.
Теперь необходимо настроить подключение к ранее созданной базе данных.
Выбираем “My own database” и нажимаем на кнопку “Next”.
Теперь необходимо указать систему для управления базами данных и ранее созданную базу данных, которая будет использоваться для работы 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”.
Сообщение “Success! Database connected successfully.” означает, что все данные были указаны корректно.
Нажимаем на кнопку “Next”.
На следующем шаге будет возможность выбрать из нескольких вариантов: загрузить демонстрационный контент, не загружать никакого контента и начать наполнять Confluence самостоятельно или восстановить данные из резервной копии.
В данном руководстве рассматривается установка Confluence без импорта какого-либо контента.
Нажимаем на кнопку “Empty Site”.
Далее можно настроить управление пользователями Confluence при помощи “Jira”.
В данном руководстве рассматривается установка Confluence без возможности управления пользователями при помощи Jira.
Нажимаем на кнопку “Manage users and groups within Confluence”.
На следующем шаге необходимо указать: логин, имя, адрес электронной почты и пароль для создания учетной записи администратора Confluence.
Нажимаем на кнопку “Next”.
Все готово для использования Confluence.
Нажимаем на кнопку “Start”.
Теперь можно создать первое пространство, например, для команды разработчиков, где они будут работать над своими проектами.
Указываем имя для первого пространства и нажимаем на кнопку “Continue”.
Далее откроется редактор, в котором можно создать первую страницу в новом пространстве.
Нажимаем на кнопку “Skip tutorial”.
Наполняем страницу полезным контентом, чтобы затем опубликовать ее в новом пространстве.
Нажимаем на кнопку “Publish”.
Первая страница в пространстве для разработчиков успешно создана.
Обратите внимание, вы можете ограничить доступ для пользователей, как к пространству, так и к определенным страницам внутри него.
Для доступа к панели управления Traefik необходимо с рабочей станции перейти по ссылке https://traefik.confluence.heyvaldemar.net, где traefik.confluence.heyvaldemar.net — имя моего сервера. Соответственно, вам необходимо указать имя вашего сервера с установленным Traefik.
Указываем имя пользователя и пароль, заданный ранее в конфигурационном файле YAML, и нажимаем на кнопку “OK”.
Добро пожаловать в панель управления Traefik.