Atlassian Software in Kubernetes (ASK) — Jira

Этот репозиторий является компонентом Atlassian Software in Kubernetes и содержит программный код для создания образа Docker для Jira Software (не Jira Core).

Хотя в названии говорится «Atlassian Software in Kubernetes», образ контейнера можно запускать на простом Docker/Docker-Compose/Docker-Swarm и т. д.

Этот образ можно использовать для запуска одного / автономного экземпляра Jira Software или кластерной установки, известной как Jira DataCenter. Для этого вам просто нужно включить определённые переменные среды.

Исходный код в этом репозитории выпущен под лицензией MIT, но фактические образы контейнеров Docker (двоичные файлы), созданные на его основе, нет. Вы можете свободно использовать этот исходный код для создания собственных образов Jira Docker и размещать их где угодно. Помните о различных ограничениях лицензий Atlassian и Oracle при этом.

Основные функции:

• использует Fedora 29 в качестве базового образа;
• использует бинарный установщик Atlassian Confluence, который поставляется со встроенным Oracle JDK — Adopt JDK/JRE в новых установщиках;
• предоставляет порт 8080;
• поддерживает режим центра обработки данных и самозаверяющие сертификаты;
• может быть настроен за обратным прокси-сервером путём настройки определённых переменных среды, связанных с прокси, как указано ниже.

Использование

Сборка: Сначала необходимо собрать образ контейнера:

docker build -t local/jira:version-tag .

Применение: В простейшей форме этот образ можно использовать, выполнив:

$ docker run -p 8080:8080 -d local/jira:version-tag

$ docker ps

CONTAINER ID        IMAGE               COMMAND                  CREATED             STATUS              PORTS                    NAMES
2585785edf49        local/jira          "/opt/atlassian/jira/"   3 seconds ago       Up 2 seconds        0.0.0.0:8080->8080/tcp   stupefied_wing

Если вы хотите настроить его за обратным прокси, используйте следующую команду:

$ docker run  \
  -e X_PROXY_NAME=<<YOUR_PROXY_NAME>> \
  -e X_PROXY_PORT=<<YOUR_PROXY_PORT>> \
  -e X_PROXY_SCHEME=<<YOUR_PROXY_SCHEME>> \
  -e X_CONTEXT_PATH=<<YOUR_X_CONTEXT_PATH>> \
  -e .... other variables ... \
  -p 8080:8080  \
  -d local/jira:version-tag

Примечание: При настройке Jira за прокси/балансировщиком нагрузки (GCE/AWS/другие) убедитесь, что установлены тайм-ауты прокси/балансировщика нагрузки на большие значения, такие как 300 секунд или более. (По умолчанию установлено значение 60 секунд). Очень важно установить эти тайм-ауты, так как Jira (и другое программное обеспечение Atlassian) может занять значительное время для настройки начальной базы данных. Меньшие тайм-ауты вызовут панику в процессе настройки Jira, и он завершится.

Если запустить без предоставления существующей базы данных, JIRA запустится и предоставит вам мастер веб-настройки:

docker run \
  -p 8080:8080  \
  -d local/jira:version-tag

Если вы хотите использовать другую версию JIRA, просто измените номер версии в Dockerfile и перестройте образ.

Сертификаты

Добавьте дополнительные сертификаты из единого смонтированного каталога.

docker run \
    --detach \
    --name container-name \
    --publish 8080:8080 \
    --volume /path/to/certificates:/var/atlassian/ssl \
    --volume /path/to/jira-plugins.list:/tmp/jira-plugins.list \
    local/image:tag

См. переменную среды SSL_CERTS_PATH в Dockerfile.

Аналогичный вывод должен отображаться командой docker logs container-name.

Importing certificate: /var/atlassian/ssl/eastwind.crt ...
Certificate was added to keystore
Importing certificate: /var/atlassian/ssl/northwind.crt ...
Certificate was added to keystore
Importing certificate: /var/atlassian/ssl/southwind.pem ...
Certificate was added to keystore
Importing certificate: /var/atlassian/ssl/westwind.pem ...
Certificate was added to keystore

Пользовательские плагины: Если вы хотите добавить плагины по своему выбору, вы можете перечислить их идентификаторы в файле jira-plugins.list, по одному плагину на каждой строке. Вы можете подключить этот файл внутри JIRA_INSTALL — как JIRA_INSTALL/jira-plugins.list. Скрипт docker-entrypoint.sh обработает этот файл и установит плагины. ## Плагины

Расположение этого файла в Dockerfile можно настроить, установив переменную среды PLUGINS_FILE в нужное место.

docker run \
  -p 8080:8080  \
  -v ${PWD}/jira-plugins.list:/tmp/jira-plugins.list \
  -d local/jira:version-tag

Переменные среды

При создании образа Docker можно задать следующие переменные среды.