# Démarrage rapide pour les packages GitHub

Publier sur GitHub Packages avec GitHub Actions.

> \[!NOTE]
> Les exécuteurs hébergés sur GitHub Enterprise Server ne sont pas pris en charge sur GitHub.

## Introduction

Dans ce guide, vous allez créer un GitHub Actions flux de travail pour tester votre code, puis le publier sur GitHub Packages.

## Publication de votre package

1. Créez un dépôt sur GitHub, en ajoutant le `.gitignore` pour Node. Pour plus d’informations, consultez « [Création d’un dépôt](/fr/enterprise-server@3.22/repositories/creating-and-managing-repositories/creating-a-new-repository) ».

2. Clonez le référentiel sur votre ordinateur local.

   ```shell
   git clone https://YOUR-HOSTNAME/YOUR-USERNAME/YOUR-REPOSITORY.git
   cd YOUR-REPOSITORY
   ```

3. Créez un fichier `index.js` et ajoutez une alerte de base pour dire « Bonjour le monde ! »

   ```javascript copy
   console.log("Hello, World!");
   ```

4. Initialisez un package npm avec `npm init`. Dans l'assistant d'initialisation du package, saisissez le nom de votre package : *`@YOUR-USERNAME/YOUR-REPOSITORY`*, et définissez le script de test à partir de `exit 0`. Cela génère un fichier `package.json` contenant des informations sur votre package.

   ```shell
   $ npm init
     ...
     package name: @YOUR-USERNAME/YOUR-REPOSITORY
     ...
     test command: exit 0
     ...
   ```

5. Exécutez `npm install` pour générer le `package-lock.json` fichier, puis validez et envoyez vos modifications à GitHub.

   ```shell
   npm install
   git add index.js package.json package-lock.json
   git commit -m "initialize npm package"
   git push
   ```

6. Créez un répertoire `.github/workflows`. Dans ce répertoire, créez un fichier nommé `release-package.yml`.

7. Copiez le contenu YAML suivant dans le `release-package.yml` fichier, en remplaçant `YOUR-HOSTNAME` par le nom de votre entreprise.

   ```yaml copy
   name: Node.js Package

   on:
     release:
       types: [created]

   jobs:
     build:
       runs-on: ubuntu-latest
       steps:
         - uses: actions/checkout@v6
         - uses: actions/setup-node@v7
           with:
             node-version: 20
         - run: npm ci
         - run: npm test

     publish-gpr:
       needs: build
       runs-on: ubuntu-latest
       permissions:
         packages: write
         contents: read
       steps:
         - uses: actions/checkout@v6
         - uses: actions/setup-node@v7
           with:
             node-version: 20
             registry-url: https://npm.YOUR-HOSTNAME.com/
         - run: npm ci
         - run: npm publish
           env:
             NODE_AUTH_TOKEN: ${{secrets.GITHUB_TOKEN}}
   ```

8. Indiquez à npm l’étendue et le registre où publier les packages en utilisant une des méthodes suivantes :
   * Ajoutez un fichier de configuration npm pour le référentiel en créant un fichier `.npmrc` dans le répertoire racine avec le contenu :

     ```shell
     @YOUR-USERNAME:registry=https://npm.pkg.github.com
     ```

   * Modifiez le fichier `package.json` et spécifiez la clé `publishConfig` :

     ```shell
     "publishConfig": {
       "@YOUR-USERNAME:registry": "https://npm.pkg.github.com"
     }
     ```

9. Validez et envoyez vos modifications à GitHub.

   ```shell
   $ git add .github/workflows/release-package.yml
   # Also add the file you created or edited in the previous step.
   $ git add .npmrc or package.json
   $ git commit -m "workflow to publish package"
   $ git push
   ```

10. Le workflow que vous avez créé s’exécute chaque fois qu’une nouvelle version est créée dans votre référentiel. Si les tests réussissent, le package sera publié sur GitHub Packages.

    Pour le tester, accédez à l’onglet **Coder** de votre référentiel et créez une version. Pour plus d’informations, consultez [Gestion des versions dans un référentiel](/fr/enterprise-server@3.22/repositories/releasing-projects-on-github/managing-releases-in-a-repository#creating-a-release).

## Affichage de votre package publié

Vous pouvez afficher tous les packages que vous avez publiés.

1. Sur GitHub, accédez à la page principale du référentiel.
2. Dans la barre latérale droite de votre dépôt, cliquez sur **Packages**.

   ![Capture d’écran de la barre latérale d’une page de dépôt. La section « Packages » est mise en évidence en orange.](/assets/images/help/package-registry/packages-from-repo.png)
3. Recherchez le nom du package que vous souhaitez voir et cliquez dessus.

## Utilisation d’un package publié

Maintenant que vous avez publié le package, vous souhaiterez l’utiliser comme dépendance entre vos projets. Pour plus d’informations, consultez « [Utilisation du registre npm](/fr/enterprise-server@3.22/packages/working-with-a-github-packages-registry/working-with-the-npm-registry#installing-a-package) ».

## Étapes suivantes

Le workflow de base que vous venez d’ajouter s’exécute chaque fois qu’une nouvelle version est créée dans votre référentiel. Mais c’est seulement le début de ce que vous pouvez faire avec GitHub Packages. Vous pouvez publier votre package sur plusieurs registres avec un seul workflow, déclencher le workflow pour se lancer sur différents événements tels qu'un pull request fusionné, gérer des conteneurs, etc.

La combinaison de GitHub Packages et de GitHub Actions peut vous aider à automatiser presque tous les aspects de vos processus de développement de vos applications. Vous êtes prêt à commencer ? Voici quelques ressources utiles pour passer aux prochaines étapes avec GitHub Packages et GitHub Actions :

* Pour suivre un tutoriel détaillé sur les packages GitHub, consultez [Découvrir GitHub Packages](/fr/enterprise-server@3.22/packages/learn-github-packages)
* Pour suivre un tutoriel détaillé sur GitHub Actions, consultez [Écriture de workflows](/fr/enterprise-server@3.22/actions/how-tos/write-workflows)
* Pour obtenir des cas d’utilisation et des exemples spécifiques, consultez [Utilisation d’un registre GitHub Packages](/fr/enterprise-server@3.22/packages/working-with-a-github-packages-registry)