Créer des dépôts distants

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

Indicateurs facultatifs pour l'authentification auprès du dépôt en amont :

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

Remplacez les éléments suivants :

• REMOTE-REPOSITORY-NAME par le nom du dépôt. Pour chaque emplacement de dépôt d'un projet, les noms de dépôt doivent être uniques.
• PROJECT_ID par l'ID du projet. Si cette option est ignorée, le projet en cours ou par défaut est utilisé.
• LOCATION avec l'emplacement régional ou multirégional du dépôt. Vous pouvez ignorer cette option si vous définissez une valeur par défaut. Pour afficher la liste des emplacements acceptés, exécutez la commande gcloud artifacts locations list.
• DESCRIPTION avec une description facultative du dépôt. N'incluez pas de données sensibles, car les descriptions des dépôts ne sont pas chiffrées.
• REMOTE-REPOSITORY-DESCRIPTION avec une description de la configuration du dépôt externe pour ce dépôt distant.
• USERNAME (facultatif) si vous utilisez l'authentification, avec votre nom d'utilisateur pour l'authentification auprès du dépôt en amont.
• SECRET_VERSION (facultatif) si vous utilisez l'authentification, avec la version secrète contenant le mot de passe de votre dépôt en amont.

• UPSTREAM par le nom prédéfini en amont, le chemin d'accès au dépôt Artifact Registry ou l'URL définie par l'utilisateur du dépôt en amont.
  
  Pour les dépôts en amont Artifact Registry, mettez en forme le chemin d'accès au dépôt comme suit : projects/UPSTREAM_PROJECT_ID/locations/REGION/repositories/UPSTREAM_REPOSITORY.
  
  Pour en savoir plus sur les flux en amont prédéfinis disponibles et les flux en amont définis par l'utilisateur compatibles, consultez Formats acceptés.

• --disable-vulnerability-scanning : option facultative qui configure votre dépôt pour désactiver l'analyse automatique des failles.

• --allow-vulnerability-scanning : option facultative qui configure votre dépôt pour autoriser l'analyse automatique des failles. Pour en savoir plus, consultez Activer ou désactiver l'analyse automatique.

Par exemple, la commande suivante crée un dépôt distant nommé my-repo dans la région us-east1 du projet Google Cloud my-project et peut s'authentifier auprès du dépôt en amont à l'aide du nom d'utilisateur my-username et de la version secrète projects/my-project/secrets/my-secret/versions/1.

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

Pour en savoir plus sur l'authentification auprès des dépôts en amont Docker Hub, consultez Configurer l'authentification des dépôts distants auprès de Docker Hub.

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

Indicateurs facultatifs pour l'authentification auprès du dépôt en amont :

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

Remplacez les éléments suivants :

• REMOTE-REPOSITORY-NAME par le nom du dépôt. Pour chaque emplacement de dépôt d'un projet, les noms de dépôt doivent être uniques.
• PROJECT_ID par l'ID du projet. Si cette option est ignorée, le projet en cours ou par défaut est utilisé.
• LOCATION avec l'emplacement régional ou multirégional du dépôt. Vous pouvez ignorer cette option si vous définissez une valeur par défaut. Pour afficher la liste des emplacements acceptés, exécutez la commande gcloud artifacts locations list.
• DESCRIPTION avec une description facultative du dépôt. N'incluez pas de données sensibles, car les descriptions des dépôts ne sont pas chiffrées.
• REMOTE-REPOSITORY-DESCRIPTION avec une description de la configuration du dépôt externe pour ce dépôt distant.
• USERNAME (facultatif) si vous utilisez l'authentification, avec votre nom d'utilisateur pour l'authentification auprès du dépôt en amont.
• SECRET_VERSION (facultatif) si vous utilisez l'authentification, avec la version secrète contenant le mot de passe de votre dépôt en amont.

• UPSTREAM par le nom prédéfini en amont, le chemin d'accès au dépôt Artifact Registry ou l'URL définie par l'utilisateur du dépôt en amont.
  
  Pour les dépôts en amont Artifact Registry, mettez en forme le chemin d'accès au dépôt comme suit : projects/UPSTREAM_PROJECT_ID/locations/REGION/repositories/UPSTREAM_REPOSITORY.
  
  Pour en savoir plus sur les flux en amont prédéfinis disponibles et les flux en amont définis par l'utilisateur compatibles, consultez Formats acceptés.

• --disable-vulnerability-scanning : option facultative qui configure votre dépôt pour désactiver l'analyse automatique des failles.

• --allow-vulnerability-scanning : option facultative qui configure votre dépôt pour autoriser l'analyse automatique des failles. Pour en savoir plus, consultez Activer ou désactiver l'analyse automatique.

Par exemple, la commande suivante crée un dépôt distant nommé my-repo dans la région us-east1 du projet Google Cloud my-project et peut s'authentifier auprès du dépôt en amont à l'aide du nom d'utilisateur my-username et de la version secrète projects/my-project/secrets/my-secret/versions/1.

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

Indicateurs facultatifs pour l'authentification auprès du dépôt en amont :

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

Remplacez les éléments suivants :

• REMOTE-REPOSITORY-NAME par le nom du dépôt. Pour chaque emplacement de dépôt d'un projet, les noms de dépôt doivent être uniques.
• PROJECT_ID par l'ID du projet. Si cette option est ignorée, le projet en cours ou par défaut est utilisé.
• LOCATION avec l'emplacement régional ou multirégional du dépôt. Vous pouvez ignorer cette option si vous définissez une valeur par défaut. Pour afficher la liste des emplacements acceptés, exécutez la commande gcloud artifacts locations list.
• DESCRIPTION avec une description facultative du dépôt. N'incluez pas de données sensibles, car les descriptions des dépôts ne sont pas chiffrées.
• REMOTE-REPOSITORY-DESCRIPTION avec une description de la configuration du dépôt externe pour ce dépôt distant.
• USERNAME (facultatif) si vous utilisez l'authentification, avec votre nom d'utilisateur pour l'authentification auprès du dépôt en amont.
• SECRET_VERSION (facultatif) si vous utilisez l'authentification, avec la version secrète contenant le mot de passe de votre dépôt en amont.

• UPSTREAM par le nom prédéfini en amont, le chemin d'accès au dépôt Artifact Registry ou l'URL définie par l'utilisateur du dépôt en amont.
  
  Pour les dépôts en amont Artifact Registry, mettez en forme le chemin d'accès au dépôt comme suit : projects/UPSTREAM_PROJECT_ID/locations/REGION/repositories/UPSTREAM_REPOSITORY.
  
  Pour en savoir plus sur les flux en amont prédéfinis disponibles et les flux en amont définis par l'utilisateur compatibles, consultez Formats acceptés.

• --disable-vulnerability-scanning : option facultative qui configure votre dépôt pour désactiver l'analyse automatique des failles.

• --allow-vulnerability-scanning : option facultative qui configure votre dépôt pour autoriser l'analyse automatique des failles. Pour en savoir plus, consultez Activer ou désactiver l'analyse automatique.

Par exemple, la commande suivante crée un dépôt distant nommé my-repo dans la région us-east1 du projet Google Cloud my-project et peut s'authentifier auprès du dépôt en amont à l'aide du nom d'utilisateur my-username et de la version secrète projects/my-project/secrets/my-secret/versions/1.

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

Indicateurs facultatifs pour l'authentification auprès du dépôt en amont :

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

Remplacez les éléments suivants :

• REMOTE-REPOSITORY-NAME par le nom du dépôt. Pour chaque emplacement de dépôt d'un projet, les noms de dépôt doivent être uniques.
• PROJECT_ID par l'ID du projet. Si cette option est ignorée, le projet en cours ou par défaut est utilisé.
• LOCATION avec l'emplacement régional ou multirégional du dépôt. Vous pouvez ignorer cette option si vous définissez une valeur par défaut. Pour afficher la liste des emplacements acceptés, exécutez la commande gcloud artifacts locations list.
• DESCRIPTION avec une description facultative du dépôt. N'incluez pas de données sensibles, car les descriptions des dépôts ne sont pas chiffrées.
• REMOTE-REPOSITORY-DESCRIPTION avec une description de la configuration du dépôt externe pour ce dépôt distant.
• USERNAME (facultatif) si vous utilisez l'authentification, avec votre nom d'utilisateur pour l'authentification auprès du dépôt en amont.
• SECRET_VERSION (facultatif) si vous utilisez l'authentification, avec la version secrète contenant le mot de passe de votre dépôt en amont.

• UPSTREAM par le nom prédéfini en amont, le chemin d'accès au dépôt Artifact Registry ou l'URL définie par l'utilisateur du dépôt en amont.
  
  Pour les dépôts en amont Artifact Registry, mettez en forme le chemin d'accès au dépôt comme suit : projects/UPSTREAM_PROJECT_ID/locations/REGION/repositories/UPSTREAM_REPOSITORY.
  
  Pour en savoir plus sur les flux en amont prédéfinis disponibles et les flux en amont définis par l'utilisateur compatibles, consultez Formats acceptés.

• --disable-vulnerability-scanning : option facultative qui configure votre dépôt pour désactiver l'analyse automatique des failles.

• --allow-vulnerability-scanning : option facultative qui configure votre dépôt pour autoriser l'analyse automatique des failles. Pour en savoir plus, consultez Activer ou désactiver l'analyse automatique.

Par exemple, la commande suivante crée un dépôt distant nommé my-repo dans la région us-east1 du projet Google Cloud my-project et peut s'authentifier auprès du dépôt en amont à l'aide du nom d'utilisateur my-username et de la version secrète projects/my-project/secrets/my-secret/versions/1.

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 (preview)

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"

Remplacez les éléments suivants :

• REMOTE_REPOSITORY_NAME par le nom du dépôt. Pour chaque emplacement de dépôt d'un projet, les noms de dépôt doivent être uniques.
• PROJECT_ID par l'ID du projet. Si cette option est ignorée, le projet en cours ou par défaut est utilisé.
• LOCATION avec l'emplacement régional ou multirégional du dépôt. Vous pouvez ignorer cette option si vous définissez une valeur par défaut. Pour afficher la liste des emplacements acceptés, exécutez la commande gcloud artifacts locations list.
• DESCRIPTION avec une description facultative du dépôt. N'incluez pas de données sensibles, car les descriptions des dépôts ne sont pas chiffrées.
• REMOTE_REPOSITORY_DESCRIPTION avec une description facultative de la configuration du dépôt externe pour ce dépôt distant.
• APT_REPOSITORY_BASE avec l'un des noms de base de dépôt compatibles listés dans les sources en amont compatibles avec les packages OS pour les dépôts Apt à distance.
• APT_REPOSITORY_PATH avec le reste de l'URL du dépôt en amont que vous souhaitez mettre en cache dans votre dépôt distant après la base du dépôt.

Par exemple, la commande suivante crée un dépôt distant nommé my-repo pour mettre en cache le dépôt Debian buster dans la région us-east1 du projet Google Cloud my-project. L'URL complète du dépôt en amont est 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 (preview)

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"

Remplacez les éléments suivants :

• REMOTE_REPOSITORY_NAME par le nom du dépôt. Pour chaque emplacement de dépôt d'un projet, les noms de dépôt doivent être uniques.
• PROJECT_ID par l'ID du projet. Si cette option est ignorée, le projet en cours ou par défaut est utilisé.
• LOCATION avec l'emplacement régional ou multirégional du dépôt. Vous pouvez ignorer cette option si vous définissez une valeur par défaut. Pour afficher la liste des emplacements acceptés, exécutez la commande gcloud artifacts locations list.
• DESCRIPTION avec une description facultative du dépôt. N'incluez pas de données sensibles, car les descriptions des dépôts ne sont pas chiffrées.
• REMOTE_REPOSITORY_DESCRIPTION avec une description facultative de la configuration du dépôt externe pour ce dépôt distant.
• Remplacez YUM_REPOSITORY_BASE par l'un des noms de base de dépôt compatibles listés dans Upstreams compatibles avec les packages OS pour les dépôts distants Yum.
• YUM_REPOSITORY_PATH avec le reste de l'URL du dépôt en amont que vous souhaitez mettre en cache dans votre dépôt distant après la base du dépôt.

Par exemple, la commande suivante crée un dépôt distant pour les packages Yum nommé my-repo dans la région us-east1 du projet Google Cloud pour le dépôt en amont 9-stream/BaseOs/x86_64/os.my-project L'URL complète du dépôt est 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

Les dépôts distants Go Artifact Registry ne sont compatibles qu'avec le https://proxy.golang public en amont.

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

Remplacez les éléments suivants :

• REMOTE-REPOSITORY-NAME est le nom du dépôt. Pour chaque emplacement de dépôt d'un projet, les noms de dépôt doivent être uniques.
• PROJECT_ID est l'ID de projet. Si cette option est ignorée, le projet en cours ou par défaut est utilisé.

• LOCATION est l'emplacement régional ou multirégional du dépôt. Vous pouvez ignorer cette option si vous définissez une valeur par défaut. Pour afficher la liste des emplacements acceptés, exécutez la commande gcloud artifacts locations list.

• DESCRIPTION est une description facultative du dépôt. N'incluez pas de données sensibles, car les descriptions de dépôt ne sont pas chiffrées.

• REMOTE-REPOSITORY-DESCRIPTION est une description de la configuration du dépôt externe pour ce dépôt distant.

Par exemple, la commande suivante crée un dépôt distant nommé my-repo dans la région us-east1 du projet Google Cloud my-project.

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
    }
  }
}

Où

• PROJECT-IDest l'ID du projet Google Cloud .
• LOCATION est l'emplacement du dépôt.
• REPOSITORY_ID est l'ID du dépôt.
• DESCRIPTION est la description facultative du dépôt. N'incluez pas de données sensibles, car les descriptions des dépôts ne sont pas chiffrées.
• KEY est le nom de la clé Cloud Key Management Service si vous utilisez des clés de chiffrement gérées par le client (CMEK) pour le chiffrement. Omettez cet argument pour utiliser le paramètre par défaut, à savoir les clés de chiffrement gérées par Google.
• CONFIG_DESCRIPTION est la description facultative de la source distante.
• DRY_RUN_STATUS détermine si les règles de nettoyage suppriment les artefacts ou enregistrent uniquement ceux qui seraient supprimés si des règles de nettoyage étaient définies dans le dépôt. Omettez ce champ si vous ne souhaitez pas ajouter de règles de nettoyage au dépôt. * true : définit les règles à exécuter en mode de simulation. Aucun artefact n'est supprimé en mode de simulation. * false : applique les règles de nettoyage. Les artefacts sont supprimés ou conservés en fonction des règles. Pour en savoir plus sur les règles de nettoyage, consultez Configurer des règles de nettoyage.
  • POLICY_NAME est le nom de la règle de nettoyage.
  • TAG_STATE correspond à l'état du tag auquel appliquer la règle. Les valeurs sont tagged, untagged et any. any s'applique aux artefacts tagués et non tagués. Si les tags immuables sont activés pour un dépôt, les artefacts tagués ne peuvent pas être supprimés.
  • TAG_PREFIX et TAG_PREFIX_N sont des préfixes de tag auxquels appliquer la règle.
  • PKG_PREFIX et PKG_PREFIX_N sont des préfixes de package auxquels appliquer la règle.
  • TIME_SINCE_UPLOAD correspond au temps écoulé depuis qu'une version d'artefact a été importée dans le dépôt, spécifié sous forme de durée. Vous pouvez spécifier des durées en secondes, minutes, heures ou jours en ajoutant respectivement s, m, h ou d.
  • KEEP_COUNT correspond au nombre de versions par package d'un artefact à conserver dans votre dépôt.

Maven

Si vous ne spécifiez pas de stratégie de version, Artifact Registry crée par défaut un dépôt Maven qui stocke les versions instantané et release des packages.

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
    }
  }
}

Où

• PROJECT-IDest l'ID du projet Google Cloud .
• LOCATION est l'emplacement du dépôt.
• REPOSITORY_ID est l'ID du dépôt.
• DESCRIPTION est la description facultative du dépôt. N'incluez pas de données sensibles, car les descriptions des dépôts ne sont pas chiffrées.
• KEY est le nom de la clé Cloud Key Management Service si vous utilisez des clés de chiffrement gérées par le client (CMEK) pour le chiffrement. Omettez cet argument pour utiliser le paramètre par défaut, à savoir les clés de chiffrement gérées par Google.
• CONFIG_DESCRIPTION est la description facultative de la source distante.
• DRY_RUN_STATUS détermine si les règles de nettoyage suppriment les artefacts ou enregistrent uniquement ceux qui seraient supprimés si des règles de nettoyage étaient définies dans le dépôt. Omettez ce champ si vous ne souhaitez pas ajouter de règles de nettoyage au dépôt. * true : définit les règles à exécuter en mode de simulation. Aucun artefact n'est supprimé en mode de simulation. * false : applique les règles de nettoyage. Les artefacts sont supprimés ou conservés en fonction des règles. Pour en savoir plus sur les règles de nettoyage, consultez Configurer des règles de nettoyage.
  • POLICY_NAME est le nom de la règle de nettoyage.
  • TAG_STATE correspond à l'état du tag auquel appliquer la règle. Les valeurs sont tagged, untagged et any. any s'applique aux artefacts tagués et non tagués. Si les tags immuables sont activés pour un dépôt, les artefacts tagués ne peuvent pas être supprimés.
  • TAG_PREFIX et TAG_PREFIX_N sont des préfixes de tag auxquels appliquer la règle.
  • PKG_PREFIX et PKG_PREFIX_N sont des préfixes de package auxquels appliquer la règle.
  • TIME_SINCE_UPLOAD correspond au temps écoulé depuis qu'une version d'artefact a été importée dans le dépôt, spécifié sous forme de durée. Vous pouvez spécifier des durées en secondes, minutes, heures ou jours en ajoutant respectivement s, m, h ou d.
  • KEEP_COUNT correspond au nombre de versions par package d'un artefact à conserver dans votre dépôt.

Pour stocker des versions d'instantanés et des versions dans différents dépôts, spécifiez une règle de version pour le dépôt à l'aide d'un bloc maven_config. Ce bloc accepte les paramètres suivants :

• version_policy définit la stratégie de version avec l'une des valeurs suivantes :
  • VERSION_POLICY_UNSPECIFIED : stocker les packages d'instantané et de version Il s'agit du paramètre par défaut.
  • RELEASE (VERSION) : packages de version uniquement.
  • SNAPSHOT : stocke uniquement les packages d'instantanés.
• allow_snapshot_overwrites configure un dépôt avec une règle de version SNAPSHOT pour accepter les instantanés non uniques qui écrasent les versions existantes dans le dépôt.

L'exemple suivant définit un dépôt Maven avec une règle de version de publication.

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
    }
  }
}

Où

• PROJECT-IDest l'ID du projet Google Cloud .
• LOCATION est l'emplacement du dépôt.
• REPOSITORY_ID est l'ID du dépôt.
• DESCRIPTION est la description facultative du dépôt. N'incluez pas de données sensibles, car les descriptions des dépôts ne sont pas chiffrées.
• KEY est le nom de la clé Cloud Key Management Service si vous utilisez des clés de chiffrement gérées par le client (CMEK) pour le chiffrement. Omettez cet argument pour utiliser le paramètre par défaut, à savoir les clés de chiffrement gérées par Google.
• CONFIG_DESCRIPTION est la description facultative de la source distante.
• DRY_RUN_STATUS détermine si les règles de nettoyage suppriment les artefacts ou enregistrent uniquement ceux qui seraient supprimés si des règles de nettoyage étaient définies dans le dépôt. Omettez ce champ si vous ne souhaitez pas ajouter de règles de nettoyage au dépôt. * true : définit les règles à exécuter en mode de simulation. Aucun artefact n'est supprimé en mode de simulation. * false : applique les règles de nettoyage. Les artefacts sont supprimés ou conservés en fonction des règles. Pour en savoir plus sur les règles de nettoyage, consultez Configurer des règles de nettoyage.
  • POLICY_NAME est le nom de la règle de nettoyage.
  • TAG_STATE correspond à l'état du tag auquel appliquer la règle. Les valeurs sont tagged, untagged et any. any s'applique aux artefacts tagués et non tagués. Si les tags immuables sont activés pour un dépôt, les artefacts tagués ne peuvent pas être supprimés.
  • TAG_PREFIX et TAG_PREFIX_N sont des préfixes de tag auxquels appliquer la règle.
  • PKG_PREFIX et PKG_PREFIX_N sont des préfixes de package auxquels appliquer la règle.
  • TIME_SINCE_UPLOAD correspond au temps écoulé depuis qu'une version d'artefact a été importée dans le dépôt, spécifié sous forme de durée. Vous pouvez spécifier des durées en secondes, minutes, heures ou jours en ajoutant respectivement s, m, h ou d.
  • KEEP_COUNT correspond au nombre de versions par package d'un artefact à conserver dans votre dépôt.

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
    }
  }
}

Où

• PROJECT-IDest l'ID du projet Google Cloud .
• LOCATION est l'emplacement du dépôt.
• REPOSITORY_ID est l'ID du dépôt.
• DESCRIPTION est la description facultative du dépôt. N'incluez pas de données sensibles, car les descriptions des dépôts ne sont pas chiffrées.
• KEY est le nom de la clé Cloud Key Management Service si vous utilisez des clés de chiffrement gérées par le client (CMEK) pour le chiffrement. Omettez cet argument pour utiliser le paramètre par défaut, à savoir les clés de chiffrement gérées par Google.
• CONFIG_DESCRIPTION est la description facultative de la source distante.
• DRY_RUN_STATUS détermine si les règles de nettoyage suppriment les artefacts ou enregistrent uniquement ceux qui seraient supprimés si des règles de nettoyage étaient définies dans le dépôt. Omettez ce champ si vous ne souhaitez pas ajouter de règles de nettoyage au dépôt. * true : définit les règles à exécuter en mode de simulation. Aucun artefact n'est supprimé en mode de simulation. * false : applique les règles de nettoyage. Les artefacts sont supprimés ou conservés en fonction des règles. Pour en savoir plus sur les règles de nettoyage, consultez Configurer des règles de nettoyage.
  • POLICY_NAME est le nom de la règle de nettoyage.
  • TAG_STATE correspond à l'état du tag auquel appliquer la règle. Les valeurs sont tagged, untagged et any. any s'applique aux artefacts tagués et non tagués. Si les tags immuables sont activés pour un dépôt, les artefacts tagués ne peuvent pas être supprimés.
  • TAG_PREFIX et TAG_PREFIX_N sont des préfixes de tag auxquels appliquer la règle.
  • PKG_PREFIX et PKG_PREFIX_N sont des préfixes de package auxquels appliquer la règle.
  • TIME_SINCE_UPLOAD correspond au temps écoulé depuis qu'une version d'artefact a été importée dans le dépôt, spécifié sous forme de durée. Vous pouvez spécifier des durées en secondes, minutes, heures ou jours en ajoutant respectivement s, m, h ou d.
  • KEEP_COUNT correspond au nombre de versions par package d'un artefact à conserver dans votre dépôt.

Apt (preview)

  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"
      }
    }
  }
}

Où

• PROJECT-ID est l'ID du projet Google Cloud .
• LOCATION est l'emplacement du dépôt.
• REPOSITORY_ID est l'ID du dépôt.
• DESCRIPTION est la description facultative du dépôt. N'incluez pas de données sensibles, car les descriptions des dépôts ne sont pas chiffrées.
• CONFIG_DESCRIPTION est la description facultative de la source distante.
• REPOSITORY_BASE est la base de dépôt public prédéfinie pour Apt. Les valeurs possibles sont DEBIAN et UBUNTU.
• REPOSITORY_PATH est le dépôt spécifique de la base. Par exemple, debian/dists/buster.

Yum (preview)

  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"
      }
    }
  }
}

Où

• PROJECT-ID est l'ID du projet Google Cloud .
• LOCATION est l'emplacement du dépôt.
• REPOSITORY_ID est l'ID du dépôt.
• DESCRIPTION est la description facultative du dépôt. N'incluez pas de données sensibles, car les descriptions des dépôts ne sont pas chiffrées.
• CONFIG_DESCRIPTION est la description facultative de la source distante.
• REPOSITORY_BASE est la base de dépôt public prédéfinie pour Yum. Les valeurs possibles sont CENTOS, CENTOS_DEBUG, CENTOS_VAULT, CENTOS_STREAM, ROCKY et EPEL.
• REPOSITORY_PATH est le dépôt spécifique de la base. Par exemple, "centos/8-stream/BaseOS/x86_64/os.