Panoramica del deploy
Opzioni di hosting per la documentazione: sottodominio Jamdesk, dominio personalizzato con SSL o sottopercorso /docs sul sito esistente tramite reverse proxy.
Jamdesk pubblica automaticamente la documentazione su un sottodominio *.jamdesk.app. Quando sei pronto per andare online con il tuo dominio, puoi scegliere un sottodominio personalizzato (come docs.example.com) oppure ospitare la documentazione in un sottopercorso del sito principale: /docs per impostazione predefinita o qualsiasi segmento personalizzato.
Opzioni di deploy
| Opzione | Ideale per | Complessità di configurazione |
|---|---|---|
Sottodominio Jamdesk (your-project.jamdesk.app) | Lancio rapido, nessuna configurazione DNS | Bassa |
Sottodominio personalizzato (docs.example.com) | Documentazione di produzione con il tuo brand | Media |
Hosting in un sottopercorso (example.com/docs, personalizzabile) | Mantenere la documentazione sul dominio principale | Alta |
Hosting predefinito (nessuna configurazione)
Ogni progetto viene pubblicato su un sottodominio Jamdesk non appena colleghi un repository. È l'opzione più semplice per la documentazione interna, le anteprime o i primi lanci.
Dominio personalizzato (sottodominio)
Usa il tuo sottodominio (ad esempio docs.example.com) per un URL pubblico e personalizzato. Dovrai aggiungere i record DNS e verificare la proprietà nel dashboard Jamdesk.
La verifica DNS e SSL vengono gestiti automaticamente non appena i record sono configurati. Consulta Domini personalizzati per la configurazione.
Hosting in un sottopercorso
Ospita la documentazione in un sottopercorso del tuo dominio inoltrando il traffico a Jamdesk tramite proxy: example.com/docs per impostazione predefinita o un segmento personalizzato come example.com/help. Usa questa opzione quando vuoi che la documentazione risieda sotto il dominio principale dedicato al marketing.
L'hosting in un sottopercorso richiede un livello proxy o CDN per inoltrare le richieste e impostare l'header X-Jamdesk-Forwarded-Host. Consulta Hosting in un sottopercorso.
Esempio di configurazione proxy (nginx)
location /docs {
proxy_pass https://YOUR_SLUG.jamdesk.app;
proxy_set_header X-Jamdesk-Forwarded-Host $host;
}
location /_next/ {
proxy_pass https://YOUR_SLUG.jamdesk.app;
}
location /_jd/ {
proxy_pass https://YOUR_SLUG.jamdesk.app;
}
Per una configurazione completa con SSL, header e indicazioni specifiche per il provider, consulta la guida Hosting in un sottopercorso.
Guide per provider
Scegli la tua infrastruttura per implementare l'hosting in un sottopercorso: