Documentation sur Oracle Cloud Infrastructure

Création d'un référentiel

Découvrez comment créer un référentiel dans le registre de conteneurs.

Après avoir créé un référentiel, vous pouvez y pousser une image à l'aide de l'interface de ligne de commande Docker (voir Transmission d'images à l'aide de l'interface de ligne de commande Docker). Toutes les images que vous poussez ensuite vers le registre et qui incluent le même nom de référentiel sont regroupées dans ce référentiel.

La création d'un référentiel avant de pousser une image est le flux de travail habituel, mais ce n'est pas toujours nécessaire. Si vous n'êtes pas autorisé à gérer les référentiels dans le compartiment racine de la location, vous devez toujours pousser une image vers un référentiel existant. Toutefois, si vous êtes autorisé à pousser des images vers le compartiment racine de la location et que vous avez l'intention de le faire, un référentiel existant n'est pas nécessaire.

Lorsque vous poussez une image, vous utilisez normalement une commande dans le format docker push <registry-domain>/<tenancy-namespace>/<repo-name>:<version>. Toutefois, si vous sélectionnez l'option Créer un référentiel lors de la première poussée dans le compartiment racine et que vous poussez une image avec une commande qui inclut le nom d'un référentiel qui n'existe pas encore, un nouveau référentiel privé est créé automatiquement dans le compartiment racine.

Par exemple, si vous entrez la commande docker push ocir.us-ashburn-1.oci.oraclecloud.com/ansh81vru1zp/project02/acme-web-app:7.5.2 et que le référentiel project02/acme-web-app n'existe pas, un référentiel privé nommé project02/acme-web-app est créé automatiquement dans le compartiment racine.

Vous devez appartenir au groupe Administrateurs de la location ou disposer de l'autorisation REPOSITORY_MANAGE sur la location pour créer automatiquement le référentiel privé dans le compartiment racine de la location. Voir Politiques pour contrôler l'accès aux référentiels.

    1. Dans la page de liste Registre de conteneurs, sélectionnez Créer un référentiel. Si vous avez besoin d'aide pour trouver la page de liste, voir Liste des référentiels.
    2. Entrez les informations suivantes :

      • Créer dans le compartiment : compartiment dans lequel créer le référentiel. Vous pouvez sélectionner tout compartiment que vous êtes autorisé à utiliser.

      • Accès : Indique si le référentiel est un référentiel public ou un référentiel privé. Vous ne pouvez définir le référentiel comme public que si vous appartenez au groupe Administrateurs de la location ou que vous disposez de l'autorisation REPOSITORY_MANAGE. Notez ces points :

        • Si vous définissez le référentiel comme étant public, tout utilisateur disposant d'un accès Internet et connaissant l'URL appropriée peut extraire des images du référentiel.

        • Si vous rendez le référentiel privé, vous (et les utilisateurs appartenant au groupe Administrateurs de la location) pouvez effectuer toutes les opérations sur le référentiel.

      • Nom du référentiel : nom de votre choix pour le référentiel. Le nom que vous entrez doit être unique dans tous les compartiments de la location. Évitez d'entrer des informations confidentielles.

      • Marqueurs : Facultativement, un ou plusieurs marqueurs à structure libre ou des marqueurs définis à appliquer au référentiel. Pour appliquer un marqueur défini, vous devez être autorisé à utiliser l'espace de noms de marqueur. Si vous ne êtes pas sûr d'appliquer des marqueurs, ignorez cette option (vous pourrez appliquer des marqueurs plus tard) ou demandez à l'administrateur. Pour plus d'informations, voir Application de marqueurs à structure libre et de marqueurs définis aux référentiels, images et signatures d'image.

    3. Sélectionnez Créer.
    4. (Facultatif) Pour créer automatiquement de nouveaux référentiels privés dans le compartiment racine de la location lorsque les commandes docker push n'incluent pas le nom d'un référentiel existant, procédez comme suit :

      1. Sélectionnez Paramètres.

      2. Sélectionnez Créer un référentiel lors de la première poussée dans le compartiment racine.

  • Utilisez la commande oci artefacts container repository create et les paramètres requis pour créer un référentiel :

    oci artifacts container repository create --display-name <repo-name> --compartment-id <compartment_ocid> [OPTIONS]

    Par exemple :

    oci artifacts container repository create --display-name project01/acme-web-app --compartment-id ocid1.compartment.oc1..aaaaaaaarvdfa72n...

    Pour la liste complète des indicateurs et des options de variable pour les commandes de l'interface de ligne de commande, voir Informations de référence sur la ligne de commande.

  • Exécutez l'opération CreateContainerRepository pour créer un référentiel.