Problèmes GitHub

Si vous êtes propriétaire de l'organisation, vous pouvez approuver Jamdesk immédiatement :

1. Cliquez sur grant Jamdesk access on GitHub sous le sélecteur d'organisation (ou allez dans GitHub → Settings → Applications → Authorized OAuth Apps → Jamdesk)
2. Sous Organization access, cliquez sur Grant à côté de votre organisation
3. De retour dans le flux de configuration de Jamdesk, cliquez sur refresh the list. Votre organisation apparaît immédiatement

Si vous êtes membre (et non propriétaire), vous verrez plutôt un bouton Request ; cliquer dessus envoie une demande d'approbation à vos administrateurs d'organisation.

Si vous êtes membre sans droits de propriétaire, envoyez d'abord une demande d'approbation à vos administrateurs :

1. Allez dans GitHub → Settings → Applications → Authorized OAuth Apps → Jamdesk
2. Sous Organization access, cliquez sur Request à côté de votre organisation. Cela notifie vos administrateurs d'organisation
3. Un administrateur l'approuve dans Settings → Third-party access → OAuth application policy de l'organisation (les demandes en attente affichent un bouton Approve)
4. Retournez au flux de configuration de Jamdesk et cliquez sur refresh the list ; votre organisation devrait maintenant apparaître

Consultez le guide de GitHub sur l'approbation des applications OAuth pour votre organisation pour connaître les étapes détaillées.

Vous ne voulez pas attendre l'approbation d'un administrateur ? Choisissez votre compte personnel lors de la configuration, puis transférez le dépôt vers votre organisation par la suite :

1. Terminez la configuration de Jamdesk avec votre compte personnel
2. Accédez au dépôt créé sur GitHub
3. Accédez à Settings → General → Danger Zone
4. Cliquez sur Transfer et sélectionnez votre organisation comme destination
5. Dans Jamdesk, déconnectez puis reconnectez le dépôt depuis la page Settings de votre projet

Cela ne fonctionne pas si votre entreprise gère votre compte GitHub. Consultez plutôt comptes GitHub gérés par l'entreprise.

1. Demandez à un propriétaire d'entreprise de créer une organisation depuis l'onglet Organizations de votre entreprise. Demandez-lui de vous autoriser à y créer des dépôts.
2. Transférez votre dépôt de documentation dedans. Dans le dépôt, allez dans Settings, cliquez sur Transfer en bas de page, puis choisissez la nouvelle organisation.
3. Dans Jamdesk, cliquez sur Connect an existing repository (ou Install GitHub App dans les paramètres du projet). Sur GitHub, choisissez l'organisation, sélectionnez Only select repositories, choisissez votre dépôt, puis installez.

Si GitHub affiche Request au lieu de Install, un propriétaire de l'organisation reçoit un e-mail pour l'approuver. Cliquez à nouveau sur le bouton Jamdesk une fois que c'est fait.

Utilisez cette méthode si votre entreprise ne peut pas ajouter d'organisation. Vérifiez d'abord avec votre administrateur GitHub, car la documentation résidera en dehors du GitHub de votre entreprise.

1. Dans une fenêtre de navigation privée, connectez-vous à GitHub avec un compte personnel (ou créez-en un).
2. Créez un dépôt privé vide sur ce compte.
3. Poussez-y une copie de votre documentation. GitHub ne peut pas transférer de dépôts hors d'une entreprise gérée, une copie est donc nécessaire.

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

Conservez jsmith@ dans l'URL pour que Git vous demande les identifiants de votre compte personnel.

4. Dans Jamdesk, cliquez sur Connect an existing repository (ou Install GitHub App dans les paramètres du projet), installez Jamdesk sur votre compte personnel, puis choisissez le dépôt.

Les comptes gérés ne peuvent pas pousser vers des dépôts en dehors de votre entreprise ; toute personne qui modifie la documentation a donc besoin d'un compte GitHub personnel. Ajoutez-les au dépôt en tant que collaborateurs.

1. Allez dans GitHub → Settings → Applications → Jamdesk
2. Vérifiez que l'accès au dépôt a bien été accordé
3. Cliquez sur Configure pour ajouter d'autres dépôts

Pour les dépôts d'organisation :

1. Un administrateur de l'organisation doit approuver Jamdesk
2. Allez dans les paramètres de l'organisation → Third-party access
3. Approuvez la demande d'accès de Jamdesk

Les dépôts privés nécessitent une autorisation GitHub. Réautorisez Jamdesk si nécessaire.