Repository-Einstellungen aktualisieren

Sie können die folgenden Repository-Einstellungen aktualisieren:

  • Repository-Beschreibung.

  • Details zur Authentifizierung des Remote-Repository-Upstreams.

  • Unveränderliche Image-Tags für Docker-Repositories. Wenn Sie diese Einstellung aktivieren, verweist ein Image-Tag immer auf denselben Image-Digest, einschließlich des Standard-latest-Tags.

    Weitere Informationen zu Image-Tags, Image-Digests und unveränderlichen Image-Tags finden Sie unter Container-Image-Versionen.

  • Repository-Labels.

Erforderliche Rollen

Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Artifact Registry-Administrator (roles/artifactregistry.admin) für das Google Cloud-Projekt zu gewähren, um die Berechtigungen zu erhalten, die Sie zum Aktualisieren der Repository-Einstellungen benötigen. Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff verwalten.

Möglicherweise können Sie die erforderlichen Berechtigungen auch über benutzerdefinierte Rollen oder andere vordefinierte Rollen erhalten.

Einstellungen aktualisieren

Sie können die Einstellungen über die Google Cloud Console oder die Google Cloud CLI aktualisieren.

Console

  1. Öffnen Sie in der Cloud Console die Seite Repositories.

    Zur Seite „Repositories“

  2. Wählen Sie in der Repository-Liste das Repository aus und klicken Sie auf Repository bearbeiten.

  3. Bearbeiten Sie die Einstellungen, die Sie ändern möchten:

    • Ändern Sie die Repository-Beschreibung.
    • Aktualisieren Sie die Details der Remote-Repository-Upstream-Authentifizierung.

    • Aktivieren oder deaktivieren Sie unveränderliche Image-Tags im Bereich Unveränderliche Image-Tags. Wenn Sie diese Einstellung aktivieren, sind folgende Aktionen nicht zulässig:

      • Löschen Sie ein getaggtes Bild.
      • Tag von einem Image entfernen
      • Übertragen Sie ein Image mit einem Tag, das bereits von einer anderen Version des Images im Repository verwendet wird.
      • Labels hinzufügen, entfernen oder aktualisieren

  4. Klicken Sie auf Speichern.

gcloud

Führen Sie den folgenden Befehl aus, um die Repository-Beschreibung zu bearbeiten:

gcloud artifacts repositories update REPOSITORY \
    --project=PROJECT-ID \
    --location=LOCATION \
    --description="DESCRIPTION"

Führen Sie den folgenden Befehl aus, um die Details der Remote-Repository-Upstream-Authentifizierung zu aktualisieren:

gcloud artifacts repositories update REPOSITORY \
    --project=PROJECT_ID \
    --location=LOCATION \
    --remote-username=USERNAME \
    --remote-password-secret-version=projects/PROJECT_ID/secrets/SECRET_ID/versions/SECRET_VERSION

Führen Sie einen der folgenden Befehle aus, um die Veränderlichkeit der Bild-Tags zu bearbeiten:

So setzen Sie Image-Tags als unveränderlich:

gcloud artifacts repositories update REPOSITORY \
    --project=PROJECT-ID \
    --location=LOCATION \
    --immutable-tags

So legen Sie die Image-Tags als änderbar fest:

gcloud artifacts repositories update REPOSITORY \
    --project=PROJECT-ID \
    --location=LOCATION \
    --no-immutable-tags

Führen Sie den folgenden Befehl aus, um Labels zu aktualisieren:

gcloud artifacts repositories update REPOSITORY \
    --project=PROJECT-ID \
    --location=LOCATION \
    --update-labels="KEY=VALUE,..."

Ersetzen Sie die folgenden Werte:

  • REPOSITORY durch den Namen des Repositorys. Wenn Sie ein Standard-Repository konfiguriert haben, wird bei Weglassen des Flags dieses Standard-Repository verwendet.
  • PROJECT-ID durch die Google Cloud-Projekt-ID. Wenn dieses Flag nicht angegeben ist, wird das aktuelle Projekt oder das Standardprojekt verwendet.
  • LOCATION durch den regionalen oder multiregionalen Standort. Verwenden Sie dieses Flag, um Repositories an einem bestimmten Speicherort aufzurufen. Wenn Sie einen Standard-Speicherort konfiguriert haben, wird bei Weglassen dieses Flags dieser Standardwert verwendet.
  • DESCRIPTION durch eine Beschreibung für das Repository.
  • USERNAME durch den Nutzernamen Ihres Upstream-Repositorys.
  • SECRET_ID durch den Namen Ihres Secrets.
  • SECRET_VERSION durch die Secret-Version, die Sie verwenden möchten.
  • TAG-SETTING gibt an, wie Tags mit Versionen von Images verknüpft werden.
  • --no-immutable-tags: Die Image-Version, auf die das Tag verweist, kann sich ändern. Das Löschen von Images, das Entfernen von Tags und das Ändern der Version eines Images, auf die ein Tag verweist, sind zulässig.
  • --immutable-tags: Im Repository verweist ein Tag immer auf dieselbe Version eines Images. Folgende Aktionen sind nicht zulässig:
    • Löschen Sie ein getaggtes Bild.
    • Tag von einem Image entfernen
    • Übertragen Sie ein Image mit einem Tag, das bereits von einer anderen Version des Images im Repository verwendet wird.
  • KEY=VALUE,... durch eine Liste kommagetrennter Labels, die als Schlüssel/Wert-Paare angegeben sind. Beispiel: team=team-1,product=example_product,stage=development. Weitere Informationen zum Arbeiten mit Labels finden Sie unter Label-Repositories.