Установка 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.

[Arkshine]

@Arkshine

На свежей установке Ubuntu 22 (Windows 10, WSL2) и успешной установке Discourse все изображения не загружаются на порту по умолчанию 4200.

Отлично, решение найдено.

Я заметил, что замена 127.0.0.1 на localhost исправляет проблему с изображениями.

После небольшого поиска вот команда, которую можно использовать для запуска Discourse:

DISCOURSE_HOSTNAME=localhost UNICORN_LISTENER=localhost:3000 bin/ember-cli -u

---

Позже я постараюсь обновить руководство.

[Arkshine]

Есть ли возможность просмотреть этот PR?

FIX: The PostgreSQL service not starting after installation (WSL2 context) (#45)

Это сделало бы это руководство немного более дружелюбным.

[Will_S1 (Will S)]

Есть ли какие-то идеи, почему я получаю сообщение «К сожалению, произошла непредвиденная ошибка, и Bundler не может продолжить работу» после выполнения bundle install?

[D111 (D)]

та же проблема

[sam (Sam Saffron)]

Можете прислать скриншот ошибки? Какая версия Ruby у вас установлена?

[frocm]

У меня возникли проблемы с зависимостями:

ux430uq@Asus-UX430UQ:~/discourse$ bundle install
Для работы с этим lockfile-файлом необходимо использовать Bundler версии 2 или выше.
ux430uq@Asus-UX430UQ:~/discourse$ bundler -v
Bundler version 1.16.1

ux430uq@Asus-UX430UQ:~/discourse$ gem install bundler

Fetching: bundler-2.4.20.gem (100%)
ERROR:  While executing gem ... (Gem::FilePermissionError)
    У вас нет прав на запись в каталог /var/lib/gems/2.5.0.
ux430uq@Asus-UX430UQ:~/discourse$
ux430uq@Asus-UX430UQ:~/discourse$ sudo gem install bundler
[sudo] пароль для ux430uq:
Fetching: bundler-2.4.20.gem (100%)
ERROR:  Error installing bundler:
        Последней версией bundler (>= 0), поддерживающей вашу Ruby и RubyGems, является версия 2.3.26. Попробуйте установить её командой `gem install bundler -v 2.3.26`
        bundler требует версию Ruby >= 2.6.0. Текущая версия Ruby — 2.5.0.
ux430uq@Asus-UX430UQ:~/discourse$ bundler -v
Bundler version 1.16.1
ux430uq@Asus-UX430UQ:~/discourse$

Как я могу легко исправить это? Я пытался установить версии 2.6.0, затем 2.7.0, но всегда возникали другие проблемы.

[AliBenBongo]

Как и некоторые ранее комментировавшие, я также столкнулся с трудностями и ошибками при попытке следовать этой инструкции — пробовал как на Windows 10, так и на Windows 11.

После ряда проб и ошибок я наконец нашёл шаги, которые позволяют создать полностью рабочую среду разработки под Windows 11. Это было протестировано на последней сборке 22H2, а также на предварительной версии релиза 23H2 (предполагаю, что это также будет работать на новейшей сборке Windows 10).

Если это кому-то пригодится, я только что опубликовал инструкцию здесь:

Guide to Setting Up Discourse Development Environment - Windows 11

Hi Everyone, After spending some time attempting to get a working development environment up and running under Windows 11 / WSL2 I thought I would share the steps that I have followed. This is my first post here so I hope that this is of use to somebody I am a Systems Administrator used to working with Windows so this has been an interesting journey learning Linux / Ruby / Discourse etc. A few things seem to have changed since the guide for Windows 10 was written and I ran into…

Надеюсь, это поможет людям, таким как я, которые пытаются запустить Discourse под Windows

[Canapin (Coin-coin le Canapin)]

Я снова прошелся по всему этому официальному руководству, чтобы убедиться, что после моей предыдущей попытки ничего не сломалось.

Я установил Ubuntu (версия не указана) через WSL на Windows 11, в результате чего была установлена последняя LTS-версия — в данном случае 22.04.

У меня не возникло никаких проблем: всё прошло гладко, без ошибок, и установка разработчика работает корректно.

Если в будущем у вас возникнут трудности с установкой чего-либо по одному из наших официальных руководств, пожалуйста, записывайте ошибки и сообщайте нам об этом — это всегда полезно

---

Однако есть два предупреждения:

При установке Node.js:

================================================================================
▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓
================================================================================

                           ПРЕДУПРЕЖДЕНИЕ ОБ УСТАРЕВАНИИ СКРИПТА


  Этот скрипт, расположенный по адресу https://deb.nodesource.com/setup_X, который использовался
  для установки Node.js, теперь устарел и в конечном итоге будет отключён.

  Пожалуйста, посетите репозиторий NodeSource distributions на GitHub и следуйте
  инструкциям по миграции вашего репозитория.
  https://github.com/nodesource/distributions

  В репозитории GitHub NodeSource Node.js Linux distributions содержится
  информация о том, какие версии Node.js и какие дистрибутивы Linux
  поддерживаются, а также как их установить.
  https://github.com/nodesource/distributions


                          ПРЕДУПРЕЖДЕНИЕ ОБ УСТАРЕВАНИИ СКРИПТА

================================================================================
▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓
================================================================================

ЧТОБЫ ИЗБЕЖАТЬ ЭТОГО, ПЕРЕЙДИТЕ НА НОВЫЙ СКРИПТ
Продолжение через 60 секунд (нажмите Ctrl-C для прерывания) ...

При запуске redis-server --daemonize yes:

# ВНИМАНИЕ: необходимо включить переполнение памяти! Без этого фоновое сохранение или репликация могут завершиться неудачей при нехватке памяти. Отключение этой опции также может привести к сбоям даже при наличии достаточного объёма памяти. Подробнее см. https://github.com/jemalloc/jemalloc/issues/1328. Чтобы исправить эту проблему, добавьте 'vm.overcommit_memory = 1' в файл /etc/sysctl.conf, затем перезагрузите систему или выполните команду 'sysctl vm.overcommit_memory=1', чтобы изменения вступили в силу.

[AliBenBongo]

Не знаю, почему у меня тогда возникло столько проблем! Возможно, в моей установке Windows что-то было странное, и я случайно исправил это во время устранения неполадок, даже не осознав этого!

В любом случае, я доволен тем, что уже узнал, и с нетерпением жду продолжения работы по переносу моих форумов на Discourse.

[Arkshine]

@Coin-coin le Canapin

Я снова прошел весь этот официальный гайд, чтобы убедиться, что ничего не сломалось с момента моей последней попытки.

Мне пришлось переустановить Windows, и теперь у меня чистая установка Windows 11.
Я буду следовать гайду и позже отчитаюсь! Также буду иметь в виду гайд от @AliBenBongo.

[Arkshine]

Вот продолжение.

Конечно, руководство можно было бы обновить, но оно всё ещё отлично работает на чистой Windows 11 22H2.

Единственная проблема, с которой я столкнулся, заключалась в том, что, хотя команда wsl работала в терминале, функция WSL по умолчанию не была включена:

[NateDhaliwal]

Я думаю, что эта инструкция устарела. Шаги, упомянутые в руководстве для Ubuntu/Debian, больше даже не существуют.

[NateDhaliwal]

Есть ли способ отменить все эти действия, например, выполнить обратную установку скрипта пакетов, gem-библиотек и клонирования?

[TempAccount]

@Discourse

ВНИМАНИЕ: Установите Ubuntu 18.04, а не 20.04, так как некоторые установки не пройдут на 20.04.

Все еще требуется установка 18.04 вместо 20.04?

Получаю ошибку при установке nodejs:

# apt install nodejs

Чтение списков пакетов... Готово
Построение дерева зависимостей
Чтение информации о состоянии... Готово
Некоторые пакеты не могут быть установлены. Это может означать, что вы
запросили невозможную ситуацию или, если вы используете нестабильную
версию дистрибутива, некоторые требуемые пакеты еще не созданы
или были перемещены из Incoming.
Следующая информация может помочь разрешить ситуацию:

Следующие пакеты имеют неудовлетворенные зависимости:
 nodejs : Зависит: libc6 (>= 2.28), но будет установлен 2.27-3ubuntu1.6
E: Не удалось исправить проблемы, у вас есть заблокированные поврежденные пакеты.

[saros]

@Arkshine

Всё, я нашёл решение.

Я заметил, что замена 127.0.0.1 на localhost решает проблему с изображениями.

Поискал информацию и обнаружил, что для запуска Diwsl можно использовать следующую команду:

Установка на 24.04 не удалась, хост-машина не может подключиться к порту 3000

[merefield (Robert)]

У меня это работает на 24.04. Рекомендую поделиться более подробной информацией о том, что происходит при запуске сервера.

Попробуйте FORCE_HOSTNAME=localhost bin/ember-cli -u — это запустит одновременно серверы бэкенда и фронтенда.

(В пути: по памяти)