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.