Problemi GitHub

Se sei il proprietario dell'organizzazione, puoi approvare subito Jamdesk:

1. Fai clic su grant Jamdesk access on GitHub sotto il selettore dell'organizzazione (oppure vai su GitHub → Settings → Applications → Authorized OAuth Apps → Jamdesk)
2. In Organization access, fai clic su Grant accanto alla tua organizzazione
3. Torna al flusso di configurazione di Jamdesk e fai clic su refresh the list. La tua organizzazione appare immediatamente

Se sei un membro (non un proprietario), vedrai invece un pulsante Request; facendo clic invierai una richiesta di approvazione agli amministratori della tua organizzazione.

Se sei un membro senza diritti di proprietario, invia prima una richiesta di approvazione agli amministratori:

1. Vai su GitHub → Settings → Applications → Authorized OAuth Apps → Jamdesk
2. In Organization access, fai clic su Request accanto alla tua organizzazione. Questa azione avvisa gli amministratori
3. Un amministratore approva la richiesta in Settings → Third-party access → OAuth application policy dell'organizzazione (le richieste in sospeso mostrano un pulsante Approve)
4. Torna al flusso di configurazione di Jamdesk e fai clic su refresh the list; ora la tua organizzazione dovrebbe essere visualizzata

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 in seguito il repository alla tua organizzazione:

1. Completa la configurazione di Jamdesk usando il tuo account personale
2. Vai al repository creato su GitHub
3. Vai su Settings → General → Danger Zone
4. Fai clic su Transfer e seleziona la tua organizzazione come destinazione
5. In Jamdesk, disconnetti e riconnetti il repository dalla pagina Settings del progetto

Questa procedura non funziona se la tua azienda gestisce il tuo account GitHub. Consulta invece Account GitHub gestiti dall'azienda.

1. Chiedi al proprietario dell'azienda di creare un'organizzazione dalla scheda Organizations della tua azienda. Chiedigli di consentirti di creare repository al suo interno.
2. Trasferisci il repository della documentazione al suo interno. Nel repository, vai su Settings, fai clic su Transfer in fondo alla pagina e scegli la nuova organizzazione.
3. In Jamdesk, fai clic su Connect an existing repository (oppure su Install GitHub App nelle impostazioni del progetto). Su GitHub, scegli l'organizzazione, seleziona Only select repositories, seleziona il repository e installa l'app.

Se GitHub mostra Request invece di Install, un proprietario dell'organizzazione riceverà un'e-mail per approvare la richiesta. Dopo l'approvazione, fai nuovamente clic sul pulsante di Jamdesk.

Usa questa opzione se la tua azienda non può aggiungere un'organizzazione. Prima chiedi conferma all'amministratore GitHub, poiché la documentazione sarà esterna all'account GitHub aziendale.

1. In una finestra privata del browser, accedi a GitHub con un account personale (oppure creane uno).
2. Crea un repository privato vuoto su quell'account.
3. Invia una copia della documentazione al repository. GitHub non può trasferire repository da un'azienda gestita, quindi è necessaria una copia.

git remote set-url origin https://jsmith@github.com/jsmith/product-docs.git
git push -u origin main

Mantieni jsmith@ nell'URL in modo che Git richieda le credenziali del tuo account personale.

4. In Jamdesk, fai clic su Connect an existing repository (oppure su Install GitHub App nelle impostazioni del progetto), installa Jamdesk sul tuo account personale e scegli il repository.

Gli account gestiti non possono eseguire il push verso repository esterni alla tua azienda, quindi chiunque modifichi la documentazione deve avere un account GitHub personale. Aggiungili al repository come collaboratori.

1. Vai su GitHub → Settings → Applications → Jamdesk
2. Verifica che l'accesso al repository sia stato concesso
3. Fai clic su Configure per aggiungere altri repository

Per i repository dell'organizzazione:

1. Un amministratore dell'organizzazione deve approvare Jamdesk
2. Vai alle impostazioni dell'organizzazione → Third-party access
3. Approva la richiesta di accesso di Jamdesk

I repository privati richiedono l'autorizzazione di GitHub. Se necessario, autorizza nuovamente Jamdesk.