Documentation Oracle Cloud Infrastructure

Création d'un référentiel

Découvrez comment créer un référentiel dans Container Registry.

Une fois que vous avez créé un référentiel, vous pouvez propager une image vers celui-ci à l'aide de l'interface de ligne de commande Docker (reportez-vous à Transmission d'images à l'aide de l'interface de ligne de commande Docker). Toutes les images que vous propagez ensuite vers le registre et qui ont 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 propager une image est le workflow 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 propager une image vers un référentiel existant. Toutefois, si vous êtes autorisé à propager 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 propagez une image, vous utilisez normalement une commande au 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 propagation dans le compartiment racine et que vous propagez une image avec une commande qui inclut le nom d'un référentiel qui n'existe pas encore, un 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 d'administrateurs de la location ou disposer du droit d'accès REPOSITORY_MANAGE sur la location pour créer automatiquement le référentiel privé dans le compartiment racine de la location. Reportez-vous à Stratégies de contrôle d'accès au référentiel.

    1. Sur 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, reportez-vous à Liste des référentiels.
    2. Saisissez les informations suivantes:

      • Créer dans le compartiment : compartiment dans lequel créer le référentiel. Vous pouvez sélectionner n'importe quel compartiment dans lequel vous êtes autorisé à travailler.

      • Accès : indique si le référentiel est public ou privé. Vous ne pouvez rendre le référentiel public que si vous appartenez au groupe d'administrateurs de la location ou si vous disposez du droit d'accès REPOSITORY_MANAGE. Notez les points suivants :

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

        • Si vous rendez privé le référentiel, vous (et les utilisateurs appartenant au groupe d'administrateurs de la location) pouvez effectuer n'importe quelle opération sur le référentiel.

      • Nom de référentiel : nom choisi pour le référentiel. Le nom que vous entrez doit être unique parmi tous les compartiments de la location. Evitez de saisir des informations confidentielles.

      • Balises : vous pouvez éventuellement appliquer au référentiel des balises à format libre ou des balises définies. Pour appliquer une balise définie, vous devez disposer de droits d'accès permettant d'utiliser l'espace de noms de balise. Si vous n'êtes pas certain d'appliquer des balises, ignorez cette option (vous pouvez les appliquer ultérieurement) ou demandez à l'administrateur. Pour plus d'informations, reportez-vous à Application de balises à format libre et de balises définies aux référentiels, images et signatures d'image.

    3. Sélectionnez Créer.
    4. (Facultatif) Pour créer automatiquement des 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 propagation 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...

    Afin d'obtenir la liste complète des indicateurs et des options de variable pour les commandes d'interface de ligne de commande, reportez-vous à Référence de ligne de commande.

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