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

[Discourse]

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

Чтобы настроить среду разработки для Discourse на Windows, вы можете использовать функцию Подсистемы Windows для Linux (WSL).

Эта настройка требует установки WSL 2. Она доступна только в сборках Windows 10 версии 18917 и выше. Мы предполагаем, что вы уже установили Подсистему Windows для 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"

Инициализация Discourse

Переключитесь в папку Discourse:

cd ~/discourse

Установите необходимые gems:

source ~/.bashrc
bundle install

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

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) с помощью следующей команды:

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 от мая 2020 года», чтобы загрузить помощник по обновлению и дождаться завершения установки.
• Если возникнут ошибки, загрузите средство создания носителя, запустите его, создайте загрузочный флеш-накопитель (объемом не менее 8 ГБ) и используйте его для установки Windows.

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

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

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

• Установите Ubuntu 18.04, а не 20.04, так как некоторые установки могут завершиться ошибкой на версии 20.04.
• Перейдите сюда и обновите ядро Linux: Ссылка в ответах.
• Перейдите по этой ссылке и выполните шаги: Установка подсистемы Windows для 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 и начать установку зависимостей и инструментов.

Примечание: Если вы столкнулись с ошибкой при установке одного из gems во время 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.