À propos de la GitHub Marketplace
Cet article s’applique à l’installation et à l’achat de GitHub Apps à partir de GitHub Marketplace. Pour plus d’informations sur l’installation de GitHub Apps à partir d’une source autre que GitHub Marketplace, consultez « Installation d’une application GitHub à partir d’un tiers ».
Si vous installez une GitHub App sur votre compte personnel et que vous choisissez un plan payant, vous payez votre abonnement à la date de facturation actuelle de votre compte personnel à l’aide de votre mode de paiement existant.
Si vous choisissez un plan payant avec un essai gratuit, vous pouvez l’annuler à tout moment pendant votre période d’essai sans être facturé, mais vous perdrez automatiquement l’accès à l’application. Votre abonnement payant commence à la fin de l’essai gratuit de 14 jours. Pour plus d’informations, consultez « À propos de la facturation pour la Place de marché GitHub ».
Pour plus d’informations sur l’installation d’une OAuth app au lieu d’une GitHub App à partir de GitHub Marketplace, consultez « Installation d’une application OAuth dans votre compte personnel ».
À propos de l’installation de GitHub Apps
Pour pouvoir utiliser une GitHub App dans vos dépôts ou votre organisation, vous devez l’installer sur votre compte d’organisation ou personnel. Vous pouvez installer la même GitHub App sur plusieurs comptes. Par exemple, si vous installez l’application sur votre compte personnel et sur quelques organisations dont vous êtes propriétaire, vous pourrez utiliser l’application sur vos dépôts personnels, sur les organisations où vous avez installé l’application et sur les dépôts appartenant à ces organisations.
Lorsque vous installez une application, vous accordez à l’application l’autorisation d’accéder aux ressources de l’organisation et du dépôt qu’elle a demandées. Durant le processus d’installation, GitHub vous indique quelles autorisations l’GitHub App a demandées. Pour plus d’informations sur les demandes d’API REST que l’GitHub App peut faire avec ces autorisations, consultez « Autorisations requises pour les applications GitHub ».
Lorsque vous installez une application, vous choisissez également les dépôts auxquels accorder l’accès à l’GitHub App.
Avant d’installer une GitHub App, vous devez veiller à approuver le propriétaire de l’GitHub App. Vous devez également passer en revue les autorisations demandées par l’GitHub App et vous assurer qu’accorder ces autorisations vous convient. Pour plus d’informations sur les demandes d’API REST que l’GitHub App peut faire avec ces autorisations, consultez « Autorisations requises pour les applications GitHub ».
Vous pouvez installer autant d’applications que vous le voulez.
Différence entre l’installation et l’autorisation
Après avoir installé une GitHub App, vous pouvez également être invité à autoriser l’application.
Lorsque vous installez une GitHub App sur votre compte ou votre organisation, vous autorisez l’application à accéder aux ressources de l’organisation et du référentiel demandées. Vous spécifiez également les dépôts accessibles à l’application. Pendant le processus d’installation, GitHub App indique les autorisations de référentiel et d’organisation que vous accordez. Pour plus d’informations sur les différentes autorisations qui permettent à un GitHub App d’agir, consultez « Choix des autorisations pour une application GitHub ».
Par exemple, vous pouvez accorder à l’GitHub App l’autorisation de lire les métadonnées des dépôts et d’écrire des problèmes, et vous pouvez accorder à l’GitHub App l’accès à tous vos dépôts.
Lorsque vous autorisez une GitHub App, vous lui accordez l’accès d’application à votre compte GitHub, sur la base des autorisations de compte demandées par l’application. Pendant le processus d’autorisation, l’application indique les ressources auxquelles l’application peut accéder sur votre compte. Lorsque vous autorisez une GitHub App, vous accordez également à l’application l’autorisation d’agir en votre nom.
Par exemple, vous pouvez accorder à l’GitHub App l’autorisation de lire vos adresses e-mail et d’écrire des gists.
Vous pouvez installer une GitHub App sans lui donner d’autorisation. Inversement, vous pouvez autoriser l’application sans l’installer.
Pour plus d’informations sur l’autorisation des GitHub Apps, consultez « Autorisation des applications GitHub ».
Installation d’une GitHub App dans votre compte personnel
-
Pour ouvrir GitHub Marketplace, dans le coin supérieur gauche de GitHub.com, sélectionnez , puis cliquez sur Place de marché.
Remarque : cette étape fait référence à la nouvelle navigation globale, actuellement en version bêta publique et susceptible d’être modifiée. Pour plus d’informations sur la nouvelle navigation globale et sur le retour à l’ancienne navigation globale, consultez le GitHub journal des modifications.
-
Accédez à l’application que vous souhaitez installer, puis cliquez sur son nom.
-
Dans la page de l’application, sous « Prix et configuration », cliquez sur le plan tarifaire que vous souhaitez utiliser.
-
Cliquez sur L’installer gratuitement, Acheter avec GitHub , ou Essayer gratuitement pendant 14 jours.
-
Sous « Vérifier votre commande », dans le menu déroulant Compte, vérifiez que vous installez l’application pour votre compte personnel.
-
Si vous avez choisi un plan payant, dans la section « Mode de paiement », passez en revue votre mode de paiement.
- Pour changer le mode de paiement existant sur le fichier de votre compte personnel, cliquez sur Modifier et remplissez le formulaire pour ajouter un nouveau mode de paiement.
- S’il n’existe pas de mode de paiement sur le fichier de votre compte personnel, remplissez le formulaire pour ajouter une carte de crédit ou un compte PayPal.
-
Sélectionnez Terminer la commande et commencer l’installation.
-
Si l’application a besoin d’un accès aux dépôts, sélectionnez Tous les dépôts ou Uniquement les dépôts sélectionnés.
Si l’application crée des dépôts, l’application se voit automatiquement accorder l’accès à ces dépôts.
-
Si vous avez choisi d’accorder à l’application l’accès à un nombre limité de dépôts au lieu de tous vos dépôts, entrez le nom de chaque dépôt auquel vous souhaitez accorder l’accès à l’application, puis cliquez sur le nom du dépôt pour le sélectionner.
-
Vérifiez les autorisations d’accès de l’application, puis cliquez sur Installer.
