PlayCommunity: система сообщества

Система сообщества PlayCommunity разработана на основе Play Framework 2.6.x и в настоящее время используется в сообществе PlayScala.

Участие и вклад

• Руководство по разработке Play For Scala: https://www.playscala.cn/docs
• Руководство по вкладу в сообщество PlayScala: https://github.com/playcommunity/play-community/blob/master/CONTRIBUTE.md

Загрузка и компиляция

git clone https://github.com/playcommunity/play-community.git

Откройте командную строку, перейдите в каталог play-community и выполните команду:

sbt dist

Окончательный путь к приложению Play будет:

play-community\target\universal\play-community-<version>.zip

Конфигурация

Конфигурация соединения MongoDB

Загрузите файл play-community-<версия>.zip на сервер и распакуйте его. Откройте файл конфигурации conf/application.conf и настройте следующим образом:

# Конфигурация MongoDB
mongodb.uri = "mongodb://user:password@host:port/play-community?authMode=scram-sha1"

Обратите внимание, что MongoDB должен иметь функцию ReplicaSet. Вы можете обратиться к официальной документации для настройки: Deploy Replica Set: https://docs.mongodb.com/manual/tutorial/deploy-replica-set/index.html. Также можно использовать скрипт запуска, предоставленный участником сообщества «Мечтательный странник». Этот скрипт необходимо запустить в Git Bash. Вот как его использовать:

• Откройте Git Bash, перейдите в корневой каталог проекта;
• Перейдите в каталог конфигурационных файлов: cd conf;
• Запустите скрипт запуска: bash start_mongo.sh. Скрипт запустит процесс mongod и автоматически перейдёт в оболочку mongo shell.
• В оболочке mongo введите следующую команду для инициализации ReplicaSet:

var config = {_id:"rs",members:[{_id:0,host:"127.0.0.1:27001"},{_id:1,host:"127.0.0.1:27002"}]};
rs.initiate(config);

• Проверьте статус ReplicaSet с помощью команды: rs.status().

Скрипт запуска создаст два узла MongoDB: 127.0.0.1:27001 и 127.0.0.1:27002. Файлы базы данных находятся в папке C:/mongo/data, а файлы журналов — в папках C:/mongo/logs/log1.log и C:/mongo/logs/log2.log.

Настройка учётной записи электронной почты

Откройте файл конфигурации conf/application.conf и настройте следующим образом:

# Настройка учётной записи для отправки электронной почты
play.mailer {
  host = "smtp.163.com"
  port = 25
  user = "xxx@163.com"
  password = "xxx"
}

Настройка службы поиска ElasticSearch

Установка ElasticSearch Скачайте любую версию и извлеките её. Затем запустите службу с помощью следующей команды:

• Официальная версия: https://www.elastic.co/products/elasticsearch
• Версия без ограничений root: http://pan.baidu.com/s/1jIijkrW (официальные установочные пакеты не могут быть запущены от имени пользователя root из соображений безопасности).

cd elasticsearch-5.5.0/bin
nohup ./elasticsearch > ./log.txt&

Откройте файл конфигурации conf/application.conf, настройте следующим образом:

# Настройка ElasticSearch
es {
  enabled = true
  index = "play-community"
  host = "127.0.0.1:9200"
}

Запуск

Запустите приложение с помощью следующей команды:

nohup ./play-community -J-Xms1g -J-Xmx1g -Dhttp.port=80 > ../log.txt &

Для получения дополнительной информации о запуске, остановке и обновлении приложений Play обратитесь к разделу «Play For Scala Development Guide — Chapter 5 The First Play Project — Publishing a Play Project»: https://www.playscala.cn/doc/catalog?_id=j1_11.

Управление

Доступ к системе управления находится по адресу:

http://адрес сервера/admin

По умолчанию учётная запись администратора — admin@playscala.cn 123456.