Questo articolo è una traduzione del testo originale in inglese: Change the domain name or rename your Discourse
Se hai seguito le istruzioni della pagina Guida all’installazione su GitHub per installare un’istanza di Discourse e desideri modificare il nome di dominio di tale istanza, consulta questa guida. Se utilizzi il servizio di hosting ufficiale di Discourse, fai riferimento ai dettagli contenuti nella pagina Configura il tuo nome di dominio per Discourse ospitato.
Supponiamo che tu desideri modificare il nome di dominio della tua istanza Discourse da talk.foo.com a talk.bar.com.
Iniziamo il processo.
Imposta il TTL su basso nelle impostazioni DNS avanzate
Per assicurarti che tutti sappiano che il tuo nome di dominio è stato modificato, imposta il valore TTL (Time To Live) nel DNS del tuo dominio su un valore basso, ad esempio 60 minuti.
Lo scopo principale di questa impostazione è permettere alle modifiche DNS di avere effetto più rapidamente. Le modifiche DNS su Internet richiedono tempo a causa della presenza di cache.
Rimuovi tutte le configurazioni relative al vecchio dominio dal sito
Accedi a /admin/site_settings e cerca tutte le impostazioni relative al vecchio dominio.
Se la ricerca individua configurazioni relative al vecchio dominio, assicurati di modificarle come indicato sopra.
Modifica la configurazione di Discourse nel file app.yml
Opzionale: puoi eseguire nuovamente il comando
./discourse-setupe, seguendo le istruzioni fornite, aggiornare il nuovo nome di dominio nel file di configurazioneapp.yml.
Nel file app.yml, modifica il contenuto della voce hostname.
## Il nome host nell'istanza Discourse verrà modificato come segue
DISCOURSE_HOSTNAME: 'talk.bar.com'
(Inoltre, se stai utilizzando una CDN, puoi commentare le relative impostazioni nel file app.yml. Una volta completate le modifiche, rimuovi il commento.)
Dopo aver completato le configurazioni sopra, è necessario ricostruire Discourse:
./launcher rebuild app
Una volta completata la ricostruzione, il tuo sito sarà accessibile solo tramite il nuovo nome di dominio.
Modifica le tue configurazioni DNS
- Elimina i record DNS relativi al vecchio dominio.
- Modifica i record DNS del nuovo dominio, puntandoli all’indirizzo del tuo servizio Discourse.
Dopo aver completato queste configurazioni, dovresti poter accedere al tuo sito Discourse senza problemi tramite il nuovo nome di dominio.
Puoi anche modificare le informazioni DNS mentre ricostruisci il sito.
Verifica che tutte le funzionalità siano accessibili correttamente. Durante la verifica, vogliamo assicurarci di poter accedere normalmente al sistema Discourse. Questo è l’argomento trattato nella sezione successiva…
Modifica l’accesso tramite terze parti
A seconda del metodo di accesso che utilizzi, devi apportare queste modifiche immediatamente; altrimenti, dopo la modifica del dominio, non potrai più accedere tramite servizi di terze parti.
Anche le configurazioni di accesso tramite i tuoi account social Twitter, Facebook, Google, Yahoo e GitHub devono essere aggiornate in modo che gli indirizzi di callback corrispondano al nuovo indirizzo.
Fai riferimento alla documentazione ufficiale per configurare e modificare tali impostazioni.
Sostituisci tutti i riferimenti al vecchio sito nei temi con il nuovo nome di dominio
Attualmente, tutti i collegamenti nei temi e nei post che fanno riferimento al sito puntano ancora al vecchio dominio. Dobbiamo ora modificarli in modo che puntino al nuovo dominio. Procediamo:
./launcher enter app
Quindi inserisci ed esegui il seguente comando:
discourse remap =BEFORE= =AFTER=
Dopo aver seguito le istruzioni a schermo, esegui il comando successivo:
rake posts:rebake
I remap nei temi ora utilizzeranno il nuovo indirizzo di dominio al posto di quello vecchio, e rigenereremo tutti i post per evitare omissioni.
A questo punto, tutte le configurazioni per la modifica del nome di dominio sono state completate!
(Se all’inizio hai commentato le impostazioni della CDN, non dimenticare di ripristinarle.)
Vuoi sapere come sono stati creati i campi di input nei temi?
Per ulteriori informazioni, consulta l’articolo originale Come modificare il nome di dominio di Discourse - Discourse - OSSEZ.
Grazie per il supporto ufficiale.