Installare Discourse su macOS per lo sviluppo

[Discourse]

Questa guida copre le istruzioni di installazione per un ambiente di sviluppo macOS; per le guide di produzione, vedere: Install Discourse in production with the official supported instructions

Quindi vuoi configurare Discourse su macOS per sperimentare e sviluppare?

Daremo per scontato che tu non abbia Ruby/Rails/Postgres/Redis installato sul tuo Mac. Iniziamo !

Installa 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, passiamo all’installazione di Discourse stesso.

Riavvia il Terminale

Uscire dalla shell e riavviarla garantisce che i percorsi dei pacchetti installati vengano correttamente rilevati dal Terminale.

Clona Discourse

Clona il repository di Discourse nella cartella ~/discourse:

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

Il simbolo ~ indica la cartella home, quindi il codice sorgente di Discourse sarà disponibile nella tua cartella home.

Configura Discourse

Passa alla tua cartella Discourse:

cd ~/discourse

Installa le gemme necessarie

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 disposizione.

Opzione 1: utilizzando due schede/finestre separate del Terminale, esegui Rails e il bundler 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 frontend insieme

Ora dovresti essere in grado di navigare su http://localhost:3000 per visualizzare la tua installazione locale di Discourse. (Nota che il primo caricamento può richiedere fino a un minuto mentre il server viene avviato.)

Puoi anche provare a eseguire gli spec:

bundle exec rake autospec

Tutti (o quasi tutti) i test dovrebbero superare.

Crea 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.

Configura la posta

Esegui MailHog:

mailhog

---

Congratulazioni! Ora sei l’amministratore della tua installazione di Discourse!

Buon hacking! E per iniziare, consulta la Guida per principianti alla creazione di plugin Discourse.

---

Questo documento è sotto controllo versione - suggerisci 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.