Questa guida spiega come installare un tema o un componente tema di Discourse da un repository GitHub privato.
Livello utente richiesto: Amministratore
Sommario
Questa documentazione copre il processo di installazione di un tema o componente tema di Discourse da un repository GitHub privato. Include i passaggi per generare e utilizzare le chiavi SSH per un accesso sicuro. Sarà necessario disporre dei privilegi di amministratore sia per la propria istanza di Discourse sia per il repository GitHub da cui si sta installando. Ecco come è possibile utilizzare i propri temi e componenti tema privati sul proprio forum.
Prerequisiti
Prima di iniziare, assicurarsi di avere:
- Accesso amministrativo alla propria istanza di Discourse
- Un repository Git privato contenente il tema o il componente
- Accesso per aggiungere chiavi di deployment al proprio repository Git (livello amministratore/proprietario)
Guida passo passo
- Vai al tuo repository GitHub privato e copia l’indirizzo SSH dalla scheda Clone SSH.
2. Naviga nel pannello di amministrazione di Discourse.
3. Nella barra laterale di amministrazione, vai su
Aspetto > Temi e componenti, quindi seleziona la scheda Temi o Componenti (a seconda di ciò che stai installando). 4. Fai clic su
Installa e poi seleziona Da un repository git.
5. Incolla l’indirizzo SSH che hai copiato dal repository privato al passaggio 1. Dovrebbe essere nel formato:
git@github.com:NOMEUTENTE/NOME-REPO.git.
Assicurati di utilizzare il link clona con SSH, non quello che inizia con
https
6. Una chiave SSH viene generata automaticamente e visualizzata in una nuova casella di testo.
7. Fai clic sull’icona di copia nell’angolo in alto a destra di quella casella per copiare la nuova chiave SSH. Non fare clic su installa o chiudere questa finestra modale per ora.
8. Ora vai alle impostazioni del tuo repository GitHub privato (ad esempio, su GitHub, vai su
Impostazioni > Chiavi di deployment)
9. Aggiungi una nuova chiave di deployment. Dovrai darle un titolo appropriato. Incolla la chiave SSH che hai copiato da Discourse nel campo chiave di deployment.
10. Fai clic su
Aggiungi chiave per salvare la chiave di deployment nelle impostazioni del tuo repository Git.
11. Torna alla finestra modale di installazione del tema di Discourse e fai clic sul pulsante
Installa. Ora dovresti vedere la pagina delle impostazioni del tuo nuovo tema o componente.
Best practice
- Utilizza sempre l’URL SSH per il tuo repository, non l’URL HTTPS.
- Mantieni sicure le tue chiavi di deployment e non condividerle pubblicamente.
- Aggiorna regolarmente il tuo tema o i tuoi componenti per assicurarti di avere le ultime funzionalità e gli aggiornamenti di sicurezza.
FAQ
D: Posso usare questo metodo con provider Git diversi da GitHub?
R: Sì, questo metodo dovrebbe funzionare con qualsiasi provider Git che supporti le chiavi di deployment o l’autenticazione SSH.
D: Discourse ricorderà la chiave SSH per gli aggiornamenti futuri?
R: Sì, Discourse memorizzerà la chiave privata generata e la utilizzerà per gli accessi futuri al repository Git.
D: Posso cambiare il repository privato in seguito?
R: Sì, puoi aggiornare l’URL del repository nelle impostazioni del tema, se necessario.
Risorse aggiuntive
Le chiavi SSH utilizzate in questo argomento sono state generate solo per questa documentazione