Installer Discourse sur Windows pour le développement

[Discourse]

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

Pour configurer un environnement de développement Discourse sur Windows, vous pouvez utiliser la fonctionnalité Windows Subsystem for Linux (WSL).

Cette configuration nécessite l’installation de WSL 2. Elle n’est disponible que sur les versions de Windows 10 build 18917 ou supérieure. Nous supposons que vous avez déjà installé Windows Subsystem for Linux 2 (Ubuntu) sur votre système Windows 10. ATTENTION : Installez Ubuntu 18.04, et non 20.04, car certaines installations échoueront sur 20.04. Pour plus d’informations, consultez les notes du 30 juin 2020 en bas de cet article.

Commençons !

Installation de Discourse

1. Suivez d’abord les étapes du sujet Guide pour débutants : 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, parcourez 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 (Bootstrap)

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 specs (tests) :

bundle exec rake autospec

Tous les tests devraient passer.

Démarrer le serveur Rails :

bundle exec rails server

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

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 accessible depuis http://localhost:3000.

Créer une commande pour démarrer Discourse

Votre environnement de développement est presque prêt. Le seul problème est qu’à 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 cela en créant une commande personnalisée

cd ~

Créez un nouveau fichier en utilisant la commande nano start-discourse et 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 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. Maintenant, 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 Education, vous pouvez créer une machine virtuelle Linux dans Hyper-V pour configurer l’environnement de développement Discourse.

Notes sur l’environnement Windows

À partir du 30 juin 2020 :

@AndreaHabib

Avec l’introduction de la build Windows 10 2004 et de WSL 2, beaucoup d’entre vous pourraient rencontrer des problèmes car Discourse nécessite désormais WSL 2 pour fonctionner réellement.
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 système, car vous pourriez rencontrer des erreurs en milieu 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 Windows 10 Mise à jour de mai 2020 pour télécharger l’assistant de mise à jour et laissez-le installer et terminer.
• Si vous obtenez des erreurs, téléchargez l’outil de création de supports d’installation, exécutez-le et créez une clé USB amorçable (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 2 fonctionnalités sont activées :

• La plateforme 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 rechercher votre carte mère spécifique.

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

• Installez Ubuntu 18.04, et non 20.04, car certaines installations échoueront sur 20.04.
• Allez ici et mettez à jour le noyau Linux : Lien dans les réponses.
• Allez à ce lien et suivez les étapes : Installer Windows Subsystem for Linux (WSL) sur Windows 10 | Microsoft Docs
• Allez dans PowerShell (exécuter en tant qu’administrateur) et exécutez : wsl --set-version Ubuntu-18.04 2 ou wsl --set-version Ubuntu 2, selon la distribution affichée 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 et qu’il tourne sur le port 5432, vous pourriez rencontrer des problèmes, car les dépendances installent PostgreSQL 10, ce qui pourrait incrémenter le port à 5433.
Pour corriger cela :

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

Si cela ne fonctionne pas, assurez-vous de vérifier 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 s’exécute.

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

@RickyC0626

Une solution qui ne nécessite pas de configuration explicite de port 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
(See full trace by running task with --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 effectué les étapes ci-dessus ou exécuté la commande start-discourse, les deux instances devraient s’exécuter sur leurs ports par défaut/spécifiés. Pour vérifier leur statut via le terminal cmd Windows 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ème majeur, 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

Toute autre problème qui apparaîtrait pourra être traité à l’avenir.

À partir du 1er juillet 2020

@RickyC0626

Une solution qui ne nécessite pas de configuration explicite de port 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
(See full trace by running task with --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 effectué les étapes ci-dessus ou exécuté la commande start-discourse, les deux instances devraient s’exécuter sur leurs ports par défaut/spécifiés. Pour vérifier leur statut via le terminal cmd Windows 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ème majeur, 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

Toute autre problème qui apparaîtrait pourra être traité à l’avenir.

---

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

---

Ce document est sous contrôle de version - suggérez des modifications sur github.