Skip to main content

Connexion d’un dépôt à un package

Vous pouvez connecter un référentiel à un package sur GitHub.

Quand vous publiez un package délimité à un compte personnel ou à une organisation, le package n’est pas lié à un dépôt par défaut. Si vous connectez un package à un dépôt, la page d’accueil du package affiche des informations et des liens venant du dépôt comme le fichier README. Vous pouvez également définir que le package doit hériter des autorisations d’accès à partir du référentiel lié. Pour plus d’informations, consultez « Configuration du contrôle d’accès et de la visibilité d’un package ».

Connexion d’un dépôt à un package délimité à l’utilisateur sur GitHub

  1. Sur GitHub, accédez à la page principale de votre compte personnel.

  2. En haut à droite de GitHub, cliquez sur votre photo de profil, puis sur Votre profil.

    Capture d’écran du menu déroulant sous l’image de profil de @octocat. « Votre profil » est délimité en orange foncé.

  3. Dans la page de votre profil, dans l’en-tête, cliquez sur l’onglet Packages.

  4. Recherchez le nom du package que vous souhaitez gérer et cliquez dessus.

  5. Sous les versions de votre package, cliquez sur Connecter un dépôt.

  6. Sélectionnez un dépôt à lier au package et cliquez sur Connecter le dépôt.

Connexion d’un dépôt à un package délimité à l’organisation sur GitHub

  1. Sur GitHub, accédez à la page principale de votre organisation.

  2. Sous le nom de votre organisation, cliquez sur l’onglet Packages.

    Capture d’écran de la page de profil de @octo-org. L’onglet « Packages » est mis en évidence avec un encadré orange.

  3. Recherchez le nom du package que vous souhaitez gérer et cliquez dessus.

  4. Sous les versions de votre package, cliquez sur Connecter un dépôt.

  5. Sélectionnez un dépôt à lier au package et cliquez sur Connecter le dépôt.

Connexion d’un dépôt à une image conteneur à l’aide de la ligne de commande

Remarque : Container registry est actuellement en beta pour GitHub Enterprise Server et susceptible d’être modifié.

GitHub Packages et l’isolation de sous-domaine doivent être activés pour utiliser Container registry. Pour plus d’informations, consultez « Utilisation du registre de conteneurs ».

  1. Dans votre Dockerfile, ajoutez cette ligne, en remplaçant HOSTNAME, OWNER et REPO par vos informations :

    LABEL org.opencontainers.image.source=https://HOSTNAME/OWNER/REPO
    

    Par exemple, si vous êtes l’utilisateur octocat et propriétaire de my-repo, et que votre nom d’hôte GitHub est github.companyname.com, ajoutez cette ligne à votre Dockerfile :

    LABEL org.opencontainers.image.source=https://containers.github.companyname.com/octocat/my-repo
    

    Pour plus d’informations, consultez « LABEL » dans la documentation Docker officielle et « Clés d’annotation prédéfinies » dans le dépôt opencontainers/image-spec.

  2. Générez votre image conteneur. Cet exemple génère une image à partir du fichier Dockerfile dans le répertoire actif et attribue à l’image le nom hello_docker.

    docker build -t hello_docker .
    
  3. Si vous le souhaitez, passez en revue les détails de l’image Docker que vous venez de créer.

    $ docker images
    > REPOSITORY          TAG         IMAGE ID       CREATED         SIZE
    > hello_docker        latest      142e665b1faa   5 seconds ago   125MB
    > redis               latest      afb5e116cac0   3 months ago    111MB
    > alpine              latest      a6215f271958   5 months ago    5.29MB
    
  4. Attribuez un nom et une destination d’hébergement à votre image Docker.

    docker tag IMAGE_NAME containers.HOSTNAME/NAMESPACE/NEW_IMAGE_NAME:TAG
    

    Remplacez NAMESPACE par le nom du compte personnel ou de l’organisation auquel vous souhaitez que le package soit délimité.

    Par exemple :

    docker tag 38f737a91f39 containers.github.companyname.com/octocat/hello_docker:latest
    
  5. Si ce n’est déjà fait, authentifiez-vous auprès du Container registry. Pour plus d’informations, consultez « Utilisation du registre de conteneurs ».

    $ echo $CR_PAT | docker login containers.HOSTNAME -u USERNAME --password-stdin
    > Login Succeeded
    
  6. Poussez votre image conteneur vers le Container registry.

    docker push containers.HOSTNAME/NAMESPACE/IMAGE-NAME:TAG
    

    Par exemple :

    docker push containers.github.companyname.com/octocat/hello_docker:latest
    

Dissociation d'un référentiel d'un package sur GitHub

Note

La dissociation d'un package d'un référentiel supprime les informations relatives au référentiel de la page de destination du package et peut affecter le modèle d'accès selon que le package hérite ou non de ses autorisations d'accès du référentiel. Pour plus d’informations, consultez « Configuration du contrôle d’accès et de la visibilité d’un package ». Ce comportement ne s’applique pas aux packages Apache Maven, comme indiqué dans « À propos des autorisations pour les packages GitHub ».

  1. Sur GitHub, accédez à la page de configuration du Package que vous souhaitez dissocier.

  2. Sur la page Paramètres du package, vous verrez une section Source du référentiel. Si cette section n'est pas présente, alors le package n'est pas encore lié à un référentiel.

  3. Cliquez sur l'icône de la corbeille dans le coin supérieur droit de la section Source du référentiel.

Il est possible que la section Source du référentiel existe, mais qu'il n'y ait pas d'icône de corbeille. Cela est dû au fait qu'une source de référentiel a été définie comme faisant partie du code packagé, c'est-à-dire un fichier package.json, un fichier .gemspec, mais elle n'est pas réellement liée à un référentiel sur GitHub. Pour lier le package à un référentiel, vous devez suivre les étapes de la section ci-dessus.

  1. Confirmez que vous souhaitez dissocier le référentiel du package à l'aide de la boîte de dialogue.

Migration d’un package vers un autre référentiel

Si un package est actuellement lié à un référentiel et que vous souhaitez le lier à un autre référentiel, vous pouvez le faire en dissociant le package du référentiel actuel et en le liant au nouveau référentiel.

  1. Suivez les étapes pour le dissocier, consultez « Dissocier un référentiel d’un package sur GitHub ».
  2. Suivez les étapes pour lier le package au nouveau référentiel, consultez « Connecter un référentiel à un package défini par l’organisation sur GitHub » ou « Connecter un référentiel à un package défini par l’utilisateur sur GitHub ».