container-registry-CLI-Plug-in installieren

Installieren Sie das container-registry CLI-Plug-in, damit Sie die Befehlszeilenschnittstelle zur Verwaltung Ihrer Namespaces und „ Docker “-Images in „ IBM Cloud Container Registry “ verwenden können.

1. Installieren Sie das container-registry CLI-Plugin, indem Sie den folgenden Befehl ausführen:

   ibmcloud plugin install container-registry
   

   Weitere Informationen zur Installation von Plug-ins finden Sie unter Erweitern von IBM Cloud CLI mit Plug-ins.

2. Optional: Konfigurieren Sie Ihren Docker-Client so, dass Befehle ohne Root-Rechte ausgeführt werden können. Falls Sie diesen Schritt nicht ausführen, müssen Sie die Befehle ibmcloud login, ibmcloud cr login, docker pull und docker push mit sudo oder als Root ausführen.

IBM Cloud Container Registry Unterstützt „ Docker “ und andere Clients. Informationen zur Anmeldung mit anderen Clients finden Sie im Abschnitt zum interaktiven Zugriff auf Namensbereiche.

Sie können nun einen eigenen Namensbereich in IBM Cloud Container Registry einrichten.

container-registry-CLI-Plug-in aktualisieren

Sie können das container-registry-CLI-Plug-in regelmäßig aktualisieren, um neue Features zu nutzen.

ibmcloud plugin update container-registry

ibmcloud plugin install container-registry -v VERSION_NUMBER

ibmcloud plugin install container-registry -v 0.1.584

container-registry-CLI-Plug-in deinstallieren

Wenn Sie Container Registry nicht mehr verwenden möchten, können Sie es löschen, indem Sie das container-registry CLI-Plug-in deinstallieren.

Um das container-registry CLI-Plugin zu deinstallieren, führen Sie den folgenden Befehl aus:

ibmcloud plugin uninstall container-registry

Namensbereiche planen

IBM Cloud Container Registry bietet eine mandantenfähige private Image-RegistrierungEin Speicher-und Verteilungsservice, der öffentliche oder private Images zum Erstellen von Containern enthält., die von IBM gehostet und verwaltet wird. In dieser Registry können Sie Ihre Docker-Images speichern, indem Sie einen Registrynamensbereich einrichten.

IAM-Zugriffsberechtigungen können auf Kontoebene, für alle Namespaces oder für den Namespace selbst erteilt werden. Es ist auch möglich, den Zugriff auf der Ebene der Ressourcengruppe zu gewähren. Namensräume werden in einer Ressourcengruppe erstellt, die nicht geändert werden kann, so dass Sie den Zugriff auf der Ebene der Ressourcengruppe gewähren können. Wenn Sie keine Ressourcengruppe angeben und keine Ressourcengruppe anvisiert wird, wird die Standard-Ressourcengruppe zugewiesen, wenn der Namensraum erstellt wird.

Wenn Sie einen älteren Namespace haben, der nicht in einer Ressourcengruppe enthalten ist, können Sie ihn einer Ressourcengruppe zuweisen und dann Berechtigungen für diesen Namespace auf Ressourcengruppenebene festlegen. Weitere Informationen zu Ressourcengruppen finden Sie unter Namensbereiche zu Ressourcengruppen zuordnen.

Namensbereiche, die einer Ressourcengruppe zugeordnet sind, werden auf der Seite Ressourcenliste der IBM Cloud-Konsole angezeigt.

Wenn Sie separate Repositorys verwenden möchten (beispielsweise für Ihre Produktions- und Ihre Staging-Umgebungen), können Sie mehrere Namensbereiche einrichten. Falls Sie die Registry in mehreren IBM Cloud-Regionen verwenden möchten, müssen Sie für jede Region einen eigenen Namensbereich einrichten. Namensbereiche sind innerhalb Regionen eindeutig. Sie können denselben Namensbereichsnamen für jede Region verwenden, solange nicht bereits ein anderer Namensbereich mit diesem Namen in der betreffenden Region eingerichtet wurde.

Sie können einen Container Registry (icr.io) Namensraum nicht für mehrere IBM Cloud Konten freigeben. Ein Namensraum ist Eigentum eines einzigen IBM Cloud Kontos und kann nicht von mehreren Konten gemeinsam genutzt werden.

Sie können in jeder Region über 100 Namensbereiche verfügen.

Wenn Sie ausschließlich mit den von IBM bereitgestellten öffentlichen Images arbeiten möchten, ist die Einrichtung eines Namensbereichs nicht erforderlich.

Wenn Sie sich nicht sicher sind, ob für Ihr Konto bereits ein Namespace festgelegt ist, führen Sie den ibmcloud cr namespace-list Befehl mit der -v Option aus, um vorhandene Namespace-Informationen abzurufen.

Beachten Sie bei der Wahl eines Namens für den Namensbereich die folgenden Regeln:

• Ihr Namensbereich muss in allen IBM Cloud-Konten derselben Region eindeutig sein.
• Ihr Namensbereich muss 4 bis 30 Zeichen lang sein.
• Ihr Namensbereich muss mit einem Buchstaben oder einer Zahl beginnen und enden.
• Ihr Namensbereich darf ausschließlich Kleinbuchstaben, Zahlen, Bindestriche (-) und Unterstreichungszeichen (_) enthalten.

Beziehen Sie keine personenbezogenen Daten in Ihre Namensbereichsnamen ein.

Nachdem Sie Ihren ersten Namespace eingerichtet haben, wird Ihnen der kostenlose Serviceplan „ IBM Cloud Container Registry “ zugewiesen, sofern Sie keinen Upgrade Ihres Plans vornehmen.

Namensbereich einrichten

Sie müssen einen Namensbereich erstellen, um Docker-Images in IBM Cloud Container Registry zu speichern.

Führen Sie die folgenden Aufgaben aus, bevor Sie beginnen:

• IBM Cloud-Befehlszeilenschnittstelle und das Plug-in container-registry der Befehlszeilenschnittstelle installieren.
• Verwendung und Benennung der Registry-Namensbereiche planen.

Informationen zum Erstellen eines Namensbereichs finden Sie unter Namensbereich einrichten. Namensbereiche werden in der von Ihnen angegebenen Ressourcengruppe erstellt, sodass Sie den Zugriff auf Ressourcen innerhalb des Namensbereichs auf der Ressourcengruppen-Ebene konfigurieren können. Wenn Sie keine Ressourcengruppe angeben und keine Ressourcengruppe als Ziel angegeben ist, wird die Standardressourcengruppe verwendet. Weitere Informationen zu Ressourcengruppen finden Sie unter Ressourcengruppen verwalten.

Namensbereiche, die einer Ressourcengruppe zugeordnet sind, werden auf der Seite Ressourcenliste der IBM Cloud-Konsole angezeigt.

Der Namensbereich muss für alle IBM Cloud-Konten in derselben Region eindeutig sein. Namensbereiche müssen 4 bis 30 Zeichen lang sein und dürfen nur Kleinbuchstaben, Zahlen, Bindestriche (-) und Unterstreichungszeichen (_) enthalten. Namensbereiche müssen mit einem Buchstaben oder einer Zahl beginnen und enden.

Sie können nun Docker-Images per Push-Operation in Ihren Namensbereich in IBM Cloud Container Registry übertragen und diese Images mit anderen Benutzern in Ihrem Konto gemeinsam nutzen. Informationen zur Steuerung des Zugriffs auf Namensbereich in IBM Cloud IAM finden Sie in Richtlinien erstellen.

Namensbereiche zu Ressourcengruppen zuordnen

Namensbereiche, die in Version 0.1.484 oder einer früheren Version der Befehlszeilenschnittstelle bzw. in einer Version der IBM Cloud-Konsole vor dem 29. Juli 2020 erstellt werden, werden keiner Ressourcengruppe zugewiesen. Wenn Sie über einen Namespace verfügen, der keiner Ressourcengruppe zugewiesen ist, können Sie den Namespace einer Ressourcengruppe zuweisen und anschließend Berechtigungen für diesen Namespace auf Ressourcengruppenebene festlegen.

Sie können einer Ressourcengruppe nur ein einziges Mal einen Namensbereich zuordnen. Wenn sich ein Namensbereich in einer Ressourcengruppe befindet, können Sie ihn nicht in eine andere Ressourcengruppe verschieben.

Sie können einer Ressourcengruppe einen vorhandenen Namensbereich mithilfe des Befehls ibmcloud cr namespace-assign zuordnen. Um zu ermitteln, welche Namensbereiche welchen Ressourcengruppen zugeordnet sind und welche Namensbereiche nicht zugeordnet sind, führen Sie den Befehl ibmcloud cr namespace-list mit der Option -v aus.

Namensbereiche, die einer Ressourcengruppe zugeordnet sind, werden auf der Seite Ressourcenliste der IBM Cloud-Konsole angezeigt.

Wenn die Namensbereiche nicht alle auf der Seite Ressourcenliste angezeigt werden, finden Sie in Warum werden nicht alle meine Namensbereiche in der Ressourcenliste angezeigt? Unterstützung.

Weitere Informationen zu Ressourcengruppen finden Sie unter Ressourcengruppe erstellen.

Führen Sie die folgenden Schritte aus, um einer Ressourcengruppe einen vorhandenen Namensbereich zuzuordnen:

1. Melden Sie sich bei IBM Cloud an.

   ibmcloud login
   

2. Um den Namensbereich zu suchen, listen Sie die verfügbaren Namensbereiche auf.

   ibmcloud cr namespace-list -v
   

3. Ordnen Sie den Namensbereich einer Ressourcengruppe zu.

   Ersetzen Sie MY_RESOURCE_GROUP durch den Namen oder die ID der Ressourcengruppe und MY_NAMESPACE durch den Namen des Namensbereichs.

   ibmcloud cr namespace-assign -g MY_RESOURCE_GROUP MY_NAMESPACE
   

Namensbereiche entfernen

Falls Sie einen Registry-Namensbereich nicht mehr benötigen, können Sie ihn aus Ihrem IBM Cloud-Konto entfernen.

1. Melden Sie sich bei IBM Cloud an.

   ibmcloud login
   

2. Listen Sie die verfügbaren Namensbereiche auf.

   ibmcloud cr namespace-list
   

3. Namensbereich entfernen.

   Wenn Sie einen Namensbereich entfernen, werden alle in diesemNamensbereich gespeicherten Images ebenfalls gelöscht. Diese Aktion kann nicht rückgängig gemacht werden.

   Ersetzen Sie MY_NAMESPACE durch den Namensbereich, den Sie entfernen möchten.

   ibmcloud cr namespace-rm MY_NAMESPACE
   

   Nachdem Sie einen Namensbereich gelöscht haben, kann es einige Minuten dauern, bis dieser Namensbereich wieder zur erneuten Verwendung verfügbar ist.