Installer Discourse sur macOS pour le développement

[Discourse]

Ce guide couvre les instructions d’installation pour un environnement de développement macOS. Pour les guides de production, consultez : Install Discourse in production with the official supported instructions

Vous souhaitez configurer Discourse sur macOS pour le développer et y apporter des modifications ?

Nous supposerons que Ruby, Rails, Postgres et Redis ne sont pas installés sur votre Mac. Commençons :rocket

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

redémarrez votre terminal

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

Redémarrer votre terminal

Quitter et redémarrer votre shell garantit que les chemins vers les packages installés sont correctement pris en compte par le terminal.

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.

Initialiser Discourse

Accédez au dossier Discourse :

cd ~/discourse

Installez les gems nécessaires :

bundle install

Installez les dépendances JS :

pnpm install

Ensuite, exécutez ces commandes pour configurer votre instance locale de Discourse :

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

Démarrez les serveurs Rails et Ember. Vous avez deux options ici.

Option 1 : en utilisant deux onglets/fenêtres de terminal séparés, exécutez Rails et le bundler frontend séparément via :

bundle exec rails server

et

bin/dev --only ember

Option 2 : en utilisant un seul onglet/fenêtre de terminal :

bin/dev # exécute Pitchfork et le bundler frontend ensemble

Vous devriez maintenant pouvoir naviguer vers http://localhost:3000 pour voir votre installation locale de Discourse. (Notez que le premier chargement peut prendre jusqu’à une minute pendant que le serveur se réchauffe.)

Vous pouvez également essayer d’exécuter les spécifications :

bundle exec rake autospec

Toutes (ou presque toutes) les tests devraient passer.

Créer un nouvel administrateur

Pour créer un nouvel administrateur, exécutez la commande suivante :

RAILS_ENV=development bundle exec rake admin:create

Suivez les invites pour créer un compte administrateur.

Configurer la messagerie

Exécutez MailHog :

mailhog

---

Félicitations ! Vous êtes maintenant l’administrateur de votre propre installation Discourse !

Bon développement ! Pour commencer, consultez le Guide pour débutants sur la création de plugins Discourse.

---

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

[jamesmarkcook (James Cook)]

If anyone is getting failing specs with most of them being .count errors, then try the following:

RAILS_ENV=test bundle exec rake db:reset

I had a problem where development data somehow got into my test database and was causing lots of failures.

[henrikbg (Henrik Berg)]

Is it possible to reset a discourse completely?

[techAPJ (Arpit Jalan)]

@Henrik_B

Is it possible to reset a discourse completely?

Yes, do:

rake db:drop db:create db:migrate

Note that this will wipe everything and you will have to create your Admin user account again.

[Chaboi_3000]

Can someone assist me in how I can update my discourse?

/launcher rebuild app

returns an error.

[techAPJ (Arpit Jalan)]

./launcher rebuild app is for discourse_docker based production setup. To update local/development Discourse instance you need:

cd ~/discourse
git pull origin master

[Chaboi_3000]

@techAPJ

git pull origin master

I get this error @techAPJ,

error: Your local changes to the following files would be overwritten by merge:
	.gitignore
Please commit your changes or stash them before you merge.
Aborting

[techAPJ (Arpit Jalan)]

The error message is pretty clear:

Please commit your changes or stash them before you merge.

If you want to ignore your local changes, do:

git fetch origin
git reset --hard origin/master

[Decorbuz]

En suivant le guide du forum Ruby on Rails, je suis actuellement bloqué à l’étape 7.

C’est probablement une question très « débutant », mais comment « pointer » vers la branche expérimentale qui était liée dans ce sujet ? J’ai essayé plusieurs choses et j’ai fini par recevoir le message Unknown command mini_racer à chaque fois.

[blake (Blake Erickson)]

Ils ont tout à fait le droit de poser la question ici.

Nous avons rédigé certaines instructions spécifiques pour M1 que nous mentionnons sur le forum Rails dans ce guide.

@Decorbuz

C’est probablement une question très « débutant », mais comment puis-je « pointer » vers la branche expérimentale liée dans ce sujet ?

Je devrai vérifier plus tard sur mon MacBook Air M1, et peut-être que mes collègues qui ont récemment configuré de nouveaux Macs sauront mieux si cela est encore nécessaire. Cependant, il existe un exemple montrant comment pointer vers une branche à l’étape 7 :

gem 'mini_racer', github: 'rubyjs/mini_racer', branch: 'refs/pull/186/head'

Vous devrez donc modifier cette ligne dans votre version locale de discourse/Gemfile :

Gemfile

puis exécuter bundle install.

[Decorbuz]

@pfaffman

Si vous n’avez pas suivi ces instructions (je ne vois pas d’étape 7), ce n’est pas un endroit idéal pour poser votre question.

C’est lié tout en haut du message original.

Le sujet du forum Ruby on Rails est mort depuis plusieurs mois. L’auteur du sujet (OP) n’est plus actif depuis février et n’a répondu à aucun commentaire demandant de l’aide.

Il y a plus de gens ici pour m’aider. Juste pour le dire.

@blake

Il y a un exemple montrant comment pointer vers une branche à l’étape 7 :

gem 'mini_racer', github: 'rubyjs/mini_racer', branch: 'refs/pull/186/head'

J’ai essayé de copier cela dans le Terminal et j’ai reçu la même erreur Unknown command mini_racer qu’auparavant.

Il faut admettre que le guide du forum Ruby on Rails n’est pas aussi clair que je l’espérais à cet égard.

Désolé par avance…

[blake (Blake Erickson)]

@Decorbuz

J’ai essayé de copier cela dans le Terminal et j’ai reçu la même erreur « Unknown command mini_racer » que précédemment.

Ce n’est pas une commande à exécuter. Vous devrez modifier le fichier texte réel nommé « Gemfile » situé dans le répertoire discourse.

[Decorbuz]

@blake

Vous devrez modifier le fichier texte réel appelé « Gemfile » situé dans le répertoire discourse.

Doh!

Merci ! Je vais essayer ça tout de suite.

À mon avis, quelqu’un devrait modifier le guide du forum Ruby on Rails et fournir des clarifications supplémentaires concernant l’étape 7. Ce n’est que mon avis.

Je reviens tout de suite. Attendez une seconde…

[blake (Blake Erickson)]

Désolé, je dois filer, mais je pense que la correction de mini_racer pour les Mac M1 a été intégrée. Je viens de vérifier mon Gemfile sur mon Mac M1 et le mien n’a pas été modifié. Tu peux donc sauter l’étape 7.

[Decorbuz]

J’ai exécuté l’étape 8 et j’ai reçu l’erreur « Could not locate Gemfile ».

Je pense avoir réussi à résoudre l’étape 7, mais l’étape 8 me pose toujours problème et affiche l’erreur mentionnée ci-dessus.

[blake (Blake Erickson)]

@Decorbuz

J’ai exécuté l’étape 8 et j’ai reçu l’erreur « Could not locate Gemfile ».

Vous devez vous trouver à l’intérieur du répertoire discourse lorsque vous exécutez bundle install.

@techAPJ

Cloner Discourse

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

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

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

Amorcer Discourse

Changez de répertoire pour accéder au dossier Discourse :

cd ~/discourse

Installez les gems nécessaires

bundle install

[JQ331]

@merefield

En fait, c’est un peu plus qu’un couple de dollars (il s’agit d’un VPS 4 Go avec 8 cœurs — probablement excessif), mais cela me permet de développer depuis n’importe où et sur n’importe quelle plateforme. C’est assez performant, mais il y aura toujours un délai de quelques secondes si vous redémarrez le serveur web.

Bonjour @merefield : Pourriez-vous décrire un peu plus votre configuration à distance ?

Alors que le développement d’un thème me permet d’ajouter des modifications sur un site en direct, pour développer un plugin, je ne vois aucun moyen d’éviter de le faire sur ma machine locale, avec l’ensemble du codebase de Discourse (avec mon plugin ajouté par-dessus).

Le résultat est que pour tout changement (non-CSS) lors du codage d’un plugin, lorsque je le recharge : 1) cela fait démarrer les ventilateurs de mon ordinateur et 2) cela prend environ 30 secondes pour recharger. Et si je dois redémarrer le serveur, cela prend plusieurs minutes.

Ces délais s’accumulent vraiment — au point qu’il me faut une heure pour coder quelque chose qui, avec mon flux de travail habituel (où il y a un rechargement à chaud ou au maximum 2 à 3 secondes par changement), ne prendrait que 15 minutes.

Ainsi, j’apprécierais toute suggestion pour accélérer les choses.

[merefield (Robert)]

Cela serait probablement mieux placé dans le sujet Ubuntu, car j’exécute simplement cette installation sur un serveur cloud, précédé par nginx et un DNS complet (sans Docker), je m’adresse donc réellement au domaine. Tout est exécuté depuis le terminal. J’ai même réussi à faire fonctionner Ember CLI correctement dans cette configuration.

Ce n’est pas non plus très rapide, mais assez rapide. L’avantage est de pouvoir exécuter et tester des services de rappel HTTPS complets.

L’environnement de développement de plugins le plus rapide que je connaisse de loin est Docker Dev local sur WSL2, qui dévale. Il est également extrêmement simple à maintenir. Malheureusement, discourse_theme ne fonctionne pas encore dans cet environnement, à ma connaissance, je retourne donc à mon serveur cloud pour ce travail.

C’est un peu étrange qu’Apple soit en retard ici ? Les ingénieurs de Microsoft se sont montrés très astucieux.

[Nacho_Caballero]

Au cas où quelqu’un rencontrerait des erreurs en essayant d’installer ruby 2.7.3, apparemment quelque chose a changé après Xcode 12, ce qui casse le processus d’installation avec rbenv :

installing older Ruby versions on OSX after XCode 12

J’ai continué à recevoir ceci, même si j’ai les dernières versions de psych et libyaml installées :

Il semble que votre installation de ruby manque de psych (pour la sortie YAML).
Pour éliminer cet avertissement, veuillez installer libyaml et réinstaller votre ruby.

J’ai essayé la solution de contournement qu’ils suggèrent dans le guide, mais j’ai continué à recevoir la même erreur et j’ai fini par devoir utiliser rvm :

rvm install 2.7.3

[JQ331]

Concernant la manière de programmer plus rapidement lors de la création d’un plugin, j’ai récemment changé d’approche. Et cela fonctionne très bien. En gros, déplacez tout ce qui concerne le front-end vers un composant de thème, et ne codez que les éléments du back-end dans le plugin lui-même. Je sais que d’autres l’ont déjà compris. Mais maintenant que je le fais, la programmation est tellement plus rapide et agréable. Détails ici.