Установка Discourse на Windows для разработки

[Discourse]

Это руководство протестировано на Windows 10 и 11.

Для настройки среды разработки Discourse на Windows вы можете использовать функцию Windows Subsystem for Linux.

Эта настройка требует установки WSL 2. Она доступна только в сборках Windows 10 версии 18917 и выше. Мы предполагаем, что вы уже установили Windows Subsystem for Linux 2 (Ubuntu) на вашей системе Windows 10. ВНИМАНИЕ: Установите Ubuntu 18.04, а не 20.04, так как некоторые установки не работают на 20.04. Дополнительную информацию см. в заметках от 30 июня 2020 года в конце этой статьи.

Начнем!

Установка Discourse

1. Сначала следуйте инструкциям из темы Руководство для начинающих по установке Discourse на Ubuntu для разработки до шага Клонирование Discourse.

@techAPJ

Установка зависимостей Discourse

Вам понадобятся следующие пакеты в вашей системе:

• Git
• rbenv или asdf
• ruby-build
• Ruby (последняя стабильная версия)
• Rails
• PostgreSQL
• SQLite
• Redis
• Node.js
• pnpm
• MailHog**
• ImageMagick**

** опционально

Теперь, когда мы установили зависимости Discourse, перейдем к установке самого Discourse.

2. Перед настройкой базы данных вам необходимо вручную запустить службу PostgreSQL и сервер Redis с помощью следующих команд

   sudo service postgresql start
   redis-server --daemonize yes
   

3. Затем выполните все оставшиеся шаги из руководства для Ubuntu.

@techAPJ

Клонирование Discourse

Клонируйте репозиторий Discourse в папку ~/discourse:

git clone https://github.com/discourse/discourse.git ~/discourse

~ обозначает домашнюю папку, поэтому исходный код Discourse будет доступен в вашей домашней папке.

Настройка базы данных

Создайте роль с тем же именем, что и имя пользователя вашей системы Ubuntu:

sudo -u postgres createuser -s "$USER"
```\n
## Настройка Discourse

Перейдите в вашу папку Discourse:

```sh
cd ~/discourse
```\n
Установите необходимые гемы

```sh
source ~/.bashrc
bundle install

Теперь, когда вы успешно установили гемы, выполните эти команды:

bundle exec rake db:create
bundle exec rake db:migrate
RAILS_ENV=test bundle exec rake db:create db:migrate

Попробуйте запустить тесты:

bundle exec rake autospec

Все тесты должны пройти успешно.

Запустите сервер Rails:

bundle exec rails server

Теперь вы сможете подключиться к вашему приложению Discourse по адресу http://localhost:3000 - попробуйте!

В отдельном окне терминала перейдите в вашу папку discourse (cd ~/discourse) и выполните:

bin/dev --only ember

Это запускает сборщик фронтенда; приложение по-прежнему обслуживается с http://localhost:3000.

Создание команды для запуска Discourse

Теперь ваша среда разработки почти готова. Единственная проблема заключается в том, что каждый раз, когда вы открываете Ubuntu на Windows, вам приходится вручную запускать службу PostgreSQL и сервер Redis. Не волнуйтесь, мы можем решить эту проблему, создав пользовательскую команду

cd ~

Создайте новый файл с помощью команды nano start-discourse и вставьте содержимое ниже, затем сохраните и выйдите.

#!/bin/bash

# для запуска PostgreSQL
sudo service postgresql start

# для запуска сервера Redis
redis-server --daemonize yes

Теперь измените права доступа с помощью следующей команды

chmod +x start-discourse

И скопируйте файл в вашу папку bin

sudo cp start-discourse /usr/bin/

Готово. Теперь, каждый раз, когда вы открываете bash Ubuntu, просто выполните команду ниже и приступайте к разработке

start-discourse

---

В качестве альтернативы, если вы используете Windows 10 Enterprise, Pro или Education, вы можете создать виртуальную машину Linux в Hyper-V для настройки среды разработки Discourse.

Примечания по среде Windows

По состоянию на 30 июня 2020 года:

@AndreaHabib

С появлением сборки Windows 10 2004 и WSL 2 многие из вас могут столкнуться с некоторыми проблемами, так как теперь Discourse требует WSL 2 для работы.
Для начала: Если вы еще этого не сделали, вам следует обновить систему до Windows 2004 (19041)
Примечание: Не устанавливайте через Центр обновления Windows в настройках системы, так как во время установки могут возникнуть ошибки. Также убедитесь, что у вас установлена Windows 1903 (18362) или 1909 (18363), вы можете проверить это, введя winver в поиске.

• Перейдите по ссылке: Скачать Windows 10
• Нажмите кнопку “Обновить сейчас” под Windows 10 May 2020 Update, чтобы скачать помощник по обновлению и позвольте ему установить и завершить работу
• Если вы получите какие-либо ошибки, скачайте средство создания носителя, запустите его и создайте загрузочную флешку (флешка минимум на 8 ГБ) и используйте ее для установки Windows.

Когда вы закончите установку Windows, вам нужно будет вручную установить WSL 2
Но сначала нам нужно убедиться, что включены 2 функции:

• Платформа виртуальных машин, которую можно включить непосредственно из Windows, перейдя в Программы и компоненты, а затем включив Дополнительные компоненты в Включение или отключение компонентов Windows
• Другая - Виртуализация, которую можно включить только из BIOS. Однако этот вариант может отличаться в зависимости от материнской платы. Например: на AMD он называется SVM. Поэтому, пожалуйста, найдите информацию о вашей конкретной материнской плате.

Теперь, когда у вас включены обе функции:

• Установите Ubuntu 18.04, а не 20.04, так как некоторые установки не работают на 20.04.
• Перейдите сюда и обновите ядро Linux: Ссылка в ответах
• Перейдите по этой ссылке и следуйте инструкциям: Установка Windows Subsystem for Linux (WSL) на Windows 10 | Microsoft Docs
• Перейдите в PowerShell (запустите от имени администратора) и выполните: wsl --set-version Ubuntu-18.04 2 или wsl --set-version Ubuntu 2, в зависимости от того, какой дистрибутив отображается в wsl -l -v
• Конвертация занимает время, несколько минут
• Выполните wsl -l -v, чтобы убедиться, что Ubuntu работает на WSL 2

Теперь вы можете запустить Ubuntu-18.04 или Windows Terminal с Ubuntu и начать установку зависимостей и инструментов

Примечание: Если вы сталкиваетесь с ошибкой при установке одного из гемов во время bundle install: Убедитесь, что вы используете Ubuntu-18.04, а не 20.04

Однако, если у вас уже есть postgreSQL 12 и он работает на порту 5432, вы можете столкнуться с некоторыми проблемами, так как зависимости устанавливают postgreSQL 10, который может увеличить порт до 5433.
Чтобы это исправить:

• Откройте вашу папку в текстовом редакторе (например, VS Code)
• Перейдите в config/database.yml
• Под development и под adapter, добавьте новую строку, а затем добавьте: port: 5433
• Убедитесь, что вы сделали то же самое для test и profile.

Если вышеуказанное не работает, убедитесь, что PostgreSQL запущен и на каком порту с помощью pg_isready. Затем следуйте тем же инструкциям выше, установив порт равным тому, на котором работает база данных.

ДЛЯ ЯДРА LINUX: Обновление ядра Linux WSL 2 | Microsoft Docs

@RickyC0626

Решение, не требующее явной настройки порта в database.yml

Некоторые ошибки при создании и миграции базы данных:

Неверное подключение Redis к определенному порту / отказ в подключении

bundle exec rake db:create

rake aborted!
Redis::CannotConnectError: Error connecting to Redis on localhost:6379 (Errno::ECONNREFUSED)
...

Caused by:
Errno::ECONNREFUSED: Connection refused - connect(2) for 127.0.0.1:6379
...

Caused by:
IO::EINPROGRESSWaitWritable: Operation now in progress - connect(2) would block
...

Tasks: TOP => db:create => db:load_config => environment
(See full trace by running task with --trace)

Из этой ошибки мы видим, что порт, который использует Redis, это 6379, и мы можем исправить это, запустив сервер Redis через этот порт.

По умолчанию redis-server --daemonize yes должен работать, но если нет, используйте:

redis-server --daemonize yes --port 6379

Проверьте состояние экземпляра Redis:

redis-cli

127.0.0.1:6379> ping
PONG

Неверное подключение к порту psql

bundle exec rake db:migrate

PG::ConnectionBad: could not connect to server: No such file or directory
       Is the server running locally and accepting
       connections on Unix domain socket "/var/run/postgresql/.s.PGSQL.5432"?

Из этой ошибки мы видим, что PostgreSQL испытывает трудности с подключением к порту 5432. Обычно запуск службы должен помочь

sudo service postgresql start

Если это все еще не работает и ошибка сохраняется, попробуйте проверить, на каком порту прослушивает служба, и при необходимости измените порт на тот, который вы хотите, в postgresql.conf:

pg_isready

/var/run/postgresql:5432 - no response
or
/var/run/postgresql:5432 - accepting connections

---

Результат

После выполнения вышеуказанных действий или выполнения команды start-discourse, два экземпляра должны работать на своих стандартных/указанных портах. Чтобы проверить их состояние через стандартный терминал Windows cmd, мы можем выполнить:

netstat -anop tcp

что покажет что-то вроде этого:

Proto    Local Address        Foreign Address        State            PID
TCP      127.0.0.1:5432       0.0.0.0:0              LISTENING        17768
TCP      127.0.0.1:6379       0.0.0.0:0              LISTENING        17768

Теперь мы подтвердили, что наши экземпляры postgresql и redis-server запущены.

Мы также можем проверить состояние экземпляров на Ubuntu или WSL, с помощью следующих команд:

lsof -i

COMMAND     PID        USER  FD  TYPE  DEVICE  SIZE/OFF  NODE  NAME
mailcatch  3244  rickyc0626  7u  IPv4   36127       0t0   TCP  localhost:1025 (LISTEN)
mailcatch  3244  rickyc0626  8u  IPv4   36128       0t0   TCP  *:socks (LISTEN)
redis-ser  3287  rickyc0626  6u  IPv6   29352       0t0   TCP  *:6379 (LISTEN)
redis-ser  3287  rickyc0626  7u  IPv6   29353       0t0   TCP  *:6379 (LISTEN)

---

sudo ss -plunt | grep postgres

tcp  LISTEN  0  128  127.0.0.1:5432  0.0.0.0:*  users:(("postgres",pid=3070,fd=7))

---

pg_lsclusters

Ver Cluster Port Status Owner    Data directory              Log file
10  main    5432 online postgres /var/lib/postgresql/10/main /var/log/postgresql/postgresql-10-main.log

---

Отсюда эти команды должны работать без серьезных проблем, без необходимости изменять файл database.yml:

bundle exec rake db:create
bundle exec rake db:migrate
RAILS_ENV=test bundle exec rake db:create db:migrate

Любые дальнейшие проблемы, которые возникнут, могут быть решены в будущем.

По состоянию на 1 июля 2020 года

@RickyC0626

Решение, не требующее явной настройки порта в database.yml

Некоторые ошибки при создании и миграции базы данных:

Неверное подключение Redis к определенному порту / отказ в подключении

bundle exec rake db:create

rake aborted!
Redis::CannotConnectError: Error connecting to Redis on localhost:6379 (Errno::ECONNREFUSED)
...

Caused by:
Errno::ECONNREFUSED: Connection refused - connect(2) for 127.0.0.1:6379
...

Caused by:
IO::EINPROGRESSWaitWritable: Operation now in progress - connect(2) would block
...

Tasks: TOP => db:create => db:load_config => environment
(See full trace by running task with --trace)

Из этой ошибки мы видим, что порт, который использует Redis, это 6379, и мы можем исправить это, запустив сервер Redis через этот порт.

По умолчанию redis-server --daemonize yes должен работать, но если нет, используйте:

redis-server --daemonize yes --port 6379

Проверьте состояние экземпляра Redis:

redis-cli

127.0.0.1:6379> ping
PONG

Неверное подключение к порту psql

bundle exec rake db:migrate

PG::ConnectionBad: could not connect to server: No such file or directory
       Is the server running locally and accepting
       connections on Unix domain socket "/var/run/postgresql/.s.PGSQL.5432"?

Из этой ошибки мы видим, что PostgreSQL испытывает трудности с подключением к порту 5432. Обычно запуск службы должен помочь

sudo service postgresql start

Если это все еще не работает и ошибка сохраняется, попробуйте проверить, на каком порту прослушивает служба, и при необходимости измените порт на тот, который вы хотите, в postgresql.conf:

pg_isready

/var/run/postgresql:5432 - no response
or
/var/run/postgresql:5432 - accepting connections

---

Результат

После выполнения вышеуказанных действий или выполнения команды start-discourse, два экземпляра должны работать на своих стандартных/указанных портах. Чтобы проверить их состояние через стандартный терминал Windows cmd, мы можем выполнить:

netstat -anop tcp

что покажет что-то вроде этого:

Proto    Local Address        Foreign Address        State            PID
TCP      127.0.0.1:5432       0.0.0.0:0              LISTENING        17768
TCP      127.0.0.1:6379       0.0.0.0:0              LISTENING        17768

Теперь мы подтвердили, что наши экземпляры postgresql и redis-server запущены.

Мы также можем проверить состояние экземпляров на Ubuntu или WSL, с помощью следующих команд:

lsof -i

COMMAND     PID        USER  FD  TYPE  DEVICE  SIZE/OFF  NODE  NAME
mailcatch  3244  rickyc0626  7u  IPv4   36127       0t0   TCP  localhost:1025 (LISTEN)
mailcatch  3244  rickyc0626  8u  IPv4   36128       0t0   TCP  *:socks (LISTEN)
redis-ser  3287  rickyc0626  6u  IPv6   29352       0t0   TCP  *:6379 (LISTEN)
redis-ser  3287  rickyc0626  7u  IPv6   29353       0t0   TCP  *:6379 (LISTEN)

---

sudo ss -plunt | grep postgres

tcp  LISTEN  0  128  127.0.0.1:5432  0.0.0.0:*  users:(("postgres",pid=3070,fd=7))

---

pg_lsclusters

Ver Cluster Port Status Owner    Data directory              Log file
10  main    5432 online postgres /var/lib/postgresql/10/main /var/log/postgresql/postgresql-10-main.log

---

Отсюда эти команды должны работать без серьезных проблем, без необходимости изменять файл database.yml:

bundle exec rake db:create
bundle exec rake db:migrate
RAILS_ENV=test bundle exec rake db:create db:migrate

Любые дальнейшие проблемы, которые возникнут, могут быть решены в будущем.

---

Последний раз проверено @SaraDev 2022-06-16T02:00:00Z

---

Этот документ находится под контролем версий - предложите изменения на github.