Installer Discourse sur Windows pour le développement

[Discourse]

Ce tutoriel a été testé sous Windows 10 et 11.

Pour configurer un environnement de développement pour Discourse sur Windows, vous pouvez utiliser la fonctionnalité Sous-système Windows pour Linux (WSL).

Cette configuration nécessite l’installation de WSL 2. Elle n’est disponible que dans les versions de Windows 10 18917 ou ultérieures. Nous supposerons que vous avez déjà installé Sous-système Windows pour Linux 2 (Ubuntu) sur votre système Windows 10. ATTENTION : Installez Ubuntu 18.04, et non 20.04, car certaines installations échouent sur 20.04. Pour plus d’informations, consultez les notes du 30 juin 2020 en bas de ce post.

Commençons !

Installation de Discourse

1. Suivez initialement les étapes du sujet Guide pour les débutants pour installer Discourse sur Ubuntu pour le développement jusqu’à l’étape Cloner Discourse.

@techAPJ

Installer les dépendances de Discourse

Vous aurez besoin des packages suivants sur votre système :

• Git
• rbenv ou asdf
• ruby-build
• Ruby (dernière version stable)
• Rails
• PostgreSQL
• SQLite
• Redis
• Node.js
• pnpm
• MailHog**
• ImageMagick**

** optionnel

Maintenant que nous avons installé les dépendances de Discourse, passons à l’installation de Discourse lui-même.

2. Avant de configurer la base de données, vous devez démarrer manuellement le service PostgreSQL et le serveur Redis en utilisant les commandes suivantes :

   sudo service postgresql start
   redis-server --daemonize yes
   

3. Ensuite, suivez toutes les étapes restantes du guide Ubuntu.

@techAPJ

Cloner Discourse

Clonez le dépôt Discourse dans le dossier ~/discourse :

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

~ indique le dossier personnel, donc le code source de Discourse sera disponible dans votre dossier personnel.

Configurer la base de données

Créez un rôle avec le même nom que votre nom d’utilisateur Ubuntu :

sudo -u postgres createuser -s "$USER"

Initialiser Discourse

Accédez à votre dossier Discourse :

cd ~/discourse

Installez les gems nécessaires :

source ~/.bashrc
bundle install

Maintenant que vous avez installé les gems avec succès, exécutez ces commandes :

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

Essayez d’exécuter les tests :

bundle exec rake autospec

Tous les tests devraient réussir.

Démarrer le serveur Rails :

bundle exec rails server

Vous devriez maintenant pouvoir vous connecter à votre application Discourse sur http://localhost:3000 — essayez-le !

Dans une instance de terminal séparée, accédez à votre dossier Discourse (cd ~/discourse) et exécutez :

bin/dev --only ember

Cela démarre le bundler frontend ; l’application reste servie depuis http://localhost:3000.

Créer une commande pour démarrer Discourse

Votre environnement de développement est maintenant presque prêt. Le seul problème est que chaque fois que vous ouvrez Ubuntu sur Windows, vous devez démarrer manuellement le service PostgreSQL et le serveur Redis. Ne vous inquiétez pas, nous pouvons contourner ce problème en créant une commande personnalisée

cd ~

Créez un nouveau fichier en utilisant la commande nano start-discourse, collez le contenu ci-dessous, puis enregistrez et quittez.

#!/bin/bash

# pour démarrer PostgreSQL
sudo service postgresql start

# pour démarrer le serveur Redis
redis-server --daemonize yes

Modifiez maintenant les permissions CHMOD avec la commande suivante :

chmod +x start-discourse

Et copiez le fichier dans votre dossier bin :

sudo cp start-discourse /usr/bin/

C’est fait. Désormais, chaque fois que vous ouvrez le bash Ubuntu, exécutez simplement la commande ci-dessous et commencez à développer

start-discourse

---

Alternativement, si vous utilisez Windows 10 Enterprise, Pro ou Éducation, vous pouvez créer une machine virtuelle Linux dans Hyper-V pour configurer l’environnement de développement de Discourse.

Notes sur l’environnement Windows

Au 30 juin 2020 :

@AndreaHabib

Avec l’introduction de la version 2004 de Windows 10 et de WSL 2, beaucoup d’entre vous pourraient rencontrer des problèmes, car Discourse nécessite désormais WSL 2 pour fonctionner correctement.
Pour commencer : Si ce n’est pas déjà fait, vous voudrez mettre à jour votre système vers Windows 2004 (19041).
Note : N’installez pas via Windows Update dans les paramètres du système, car vous pourriez rencontrer des erreurs en cours d’installation. Assurez-vous également d’être sur Windows 1903 (18362) ou 1909 (18363), vous pouvez rechercher winver pour cela.

• Allez à : Télécharger Windows 10
• Cliquez sur le bouton Mettre à jour maintenant sous la mise à jour Windows 10 de mai 2020 pour télécharger l’assistant de mise à jour et laissez-le s’installer et se terminer.
• Si vous rencontrez des erreurs, téléchargez l’outil de création de média, exécutez-le et créez une clé USB amorçable (d’au moins 8 Go) et utilisez-la pour installer Windows.

Une fois l’installation de Windows terminée, vous devrez installer manuellement WSL 2.
Mais d’abord, nous devons nous assurer que deux fonctionnalités sont activées :

• Plateforme de machine virtuelle, qui peut être activée directement depuis Windows en allant dans Programmes et fonctionnalités, puis en activant les fonctionnalités facultatives dans Activer ou désactiver des fonctionnalités Windows.
• L’autre est la virtualisation, qui ne peut être activée que depuis votre BIOS. Cependant, cette option peut varier d’une carte mère à l’autre. Par exemple, sur AMD, elle s’appelle SVM. Veuillez donc consulter les spécifications de votre carte mère.

Maintenant que vous avez activé les deux fonctionnalités :

• Installez Ubuntu 18.04, et non 20.04, car certaines installations échouent sur 20.04.
• Rendez-vous ici et mettez à jour le noyau Linux : Lien dans les réponses.
• Rendez-vous à ce lien et suivez les étapes : Installer le sous-système Windows pour Linux (WSL) sur Windows 10 | Microsoft Docs
• Ouvrez PowerShell (en tant qu’administrateur) et exécutez : wsl --set-version Ubuntu-18.04 2 ou wsl --set-version Ubuntu 2, selon la distribution qui apparaît dans wsl -l -v.
• La conversion prend du temps, quelques minutes.
• Exécutez wsl -l -v pour vous assurer qu’Ubuntu fonctionne sur WSL 2.

Vous pouvez maintenant exécuter Ubuntu-18.04 ou Windows Terminal avec Ubuntu et commencer à installer les dépendances et les outils.

Note : Si vous rencontrez une erreur lors de l’installation d’une des gems pendant bundle install : Assurez-vous d’être sur Ubuntu-18.04 et non 20.04.

Cependant, si vous avez déjà PostgreSQL 12 en cours d’exécution sur le port 5432, vous pourriez rencontrer des problèmes, car les dépendances installent PostgreSQL 10, ce qui peut augmenter le port à 5433.
Pour corriger cela :

• Ouvrez votre dossier dans un éditeur de texte (VS Code par exemple).
• Allez dans config/database.yml.
• Sous development et sous adapter, ajoutez une nouvelle ligne puis ajoutez : port: 5433.
• Assurez-vous de faire de même pour test et profile.

Si ce qui précède ne fonctionne pas, vérifiez si PostgreSQL est en cours d’exécution et sur quel port via pg_isready. Suivez ensuite les mêmes instructions ci-dessus, en définissant le port égal à celui sur lequel la base de données est en cours d’exécution.

POUR LE NOYAU LINUX : Mise à jour du noyau Linux WSL 2 | Microsoft Docs

@RickyC0626

Une solution qui ne nécessite pas de configuration explicite des ports dans database.yml.

Quelques erreurs lors de la création et de la migration de la base de données :

Connexion Redis invalide à un port spécifique / refus de connexion

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
(Voir la trace complète en exécutant la tâche avec --trace)

À partir de cette erreur, nous pouvons voir que le port utilisé par Redis est 6379, et nous pouvons corriger cela en démarrant le serveur Redis via ce port.

Par défaut, redis-server --daemonize yes devrait fonctionner, mais si ce n’est pas le cas, utilisez :

redis-server --daemonize yes --port 6379

Vérifiez l’état de l’instance Redis :

redis-cli

127.0.0.1:6379> ping
PONG

Connexion invalide au port 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"?

À partir de cette erreur, nous pouvons voir que PostgreSQL a du mal à se connecter au port 5432. Habituellement, démarrer le service devrait fonctionner.

sudo service postgresql start

Si cela ne fonctionne toujours pas et que l’erreur persiste, essayez de vérifier sur quel port le service écoute, et si nécessaire, changez le port vers celui que vous souhaitez dans postgresql.conf :

pg_isready

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

---

Le résultat

Une fois que nous avons fait ce qui précède ou exécuté la commande start-discourse, les deux instances devraient fonctionner sur leurs ports par défaut/spécifiés. Pour vérifier leur état via le terminal Windows cmd par défaut, nous pouvons exécuter :

netstat -anop tcp

ce qui affichera quelque chose comme ceci :

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

Nous avons maintenant confirmé que nos instances postgresql et redis-server sont en cours d’exécution.

Nous pouvons également vérifier l’état des instances sur Ubuntu ou WSL avec les commandes suivantes :

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

---

À partir d’ici, ces commandes devraient fonctionner sans problèmes majeurs, sans avoir besoin de modifier le fichier database.yml :

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

Tous les problèmes supplémentaires qui apparaîtront pourront être résolus à l’avenir.

Au 1er juillet 2020

@RickyC0626

Une solution qui ne nécessite pas de configuration explicite des ports dans database.yml.

Quelques erreurs lors de la création et de la migration de la base de données :

Connexion Redis invalide à un port spécifique / refus de connexion

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
(Voir la trace complète en exécutant la tâche avec --trace)

À partir de cette erreur, nous pouvons voir que le port utilisé par Redis est 6379, et nous pouvons corriger cela en démarrant le serveur Redis via ce port.

Par défaut, redis-server --daemonize yes devrait fonctionner, mais si ce n’est pas le cas, utilisez :

redis-server --daemonize yes --port 6379

Vérifiez l’état de l’instance Redis :

redis-cli

127.0.0.1:6379> ping
PONG

Connexion invalide au port 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"?

À partir de cette erreur, nous pouvons voir que PostgreSQL a du mal à se connecter au port 5432. Habituellement, démarrer le service devrait fonctionner.

sudo service postgresql start

Si cela ne fonctionne toujours pas et que l’erreur persiste, essayez de vérifier sur quel port le service écoute, et si nécessaire, changez le port vers celui que vous souhaitez dans postgresql.conf :

pg_isready

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

---

Le résultat

Une fois que nous avons fait ce qui précède ou exécuté la commande start-discourse, les deux instances devraient fonctionner sur leurs ports par défaut/spécifiés. Pour vérifier leur état via le terminal Windows cmd par défaut, nous pouvons exécuter :

netstat -anop tcp

ce qui affichera quelque chose comme ceci :

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

Nous avons maintenant confirmé que nos instances postgresql et redis-server sont en cours d’exécution.

Nous pouvons également vérifier l’état des instances sur Ubuntu ou WSL avec les commandes suivantes :

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

---

À partir d’ici, ces commandes devraient fonctionner sans problèmes majeurs, sans avoir besoin de modifier le fichier database.yml :

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

Tous les problèmes supplémentaires qui apparaîtront pourront être résolus à l’avenir.

---

Dernière révision par @SaraDev le 2022-06-16T02:00:00Z

---

Ce document est versionné - proposez des modifications sur github.