{"meta":{"title":"Démarrage rapide pour la création d’applications GitHub","intro":"Créez rapidement une GitHub App qui commente les demandes de tirage.","product":"Applications","breadcrumbs":[{"href":"/fr/apps","title":"Applications"},{"href":"/fr/apps/creating-github-apps","title":"Création d’applications GitHub"},{"href":"/fr/apps/creating-github-apps/writing-code-for-a-github-app","title":"Écriture de code pour une application GitHub"},{"href":"/fr/apps/creating-github-apps/writing-code-for-a-github-app/quickstart","title":"Démarrage rapide"}],"documentType":"article"},"body":"# Démarrage rapide pour la création d’applications GitHub\n\nCréez rapidement une GitHub App qui commente les demandes de tirage.\n\n## Introduction\n\nGitHub Apps vous permettent d’automatiser des processus ou d’intégrer d’autres plateformes à GitHub. Pour plus d’informations, consultez « [À propos de la création d’applications GitHub](/fr/apps/creating-github-apps/creating-github-apps/about-apps) ».\n\nCe guide de démarrage rapide explique comment créer rapidement une GitHub App. Lorsqu’une demande de tirage est ouverte dans un référentiel auquel l’application a obtenu l’accès, l’application ajoute un commentaire à la demande de tirage.\n\nCe guide de démarrage rapide utilise du code préécrit pour vous aider à démarrer rapidement. Pour obtenir un tutoriel plus détaillé qui vous aide à écrire le code, consultez « [Création d’une application GitHub qui répond aux événements de webhook](/fr/apps/creating-github-apps/guides/building-a-github-app-that-responds-to-webhook-events) ».\n\n## Prérequis\n\nVotre ordinateur ou codespace doit utiliser Node.js, version 12 ou ultérieure. Pour plus d’informations, consultez [Node.js](https://nodejs.org).\n\n## Étape 1 : Cloner le code de l’application\n\nPour vous aider à démarrer rapidement, nous avons écrit du code que vous pouvez utiliser. Si vous souhaitez apprendre à écrire le code vous-même, consultez « [Création d’une application GitHub qui répond aux événements de webhook](/fr/apps/creating-github-apps/guides/building-a-github-app-that-responds-to-webhook-events) ».\n\n1. Clonez le référentiel [github/github-app-js-sample](https://github.com/github/github-app-js-sample). Pour plus d’informations, consultez « [Clonage d’un dépôt](/fr/repositories/creating-and-managing-repositories/cloning-a-repository) ». Vous pouvez utiliser un clone local ou GitHub Codespaces.\n2. Dans une fenêtre de terminal, accédez au répertoire dans lequel votre clone est stocké.\n3. Exécutez `npm install` pour installer les dépendances.\n\n## Étape 2 : Obtenir une URL de proxy webhook\n\nPour développer votre application localement, vous pouvez utiliser une URL de proxy webhook pour transférer des webhooks à partir de GitHub vers votre ordinateur ou codespace. Ce démarrage rapide utilise Smee.io pour fournir une URL de proxy webhook et transférer des webhooks.\n\n1. Dans votre navigateur, accédez à <https://smee.io/>.\n2. Cliquez sur **Démarrer un nouveau canal**.\n3. Copiez l’URL complète sous « URL du proxy webhook ». Vous utiliserez cette adresse ultérieurement.\n\n## Étape 3 : Inscrire une GitHub App\n\nLes étapes suivantes vous guident tout au long de la configuration des paramètres d’application requis pour ce démarrage rapide. Pour plus d’informations sur les paramètres, consultez « [Inscription d’une application GitHub](/fr/apps/creating-github-apps/creating-github-apps/creating-a-github-app) ».\n\n1. Dans le coin supérieur droit de n’importe quelle page sur GitHub, cliquez sur votre photo de profil.\n2. Accédez aux paramètres de votre compte.\n   * Pour une application appartenant à un compte personnel, cliquez sur **Paramètres**.\n   * Pour une application appartenant à une organisation :\n     1. Cliquez sur **Vos organisations**.\n     2. À droite de l’organisation, cliquez sur **Paramètres**.\n3. Dans la barre latérale gauche, cliquez sur **<svg version=\"1.1\" width=\"16\" height=\"16\" viewBox=\"0 0 16 16\" class=\"octicon octicon-code\" aria-label=\"code\" role=\"img\"><path d=\"m11.28 3.22 4.25 4.25a.75.75 0 0 1 0 1.06l-4.25 4.25a.749.749 0 0 1-1.275-.326.749.749 0 0 1 .215-.734L13.94 8l-3.72-3.72a.749.749 0 0 1 .326-1.275.749.749 0 0 1 .734.215Zm-6.56 0a.751.751 0 0 1 1.042.018.751.751 0 0 1 .018 1.042L2.06 8l3.72 3.72a.749.749 0 0 1-.326 1.275.749.749 0 0 1-.734-.215L.47 8.53a.75.75 0 0 1 0-1.06Z\"></path></svg> Paramètres de développeur**.\n4. Dans la barre latérale à gauche, cliquez sur **GitHub Apps** .\n5. Cliquez sur **Nouvelle GitHub App**.\n6. Sous « Nom de GitHub App », saisissez un nom pour votre application. Par exemple, `USERNAME-quickstart-app` où `USERNAME` est votre nom d'utilisateur GitHub.\n7. Sous « URL de la page d’accueil », entrez `https://github.com/github/github-app-js-sample#readme`.\n8. Ignorez les sections « Identification et autorisation des utilisateurs » et « Après installation » pour ce démarrage rapide. Pour plus d’informations sur ces paramètres, consultez [Inscription d’une application GitHub](/fr/apps/creating-github-apps/creating-github-apps/creating-a-github-app).\n9. Assurez-vous que **Actif** est sélectionné sous « Webhooks ».\n10. Sous « URL de webhook », entrez l'URL de votre proxy webhook que vous avez obtenue précédemment. Pour plus d’informations, consultez « [Étape 2 : Obtenir une URL de proxy webhook](#step-2-get-a-webhook-proxy-url) ».\n11. Sous « Webhook secret », entrez une chaîne aléatoire. Vous utiliserez cette chaîne de caractères plus tard.\n12. Sous « Autorisations du référentiel », en regard de « Demandes de tirage », sélectionnez **Lecture & écriture**.\n13. Sous « S’abonner aux événements », sélectionnez **Demande de tirage**.\n14. Sous « Où cette GitHub App peut-elle être installée ? », sélectionnez **Uniquement sur ce compte**.\n15. Cliquez sur **Créer GitHub App**.\n\n## Étape 4 : Stocker les informations d’identification et les informations de connexion\n\nDans ce démarrage rapide, vous allez stocker les informations d’identification de votre application et identifier les informations en tant que variables d’environnement dans un fichier `.env`. Quand vous déployez votre application, vous voudrez modifier la façon dont vous stockez les informations d'identification. Pour plus d’informations, consultez [Déployer votre application](#deploy-your-app).\n\nAssurez-vous que vous êtes sur un ordinateur sécurisé avant d’effectuer ces étapes, car vous allez stocker vos informations d’identification localement.\n\n### Créez un fichier `.env`\n\nVotre dépôt cloné inclut `.env` dans le fichier `.gitignore`. Cette action vous empêche de valider accidentellement les informations d'identification de votre application. Pour plus d’informations sur les fichiers `.gitignore`, consultez [Ignorer des fichiers](/fr/get-started/git-basics/ignoring-files).\n\n1. Accédez au répertoire dans lequel votre clone de [github/github-app-js-sample](https://github.com/github/github-app-js-sample) est stocké.\n2. Créez un fichier appelé `.env` au niveau supérieur de ce répertoire.\n3. Ajoutez le contenu suivant à votre fichier `.env`.  Vous mettrez à jour les valeurs ultérieurement.\n\n   ```text copy\n   APP_ID=\"YOUR_APP_ID\"\n   WEBHOOK_SECRET=\"YOUR_WEBHOOK_SECRET\"\n   PRIVATE_KEY_PATH=\"YOUR_PRIVATE_KEY_PATH\"\n   ```\n\n### Accédez aux paramètres de votre application\n\nSi vous vous êtes éloigné des paramètres de votre application après la création de votre application, accédez à la page des paramètres de votre application :\n\n1. Dans le coin supérieur droit de n’importe quelle page sur GitHub, cliquez sur votre photo de profil.\n2. Accédez aux paramètres de votre compte.\n   * Pour une application appartenant à un compte personnel, cliquez sur **Paramètres**.\n   * Pour une application appartenant à une organisation :\n     1. Cliquez sur **Vos organisations**.\n     2. À droite de l’organisation, cliquez sur **Paramètres**.\n3. Dans la barre latérale gauche, cliquez sur **<svg version=\"1.1\" width=\"16\" height=\"16\" viewBox=\"0 0 16 16\" class=\"octicon octicon-code\" aria-label=\"code\" role=\"img\"><path d=\"m11.28 3.22 4.25 4.25a.75.75 0 0 1 0 1.06l-4.25 4.25a.749.749 0 0 1-1.275-.326.749.749 0 0 1 .215-.734L13.94 8l-3.72-3.72a.749.749 0 0 1 .326-1.275.749.749 0 0 1 .734.215Zm-6.56 0a.751.751 0 0 1 1.042.018.751.751 0 0 1 .018 1.042L2.06 8l3.72 3.72a.749.749 0 0 1-.326 1.275.749.749 0 0 1-.734-.215L.47 8.53a.75.75 0 0 1 0-1.06Z\"></path></svg> Paramètres de développeur**.\n4. Dans la barre latérale à gauche, cliquez sur **GitHub Apps** .\n5. En regard du nom de votre application, cliquez sur **Modifier**.\n\n### Obtenez les identifiants et les informations d'identification de votre application\n\n1. Dans la page des paramètres de votre application, en regard de « ID d’application », recherchez l’ID d’application de votre application.\n2. Dans votre fichier, `.env` remplacez `YOUR_APP_ID` par l’ID d’application de votre application.\n3. Dans la page des paramètres de votre application, sous « Clés privées », cliquez sur **Générer une clé privée**. Une clé privée au format PEM est téléchargée sur votre ordinateur. Pour plus d’informations, consultez « [Gestion des clés privées pour les applications GitHub](/fr/apps/creating-github-apps/authenticating-with-a-github-app/managing-private-keys-for-github-apps) ».\n4. Si vous utilisez un codespace, déplacez le fichier PEM téléchargé dans votre codespace afin que votre codespace puisse accéder au fichier.\n5. Dans votre fichier `.env`, remplacez `YOUR_PRIVATE_KEY_PATH` le chemin complet de votre clé privée, y compris l’extension `.pem`.\n6. Dans votre fichier `.env`, remplacez `YOUR_WEBHOOK_SECRET` par le secret webhook de votre application. Si vous avez oublié votre secret webhook, sous « Secret webhook (facultatif) », cliquez sur **Modifier le secret**. Entrez un nouveau secret, puis cliquez sur **Enregistrer les modifications**.\n\n## Étape 5 : Installer votre application\n\nPour que votre application puisse laisser un commentaire sur les pull requests dans un référentiel, elle doit être installée sur le compte du propriétaire du référentiel et recevoir l’accès à celui-ci. Étant donné que votre application est privée, elle ne peut être installée que sur le compte propriétaire de l’application.\n\n1. Dans le compte propriétaire de l’application que vous avez créée, créez un nouveau référentiel sur lequel installer l’application. Pour plus d’informations, consultez « [Création d’un dépôt](/fr/repositories/creating-and-managing-repositories/creating-a-new-repository) ».\n2. Si vous vous êtes éloigné des paramètres de votre application après la création de votre application, accédez à la page des paramètres de votre application. Pour plus d’informations, consultez « [Accéder aux paramètres de votre application](#navigate-to-your-app-settings) ».\n3. Cliquez sur **Page publique**.\n4. Cliquez sur **Installer**.\n5. Sélectionnez **Sélectionner uniquement les référentiels**.\n6. Sélectionnez le menu déroulant **Sélectionner les référentiels** , puis cliquez sur le référentiel que vous avez choisi au début de cette section.\n7. Cliquez sur **Installer**.\n\n## Étape 6 : Démarrer votre serveur\n\nÀ des fins de test, vous utiliserez votre ordinateur ou codespace comme serveur. Votre application est uniquement active lorsque votre serveur est en cours d’exécution.\n\n1. Dans une fenêtre du terminal, accédez au répertoire dans lequel votre clone de [github/github-app-js-sample](https://github.com/github/github-app-js-sample) est stocké.\n\n2. Pour recevoir des webhooks transférés à partir de Smee.io, exécutez `npx smee -u WEBHOOK_PROXY_URL -t http://localhost:3000/api/webhook`. Remplacez `WEBHOOK_PROXY_URL` par l’URL de proxy de votre webhook. Si vous avez oublié votre URL, vous pouvez la trouver dans le champ « URL du webhook » de la page des paramètres de votre application.\n\n   Une sortie de ce type doit s’afficher, où `WEBHOOK_PROXY_URL` est l’URL de votre proxy webhook :\n\n   ```shell\n   Forwarding WEBHOOK_PROXY_URL to http://localhost:3000/api/webhook\n   Connected WEBHOOK_PROXY_URL\n   ```\n\n3. Dans une deuxième fenêtre du terminal, accédez au répertoire dans lequel votre clone de [github/github-app-js-sample](https://github.com/github/github-app-js-sample) est stocké.\n\n4. Exécutez `npm run server`. Votre terminal doit indiquer `Server is listening for events at: http://localhost:3000/api/webhook`.\n\n## Étape 7 : Test de l’application\n\nUne fois que votre serveur fonctionne et reçoit des événements de webhooks transmis, testez votre application en ouvrant une pull request.\n\n1. Ouvrez une pull request sur le dépôt que vous avez créé à l’[Étape 5 : installer votre application](#step-5-install-your-app). Pour plus d’informations, consultez « [Création d’une pull request](/fr/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request) ».\n2. Accédez à l’URL du proxy de votre webhook sur smee.io. Un événement `pull_request` devrait apparaître. Cela indique que GitHub a correctement envoyé un événement de pull request lorsque vous avez créé une pull request.\n3. Dans le terminal où vous avez exécuté `npm run server`, vous devez voir quelque chose comme « Reçu un événement de demande de tirage pour #1 » où l’entier après le `#` est le numéro de la demande de tirage que vous avez ouverte.\n4. Dans la chronologie de votre pull request, vous devriez voir un commentaire de votre application. Le commentaire utilise le contenu du fichier `message.md` dans votre dépôt cloné.\n5. Dans les deux fenêtres de terminal, saisissez <kbd>Ctrl</kbd>+<kbd>C</kbd> pour arrêter votre serveur et cesser d'écouter les webhooks transférés.\n\n## Étapes suivantes\n\nMaintenant que vous disposez d’une application, vous pouvez développer le code de votre application, déployer votre application et rendre votre application publique.\n\n### Modifier le code de l’application\n\nDupliquez le dépôt [github/github-app-js-sample](https://github.com/github/github-app-js-sample) et modifiez le code pour répondre à différents événements de webhook ou pour effectuer différentes requêtes d’API. Pour plus d’informations sur le code, consultez « [Création d’une application GitHub qui répond aux événements de webhook](/fr/apps/creating-github-apps/guides/building-a-github-app-that-responds-to-webhook-events) ».\n\nN’oubliez pas de mettre à jour les autorisations de votre application si des autorisations supplémentaires sont nécessaires pour les demandes d’API que vous souhaitez effectuer ou les événements de webhook que vous souhaitez recevoir. Pour plus d’informations, consultez « [Choix des autorisations pour une application GitHub](/fr/apps/creating-github-apps/creating-github-apps/setting-permissions-for-github-apps) ».\n\n### Déployer votre application\n\nCe tutoriel a utilisé votre ordinateur ou codespace comme serveur. Une fois que l’application est prête pour être utilisée en production, vous devez déployer votre application sur un serveur dédié. Par exemple, vous pouvez utiliser [Azure App Service](https://azure.microsoft.com/products/app-service/).\n\nUne fois que vous disposez d’un serveur, mettez à jour l’URL du webhook dans les paramètres de votre application. Vous ne devez pas utiliser Smee.io pour transférer vos webhooks en production.\n\nVous devez également mettre à jour les constantes `port` et `host` dans le code. Pour plus d’informations, consultez « [Création d’une application GitHub qui répond aux événements de webhook](/fr/apps/creating-github-apps/guides/building-a-github-app-that-responds-to-webhook-events#deploy-your-app) ».\n\nVous ne devez jamais rendre public la clé privée ou le secret du webhook de votre application. Ce tutoriel a stocké les informations d’identification de votre application dans un fichier gitignored `.env`. Quand vous déployez votre application, choisissez un moyen sécurisé de stocker les informations d'identification et de mettre à jour votre code pour obtenir la valeur en conséquence. Vous pouvez par exemple stocker vos informations d’identification dans une variable d’environnement sur le serveur sur lequel votre application est déployée. Vous pouvez également utiliser un service de gestion des secrets comme [Azure Key Vault](https://azure.microsoft.com/en-us/products/key-vault).\n\n### Partager votre application\n\nSi vous souhaitez partager votre application avec d’autres utilisateurs et organisations, rendez-la publique. Pour plus d’informations, consultez « [Création d’une application GitHub publique ou privée](/fr/apps/creating-github-apps/creating-github-apps/making-a-github-app-public-or-private) ».\n\n### Suivre les bonnes pratiques\n\nVous devez vous efforcer de suivre les bonnes pratiques avec votre GitHub App. Pour plus d’informations, consultez « [Meilleures pratiques pour la création d’une application GitHub](/fr/apps/creating-github-apps/setting-up-a-github-app/best-practices-for-creating-a-github-app) »."}