Connecter GitHub et GitLab

Connecte GitHub ou GitLab pour utiliser les issues d'un projet comme tableau de tâches. Kanbell ne parle à GitHub que si tu le connectes et qu'un projet utilise un tableau GitHub. Il ne parle qu'aux serveurs GitLab que tu indiques, en https. Les jetons sont scellés avec le trousseau de ton système.

Connecter GitHub

1. Ouvre Réglages (⌘,, Linux : Ctrl+,) › GitHub, ou clique sur Connecter GitHub dans le tableau.
2. Colle un jeton. Kanbell accepte les jetons ghp_…, gho_… et github_pat_….
   • Jeton à granularité fine : donne-lui « Issues: read and write ».
   • Jeton classique : donne-lui le scope « repo » pour modifier.
3. Ou clique sur Importer depuis gh pour reprendre ta connexion GitHub CLI. Kanbell lance gh auth token.

Choisir le dépôt GitHub

1. Ouvre le panneau de la source : Réglages › Projets › Source du tableau, puis GitHub.
2. Kanbell te suggère des dépôts d'après les remotes Git de ton dossier.
3. Choisis-en un et clique sur Utiliser ce dépôt.

Le tableau GitHub ne marche qu'avec github.com. Déplacer des cartes et changer des labels demande la permission triage sur le dépôt. Modifier un titre ou un corps demande la permission write.

Connecter GitLab

1. Ouvre Réglages › GitLab et clique sur Connecter GitLab.
2. Colle un jeton d'accès personnel (glpat-…).
   • Scope api : lecture et écriture.
   • Scope read_api : lecture seule.
3. Kanbell refuse les jetons avec le scope sudo ou admin_mode.

Pour modifier sur GitLab, il faut un jeton avec le scope api et le rôle Planner ou supérieur.

Ajouter un serveur GitLab auto-hébergé

1. Dans Réglages › GitLab, clique sur Ajouter un serveur GitLab.
2. Indique l'adresse du serveur. Elle doit être en https, avec GitLab 15.5 ou plus récent.
3. Le certificat du serveur doit être reconnu par ton système. Kanbell ne permet pas de passer outre.

Tu peux ajouter jusqu'à 5 serveurs. Indique un dépôt sous la forme group/subgroup/repo, par son URL ou par son identifiant numérique.

Choisir comment marchent les colonnes

• GitHub : Ouvert / fermé (déplacer une carte ferme ou rouvre l'issue), ou Labels avec 1 à 5 labels.
• GitLab : par état, ou par 1 à 5 labels. Les labels à portée (scoped labels) sont pris en charge.

Ce qui se synchronise

• Kanbell lit les issues, les labels et les commentaires.
• Il peut créer des issues, les déplacer (état ou labels), commenter, et modifier le titre, la description et les labels, selon tes permissions.

Ce que Kanbell ne fait jamais

• Il ne supprime jamais d'issue.
• Il ne crée jamais de label.
• Sur GitLab, il neutralise les /quick-actions et @all dans le texte qu'il envoie.

Bon à savoir

• Le tableau GitHub n'a ni suppression, ni assignation, ni priorité, ni échéance, et montre les issues les plus récentes.
• Sous Linux, Kanbell refuse les jetons GitHub et GitLab s'il n'y a pas de vrai trousseau de clés.
• Les agents peuvent lire les tableaux GitHub et GitLab avec "$KANBELL_CLI" (list et show uniquement). Voir Tableau de tâches.

Voir aussi : Confidentialité, la fonctionnalité Tableau.