Настройка Discourse: окружение AWS Linux 2 AMI и Apache2 (httpd)

Поддержка продукта Самостоятельное хостинг
4

УСТАНОВКА DOCKER И DISCOURSE НА AWS EC2 LINUX С СУЩЕСТВУЮЩИМ ОБРАТНЫМ ПРОКСИ-СЕРВЕРОМ HTTPD

Всем привет

Я разобрался. Я вернулся к чертежной доске и начал заново с чистой установкой Docker и Discourse. Мой процесс подробно описан ниже:

Предположения

• У вас уже есть экземпляр AWS EC2 Linux
• Вы можете получить доступ к своему экземпляру EC2 через SSH
• Apache 2 уже настроен и запущен на вашем сервере

ПОЛУЧЕНИЕ ДОСТУПА К ЭКЗЕМПЛЯРУ EC2 ЧЕРЕЗ SSH

  1. Откройте командную строку (CMD) или терминал

  2. Подключитесь к экземпляру AWS EC2 через SSH

Пример экрана после подключения к экземпляру EC2

image
image534×191 39.5 KB

ВЫПОЛНЕНИЕ ОБНОВЛЕНИЙ СИСТЕМЫ

  1. Выполните обновления системы, запустив следующую команду в консоли / терминале

$ sudo yum update

УСТАНОВКА DOCKER

  1. Найдите пакет Docker для AWS, запустив следующую команду в консоли / терминале

$ sudo yum search docker

  1. Получите информацию о версии, запустив следующую команду в консоли / терминале

$ sudo yum info docker

  1. Установите Docker, запустив следующую команду в консоли / терминале

$ sudo yum install docker

  1. Добавьте членство в группу для пользователя ec2-user по умолчанию, чтобы вы могли запускать все команды Docker без использования команды sudo, выполнив следующую команду в консоли / терминале
$ sudo usermod -a -G docker ec2-user
$ id ec2-user

# Перезагрузите назначения групп пользователя Linux для docker без выхода из системы

$ newgrp docker
  1. Установите docker-compose, запустив следующую команду в консоли / терминале
# 1. Получите pip3 (пакет установщика python)
$ sudo yum install python3-pip
 
# 2. Затем выполните любую из следующих команд
$ sudo pip3 install docker-compose # с правами root
 
# ИЛИ
 
$ pip3 install --user docker-compose # без прав root по соображениям безопасности

# Проверьте разрешения
$ sudo chmod -v +x /usr/local/bin/docker-compose
  1. Включите автоматический запуск службы Docker при загрузке, выполнив следующую команду в консоли / терминале

$ sudo systemctl enable docker.service

  1. Запустите службу Docker, выполнив следующую команду в консоли / терминале

$ sudo systemctl start docker.service

  1. Проверьте, запущена ли служба Docker, выполнив следующую команду в консоли / терминале; вывод будет выглядеть примерно так

image
image936×250 108 KB

Базовые команды Docker, которые полезно знать:

# Версия Docker
$ docker version

# Версия Docker Compose
$ docker-compose version

# Запуск службы Docker
$ sudo systemctl start docker.service

# Остановка службы Docker
$ sudo systemctl stop docker.service

# Перезапуск службы Docker
$ sudo systemctl restart docker.service

# Статус службы Docker
$ sudo systemctl status docker.service

УСТАНОВКА DISCOURSE

  1. Создайте папку discourse

$ sudo mkdir /var/discourse

  1. Клонируйте образ Docker Discourse в только что созданную директорию

$ sudo git clone https://github.com/discourse/discourse_docker.git /var/discourse

  1. Скопируйте файл standalone.yml в папку containers

$ cp /var/discourse/samples/standalone.yml /var/discourse/containers/discourse.yml

  1. Отредактируйте новый файл discourse.yml следующим образом (важные моменты: открытые порты для HTTP и детали электронной почты для SMTP; измените их в файле, не копируйте и не вставляйте)

Варианты редактирования:

1. Вы можете использовать nano и редактировать через командную строку / терминал
2. На AWS, если вы используете MATE с PLUMA, вы можете использовать PLUMA для редактирования файла
3. Вы можете использовать WINSCP для подключения к машине через SSH и редактирования файла через графический интерфейс Windows

## это шаблон контейнера Docker Discourse «все в одном» (standalone)
##
## После внесения изменений в этот файл вы ОБЯЗАНЫ выполнить пересборку
## /var/discourse/launcher rebuild app
##
## БУДЬТЕ *ОЧЕНЬ* ОСТОРОЖНЫ ПРИ РЕДАКТИРОВАНИИ!
## YAML-ФАЙЛЫ ЧРЕЗВЫЧАЙНО ЧУВСТВИТЕЛЬНЫ К ОШИБКАМ В ПРОБЕЛАХ ИЛИ ВЫРАВНИВАНИИ!
## посетите http://www.yamllint.com/, чтобы проверить этот файл при необходимости

templates:
  - "templates/postgres.template.yml"
  - "templates/redis.template.yml"
  - "templates/web.template.yml"
  ## Раскомментируйте следующую строку, чтобы включить прослушивание IPv6
  #- "templates/web.ipv6.template.yml"
  - "templates/web.ratelimited.template.yml"
  ## Раскомментируйте эти две строки, если хотите добавить Lets Encrypt (https)
  #- "templates/web.ssl.template.yml"
  #- "templates/web.letsencrypt.ssl.template.yml"

## какие TCP/IP-порты должен открывать этот контейнер?
## Если вы хотите, чтобы Discourse использовал порт совместно с другим веб-сервером, например Apache или nginx,
## см. https://meta.discourse.org/t/17247 для деталей
expose:
  - "8080:80"   # http (запуск на локальном порту 8080, порт Docker 80)
  #- "443:443" # https (убедитесь, что это закомментировано)

params:
  db_default_text_search_config: "pg_catalog.english"

  ## Установите db_shared_buffers максимум в 25% от общего объема памяти.
  ## будет установлено автоматически при загрузке на основе обнаруженной оперативной памяти, или вы можете переопределить
  #db_shared_buffers: "256MB"

  ## может улучшить производительность сортировки, но увеличивает использование памяти на соединение
  #db_work_mem: "40MB"

  ## Какую ревизию Git должен использовать этот контейнер? (по умолчанию: tests-passed)
  #version: tests-passed

env:
  LC_ALL: en_US.UTF-8
  LANG: en_US.UTF-8
  LANGUAGE: en_US.UTF-8
  # DISCOURSE_DEFAULT_LOCALE: en

  ## Сколько одновременных веб-запросов поддерживается? Зависит от памяти и ядер процессора.
  ## будет установлено автоматически при загрузке на основе обнаруженных процессоров, или вы можете переопределить
  #UNICORN_WORKERS: 3

  ## TODO: Доменное имя, на которое будет реагировать этот экземпляр Discourse
  ## Обязательно. Discourse не будет работать с чистым IP-адресом.
  DISCOURSE_HOSTNAME: 'faq.mobiloan.io'

  ## Раскомментируйте, если хотите, чтобы контейнер запускался с тем же
  ## именем хоста (опция -h), указанным выше (по умолчанию "$hostname-$config")
  #DOCKER_USE_HOSTNAME: true

  ## TODO: Список разделенных запятыми адресов электронной почты, которые станут администраторами и разработчиками
  ## при первоначальной регистрации, например 'user1@example.com,user2@example.com'
  DISCOURSE_DEVELOPER_EMAILS: «введите здесь email»

  ## TODO: SMTP-сервер электронной почты, используемый для проверки новых учетных записей и отправки уведомлений
  ## SMTP-адрес, имя пользователя и пароль обязательны
  ## ВНИМАНИЕ: символ '#' в пароле SMTP может вызвать проблемы!
  DISCOURSE_SMTP_ADDRESS: ВВЕДИТЕ SMTP ЗДЕСЬ
  DISCOURSE_SMTP_PORT: 587
  DISCOURSE_SMTP_USER_NAME: ВВЕДИТЕ ИМЯ ПОЛЬЗОВАТЕЛЯ ЗДЕСЬ
  DISCOURSE_SMTP_PASSWORD: ВВЕДИТЕ ПАРОЛЬ ЗДЕСЬ
  DISCOURSE_SMTP_ENABLE_START_TLS: true           # (опционально, по умолчанию true, мы используем Amazon SES)

 

  #DISCOURSE_SMTP_DOMAIN: discourse.example.com    # (требуется некоторыми провайдерами)
  #DISCOURSE_NOTIFICATION_EMAIL: noreply@discourse.example.com    # (адрес для отправки уведомлений)

  ## Если вы добавили шаблон Lets Encrypt, раскомментируйте ниже, чтобы получить бесплатный SSL-сертификат
  #LETSENCRYPT_ACCOUNT_EMAIL: me@example.com

  ## Адрес http или https CDN для этого экземпляра Discourse (настроен на получение)
  ## см. https://meta.discourse.org/t/14857 для деталей
  #DISCOURSE_CDN_URL: https://discourse-cdn.example.com
  
  ## Ключ IP-адреса геолокации maxmind для поиска по IP-адресу
  ## см. https://meta.discourse.org/t/-/137387/23 для деталей
  #DISCOURSE_MAXMIND_LICENSE_KEY: 1234567890123456

## Контейнер Docker не имеет состояния; все данные хранятся в /shared
volumes:
  - volume:
      host: /var/discourse/shared/standalone
      guest: /shared
  - volume:
      host: /var/discourse/shared/standalone/log/var-log
      guest: /var/log

## Плагины идут здесь
## см. https://meta.discourse.org/t/19157 для деталей
hooks:
  after_code:
    - exec:
        cd: $home/plugins
        cmd:
          - git clone https://github.com/discourse/docker_manager.git

## Любые пользовательские команды для запуска после сборки
run:
  - exec: echo "Начало пользовательских команд"
  ## Если вы хотите установить адрес электронной почты «От» для вашей первой регистрации, раскомментируйте и измените:
  ## После получения первого письма о регистрации снова закомментируйте строку. Она должна быть выполнена только один раз.
  #- exec: rails r "SiteSetting.notification_email='info@unconfigured.discourse.org'"
  - exec: echo "Конец пользовательских команд"
  1. После редактирования и сохранения файла выполните пересборку приложения Discourse, используя следующую команду в терминале

$ /var/discourse/launcher rebuild discourse

Примечание: если ваш yaml-файл называется иначе, замените discourse на имя вашего yaml-файла.

Обратите внимание, что пересборка занимает время.

  1. После пересборки ваше приложение должно работать на порту 8080. Чтобы проверить это, выполните следующую команду в терминале

$ sudo lsof -i -P -n | grep LISTEN

Пример вывода портов

Обратите внимание, что Docker слушает порт 8080, а httpd (Apache) слушает порт 80.

Что касается маршрутизации трафика: Apache будет получать веб-запросы и, при необходимости, перенаправлять их в контейнер Discourse на порт 8080.

image
image942×748 124 KB

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

КОНФИГУРАЦИЯ ВИРТУАЛЬНОГО ХОСТА APACHE

  1. Конфигурационный файл Apache находится по адресу /etc/httpd/conf.d/00-virtualhosts.conf. httpd / apache / apache2 — это разные версии Apache. Ваши файлы могут находиться в других местах, если вы не используете службу httpd, но конфигурация виртуального хоста в этом случае будет такой же.

Варианты редактирования:

1. Вы можете использовать nano и редактировать через командную строку / терминал
2. На AWS, если вы используете MATE с PLUMA, вы можете использовать PLUMA для редактирования файла
3. Вы можете использовать WINSCP для подключения к машине через SSH и редактирования файла через графический интерфейс Windows

Отредактируйте файл /etc/httpd/conf.d/00-virtualhosts.conf, добавив следующее:

# FAQ (МАРШРУТЫ DISCOURSE)

<VirtualHost *:80>
  	ServerName  sub.domain.com
  	ProxyPreserveHost On
    ProxyPass "/" "http://localhost:8080/"
    ProxyPassReverse "/" "http://localhost:8080/"
</VirtualHost>
  1. Вам нужно создать соответствующую DNS-запись CNAME, указывающую поддомен на ваш сервер AWS / балансировщик нагрузки.

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

Балансировщик нагрузки обрабатывает наш SSL/TLS через сертификат, предоставленный AWS.

Балансировщик нагрузки также перенаправляет трафик на экземпляр AWS.

Apache установлен на экземпляре AWS и перенаправляет трафик на наши:

  • Приложения Node Express
  • Приложение Docker / Discourse.

ЗАКЛЮЧЕНИЕ

Это лишь одно из решений, но именно оно сработало в нашей существующей настройке.

Большое спасибо:

@Kane York за его статью о Discourse,
@Axel Fernandes за его статью на Medium, его заметки о загрузке необходимых файлов Discourse и
@Vivek Gite из nixCraft и его статью на cyberciti об установке Docker на AWS Linux 2.