Oracle Cloud Infrastructure - Dokumentation

Repository erstellen

Erfahren Sie, wie Sie ein Repository in Container Registry erstellen.

Nach dem Erstellen eines Repositorys können Sie ein Image per Push in das Repository über die Docker-CLI übergeben (siehe Images mit der Docker-CLI per Push übertragen). Alle Images, die Sie anschließend per Push an die Registry übertragen und die denselben Repository-Namen enthalten, werden in diesem Repository gruppiert.

Beachten Sie, dass ein Repository-Name zwar Schrägstriche enthalten kann, der Schrägstrich jedoch keine hierarchische Verzeichnisstruktur darstellt. Es ist nur ein Zeichen in einer Zeichenfolge. Zur Vereinfachung können Sie die Namen mehrerer verschiedener Repositorys mit derselben Zeichenfolge starten, die möglicherweise mit einem Schrägstrich (wie project01/) endet. Eine solche Zeichenfolge wird manchmal als "Repository-Namenspräfix" bezeichnet. Ein Repository mit dem Namen project01/acme-web-app benötigt jedoch keine Beziehung zu einem Repository mit dem Namen project01/my-test-app. Die Verwendung des gleichen Repository-Namenspräfixes für einige Repositorys erleichtert die Organisation und Kontrolle des Zugriffs auf diese Repositorys in Container Registry, die viele andere Repositorys enthalten kann. Weitere Informationen und Beispiele finden Sie unter Repository-Name.

Das Erstellen eines Repositorys, bevor ein Image übertragen wird, ist der übliche Workflow, ist jedoch nicht immer erforderlich. Wenn Sie nicht zur Verwaltung von Repositorys im Root Compartment des Mandanten autorisiert sind, müssen Sie ein Image immer in ein vorhandenes Repository pushen. Wenn Sie jedoch autorisiert sind, Images per Push an das Root Compartment des Mandanten zu übertragen, und dies beabsichtigen, ist kein vorhandenes Repository erforderlich.

Wenn Sie ein Image pushen, verwenden Sie normalerweise einen Befehl im Format docker push <registry-domain>/<tenancy-namespace>/<repo-name>:<version>. Wenn Sie jedoch die Option Repository beim ersten Push im Root Compartment erstellen auswählen und ein Image mit einem Befehl pushen, der den Namen eines Repositorys enthält, das noch nicht vorhanden ist, wird automatisch ein neues privates Repository im Root Compartment erstellt.

Beispiel: Wenn Sie den Befehl docker push ocir.us-ashburn-1.oci.oraclecloud.com/ansh81vru1zp/project02/acme-web-app:7.5.2 eingeben und das project02/acme-web-app-Repository nicht vorhanden ist, wird automatisch ein privates Repository mit dem Namen project02/acme-web-app im Root Compartment erstellt.

Sie müssen zur Administratorengruppe des Mandanten gehören oder die Berechtigung REPOSITORY_MANAGE für den Mandanten erhalten haben, um das private Repository automatisch im Root Compartment des Mandanten zu erstellen. Siehe Policys zur Kontrolle des Repository-Zugriffs.

    1. Wählen Sie auf der Listenseite Container Registry die Option Repository erstellen aus. Wenn Sie Hilfe beim Suchen der Listenseite benötigen, finden Sie weitere Informationen unter Repositorys auflisten.
    2. Geben Sie folgende Informationen ein:

      • Erstellen in Compartment: Das Compartment, in dem das Repository erstellt werden soll. Sie können jedes Compartment auswählen, für das Sie die Berechtigung zur Arbeit haben.

      • Zugriff: Gibt an, ob das Repository ein öffentliches oder privates Repository ist. Sie können das Repository nur öffentlich machen, wenn Sie zur Administratorengruppe des Mandanten gehören oder Ihnen die Berechtigung REPOSITORY_MANAGE erteilt wurde. Beachten Sie die folgenden Punkte:

        • Wenn Sie das Repository öffentlich machen, kann jeder Benutzer mit Internetzugang und Kenntnis der entsprechenden URL Images aus dem Repository abrufen.

        • Wenn Sie das Repository privat machen, können Sie (zusammen mit Benutzern, die zur Administratorengruppe des Mandanten gehören) jeden beliebigen Vorgang für das Repository ausführen.

      • Repository-Name: Geben Sie einen Namen Ihrer Wahl für das Repository ein. Der eingegebene Name muss in allen Compartments im Mandanten eindeutig sein. Geben Sie keine vertraulichen Informationen ein.

      • Tags: Optional ein oder mehrere Freiformtags oder definierte Tags, die auf das Repository angewendet werden sollen. Um ein definiertes Tag anzuwenden, benötigen Sie die Berechtigungen zum Verwenden des Tag-Namespace. Wenn du nicht sicher bist, ob du Tags anwenden solltest, überspringen sie diese Option, oder fragen Sie Ihren Administrator. Sie können die Tags auch später auch noch anwenden. Weitere Informationen finden Sie unter Anwenden von Freiformtags und definierten Tags auf Repositorys, Images und Imagesignaturen.

    3. Klicken Sie auf Erstellen.
    4. (Optional) Um automatisch neue private Repositorys im Root Compartment des Mandanten zu erstellen, wenn docker push-Befehle nicht den Namen eines vorhandenen Repositorys enthalten, führen Sie die folgenden Schritte aus:

      1. Wählen Sie Einstellungen aus.

      2. Wählen Sie Repository bei erster Übertragung im Root Compartment erstellen aus.

  • Verwenden Sie den Befehl oci Artefaktcontainer-Repository erstellen und die erforderlichen Parameter, um ein Repository zu erstellen:

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

    Beispiel:

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

    Eine vollständige Liste der Kennzeichen und Variablenoptionen für CLI-Befehle finden Sie in der Befehlszeilenreferenz.

  • Führen Sie den Vorgang CreateContainerRepository aus, um ein Repository zu erstellen.