GitHub: problemi
Risolvi organizzazioni mancanti, repository assenti, webhook non riusciti, errori di autorizzazione e branch non corrispondenti nell'integrazione GitHub di Jamdesk.
La maggior parte dei problemi di integrazione con GitHub è dovuta a permessi, errori dei webhook o branch non corrispondenti.
Organizzazione non visibile durante la configurazione
Durante il flusso della documentazione iniziale, Jamdesk mostra le tue organizzazioni GitHub, così puoi scegliere dove creare il repository. L'elenco proviene dall'API OAuth di GitHub e GitHub nasconde le organizzazioni in due casi:
- Restrizioni dell'app OAuth: la tua organizzazione limita l'accesso alle app di terze parti (impostazione predefinita di GitHub per le nuove organizzazioni) e non ha ancora approvato Jamdesk.
- SAML SSO: la tua organizzazione richiede l'autenticazione SAML prima che l'API la restituisca.
Se sei il proprietario dell'organizzazione, puoi approvare subito Jamdesk:
- Fai clic su grant Jamdesk access on GitHub sotto il selettore dell'organizzazione (oppure vai su GitHub → Settings → Applications → Authorized OAuth Apps → Jamdesk)
- In Organization access, fai clic su Grant accanto alla tua organizzazione
- Torna al flusso di configurazione di Jamdesk e fai clic su refresh the list. La tua organizzazione apparirà immediatamente
Se sei un membro (non un proprietario), vedrai invece un pulsante Request; facendo clic su di esso invierai una richiesta di approvazione agli amministratori dell'organizzazione.
Se sei un membro senza diritti di proprietario, invia prima una richiesta di approvazione agli amministratori:
- Vai su GitHub → Settings → Applications → Authorized OAuth Apps → Jamdesk
- In Organization access, fai clic su Request accanto alla tua organizzazione. Questa azione notifica gli amministratori
- Un amministratore approva la richiesta in Settings → Third-party access → OAuth application policy dell'organizzazione (le richieste in sospeso mostrano un pulsante Approve)
- Torna al flusso di configurazione di Jamdesk e fai clic su refresh the list; ora la tua organizzazione dovrebbe essere visibile
Consulta la guida di GitHub su come approvare le app OAuth per la tua organizzazione per i passaggi dettagliati.
Non vuoi aspettare l'approvazione dell'amministratore? Durante la configurazione, scegli il tuo account personale e trasferisci successivamente il repository alla tua organizzazione:
- Completa la configurazione di Jamdesk usando il tuo account personale
- Vai al repository creato su GitHub
- Vai su Settings → General → Danger Zone
- Fai clic su Transfer e seleziona la tua organizzazione come destinazione
- In Jamdesk, disconnetti e riconnetti il repository dalla pagina Settings del tuo progetto
La disconnessione e la riconnessione generano un nuovo URL della documentazione (ad esempio, your-project.jamdesk.app potrebbe cambiare). Se hai già condiviso l'URL o configurato un dominio personalizzato, contatta il supporto prima di disconnettere il repository, così potremo mantenere la configurazione.
Repository non visibile
Se il tuo repository non viene visualizzato nell'elenco:
- Vai su GitHub → Settings → Applications → Jamdesk
- Verifica che il repository disponga dell'accesso concesso
- Fai clic su Configure per aggiungere altri repository
Per i repository dell'organizzazione:
- Un amministratore dell'organizzazione deve approvare Jamdesk
- Vai alle impostazioni dell'organizzazione → Third-party access
- Approva la richiesta di accesso di Jamdesk
I repository privati richiedono l'autorizzazione di GitHub. Se necessario, autorizza nuovamente Jamdesk.
I build non vengono avviati
Se i push non avviano i build:
- Vai al tuo repository su GitHub
- Vai su Settings → Webhooks
- Individua il webhook di Jamdesk
- Controlla la sezione "Recent Deliveries" per verificare la presenza di errori
I build vengono avviati solo sul branch configurato. Controlla Settings in Jamdesk.
- Vai su Settings del progetto in Jamdesk
- Fai clic su Re-sync GitHub
Errori dei webhook
404 Not Found
Non è stato possibile raggiungere l'endpoint del webhook.
Correzione: sincronizza nuovamente la connessione GitHub nelle impostazioni del progetto.
401 Unauthorized
L'autenticazione non è riuscita.
Correzione:
- Vai alle impostazioni del tuo account GitHub
- Vai su Applications → Authorized OAuth Apps
- Revoca Jamdesk
- Autorizza nuovamente Jamdesk nelle impostazioni
500 Server Error
Si è verificato un problema temporaneo di Jamdesk.
Correzione: attendi qualche minuto e riprova a eseguire il push oppure avvia una nuova build manualmente.
Errori di autorizzazione
"Repository not found" durante il build:
- Il repository potrebbe essere stato eliminato o rinominato
- Jamdesk potrebbe aver perso l'accesso
- Autorizza nuovamente la connessione GitHub
Problemi del branch
Viene eseguito il build del branch errato
Controlla il branch configurato in Settings → Repository.
Branch rinominato o eliminato
Aggiorna l'impostazione del branch in modo che corrisponda al nuovo nome.