Questa guida tratta le istruzioni per l’installazione di un ambiente di sviluppo su macOS; per le guide relative alla produzione, consultare: Install Discourse in production with the official supported instructions
Quindi vuoi configurare Discourse su macOS per sviluppare e lavorare sul codice?
Assumiamo che non abbiate già installato Ruby/Rails/Postgres/Redis sul vostro Mac. Cominciamo 
!
Installare le dipendenze di Discourse
Sul vostro sistema saranno necessari i seguenti pacchetti:
- Git
- rbenv oppure asdf
- ruby-build
- Ruby (ultima versione stabile)
- Rails
- PostgreSQL
- SQLite
- Redis
- Node.js
- pnpm
- MailHog**
- ImageMagick**
** opzionale
Riavviate il terminale
Ora che abbiamo installato le dipendenze di Discourse, procediamo con l’installazione dello stesso Discourse.
Riavviare il Terminale
Uscire dalla shell e riavviarla garantisce che i percorsi dei pacchetti installati vengano correttamente rilevati dal Terminale.
Clonare Discourse
Clonate il repository di Discourse nella cartella ~/discourse:
git clone https://github.com/discourse/discourse.git ~/discourse
~ indica la cartella home, quindi il codice sorgente di Discourse sarà disponibile nella vostra cartella home.
Avviare Discourse
Passate alla cartella di Discourse:
cd ~/discourse
Installate le gemme necessarie
bundle install
Installate le dipendenze JS
pnpm install
Quindi eseguite questi comandi per configurare la vostra istanza locale di Discourse:
bundle exec rake db:create
bundle exec rake db:migrate
RAILS_ENV=test bundle exec rake db:create db:migrate
Avviate i server Rails ed Ember; avete due opzioni a disposizione.
Opzione 1: utilizzando due schede/finestre separate del terminale, eseguite Rails e il bundler del frontend separatamente tramite
bundle exec rails server
e
bin/dev --only ember
Opzione 2: utilizzando una sola scheda/finestra del terminale:
bin/dev # esegue Pitchfork e il bundler del frontend insieme
Dovreste ora essere in grado di accedere a http://localhost:3000 per vedere la vostra installazione locale di Discourse. (Nota: il primo caricamento può richiedere fino a un minuto mentre il server si avvia.)
Potete anche provare a eseguire gli spec:
bundle exec rake autospec
Tutti (o quasi tutti) i test dovrebbero passare.
Creare un nuovo amministratore
Per creare un nuovo amministratore, eseguite il seguente comando:
RAILS_ENV=development bundle exec rake admin:create
Seguite le indicazioni per creare un account amministratore.
Configurare la posta
Avviate MailHog:
mailhog
Congratulazioni! Ora siete gli amministratori della vostra installazione di Discourse!
Buon hacking! Per iniziare, consultate la Guida per principianti alla creazione di plugin per Discourse.
Questo documento è sottoposto a controllo di versione: suggerite modifiche su GitHub.