Remote-Repositories erstellen

Docker

gcloud artifacts repositories create REMOTE-REPOSITORY-NAME \
    --project=PROJECT_ID \
    --repository-format=docker \
    --location=LOCATION \
    --description="DESCRIPTION" \
    --mode=remote-repository \
    --remote-repo-config-desc="REMOTE-REPOSITORY-DESCRIPTION" \
    --disable-vulnerability-scanning \
    --remote-docker-repo=UPSTREAM

Optionale Flags für die Authentifizierung beim Upstream-Repository:

• --remote-username=USERNAME
• --remote-password-secret-version=SECRET_VERSION

Ersetzen Sie Folgendes:

• REMOTE-REPOSITORY-NAME durch den Namen des Repositorys. Repository-Namen können für jeden Repository-Speicherort in einem Projekt nur einmal vorkommen.
• PROJECT_ID durch die Projekt-ID. Wenn dieses Flag nicht angegeben ist, wird das aktuelle Projekt oder das Standardprojekt verwendet.
• LOCATION durch den regionalen oder multiregionalen Standort für das Repository. Sie können dieses Flag weglassen, wenn Sie einen Standard-Speicherort festgelegt haben. Führen Sie den Befehl gcloud artifacts locations list aus, um eine Liste der unterstützten Speicherorte aufzurufen.
• DESCRIPTION mit einer optionalen Beschreibung des Repositorys. Geben Sie keine vertraulichen Daten an, da Repository-Beschreibungen nicht verschlüsselt werden.
• REMOTE-REPOSITORY-DESCRIPTION durch eine Beschreibung der Konfiguration des externen Repositorys für dieses Remote-Repository.
• USERNAME – optional, wenn Sie die Authentifizierung verwenden, mit Ihrem Nutzernamen für die Authentifizierung beim Upstream-Repository.
• SECRET_VERSION optional, wenn Sie die Authentifizierung verwenden, mit der Secret-Version, die das Passwort für Ihr Upstream-Repository enthält.

• UPSTREAM durch den voreingestellten Upstream-Namen, den Artifact Registry-Repositorypfad oder die benutzerdefinierte URL des Upstream-Repositorys.
  
  Für Artifact Registry-Upstream-Repositories formatieren Sie den Repository-Pfad so: projects/UPSTREAM_PROJECT_ID/locations/REGION/repositories/UPSTREAM_REPOSITORY.
  
  Informationen zu den verfügbaren voreingestellten Upstreams und den unterstützten benutzerdefinierten Upstreams finden Sie unter Unterstützte Formate.

• --disable-vulnerability-scanning: ist ein optionales Flag, mit dem Sie das automatische Scannen auf Sicherheitslücken für Ihr Repository deaktivieren können.

• --allow-vulnerability-scanning: ist ein optionales Flag, das Ihr Repository so konfiguriert, dass das automatische Scannen auf Sicherheitslücken zulässig ist. Weitere Informationen finden Sie unter Automatisches Scannen aktivieren oder deaktivieren.

Mit dem folgenden Befehl wird beispielsweise ein Remote-Repository namens my-repo in der Region us-east1 im Projekt Google Cloud my-project erstellt. Die Authentifizierung beim Upstream-Repository kann mit dem Nutzernamen my-username und der Secret-Version projects/my-project/secrets/my-secret/versions/1 erfolgen.

gcloud artifacts repositories create my-repo \
    --project=my-project \
    --repository-format=docker \
    --location=us-east1 \
    --description="Remote Docker repository" \
    --mode=remote-repository \
    --remote-repo-config-desc="Docker Hub" \
    --remote-username=my-username \
    --remote-password-secret-version=projects/my-project/secrets/my-secret/versions/1 \
    --remote-docker-repo=DOCKER-HUB

Weitere Informationen zur Authentifizierung bei Docker Hub-Upstream-Repositories finden Sie unter Authentifizierung für Remote-Repositories für Docker Hub konfigurieren.

Maven

gcloud artifacts repositories create REMOTE-REPOSITORY-NAME \
    --project=PROJECT_ID \
    --repository-format=maven \
    --location=LOCATION \
    --description="DESCRIPTION" \
    --mode=remote-repository \
    --remote-repo-config-desc="REMOTE-REPOSITORY-DESCRIPTION" \
    --disable-vulnerability-scanning \
    --remote-mvn-repo=UPSTREAM

Optionale Flags für die Authentifizierung beim Upstream-Repository:

• --remote-username=USERNAME
• --remote-password-secret-version=SECRET_VERSION

Ersetzen Sie Folgendes:

• REMOTE-REPOSITORY-NAME durch den Namen des Repositorys. Repository-Namen können für jeden Repository-Speicherort in einem Projekt nur einmal vorkommen.
• PROJECT_ID durch die Projekt-ID. Wenn dieses Flag nicht angegeben ist, wird das aktuelle Projekt oder das Standardprojekt verwendet.
• LOCATION durch den regionalen oder multiregionalen Standort für das Repository. Sie können dieses Flag weglassen, wenn Sie einen Standard-Speicherort festgelegt haben. Führen Sie den Befehl gcloud artifacts locations list aus, um eine Liste der unterstützten Speicherorte aufzurufen.
• DESCRIPTION mit einer optionalen Beschreibung des Repositorys. Geben Sie keine vertraulichen Daten an, da Repository-Beschreibungen nicht verschlüsselt werden.
• REMOTE-REPOSITORY-DESCRIPTION durch eine Beschreibung der Konfiguration des externen Repositorys für dieses Remote-Repository.
• USERNAME – optional, wenn Sie die Authentifizierung verwenden, mit Ihrem Nutzernamen für die Authentifizierung beim Upstream-Repository.
• SECRET_VERSION optional, wenn Sie die Authentifizierung verwenden, mit der Secret-Version, die das Passwort für Ihr Upstream-Repository enthält.

• UPSTREAM durch den voreingestellten Upstream-Namen, den Artifact Registry-Repositorypfad oder die benutzerdefinierte URL des Upstream-Repositorys.
  
  Für Artifact Registry-Upstream-Repositories formatieren Sie den Repository-Pfad so: projects/UPSTREAM_PROJECT_ID/locations/REGION/repositories/UPSTREAM_REPOSITORY.
  
  Informationen zu den verfügbaren voreingestellten Upstreams und den unterstützten benutzerdefinierten Upstreams finden Sie unter Unterstützte Formate.

• --disable-vulnerability-scanning: ist ein optionales Flag, mit dem Sie das automatische Scannen auf Sicherheitslücken für Ihr Repository deaktivieren können.

• --allow-vulnerability-scanning: ist ein optionales Flag, das Ihr Repository so konfiguriert, dass das automatische Scannen auf Sicherheitslücken zulässig ist. Weitere Informationen finden Sie unter Automatisches Scannen aktivieren oder deaktivieren.

Mit dem folgenden Befehl wird beispielsweise ein Remote-Repository namens my-repo in der Region us-east1 im Projekt Google Cloud my-project erstellt. Die Authentifizierung beim Upstream-Repository kann mit dem Nutzernamen my-username und der Secret-Version projects/my-project/secrets/my-secret/versions/1 erfolgen.

gcloud artifacts repositories create my-repo \
    --project=my-project \
    --repository-format=maven \
    --location=us-east1 \
    --description="Remote Maven repository" \
    --mode=remote-repository \
    --remote-repo-config-desc="Maven Central" \
    --remote-username=my-username \
    --remote-password-secret-version=projects/my-project/secrets/my-secret/versions/1 \
    --remote-mvn-repo=MAVEN-CENTRAL

npm

gcloud artifacts repositories create REMOTE-REPOSITORY-NAME \
    --project=PROJECT_ID \
    --repository-format=npm \
    --location=LOCATION \
    --description="DESCRIPTION" \
    --mode=remote-repository \
    --remote-repo-config-desc="REMOTE-REPOSITORY-DESCRIPTION" \
    --disable-vulnerability-scanning \
    --remote-npm-repo=UPSTREAM

Optionale Flags für die Authentifizierung beim Upstream-Repository:

• --remote-username=USERNAME
• --remote-password-secret-version=SECRET_VERSION

Ersetzen Sie Folgendes:

• REMOTE-REPOSITORY-NAME durch den Namen des Repositorys. Repository-Namen können für jeden Repository-Speicherort in einem Projekt nur einmal vorkommen.
• PROJECT_ID durch die Projekt-ID. Wenn dieses Flag nicht angegeben ist, wird das aktuelle Projekt oder das Standardprojekt verwendet.
• LOCATION durch den regionalen oder multiregionalen Standort für das Repository. Sie können dieses Flag weglassen, wenn Sie einen Standard-Speicherort festgelegt haben. Führen Sie den Befehl gcloud artifacts locations list aus, um eine Liste der unterstützten Speicherorte aufzurufen.
• DESCRIPTION mit einer optionalen Beschreibung des Repositorys. Geben Sie keine vertraulichen Daten an, da Repository-Beschreibungen nicht verschlüsselt werden.
• REMOTE-REPOSITORY-DESCRIPTION durch eine Beschreibung der Konfiguration des externen Repositorys für dieses Remote-Repository.
• USERNAME – optional, wenn Sie die Authentifizierung verwenden, mit Ihrem Nutzernamen für die Authentifizierung beim Upstream-Repository.
• SECRET_VERSION optional, wenn Sie die Authentifizierung verwenden, mit der Secret-Version, die das Passwort für Ihr Upstream-Repository enthält.

• UPSTREAM durch den voreingestellten Upstream-Namen, den Artifact Registry-Repositorypfad oder die benutzerdefinierte URL des Upstream-Repositorys.
  
  Für Artifact Registry-Upstream-Repositories formatieren Sie den Repository-Pfad so: projects/UPSTREAM_PROJECT_ID/locations/REGION/repositories/UPSTREAM_REPOSITORY.
  
  Informationen zu den verfügbaren voreingestellten Upstreams und den unterstützten benutzerdefinierten Upstreams finden Sie unter Unterstützte Formate.

• --disable-vulnerability-scanning: ist ein optionales Flag, mit dem Sie das automatische Scannen auf Sicherheitslücken für Ihr Repository deaktivieren können.

• --allow-vulnerability-scanning: ist ein optionales Flag, das Ihr Repository so konfiguriert, dass das automatische Scannen auf Sicherheitslücken zulässig ist. Weitere Informationen finden Sie unter Automatisches Scannen aktivieren oder deaktivieren.

Mit dem folgenden Befehl wird beispielsweise ein Remote-Repository namens my-repo in der Region us-east1 im Projekt Google Cloud my-project erstellt. Die Authentifizierung beim Upstream-Repository kann mit dem Nutzernamen my-username und der Secret-Version projects/my-project/secrets/my-secret/versions/1 erfolgen.

gcloud artifacts repositories create my-repo \
    --project=my-project \
    --repository-format=npm \
    --location=us-east1 \
    --description="Remote npm repository" \
    --mode=remote-repository \
    --remote-repo-config-desc="Public npm registry" \
    --remote-username=my-username \
    --remote-password-secret-version=projects/my-project/secrets/my-secret/versions/1 \
    --remote-npm-repo=NPMJS

Python

gcloud artifacts repositories create REMOTE-REPOSITORY-NAME \
    --project=PROJECT_ID \
    --repository-format=python \
    --location=LOCATION \
    --description="DESCRIPTION" \
    --mode=remote-repository \
    --remote-repo-config-desc="REMOTE-REPOSITORY-DESCRIPTION" \
    --disable-vulnerability-scanning \
    --remote-python-repo=UPSTREAM

Optionale Flags für die Authentifizierung beim Upstream-Repository:

• --remote-username=USERNAME
• --remote-password-secret-version=SECRET_VERSION

Ersetzen Sie Folgendes:

• REMOTE-REPOSITORY-NAME durch den Namen des Repositorys. Repository-Namen können für jeden Repository-Speicherort in einem Projekt nur einmal vorkommen.
• PROJECT_ID durch die Projekt-ID. Wenn dieses Flag nicht angegeben ist, wird das aktuelle Projekt oder das Standardprojekt verwendet.
• LOCATION durch den regionalen oder multiregionalen Standort für das Repository. Sie können dieses Flag weglassen, wenn Sie einen Standard-Speicherort festgelegt haben. Führen Sie den Befehl gcloud artifacts locations list aus, um eine Liste der unterstützten Speicherorte aufzurufen.
• DESCRIPTION mit einer optionalen Beschreibung des Repositorys. Geben Sie keine vertraulichen Daten an, da Repository-Beschreibungen nicht verschlüsselt werden.
• REMOTE-REPOSITORY-DESCRIPTION durch eine Beschreibung der Konfiguration des externen Repositorys für dieses Remote-Repository.
• USERNAME – optional, wenn Sie die Authentifizierung verwenden, mit Ihrem Nutzernamen für die Authentifizierung beim Upstream-Repository.
• SECRET_VERSION optional, wenn Sie die Authentifizierung verwenden, mit der Secret-Version, die das Passwort für Ihr Upstream-Repository enthält.

• UPSTREAM durch den voreingestellten Upstream-Namen, den Artifact Registry-Repositorypfad oder die benutzerdefinierte URL des Upstream-Repositorys.
  
  Für Artifact Registry-Upstream-Repositories formatieren Sie den Repository-Pfad so: projects/UPSTREAM_PROJECT_ID/locations/REGION/repositories/UPSTREAM_REPOSITORY.
  
  Informationen zu den verfügbaren voreingestellten Upstreams und den unterstützten benutzerdefinierten Upstreams finden Sie unter Unterstützte Formate.

• --disable-vulnerability-scanning: ist ein optionales Flag, mit dem Sie das automatische Scannen auf Sicherheitslücken für Ihr Repository deaktivieren können.

• --allow-vulnerability-scanning: ist ein optionales Flag, das Ihr Repository so konfiguriert, dass das automatische Scannen auf Sicherheitslücken zulässig ist. Weitere Informationen finden Sie unter Automatisches Scannen aktivieren oder deaktivieren.

Mit dem folgenden Befehl wird beispielsweise ein Remote-Repository namens my-repo in der Region us-east1 im Projekt Google Cloud my-project erstellt. Die Authentifizierung beim Upstream-Repository kann mit dem Nutzernamen my-username und der Secret-Version projects/my-project/secrets/my-secret/versions/1 erfolgen.

gcloud artifacts repositories create my-repo \
    --project=my-project \
    --repository-format=python \
    --location=us-east1 \
    --description="Remote Python repository" \
    --mode=remote-repository \
    --remote-repo-config-desc="PyPI" \
    --remote-username=my-username \
    --remote-password-secret-version=projects/my-project/secrets/my-secret/versions/1 \
    --remote-python-repo=PYPI

Apt (Vorschau)

gcloud artifacts repositories create REMOTE_REPOSITORY_NAME \
    --project=PROJECT_ID \
    --repository-format=apt \
    --location=LOCATION \
    --description="DESCRIPTION" \
    --mode=remote-repository \
    --remote-repo-config-desc="REMOTE_REPOSITORY_DESCRIPTION" \
    --remote-apt-repo=APT_REPOSITORY_BASE \
    --remote-apt-repo-path="APT_REPOSITORY_PATH"

Ersetzen Sie Folgendes:

• REMOTE_REPOSITORY_NAME durch den Namen des Repositorys. Repository-Namen können für jeden Repository-Speicherort in einem Projekt nur einmal vorkommen.
• PROJECT_ID durch die Projekt-ID. Wenn dieses Flag nicht angegeben ist, wird das aktuelle Projekt oder das Standardprojekt verwendet.
• LOCATION durch den regionalen oder multiregionalen Standort für das Repository. Sie können dieses Flag weglassen, wenn Sie einen Standard-Speicherort festgelegt haben. Führen Sie den Befehl gcloud artifacts locations list aus, um eine Liste der unterstützten Speicherorte aufzurufen.
• DESCRIPTION mit einer optionalen Beschreibung des Repositorys. Geben Sie keine vertraulichen Daten an, da Repository-Beschreibungen nicht verschlüsselt werden.
• REMOTE_REPOSITORY_DESCRIPTION mit einer optionalen Beschreibung für die Konfiguration des externen Repositorys für dieses Remote-Repository.
• Ersetzen Sie APT_REPOSITORY_BASE durch einen der unterstützten Repository-Basisnamen, die in den unterstützten Upstreams für Betriebssystempakete für Apt-Remote-Repositories aufgeführt sind.
• APT_REPOSITORY_PATH mit dem Rest der URL des Upstream-Repositorys, das Sie nach der Repository-Basis in Ihrem Remote-Repository zwischenspeichern möchten.

Mit dem folgenden Befehl wird beispielsweise ein Remote-Repository mit dem Namen my-repo erstellt, um das Debian Buster-Repository in der Region us-east1 im Projekt Google Cloud my-project zu cachen. Die vollständige URL des Upstream-Repositorys ist http://deb.debian.org/debian/dists/buster.

gcloud artifacts repositories create my-repo \
    --project=my-project \
    --repository-format=apt \
    --location=us-east1 \
    --description="Apt remote repository" \
    --mode=remote-repository \
    --remote-repo-config-desc="Debian buster distribution" \
    --remote-apt-repo=DEBIAN \
    --remote-apt-repo-path="debian/dists/buster"

Yum (Vorschau)

gcloud artifacts repositories create REMOTE_REPOSITORY_NAME \
    --project=PROJECT_ID \
    --repository-format=yum \
    --location=LOCATION \
    --description="DESCRIPTION" \
    --mode=remote-repository \
    --remote-repo-config-desc="REMOTE_REPOSITORY_DESCRIPTION" \
    --remote-yum-repo=YUM_REPOSITORY_BASE \
    --remote-yum-repo-path="YUM_REPOSITORY_PATH"

Ersetzen Sie Folgendes:

• REMOTE_REPOSITORY_NAME durch den Namen des Repositorys. Repository-Namen können für jeden Repository-Speicherort in einem Projekt nur einmal vorkommen.
• PROJECT_ID durch die Projekt-ID. Wenn dieses Flag nicht angegeben ist, wird das aktuelle Projekt oder das Standardprojekt verwendet.
• LOCATION durch den regionalen oder multiregionalen Standort für das Repository. Sie können dieses Flag weglassen, wenn Sie einen Standard-Speicherort festgelegt haben. Führen Sie den Befehl gcloud artifacts locations list aus, um eine Liste der unterstützten Speicherorte aufzurufen.
• DESCRIPTION mit einer optionalen Beschreibung des Repositorys. Geben Sie keine vertraulichen Daten an, da Repository-Beschreibungen nicht verschlüsselt werden.
• REMOTE_REPOSITORY_DESCRIPTION mit einer optionalen Beschreibung für die Konfiguration des externen Repositorys für dieses Remote-Repository.
• Ersetzen Sie YUM_REPOSITORY_BASE durch einen der unterstützten Repository-Basisnamen, die in den unterstützten Upstreams für Betriebssystempakete für Yum-Remote-Repositories aufgeführt sind.
• YUM_REPOSITORY_PATH mit dem Rest der URL des Upstream-Repositorys, das Sie nach der Repository-Basis in Ihrem Remote-Repository zwischenspeichern möchten.

Mit dem folgenden Befehl wird beispielsweise ein Remote-Repository für Yum-Pakete mit dem Namen my-repo in der Region us-east1 im Projekt Google Cloud my-project für das Upstream-Repository 9-stream/BaseOs/x86_64/os erstellt. Die vollständige URL des Repositorys lautet https://mirror.stream.centos.org/9-stream/BaseOS/x86_64/os.

gcloud artifacts repositories create my-repo \
    --project=my-project \
    --repository-format=yum \
    --location=us-east1 \
    --description="Yum remote repository" \
    --mode=remote-repository \
    --remote-repo-config-desc="CentOS 8 x86" \
    --remote-yum-repo=CENTOS_STREAM \
    --remote-yum-repo-path="9-stream/BaseOs/x86_64/os"

Go

Artifact Registry-Go-Remote-Repositories unterstützen nur den öffentlichen Upstream https://proxy.golang.

gcloud artifacts repositories create REMOTE-REPOSITORY-NAME \
    --project=PROJECT_ID \
    --repository-format=go \
    --location=LOCATION \
    --description="DESCRIPTION" \
    --mode=remote-repository \
    --remote-repo-config-desc="REMOTE-REPOSITORY-DESCRIPTION" \
    --remote-go-repo=https://proxy.golang.org

Ersetzen Sie Folgendes:

• REMOTE-REPOSITORY-NAME ist der Name des Repositorys. Repository-Namen können für jeden Repository-Speicherort in einem Projekt nur einmal vorkommen.
• PROJECT_ID ist die Projekt-ID. Wenn dieses Flag nicht angegeben ist, wird das aktuelle Projekt oder das Standardprojekt verwendet.

• LOCATION ist der regionale oder multiregionale Standort für das Repository. Sie können dieses Flag weglassen, wenn Sie einen Standard-Speicherort festgelegt haben. Führen Sie den Befehl gcloud artifacts locations list aus, um eine Liste der unterstützten Speicherorte aufzurufen.

• DESCRIPTION ist eine optionale Beschreibung des Repositorys. Geben Sie keine vertraulichen Daten an, da Repository-Beschreibungen nicht verschlüsselt sind.

• REMOTE-REPOSITORY-DESCRIPTION ist eine Beschreibung der Konfiguration des externen Repositorys für dieses Remote-Repository.

Mit dem folgenden Befehl wird beispielsweise ein Remote-Repository mit dem Namen my-repo in der Region us-east1 im Projekt Google Cloud my-project erstellt.

gcloud artifacts repositories create my-repo \
    --project=my-project \
    --repository-format=go \
    --location=us-east1 \
    --description="Remote Go repository" \
    --mode=remote-repository \
    --remote-repo-config-desc="Go proxy" \
    --remote-go-repo=https://proxy.golang.org

Docker

provider "google" {
    project = "PROJECT-ID"
}

resource "google_artifact_registry_repository" "my-repo" {
  location      = "LOCATION"
  repository_id = "REPOSITORY_ID"
  description   = "DESCRIPTION"
  format        = "docker"
  kms_key_name = "KEY"
  mode          = "REMOTE_REPOSITORY"
  remote_repository_config {
    description = "CONFIG_DESCRIPTION"
    docker_repository {
      public_repository = "DOCKER_HUB"
    }
  }
  cleanup_policy_dry_run = DRY_RUN_STATUS
  cleanup_policies {
    id     = "POLICY_NAME"
    action = "DELETE"
    condition {
      tag_state    = "TAG_STATE"
      tag_prefixes = ["TAG_PREFIX", "TAG_PREFIX_N"]
      older_than   = "TIME_SINCE_UPLOAD"
    }
  }
  cleanup_policies {
    id     = "POLICY_NAME"
    action = "KEEP"
    condition {
      tag_state             = "TAG_STATE"
      tag_prefixes          = ["TAG_PREFIX", "TAG_PREFIX_N"]
      package_name_prefixes = ["PKG_PREFIX", "PKG_PREFIX_N"]
    }
  }
  cleanup_policies {
    id     = "POLICY_NAME"
    action = "KEEP"
    most_recent_versions {
      package_name_prefixes = ["PKG_PREFIX", "PKG_PREFIX_N"]
      keep_count            = KEEP_COUNT
    }
  }
}

Wo

• PROJECT-IDist die Google Cloud Projekt-ID.
• LOCATION ist der Speicherort des Repositorys.
• REPOSITORY_ID ist die Repository-ID.
• DESCRIPTION ist die optionale Beschreibung für das Repository. Geben Sie keine vertraulichen Daten an, da Repository-Beschreibungen nicht verschlüsselt sind.
• KEY ist der Name des Cloud Key Management Service-Schlüssels, wenn Sie für die Verschlüsselung vom Kunden verwaltete Verschlüsselungsschlüssel (Customer-Managed Encryption Keys, CMEK) verwenden. Lassen Sie dieses Argument aus, um die von Google verwaltete Standardeinstellung zu verwenden.
• CONFIG_DESCRIPTIONist die optionale Beschreibung der Remotequelle.
• Mit DRY_RUN_STATUS wird festgelegt, ob Artefakte durch Bereinigungsrichtlinien gelöscht werden oder ob nur protokolliert wird, welche Artefakte gelöscht würden, wenn Bereinigungsrichtlinien für das Repository festgelegt werden. Lassen Sie das Feld weg, wenn Sie dem Repository keine Bereinigungsrichtlinien hinzufügen möchten. * true: Legt die Richtlinien fest, die im Probelaufmodus ausgeführt werden sollen. Im Probelaufmodus werden keine Artefakte gelöscht. * false: wendet die Bereinigungsrichtlinien an. Artefakte werden je nach Richtlinie gelöscht oder beibehalten. Weitere Informationen zu Bereinigungsrichtlinien finden Sie unter Bereinigungsrichtlinien konfigurieren.
  • POLICY_NAME ist der Name der Bereinigungsrichtlinie.
  • TAG_STATE ist der Tag-Status, auf den die Richtlinie angewendet werden soll. Gültige Werte sind tagged, untagged und any. any gilt sowohl für getaggte als auch für nicht getaggte Artefakte. Wenn für ein Repository unveränderliche Tags aktiviert sind, können getaggte Artefakte nicht gelöscht werden.
  • TAG_PREFIX und TAG_PREFIX_N sind Tag-Präfixe, auf die die Richtlinie angewendet werden soll.
  • PKG_PREFIX und PKG_PREFIX_N sind Paketpräfixe, auf die die Richtlinie angewendet werden soll.
  • TIME_SINCE_UPLOAD ist die Zeit seit dem Hochladen einer Artefaktversion in das Repository, angegeben als Dauer. Sie können die Dauer in Sekunden, Minuten, Stunden oder Tagen angeben, indem Sie s, m, h oder d anhängen.
  • KEEP_COUNT ist die Anzahl der Versionen pro Paket eines Artefakts, die in Ihrem Repository beibehalten werden sollen.

Maven

Wenn Sie keine Versionsrichtlinie angeben, erstellt Artifact Registry standardmäßig ein Maven-Repository, in dem sowohl Snapshot- als auch Releaseversionen von Paketen gespeichert werden.

provider "google" {
    project = "PROJECT-ID"
}

resource "google_artifact_registry_repository" "my-repo" {
  location      = "LOCATION"
  repository_id = "REPOSITORY_ID"
  description   = "DESCRIPTION"
  format        = "maven"
  kms_key_name = "KEY"
  mode          = "REMOTE_REPOSITORY"
  remote_repository_config {
    description = "CONFIG_DESCRIPTION"
    maven_repository {
      public_repository = "MAVEN_CENTRAL"
    }
  }
  cleanup_policy_dry_run = DRY_RUN_STATUS
  cleanup_policies {
    id     = "POLICY_NAME"
    action = "DELETE"
    condition {
      tag_state    = "TAG_STATE"
      tag_prefixes = ["TAG_PREFIX", "TAG_PREFIX_N"]
      older_than   = "TIME_SINCE_UPLOAD"
    }
  }
  cleanup_policies {
    id     = "POLICY_NAME"
    action = "KEEP"
    condition {
      tag_state             = "TAG_STATE"
      tag_prefixes          = ["TAG_PREFIX", "TAG_PREFIX_N"]
      package_name_prefixes = ["PKG_PREFIX", "PKG_PREFIX_N"]
    }
  }
  cleanup_policies {
    id     = "POLICY_NAME"
    action = "KEEP"
    most_recent_versions {
      package_name_prefixes = ["PKG_PREFIX", "PKG_PREFIX_N"]
      keep_count            = KEEP_COUNT
    }
  }
}

Wo

• PROJECT-IDist die Google Cloud Projekt-ID.
• LOCATION ist der Speicherort des Repositorys.
• REPOSITORY_ID ist die Repository-ID.
• DESCRIPTION ist die optionale Beschreibung für das Repository. Geben Sie keine vertraulichen Daten an, da Repository-Beschreibungen nicht verschlüsselt sind.
• KEY ist der Name des Cloud Key Management Service-Schlüssels, wenn Sie für die Verschlüsselung vom Kunden verwaltete Verschlüsselungsschlüssel (Customer-Managed Encryption Keys, CMEK) verwenden. Lassen Sie dieses Argument aus, um die von Google verwaltete Standardeinstellung zu verwenden.
• CONFIG_DESCRIPTIONist die optionale Beschreibung der Remotequelle.
• Mit DRY_RUN_STATUS wird festgelegt, ob Artefakte durch Bereinigungsrichtlinien gelöscht werden oder ob nur protokolliert wird, welche Artefakte gelöscht würden, wenn Bereinigungsrichtlinien für das Repository festgelegt werden. Lassen Sie das Feld weg, wenn Sie dem Repository keine Bereinigungsrichtlinien hinzufügen möchten. * true: Legt die Richtlinien fest, die im Probelaufmodus ausgeführt werden sollen. Im Probelaufmodus werden keine Artefakte gelöscht. * false: wendet die Bereinigungsrichtlinien an. Artefakte werden je nach Richtlinie gelöscht oder beibehalten. Weitere Informationen zu Bereinigungsrichtlinien finden Sie unter Bereinigungsrichtlinien konfigurieren.
  • POLICY_NAME ist der Name der Bereinigungsrichtlinie.
  • TAG_STATE ist der Tag-Status, auf den die Richtlinie angewendet werden soll. Gültige Werte sind tagged, untagged und any. any gilt sowohl für getaggte als auch für nicht getaggte Artefakte. Wenn für ein Repository unveränderliche Tags aktiviert sind, können getaggte Artefakte nicht gelöscht werden.
  • TAG_PREFIX und TAG_PREFIX_N sind Tag-Präfixe, auf die die Richtlinie angewendet werden soll.
  • PKG_PREFIX und PKG_PREFIX_N sind Paketpräfixe, auf die die Richtlinie angewendet werden soll.
  • TIME_SINCE_UPLOAD ist die Zeit seit dem Hochladen einer Artefaktversion in das Repository, angegeben als Dauer. Sie können die Dauer in Sekunden, Minuten, Stunden oder Tagen angeben, indem Sie s, m, h oder d anhängen.
  • KEEP_COUNT ist die Anzahl der Versionen pro Paket eines Artefakts, die in Ihrem Repository beibehalten werden sollen.

Wenn Sie Snapshot- und Releaseversionen in verschiedenen Repositorys speichern möchten, geben Sie mit einem maven_config-Block eine Versionsrichtlinie für das Repository an. Dieser Block unterstützt die folgenden Einstellungen:

• Mit version_policy wird die Versionsrichtlinie mit einem der folgenden Werte festgelegt:
  • VERSION_POLICY_UNSPECIFIED: Snapshot- und Release-Pakete speichern. Dies ist die Standardeinstellung.
  • RELEASE: Nur Store-Releasepakete.
  • SNAPSHOT: Nur Snapshot-Pakete speichern.
• Mit allow_snapshot_overwrites wird ein Repository mit einer SNAPSHOT-Versionsrichtlinie konfiguriert, um nicht eindeutige Snapshots zu akzeptieren, die vorhandene Versionen im Repository überschreiben.

Im folgenden Beispiel wird ein Maven-Repository mit einer Richtlinie für Release-Versionen definiert.

provider "google" {
project = "my-project"
}

resource "google_artifact_registry_repository" "my-repo" {
provider = google-beta

location = "LOCATION"
repository_id = "my-repo"
description = "Maven repository"
format = "MAVEN"
mode = "REMOTE_REPOSITORY"
maven_config {
  version_policy = "RELEASE"
}
}

npm

provider "google" {
    project = "PROJECT-ID"
}

resource "google_artifact_registry_repository" "my-repo" {
  location      = "LOCATION"
  repository_id = "REPOSITORY_ID"
  description   = "DESCRIPTION"
  format        = "npm"
  kms_key_name = "KEY"
  mode          = "REMOTE_REPOSITORY"
  remote_repository_config {
    description = "CONFIG_DESCRIPTION"
    npm_repository {
      public_repository = "NPMJS"
    }
  }
  cleanup_policy_dry_run = DRY_RUN_STATUS
  cleanup_policies {
    id     = "POLICY_NAME"
    action = "DELETE"
    condition {
      tag_state    = "TAG_STATE"
      tag_prefixes = ["TAG_PREFIX", "TAG_PREFIX_N"]
      older_than   = "TIME_SINCE_UPLOAD"
    }
  }
  cleanup_policies {
    id     = "POLICY_NAME"
    action = "KEEP"
    condition {
      tag_state             = "TAG_STATE"
      tag_prefixes          = ["TAG_PREFIX", "TAG_PREFIX_N"]
      package_name_prefixes = ["PKG_PREFIX", "PKG_PREFIX_N"]
    }
  }
  cleanup_policies {
    id     = "POLICY_NAME"
    action = "KEEP"
    most_recent_versions {
      package_name_prefixes = ["PKG_PREFIX", "PKG_PREFIX_N"]
      keep_count            = KEEP_COUNT
    }
  }
}

Wo

• PROJECT-IDist die Google Cloud Projekt-ID.
• LOCATION ist der Speicherort des Repositorys.
• REPOSITORY_ID ist die Repository-ID.
• DESCRIPTION ist die optionale Beschreibung für das Repository. Geben Sie keine vertraulichen Daten an, da Repository-Beschreibungen nicht verschlüsselt sind.
• KEY ist der Name des Cloud Key Management Service-Schlüssels, wenn Sie für die Verschlüsselung vom Kunden verwaltete Verschlüsselungsschlüssel (Customer-Managed Encryption Keys, CMEK) verwenden. Lassen Sie dieses Argument aus, um die von Google verwaltete Standardeinstellung zu verwenden.
• CONFIG_DESCRIPTIONist die optionale Beschreibung der Remotequelle.
• Mit DRY_RUN_STATUS wird festgelegt, ob Artefakte durch Bereinigungsrichtlinien gelöscht werden oder ob nur protokolliert wird, welche Artefakte gelöscht würden, wenn Bereinigungsrichtlinien für das Repository festgelegt werden. Lassen Sie das Feld weg, wenn Sie dem Repository keine Bereinigungsrichtlinien hinzufügen möchten. * true: Legt die Richtlinien fest, die im Probelaufmodus ausgeführt werden sollen. Im Probelaufmodus werden keine Artefakte gelöscht. * false: wendet die Bereinigungsrichtlinien an. Artefakte werden je nach Richtlinie gelöscht oder beibehalten. Weitere Informationen zu Bereinigungsrichtlinien finden Sie unter Bereinigungsrichtlinien konfigurieren.
  • POLICY_NAME ist der Name der Bereinigungsrichtlinie.
  • TAG_STATE ist der Tag-Status, auf den die Richtlinie angewendet werden soll. Gültige Werte sind tagged, untagged und any. any gilt sowohl für getaggte als auch für nicht getaggte Artefakte. Wenn für ein Repository unveränderliche Tags aktiviert sind, können getaggte Artefakte nicht gelöscht werden.
  • TAG_PREFIX und TAG_PREFIX_N sind Tag-Präfixe, auf die die Richtlinie angewendet werden soll.
  • PKG_PREFIX und PKG_PREFIX_N sind Paketpräfixe, auf die die Richtlinie angewendet werden soll.
  • TIME_SINCE_UPLOAD ist die Zeit seit dem Hochladen einer Artefaktversion in das Repository, angegeben als Dauer. Sie können die Dauer in Sekunden, Minuten, Stunden oder Tagen angeben, indem Sie s, m, h oder d anhängen.
  • KEEP_COUNT ist die Anzahl der Versionen pro Paket eines Artefakts, die in Ihrem Repository beibehalten werden sollen.

Python

provider "google" {
    project = "PROJECT-ID"
}

resource "google_artifact_registry_repository" "my-repo" {
  location      = "LOCATION"
  repository_id = "REPOSITORY_ID"
  description   = "DESCRIPTION"
  format        = "python"
  kms_key_name = "KEY"
  mode          = "REMOTE_REPOSITORY"
  remote_repository_config {
    description = "CONFIG_DESCRIPTION"
    python_repository {
      public_repository = "PYPI"
    }
  }
  cleanup_policy_dry_run = DRY_RUN_STATUS
  cleanup_policies {
    id     = "POLICY_NAME"
    action = "DELETE"
    condition {
      tag_state    = "TAG_STATE"
      tag_prefixes = ["TAG_PREFIX", "TAG_PREFIX_N"]
      older_than   = "TIME_SINCE_UPLOAD"
    }
  }
  cleanup_policies {
    id     = "POLICY_NAME"
    action = "KEEP"
    condition {
      tag_state             = "TAG_STATE"
      tag_prefixes          = ["TAG_PREFIX", "TAG_PREFIX_N"]
      package_name_prefixes = ["PKG_PREFIX", "PKG_PREFIX_N"]
    }
  }
  cleanup_policies {
    id     = "POLICY_NAME"
    action = "KEEP"
    most_recent_versions {
      package_name_prefixes = ["PKG_PREFIX", "PKG_PREFIX_N"]
      keep_count            = KEEP_COUNT
    }
  }
}

Wo

• PROJECT-IDist die Google Cloud Projekt-ID.
• LOCATION ist der Speicherort des Repositorys.
• REPOSITORY_ID ist die Repository-ID.
• DESCRIPTION ist die optionale Beschreibung für das Repository. Geben Sie keine vertraulichen Daten an, da Repository-Beschreibungen nicht verschlüsselt sind.
• KEY ist der Name des Cloud Key Management Service-Schlüssels, wenn Sie für die Verschlüsselung vom Kunden verwaltete Verschlüsselungsschlüssel (Customer-Managed Encryption Keys, CMEK) verwenden. Lassen Sie dieses Argument aus, um die von Google verwaltete Standardeinstellung zu verwenden.
• CONFIG_DESCRIPTIONist die optionale Beschreibung der Remotequelle.
• Mit DRY_RUN_STATUS wird festgelegt, ob Artefakte durch Bereinigungsrichtlinien gelöscht werden oder ob nur protokolliert wird, welche Artefakte gelöscht würden, wenn Bereinigungsrichtlinien für das Repository festgelegt werden. Lassen Sie das Feld weg, wenn Sie dem Repository keine Bereinigungsrichtlinien hinzufügen möchten. * true: Legt die Richtlinien fest, die im Probelaufmodus ausgeführt werden sollen. Im Probelaufmodus werden keine Artefakte gelöscht. * false: wendet die Bereinigungsrichtlinien an. Artefakte werden je nach Richtlinie gelöscht oder beibehalten. Weitere Informationen zu Bereinigungsrichtlinien finden Sie unter Bereinigungsrichtlinien konfigurieren.
  • POLICY_NAME ist der Name der Bereinigungsrichtlinie.
  • TAG_STATE ist der Tag-Status, auf den die Richtlinie angewendet werden soll. Gültige Werte sind tagged, untagged und any. any gilt sowohl für getaggte als auch für nicht getaggte Artefakte. Wenn für ein Repository unveränderliche Tags aktiviert sind, können getaggte Artefakte nicht gelöscht werden.
  • TAG_PREFIX und TAG_PREFIX_N sind Tag-Präfixe, auf die die Richtlinie angewendet werden soll.
  • PKG_PREFIX und PKG_PREFIX_N sind Paketpräfixe, auf die die Richtlinie angewendet werden soll.
  • TIME_SINCE_UPLOAD ist die Zeit seit dem Hochladen einer Artefaktversion in das Repository, angegeben als Dauer. Sie können die Dauer in Sekunden, Minuten, Stunden oder Tagen angeben, indem Sie s, m, h oder d anhängen.
  • KEEP_COUNT ist die Anzahl der Versionen pro Paket eines Artefakts, die in Ihrem Repository beibehalten werden sollen.

Apt (Vorschau)

  provider "google" {
  project = "PROJECT_ID"
}

resource "google_artifact_registry_repository" "my-repo" {
  location      = "LOCATION"
  repository_id = "REPOSITORY_ID"
  description   = "DESCRIPTION"
  format        = "APT"
  mode          = "REMOTE_REPOSITORY"
  remote_repository_config {
    description = "CONFIG_DESCRIPTION"
    apt_repository {
      public_repository {
        repository_base = "REPOSITORY_BASE"
        repository_path = "REPOSITORY_PATH"
      }
    }
  }
}

Wo

• PROJECT-ID ist die Google Cloud Projekt-ID.
• LOCATION ist der Speicherort des Repositorys.
• REPOSITORY_ID ist die Repository-ID.
• DESCRIPTION ist die optionale Beschreibung für das Repository. Geben Sie keine vertraulichen Daten an, da Repository-Beschreibungen nicht verschlüsselt werden.
• CONFIG_DESCRIPTION ist die optionale Beschreibung der Remotequelle.
• REPOSITORY_BASE ist die voreingestellte öffentliche Repository-Basis für Apt. Mögliche Werte sind DEBIAN und UBUNTU.
• REPOSITORY_PATH ist das spezifische Repository aus der Basis. Beispiel: debian/dists/buster.

Yum (Vorabversion)

  provider "google" {
  project = "PROJECT_ID"
}

resource "google_artifact_registry_repository" "my-repo" {
  location      = "LOCATION"
  repository_id = "REPOSITORY_ID"
  description   = "DESCRIPTION"
  format        = "YUM"
  mode          = "REMOTE_REPOSITORY"
  remote_repository_config {
    description = "CONFIG_DESCRIPTION"
    yum_repository {
      public_repository {
        repository_base = "REPOSITORY_BASE"
        repository_path = "REPOSITORY_PATH"
      }
    }
  }
}

Wo

• PROJECT-ID ist die Google Cloud Projekt-ID.
• LOCATION ist der Speicherort des Repositorys.
• REPOSITORY_ID ist die Repository-ID.
• DESCRIPTION ist die optionale Beschreibung für das Repository. Geben Sie keine vertraulichen Daten an, da Repository-Beschreibungen nicht verschlüsselt werden.
• CONFIG_DESCRIPTION ist die optionale Beschreibung der Remotequelle.
• REPOSITORY_BASE ist die voreingestellte öffentliche Repository-Basis für Yum. Mögliche Werte sind CENTOS, CENTOS_DEBUG, CENTOS_VAULT, CENTOS_STREAM, ROCKY und EPEL.
• REPOSITORY_PATH ist das spezifische Repository aus der Basis. Beispiel: "centos/8-stream/BaseOS/x86_64/os.