Installa Discourse su macOS per lo sviluppo

[Discourse]

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.

[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]

Seguendo la guida del forum di Ruby on Rails, sono attualmente bloccato al passaggio 7.

Probabilmente è una domanda molto da “principiante”, ma come faccio a “puntare” al ramo sperimentale a cui si faceva riferimento in quell’argomento? Ho provato alcune cose e ogni volta ricevevo il messaggio Unknown command mini_racer.

[blake (Blake Erickson)]

Va bene chiedere qui.

Ci sono alcune istruzioni specifiche per m1 che abbiamo scritto e a cui facciamo riferimento sul forum di Rails in questa guida.

@Decorbuz

Questa è probabilmente una domanda molto da “principiante”, ma come faccio a “puntare” al ramo sperimentale a cui si faceva riferimento in quell’argomento?

Dovrei controllare più tardi sul mio m1 Air, e forse i miei colleghi che hanno configurato di recente nuovi Mac potrebbero sapere meglio se è ancora necessario, ma c’è un esempio di come puntare a un ramo al punto 7:

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

Quindi dovresti modificare questa riga nella tua versione locale di discourse/Gemfile:

Gemfile

e poi eseguire bundle install.

[Decorbuz]

@pfaffman

Se non hai seguito queste istruzioni (non vedo un passo 7), allora questo non è un posto molto adatto per fare la tua domanda.

È collegato proprio in cima al post originale.

L’argomento del forum di Ruby on Rails è fermo da molti mesi. L’autore originale non è attivo da febbraio e non ha risposto a nessun commento lì che chiedeva aiuto.

Qui ci sono più persone che possono aiutarmi. Solo per dirlo.

@blake

nel passo 7 c’è un esempio su come puntare a un ramo:

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

Ho provato a copiarlo nel Terminale e ho ricevuto lo stesso errore Unknown command mini_racer, di prima.

Ammetto che la guida del forum di Ruby on Rails non è chiara come speravo in quel senso.

Scusate in anticipo…

[blake (Blake Erickson)]

@Decorbuz

Ho provato a copiarlo nel Terminale e ho ricevuto lo stesso errore di prima: Unknown command mini_racer.

Non è un comando da eseguire. Dovrai MODIFICARE il file di testo effettivo chiamato “Gemfile” situato all’interno della directory di Discourse.

[Decorbuz]

@blake

Dovrai modificare il file di testo vero e proprio chiamato “Gemfile” situato all’interno della directory di Discourse.

Doh!

Grazie! Provo subito.

A mio parere, qualcuno dovrebbe modificare la guida del forum di Ruby on Rails e fornire ulteriori chiarimenti riguardo al passaggio 7. Ma questa è solo la mia opinione.

Torno subito. Aspettate un attimo…

[blake (Blake Erickson)]

Scusa, devo scappare, ma penso che la correzione per mini_racer sui Mac M1 sia già stata unita. Ho appena controllato il mio Gemfile sul mio Mac M1 e non è stato modificato. Quindi penso che tu possa saltare il passaggio 7.

[Decorbuz]

Ho eseguito il passaggio 8 e ho ricevuto l’errore Could not locate Gemfile.

Penso di aver risolto il passaggio 7, ma il passaggio 8 continua a darmi problemi e restituisce l’errore menzionato sopra.

[blake (Blake Erickson)]

@Decorbuz

Ho eseguito il passaggio 8 e ho ricevuto l’errore “Could not locate Gemfile”.

Devi trovarti all’interno della directory di Discourse quando esegui bundle install.

@techAPJ

Clona 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 home.

Avvia Discourse

Passa alla tua cartella di Discourse:

cd ~/discourse

Installa i gem necessari

bundle install

[JQ331]

@merefield

In realtà costa un po’ più di qualche dollaro (è un VPS da 4GB con 8 core, probabilmente eccessivo), ma mi permette di sviluppare da qualsiasi luogo e su qualsiasi piattaforma. È piuttosto performante, ma ci saranno sempre alcuni secondi di ritardo se si riavvia il server web.

Ciao @merefield: puoi descrivere un po’ più nel dettaglio il tuo ambiente di sviluppo remoto?

Mentre lo sviluppo di un tema mi consente di apportare modifiche a un sito live, per lo sviluppo di un plugin non vedo alternative allo sviluppo sulla mia macchina locale, con l’intero codice di Discourse presente (con il mio plugin sovrapposto).

Il risultato è che per ogni modifica (non CSS) durante la codifica di un plugin, quando lo ricarico: 1) fa partire le ventole del mio computer e 2) impiega ben 30 secondi per il ricaricamento. E se devo riavviare il server, ci vogliono diversi minuti.

Questi ritardi si accumulano davvero, al punto che potrei impiegare un’ora per realizzare qualcosa che con il mio normale flusso di lavoro (dove c’è il hot reload o al massimo 2-3 secondi per modifica) richiederebbe 15 minuti.

Quindi, apprezzerei qualsiasi suggerimento per velocizzare le cose.

[merefield (Robert)]

Questo, a quanto pare, sarebbe più adatto al topic di Ubuntu, dato che sto eseguendo quell’installazione su un server cloud, con nginx e un DNS completo (senza Docker) davanti, quindi sto effettivamente indirizzando il dominio. Tutto viene eseguito dal terminale. Ora ho anche Ember CLI che funziona bene in questa configurazione.

Non è nemmeno così veloce, ma abbastanza rapido. Ha il vantaggio di poter eseguire e testare servizi di callback HTTPS completi.

L’ambiente di sviluppo per plugin più veloce di gran lunga che io conosca è il Docker Dev locale su WSL2, che vola. È anche estremamente semplice da mantenere. Purtroppo, per quanto ne sappia, discourse_theme non funziona ancora in quell’ambiente, quindi sono tornato al mio server cloud per quel lavoro.

È un po’ strano il motivo per cui Apple è in ritardo qui? Gli ingegneri Microsoft si sono dimostrati molto astuti.

[Nacho_Caballero]

Nel caso in cui qualcuno riscontri errori durante l’installazione di ruby 2.7.3, apparentemente qualcosa è cambiato dopo Xcode 12 che interrompe il processo di installazione con rbenv:

installing older Ruby versions on OSX after XCode 12

Ho continuato a ricevere questo messaggio, anche se ho le ultime versioni di psych e libyaml installate:

Sembra che alla tua installazione di ruby manchi psych (per l'output YAML).
Per eliminare questo avviso, installa libyaml e reinstalla il tuo ruby.

Ho provato la soluzione alternativa che suggeriscono nella guida, ma ho continuato a ricevere lo stesso errore e alla fine ho dovuto usare rvm:

rvm install 2.7.3

[JQ331]

Per quanto riguarda la programmazione più veloce quando si sviluppa un plugin, ho recentemente cambiato il mio approccio. E sta funzionando alla grande. In sostanza, sposta tutte le cose di front-end in un componente del tema e codifica solo le cose di back-end nel plugin stesso. So che altri l’hanno già capito. Ma ora che lo sto facendo, la programmazione è molto più veloce e piacevole. Dettagli qui.