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

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

В этом руководстве мы будем рассматривать тот случай, когда у вас уже есть сервер с установленной на нем операционной системой 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 - для доступа к веб-интерфейсу XWiki.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Нажимаем на кнопку “Register and login”.

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

Учетная запись успешно зарегистрирована.

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

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

На следующем шаге необходимо установить набор расширений для XWiki.

Выбираем “XWiki Standard Flavor” и нажимаем на кнопку “Install this flavor”.

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

Далее необходимо подтвердить установку “XWiki Standard Flavor”.

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

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

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

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

Установка “XWiki Standard Flavor” завершена.

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

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

На следующем шаге будет показано дерево страниц XWiki.

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

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

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

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

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

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

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

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

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

Мои услуги

💼 Загляните в мой каталог услуг и узнайте, как мы можем сделать вашу технологическую жизнь лучше. Будь то повышение эффективности вашей IT-инфраструктуры, развитие вашей карьеры или расширение технологических горизонтов — я здесь, чтобы помочь вам достичь ваших целей. От DevOps-трансформаций до сборки игровых компьютеров — давайте сделаем ваши технологии непревзойденными!

Пополнить запасы кофе автора

💡 Telegram | Boost
💖 PayPal
🏆 Patreon
💎 GitHub
🥤 BuyMeaCoffee
🍪 Ko-fi

Владимир Михалев
Я - Владимир Михалев, Капитан Docker, но друзья могут называть меня Вальдемарыч.

DevOps комьюнити

Привет! 👋 Если у тебя есть вопросы по установке или настройке, то задайте их мне и другим IT-экспертам нашего сообщества: