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 svilupparci e modificarlo?
Assumiamo che tu non abbia Ruby/Rails/Postgres/Redis installati sul tuo Mac. Iniziamo 
!
Installare le dipendenze di Discourse
Avrai bisogno dei seguenti pacchetti sul tuo sistema:
- Git
- rbenv o asdf
- ruby-build
- Ruby (ultima versione stabile)
- Rails
- PostgreSQL
- SQLite
- Redis
- Node.js
- pnpm
- MailHog**
- ImageMagick**
** opzionale
riavvia il terminale
Ora che abbiamo installato le dipendenze di Discourse, procediamo con l’installazione di Discourse stesso.
Riavviare il Terminale
Uscire dalla shell e riavviarla garantisce che i percorsi dei pacchetti installati vengano correttamente rilevati dal Terminale.
Clonare Discourse
Clona 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 tua cartella home.
Avviare Discourse
Passa alla cartella di Discourse:
cd ~/discourse
Installa i gem necessari:
bundle install
Installa le dipendenze JS:
pnpm install
Successivamente, esegui questi comandi per configurare la tua istanza locale di Discourse:
bundle exec rake db:create
bundle exec rake db:migrate
RAILS_ENV=test bundle exec rake db:create db:migrate
Avvia i server Rails + Ember; hai due opzioni a tua disposizione.
Opzione 1: utilizzando due schede/finestre separate del Terminale, esegui Rails e Ember CLI separatamente tramite:
bundle exec rails server
e
bin/ember-cli
Opzione 2: utilizzando una sola scheda/finestra del Terminale:
bin/ember-cli -u # avvierà il server Pitchfork in background
Dovresti ora essere in grado di navigare su http://localhost:4200 per vedere la tua installazione locale di Discourse. (Nota che il primo caricamento può richiedere fino a un minuto mentre il server si avvia.)
Puoi 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, esegui il seguente comando:
RAILS_ENV=development bundle exec rake admin:create
Segui le istruzioni per creare un account amministratore.
Configurare la posta
Esegui MailHog:
mailhog
Congratulazioni! Ora sei l’amministratore della tua installazione di Discourse!
Buon divertimento nello sviluppo! Per iniziare, consulta la Guida per principianti alla creazione di plugin per Discourse.
Questo documento è sotto controllo versione: suggerisci modifiche su GitHub.