Crear repositorios remotos

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

Marcas opcionales para autenticarte en el repositorio upstream:

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

Haz los cambios siguientes:

• REMOTE-REPOSITORY-NAME con el nombre del repositorio. Los nombres de los repositorios deben ser únicos en cada ubicación de repositorio de un proyecto.
• PROJECT_ID por el ID del proyecto. Si se omite esta marca, se usará el proyecto actual o el predeterminado.
• LOCATION con la ubicación regional o multirregional del repositorio. Puedes omitir esta marca si defines un valor predeterminado. Para ver una lista de las ubicaciones admitidas, ejecuta el comando gcloud artifacts locations list.
• DESCRIPTION con una descripción opcional del repositorio. No incluyas datos sensibles, ya que las descripciones de los repositorios no están cifradas.
• REMOTE-REPOSITORY-DESCRIPTION con una descripción de la configuración del repositorio externo de este repositorio remoto.
• USERNAME Opcionalmente, si usas la autenticación, con tu nombre de usuario para autenticarte en el repositorio upstream.
• SECRET_VERSION opcionalmente, si usas la autenticación, con la versión secreta que contiene la contraseña de tu repositorio upstream.

• UPSTREAM con el nombre predefinido del upstream, la ruta del repositorio de Artifact Registry o la URL definida por el usuario del repositorio upstream.
  
  En el caso de los repositorios upstream de Artifact Registry, el formato de la ruta del repositorio debe ser similar al siguiente: projects/UPSTREAM_PROJECT_ID/locations/REGION/repositories/UPSTREAM_REPOSITORY.
  
  Para obtener información sobre los upstream predefinidos disponibles y los upstream definidos por el usuario admitidos, consulta Formatos admitidos.

• --disable-vulnerability-scanning: es una marca opcional que configura tu repositorio para inhabilitar el análisis automático de vulnerabilidades.

• --allow-vulnerability-scanning: es una marca opcional que configura tu repositorio para permitir el análisis automático de vulnerabilidades. Para obtener más información, consulta Habilitar o inhabilitar el análisis automático.

Por ejemplo, el siguiente comando crea un repositorio remoto llamado my-repo en la región us-east1 del proyecto Google Cloud my-project y puede autenticarse en el repositorio upstream con el nombre de usuario my-username y la versión del secreto 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

Para obtener más información sobre cómo autenticarte en repositorios upstream de Docker Hub, consulta Configurar la autenticación de repositorios remotos en 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

Marcas opcionales para autenticarte en el repositorio upstream:

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

Haz los cambios siguientes:

• REMOTE-REPOSITORY-NAME con el nombre del repositorio. Los nombres de los repositorios deben ser únicos en cada ubicación de repositorio de un proyecto.
• PROJECT_ID por el ID del proyecto. Si se omite esta marca, se usará el proyecto actual o el predeterminado.
• LOCATION con la ubicación regional o multirregional del repositorio. Puedes omitir esta marca si defines un valor predeterminado. Para ver una lista de las ubicaciones admitidas, ejecuta el comando gcloud artifacts locations list.
• DESCRIPTION con una descripción opcional del repositorio. No incluyas datos sensibles, ya que las descripciones de los repositorios no están cifradas.
• REMOTE-REPOSITORY-DESCRIPTION con una descripción de la configuración del repositorio externo de este repositorio remoto.
• USERNAME Opcionalmente, si usas la autenticación, con tu nombre de usuario para autenticarte en el repositorio upstream.
• SECRET_VERSION opcionalmente, si usas la autenticación, con la versión secreta que contiene la contraseña de tu repositorio upstream.

• UPSTREAM con el nombre predefinido del upstream, la ruta del repositorio de Artifact Registry o la URL definida por el usuario del repositorio upstream.
  
  En el caso de los repositorios upstream de Artifact Registry, el formato de la ruta del repositorio debe ser similar al siguiente: projects/UPSTREAM_PROJECT_ID/locations/REGION/repositories/UPSTREAM_REPOSITORY.
  
  Para obtener información sobre los upstream predefinidos disponibles y los upstream definidos por el usuario admitidos, consulta Formatos admitidos.

• --disable-vulnerability-scanning: es una marca opcional que configura tu repositorio para inhabilitar el análisis automático de vulnerabilidades.

• --allow-vulnerability-scanning: es una marca opcional que configura tu repositorio para permitir el análisis automático de vulnerabilidades. Para obtener más información, consulta Habilitar o inhabilitar el análisis automático.

Por ejemplo, el siguiente comando crea un repositorio remoto llamado my-repo en la región us-east1 del proyecto Google Cloud my-project y puede autenticarse en el repositorio upstream con el nombre de usuario my-username y la versión del secreto 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

Marcas opcionales para autenticarte en el repositorio upstream:

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

Haz los cambios siguientes:

• REMOTE-REPOSITORY-NAME con el nombre del repositorio. Los nombres de los repositorios deben ser únicos en cada ubicación de repositorio de un proyecto.
• PROJECT_ID por el ID del proyecto. Si se omite esta marca, se usará el proyecto actual o el predeterminado.
• LOCATION con la ubicación regional o multirregional del repositorio. Puedes omitir esta marca si defines un valor predeterminado. Para ver una lista de las ubicaciones admitidas, ejecuta el comando gcloud artifacts locations list.
• DESCRIPTION con una descripción opcional del repositorio. No incluyas datos sensibles, ya que las descripciones de los repositorios no están cifradas.
• REMOTE-REPOSITORY-DESCRIPTION con una descripción de la configuración del repositorio externo de este repositorio remoto.
• USERNAME Opcionalmente, si usas la autenticación, con tu nombre de usuario para autenticarte en el repositorio upstream.
• SECRET_VERSION opcionalmente, si usas la autenticación, con la versión secreta que contiene la contraseña de tu repositorio upstream.

• UPSTREAM con el nombre predefinido del upstream, la ruta del repositorio de Artifact Registry o la URL definida por el usuario del repositorio upstream.
  
  En el caso de los repositorios upstream de Artifact Registry, el formato de la ruta del repositorio debe ser similar al siguiente: projects/UPSTREAM_PROJECT_ID/locations/REGION/repositories/UPSTREAM_REPOSITORY.
  
  Para obtener información sobre los upstream predefinidos disponibles y los upstream definidos por el usuario admitidos, consulta Formatos admitidos.

• --disable-vulnerability-scanning: es una marca opcional que configura tu repositorio para inhabilitar el análisis automático de vulnerabilidades.

• --allow-vulnerability-scanning: es una marca opcional que configura tu repositorio para permitir el análisis automático de vulnerabilidades. Para obtener más información, consulta Habilitar o inhabilitar el análisis automático.

Por ejemplo, el siguiente comando crea un repositorio remoto llamado my-repo en la región us-east1 del proyecto Google Cloud my-project y puede autenticarse en el repositorio upstream con el nombre de usuario my-username y la versión del secreto 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

Marcas opcionales para autenticarte en el repositorio upstream:

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

Haz los cambios siguientes:

• REMOTE-REPOSITORY-NAME con el nombre del repositorio. Los nombres de los repositorios deben ser únicos en cada ubicación de repositorio de un proyecto.
• PROJECT_ID por el ID del proyecto. Si se omite esta marca, se usará el proyecto actual o el predeterminado.
• LOCATION con la ubicación regional o multirregional del repositorio. Puedes omitir esta marca si defines un valor predeterminado. Para ver una lista de las ubicaciones admitidas, ejecuta el comando gcloud artifacts locations list.
• DESCRIPTION con una descripción opcional del repositorio. No incluyas datos sensibles, ya que las descripciones de los repositorios no están cifradas.
• REMOTE-REPOSITORY-DESCRIPTION con una descripción de la configuración del repositorio externo de este repositorio remoto.
• USERNAME Opcionalmente, si usas la autenticación, con tu nombre de usuario para autenticarte en el repositorio upstream.
• SECRET_VERSION opcionalmente, si usas la autenticación, con la versión secreta que contiene la contraseña de tu repositorio upstream.

• UPSTREAM con el nombre predefinido del upstream, la ruta del repositorio de Artifact Registry o la URL definida por el usuario del repositorio upstream.
  
  En el caso de los repositorios upstream de Artifact Registry, el formato de la ruta del repositorio debe ser similar al siguiente: projects/UPSTREAM_PROJECT_ID/locations/REGION/repositories/UPSTREAM_REPOSITORY.
  
  Para obtener información sobre los upstream predefinidos disponibles y los upstream definidos por el usuario admitidos, consulta Formatos admitidos.

• --disable-vulnerability-scanning: es una marca opcional que configura tu repositorio para inhabilitar el análisis automático de vulnerabilidades.

• --allow-vulnerability-scanning: es una marca opcional que configura tu repositorio para permitir el análisis automático de vulnerabilidades. Para obtener más información, consulta Habilitar o inhabilitar el análisis automático.

Por ejemplo, el siguiente comando crea un repositorio remoto llamado my-repo en la región us-east1 del proyecto Google Cloud my-project y puede autenticarse en el repositorio upstream con el nombre de usuario my-username y la versión del secreto 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 (vista previa)

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"

Haz los cambios siguientes:

• REMOTE_REPOSITORY_NAME con el nombre del repositorio. Los nombres de los repositorios deben ser únicos en cada ubicación de repositorio de un proyecto.
• PROJECT_ID por el ID del proyecto. Si se omite esta marca, se usará el proyecto actual o el predeterminado.
• LOCATION con la ubicación regional o multirregional del repositorio. Puedes omitir esta marca si defines un valor predeterminado. Para ver una lista de las ubicaciones admitidas, ejecuta el comando gcloud artifacts locations list.
• DESCRIPTION con una descripción opcional del repositorio. No incluyas datos sensibles, ya que las descripciones de los repositorios no están cifradas.
• REMOTE_REPOSITORY_DESCRIPTION con una descripción opcional de la configuración del repositorio externo de este repositorio remoto.
• APT_REPOSITORY_BASE con uno de los nombres base de repositorio admitidos que se indican en la sección Paquetes de SO admitidos de fuentes ascendentes de los repositorios remotos de Apt.
• APT_REPOSITORY_PATH con el resto de la URL del repositorio upstream que quieras almacenar en caché en tu repositorio remoto después de la base del repositorio.

Por ejemplo, el siguiente comando crea un repositorio remoto llamado my-repo para almacenar en caché el repositorio de Debian Buster en la región us-east1 del proyecto Google Cloud my-project. La URL completa del repositorio upstream es 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 (vista previa)

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"

Haz los cambios siguientes:

• REMOTE_REPOSITORY_NAME con el nombre del repositorio. Los nombres de los repositorios deben ser únicos en cada ubicación de repositorio de un proyecto.
• PROJECT_ID por el ID del proyecto. Si se omite esta marca, se usará el proyecto actual o el predeterminado.
• LOCATION con la ubicación regional o multirregional del repositorio. Puedes omitir esta marca si defines un valor predeterminado. Para ver una lista de las ubicaciones admitidas, ejecuta el comando gcloud artifacts locations list.
• DESCRIPTION con una descripción opcional del repositorio. No incluyas datos sensibles, ya que las descripciones de los repositorios no están cifradas.
• REMOTE_REPOSITORY_DESCRIPTION con una descripción opcional de la configuración del repositorio externo de este repositorio remoto.
• YUM_REPOSITORY_BASE con uno de los nombres base de repositorio admitidos que se indican en la sección Paquetes de SO admitidos por Yum para repositorios remotos de Yum.
• YUM_REPOSITORY_PATH con el resto de la URL del repositorio upstream que quieras almacenar en caché en tu repositorio remoto después de la base del repositorio.

Por ejemplo, el siguiente comando crea un repositorio remoto para paquetes Yum llamado my-repo en la región us-east1 del proyecto Google Cloud my-project para el repositorio upstream 9-stream/BaseOs/x86_64/os. La URL completa del repositorio es 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

Los repositorios remotos de Go de Artifact Registry solo admiten el upstream público 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

Haz los cambios siguientes:

• REMOTE-REPOSITORY-NAME es el nombre del repositorio. Los nombres de los repositorios deben ser únicos en cada ubicación de repositorio de un proyecto.
• PROJECT_ID es el ID del proyecto. Si se omite esta marca, se usará el proyecto actual o el predeterminado.

• LOCATION es la ubicación regional o multirregional del repositorio. Puedes omitir esta marca si defines un valor predeterminado. Para ver una lista de las ubicaciones admitidas, ejecuta el comando gcloud artifacts locations list.

• DESCRIPTION es una descripción opcional del repositorio. No incluyas datos sensibles, ya que las descripciones de los repositorios no están cifradas.

• REMOTE-REPOSITORY-DESCRIPTION es una descripción de la configuración del repositorio externo de este repositorio remoto.

Por ejemplo, el siguiente comando crea un repositorio remoto llamado my-repo en la región us-east1 del proyecto 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
    }
  }
}

Dónde

• PROJECT-ID es el Google Cloud ID del proyecto.
• LOCATION es la ubicación del repositorio.
• REPOSITORY_ID es el ID del repositorio.
• DESCRIPTIONes la descripción opcional del repositorio. No incluyas datos sensibles, ya que las descripciones de los repositorios no están cifradas.
• KEY es el nombre de la clave de Cloud Key Management Service si usas claves de cifrado gestionadas por el cliente (CMEK) para el cifrado. Omite este argumento para usar el ajuste predeterminado, que son las claves de cifrado gestionadas por Google.
• CONFIG_DESCRIPTIONes la descripción opcional de la fuente remota.
• DRY_RUN_STATUS determina si las políticas de limpieza eliminan artefactos o solo registra qué artefactos se eliminarían si se definieran políticas de limpieza en el repositorio. Omítelo si no quieres añadir políticas de limpieza al repositorio. * true: define las políticas para que se ejecuten en el modo de prueba de funcionamiento. No se elimina ningún artefacto en el modo de prueba. * false: aplica las políticas de limpieza. Los artefactos se eliminan o se conservan en función de las políticas. Para obtener más información sobre las políticas de limpieza, consulta Configurar políticas de limpieza.
  • POLICY_NAME es el nombre de la política de limpieza.
  • TAG_STATE es el estado de la etiqueta al que se aplicará la política. Los valores son tagged, untagged y any. any se aplica tanto a los artefactos etiquetados como a los que no lo están. Si un repositorio tiene habilitadas las etiquetas inmutables, no se pueden eliminar los artefactos etiquetados.
  • TAG_PREFIX y TAG_PREFIX_N son prefijos de etiquetas a los que se aplica la política.
  • PKG_PREFIX y PKG_PREFIX_N son prefijos de paquete para aplicar la política.
  • TIME_SINCE_UPLOAD es el tiempo transcurrido desde que se subió una versión de un artefacto al repositorio, especificado como duración. Puedes especificar duraciones en segundos, minutos, horas o días añadiendo s, m, h o d, respectivamente.
  • KEEP_COUNT es el número de versiones por paquete de un artefacto que se va a conservar en el repositorio.

Maven

Si no especificas una política de versiones, Artifact Registry crea un repositorio de Maven que almacena tanto las versiones de lanzamiento como las de instantánea de los paquetes de forma predeterminada.

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

Dónde

• PROJECT-ID es el Google Cloud ID del proyecto.
• LOCATION es la ubicación del repositorio.
• REPOSITORY_ID es el ID del repositorio.
• DESCRIPTIONes la descripción opcional del repositorio. No incluyas datos sensibles, ya que las descripciones de los repositorios no están cifradas.
• KEY es el nombre de la clave de Cloud Key Management Service si usas claves de cifrado gestionadas por el cliente (CMEK) para el cifrado. Omite este argumento para usar el ajuste predeterminado, que son las claves de cifrado gestionadas por Google.
• CONFIG_DESCRIPTIONes la descripción opcional de la fuente remota.
• DRY_RUN_STATUS determina si las políticas de limpieza eliminan artefactos o solo registra qué artefactos se eliminarían si se definieran políticas de limpieza en el repositorio. Omítelo si no quieres añadir políticas de limpieza al repositorio. * true: define las políticas para que se ejecuten en el modo de prueba de funcionamiento. No se elimina ningún artefacto en el modo de prueba. * false: aplica las políticas de limpieza. Los artefactos se eliminan o se conservan en función de las políticas. Para obtener más información sobre las políticas de limpieza, consulta Configurar políticas de limpieza.
  • POLICY_NAME es el nombre de la política de limpieza.
  • TAG_STATE es el estado de la etiqueta al que se aplicará la política. Los valores son tagged, untagged y any. any se aplica tanto a los artefactos etiquetados como a los que no lo están. Si un repositorio tiene habilitadas las etiquetas inmutables, no se pueden eliminar los artefactos etiquetados.
  • TAG_PREFIX y TAG_PREFIX_N son prefijos de etiquetas a los que se aplica la política.
  • PKG_PREFIX y PKG_PREFIX_N son prefijos de paquete para aplicar la política.
  • TIME_SINCE_UPLOAD es el tiempo transcurrido desde que se subió una versión de un artefacto al repositorio, especificado como duración. Puedes especificar duraciones en segundos, minutos, horas o días añadiendo s, m, h o d, respectivamente.
  • KEEP_COUNT es el número de versiones por paquete de un artefacto que se va a conservar en el repositorio.

Para almacenar versiones de lanzamiento y de instantánea en repositorios diferentes, especifica una política de versiones para el repositorio mediante un bloque maven_config. Este bloque admite los siguientes ajustes:

• version_policy define la política de versiones con uno de los siguientes valores:
  • VERSION_POLICY_UNSPECIFIED: almacena la captura y los paquetes de lanzamiento. Esta es la opción predeterminada.
  • RELEASE: solo paquetes de lanzamiento de la tienda.
  • SNAPSHOT: almacena solo los paquetes de la captura.
• allow_snapshot_overwrites configura un repositorio con una política de versiones SNAPSHOT para aceptar snapshots no únicos que sobrescriban las versiones existentes en el repositorio.

En el siguiente ejemplo se define un repositorio de Maven con una política de versiones de lanzamiento.

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

Dónde

• PROJECT-ID es el Google Cloud ID del proyecto.
• LOCATION es la ubicación del repositorio.
• REPOSITORY_ID es el ID del repositorio.
• DESCRIPTIONes la descripción opcional del repositorio. No incluyas datos sensibles, ya que las descripciones de los repositorios no están cifradas.
• KEY es el nombre de la clave de Cloud Key Management Service si usas claves de cifrado gestionadas por el cliente (CMEK) para el cifrado. Omite este argumento para usar el ajuste predeterminado, que son las claves de cifrado gestionadas por Google.
• CONFIG_DESCRIPTIONes la descripción opcional de la fuente remota.
• DRY_RUN_STATUS determina si las políticas de limpieza eliminan artefactos o solo registra qué artefactos se eliminarían si se definieran políticas de limpieza en el repositorio. Omítelo si no quieres añadir políticas de limpieza al repositorio. * true: define las políticas para que se ejecuten en el modo de prueba de funcionamiento. No se elimina ningún artefacto en el modo de prueba. * false: aplica las políticas de limpieza. Los artefactos se eliminan o se conservan en función de las políticas. Para obtener más información sobre las políticas de limpieza, consulta Configurar políticas de limpieza.
  • POLICY_NAME es el nombre de la política de limpieza.
  • TAG_STATE es el estado de la etiqueta al que se aplicará la política. Los valores son tagged, untagged y any. any se aplica tanto a los artefactos etiquetados como a los que no lo están. Si un repositorio tiene habilitadas las etiquetas inmutables, no se pueden eliminar los artefactos etiquetados.
  • TAG_PREFIX y TAG_PREFIX_N son prefijos de etiquetas a los que se aplica la política.
  • PKG_PREFIX y PKG_PREFIX_N son prefijos de paquete para aplicar la política.
  • TIME_SINCE_UPLOAD es el tiempo transcurrido desde que se subió una versión de un artefacto al repositorio, especificado como duración. Puedes especificar duraciones en segundos, minutos, horas o días añadiendo s, m, h o d, respectivamente.
  • KEEP_COUNT es el número de versiones por paquete de un artefacto que se va a conservar en el repositorio.

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

Dónde

• PROJECT-ID es el Google Cloud ID del proyecto.
• LOCATION es la ubicación del repositorio.
• REPOSITORY_ID es el ID del repositorio.
• DESCRIPTIONes la descripción opcional del repositorio. No incluyas datos sensibles, ya que las descripciones de los repositorios no están cifradas.
• KEY es el nombre de la clave de Cloud Key Management Service si usas claves de cifrado gestionadas por el cliente (CMEK) para el cifrado. Omite este argumento para usar el ajuste predeterminado, que son las claves de cifrado gestionadas por Google.
• CONFIG_DESCRIPTIONes la descripción opcional de la fuente remota.
• DRY_RUN_STATUS determina si las políticas de limpieza eliminan artefactos o solo registra qué artefactos se eliminarían si se definieran políticas de limpieza en el repositorio. Omítelo si no quieres añadir políticas de limpieza al repositorio. * true: define las políticas para que se ejecuten en el modo de prueba de funcionamiento. No se elimina ningún artefacto en el modo de prueba. * false: aplica las políticas de limpieza. Los artefactos se eliminan o se conservan en función de las políticas. Para obtener más información sobre las políticas de limpieza, consulta Configurar políticas de limpieza.
  • POLICY_NAME es el nombre de la política de limpieza.
  • TAG_STATE es el estado de la etiqueta al que se aplicará la política. Los valores son tagged, untagged y any. any se aplica tanto a los artefactos etiquetados como a los que no lo están. Si un repositorio tiene habilitadas las etiquetas inmutables, no se pueden eliminar los artefactos etiquetados.
  • TAG_PREFIX y TAG_PREFIX_N son prefijos de etiquetas a los que se aplica la política.
  • PKG_PREFIX y PKG_PREFIX_N son prefijos de paquete para aplicar la política.
  • TIME_SINCE_UPLOAD es el tiempo transcurrido desde que se subió una versión de un artefacto al repositorio, especificado como duración. Puedes especificar duraciones en segundos, minutos, horas o días añadiendo s, m, h o d, respectivamente.
  • KEEP_COUNT es el número de versiones por paquete de un artefacto que se va a conservar en el repositorio.

Apt (vista previa)

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

Dónde

• PROJECT-ID es el Google Cloud ID del proyecto.
• LOCATION es la ubicación del repositorio.
• REPOSITORY_ID es el ID del repositorio.
• DESCRIPTION es la descripción opcional del repositorio. No incluyas datos sensibles, ya que las descripciones de los repositorios no están cifradas.
• CONFIG_DESCRIPTION es la descripción opcional de la fuente remota.
• REPOSITORY_BASE es el repositorio público predefinido de Apt. Los valores posibles son DEBIAN y UBUNTU.
• REPOSITORY_PATH es el repositorio específico de la base. Por ejemplo, debian/dists/buster.

Yum (vista previa)

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

Dónde

• PROJECT-ID es el Google Cloud ID del proyecto.
• LOCATION es la ubicación del repositorio.
• REPOSITORY_ID es el ID del repositorio.
• DESCRIPTION es la descripción opcional del repositorio. No incluyas datos sensibles, ya que las descripciones de los repositorios no están cifradas.
• CONFIG_DESCRIPTION es la descripción opcional de la fuente remota.
• REPOSITORY_BASE es el repositorio público predefinido de Yum. Los valores posibles son CENTOS, CENTOS_DEBUG, CENTOS_VAULT, CENTOS_STREAM, ROCKY y EPEL.
• REPOSITORY_PATH es el repositorio específico de la base. Por ejemplo, "centos/8-stream/BaseOS/x86_64/os.