Crie repositórios 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

Flags opcionais para autenticação no repositório a montante:

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

Substitua o seguinte:

• REMOTE-REPOSITORY-NAME com o nome do repositório. Para cada localização do repositório num projeto, os nomes dos repositórios têm de ser exclusivos.
• PROJECT_ID com o ID do projeto. Se esta flag for omitida, é usado o projeto atual ou predefinido.
• LOCATION com a localização regional ou multirregional do repositório. Pode omitir esta sinalização se definir uma predefinição. Para ver uma lista de localizações suportadas, execute o comando gcloud artifacts locations list.
• DESCRIPTION com uma descrição opcional do repositório. Não inclua dados confidenciais, uma vez que as descrições dos repositórios não são encriptadas.
• REMOTE-REPOSITORY-DESCRIPTION com uma descrição da configuração do repositório externo para este repositório remoto.
• USERNAME opcionalmente, se estiver a usar a autenticação, com o seu nome de utilizador para autenticar no repositório a montante.
• SECRET_VERSION opcionalmente, se estiver a usar a autenticação, com a versão secreta que contém a palavra-passe do repositório a montante.

• UPSTREAM com o nome a montante predefinido, o caminho do repositório do Artifact Registry ou o URL definido pelo utilizador do repositório a montante.
  
  Para repositórios upstream do Artifact Registry, formate o caminho do repositório de forma semelhante à seguinte: projects/UPSTREAM_PROJECT_ID/locations/REGION/repositories/UPSTREAM_REPOSITORY.
  
  Para informações sobre as origens de dados predefinidas disponíveis e as origens de dados definidas pelo utilizador suportadas, consulte o artigo Formatos suportados.

• --disable-vulnerability-scanning: é um sinalizador opcional que configura o seu repositório para desativar a análise de vulnerabilidades automática.

• --allow-vulnerability-scanning: é um sinalizador opcional que configura o seu repositório para permitir a análise de vulnerabilidades automática. Para mais informações, consulte o artigo Ative ou desative a análise automática.

Por exemplo, o comando seguinte cria um repositório remoto denominado my-repo na região us-east1 no Google Cloud projeto my-project e pode autenticar-se no repositório a montante através do nome de utilizador my-username e da versão secreta 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 mais informações sobre a autenticação em repositórios upstream do Docker Hub, consulte o artigo Configure a autenticação de repositórios remotos no 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

Flags opcionais para autenticação no repositório a montante:

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

Substitua o seguinte:

• REMOTE-REPOSITORY-NAME com o nome do repositório. Para cada localização do repositório num projeto, os nomes dos repositórios têm de ser exclusivos.
• PROJECT_ID com o ID do projeto. Se esta flag for omitida, é usado o projeto atual ou predefinido.
• LOCATION com a localização regional ou multirregional do repositório. Pode omitir esta sinalização se definir uma predefinição. Para ver uma lista de localizações suportadas, execute o comando gcloud artifacts locations list.
• DESCRIPTION com uma descrição opcional do repositório. Não inclua dados confidenciais, uma vez que as descrições dos repositórios não são encriptadas.
• REMOTE-REPOSITORY-DESCRIPTION com uma descrição da configuração do repositório externo para este repositório remoto.
• USERNAME opcionalmente, se estiver a usar a autenticação, com o seu nome de utilizador para autenticar no repositório a montante.
• SECRET_VERSION opcionalmente, se estiver a usar a autenticação, com a versão secreta que contém a palavra-passe do repositório a montante.

• UPSTREAM com o nome a montante predefinido, o caminho do repositório do Artifact Registry ou o URL definido pelo utilizador do repositório a montante.
  
  Para repositórios upstream do Artifact Registry, formate o caminho do repositório de forma semelhante à seguinte: projects/UPSTREAM_PROJECT_ID/locations/REGION/repositories/UPSTREAM_REPOSITORY.
  
  Para informações sobre as origens de dados predefinidas disponíveis e as origens de dados definidas pelo utilizador suportadas, consulte o artigo Formatos suportados.

• --disable-vulnerability-scanning: é um sinalizador opcional que configura o seu repositório para desativar a análise de vulnerabilidades automática.

• --allow-vulnerability-scanning: é um sinalizador opcional que configura o seu repositório para permitir a análise de vulnerabilidades automática. Para mais informações, consulte o artigo Ative ou desative a análise automática.

Por exemplo, o comando seguinte cria um repositório remoto denominado my-repo na região us-east1 no Google Cloud projeto my-project e pode autenticar-se no repositório a montante através do nome de utilizador my-username e da versão secreta 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

Flags opcionais para autenticação no repositório a montante:

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

Substitua o seguinte:

• REMOTE-REPOSITORY-NAME com o nome do repositório. Para cada localização do repositório num projeto, os nomes dos repositórios têm de ser exclusivos.
• PROJECT_ID com o ID do projeto. Se esta flag for omitida, é usado o projeto atual ou predefinido.
• LOCATION com a localização regional ou multirregional do repositório. Pode omitir esta sinalização se definir uma predefinição. Para ver uma lista de localizações suportadas, execute o comando gcloud artifacts locations list.
• DESCRIPTION com uma descrição opcional do repositório. Não inclua dados confidenciais, uma vez que as descrições dos repositórios não são encriptadas.
• REMOTE-REPOSITORY-DESCRIPTION com uma descrição da configuração do repositório externo para este repositório remoto.
• USERNAME opcionalmente, se estiver a usar a autenticação, com o seu nome de utilizador para autenticar no repositório a montante.
• SECRET_VERSION opcionalmente, se estiver a usar a autenticação, com a versão secreta que contém a palavra-passe do repositório a montante.

• UPSTREAM com o nome a montante predefinido, o caminho do repositório do Artifact Registry ou o URL definido pelo utilizador do repositório a montante.
  
  Para repositórios upstream do Artifact Registry, formate o caminho do repositório de forma semelhante à seguinte: projects/UPSTREAM_PROJECT_ID/locations/REGION/repositories/UPSTREAM_REPOSITORY.
  
  Para informações sobre as origens de dados predefinidas disponíveis e as origens de dados definidas pelo utilizador suportadas, consulte o artigo Formatos suportados.

• --disable-vulnerability-scanning: é um sinalizador opcional que configura o seu repositório para desativar a análise de vulnerabilidades automática.

• --allow-vulnerability-scanning: é um sinalizador opcional que configura o seu repositório para permitir a análise de vulnerabilidades automática. Para mais informações, consulte o artigo Ative ou desative a análise automática.

Por exemplo, o comando seguinte cria um repositório remoto denominado my-repo na região us-east1 no Google Cloud projeto my-project e pode autenticar-se no repositório a montante através do nome de utilizador my-username e da versão secreta 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

Flags opcionais para autenticação no repositório a montante:

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

Substitua o seguinte:

• REMOTE-REPOSITORY-NAME com o nome do repositório. Para cada localização do repositório num projeto, os nomes dos repositórios têm de ser exclusivos.
• PROJECT_ID com o ID do projeto. Se esta flag for omitida, é usado o projeto atual ou predefinido.
• LOCATION com a localização regional ou multirregional do repositório. Pode omitir esta sinalização se definir uma predefinição. Para ver uma lista de localizações suportadas, execute o comando gcloud artifacts locations list.
• DESCRIPTION com uma descrição opcional do repositório. Não inclua dados confidenciais, uma vez que as descrições dos repositórios não são encriptadas.
• REMOTE-REPOSITORY-DESCRIPTION com uma descrição da configuração do repositório externo para este repositório remoto.
• USERNAME opcionalmente, se estiver a usar a autenticação, com o seu nome de utilizador para autenticar no repositório a montante.
• SECRET_VERSION opcionalmente, se estiver a usar a autenticação, com a versão secreta que contém a palavra-passe do repositório a montante.

• UPSTREAM com o nome a montante predefinido, o caminho do repositório do Artifact Registry ou o URL definido pelo utilizador do repositório a montante.
  
  Para repositórios upstream do Artifact Registry, formate o caminho do repositório de forma semelhante à seguinte: projects/UPSTREAM_PROJECT_ID/locations/REGION/repositories/UPSTREAM_REPOSITORY.
  
  Para informações sobre as origens de dados predefinidas disponíveis e as origens de dados definidas pelo utilizador suportadas, consulte o artigo Formatos suportados.

• --disable-vulnerability-scanning: é um sinalizador opcional que configura o seu repositório para desativar a análise de vulnerabilidades automática.

• --allow-vulnerability-scanning: é um sinalizador opcional que configura o seu repositório para permitir a análise de vulnerabilidades automática. Para mais informações, consulte o artigo Ative ou desative a análise automática.

Por exemplo, o comando seguinte cria um repositório remoto denominado my-repo na região us-east1 no Google Cloud projeto my-project e pode autenticar-se no repositório a montante através do nome de utilizador my-username e da versão secreta 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 (pré-visualização)

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"

Substitua o seguinte:

• REMOTE_REPOSITORY_NAME com o nome do repositório. Para cada localização do repositório num projeto, os nomes dos repositórios têm de ser exclusivos.
• PROJECT_ID com o ID do projeto. Se esta flag for omitida, é usado o projeto atual ou predefinido.
• LOCATION com a localização regional ou multirregional do repositório. Pode omitir esta sinalização se definir uma predefinição. Para ver uma lista de localizações suportadas, execute o comando gcloud artifacts locations list.
• DESCRIPTION com uma descrição opcional do repositório. Não inclua dados confidenciais, uma vez que as descrições dos repositórios não são encriptadas.
• REMOTE_REPOSITORY_DESCRIPTION com uma descrição opcional da configuração do repositório externo para este repositório remoto.
• APT_REPOSITORY_BASE com um dos nomes base do repositório suportados indicados nos upstream suportados do pacote do SO para repositórios remotos do Apt.
• APT_REPOSITORY_PATH com o resto do URL do repositório a montante que quer colocar em cache no seu repositório remoto após a base do repositório.

Por exemplo, o comando seguinte cria um repositório remoto com o nome my-repo para colocar em cache o repositório Debian buster na região us-east1 no projeto Google Cloud my-project. O URL completo do repositório a montante é 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 (pré-visualização)

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"

Substitua o seguinte:

• REMOTE_REPOSITORY_NAME com o nome do repositório. Para cada localização do repositório num projeto, os nomes dos repositórios têm de ser exclusivos.
• PROJECT_ID com o ID do projeto. Se esta flag for omitida, é usado o projeto atual ou predefinido.
• LOCATION com a localização regional ou multirregional do repositório. Pode omitir esta sinalização se definir uma predefinição. Para ver uma lista de localizações suportadas, execute o comando gcloud artifacts locations list.
• DESCRIPTION com uma descrição opcional do repositório. Não inclua dados confidenciais, uma vez que as descrições dos repositórios não são encriptadas.
• REMOTE_REPOSITORY_DESCRIPTION com uma descrição opcional da configuração do repositório externo para este repositório remoto.
• YUM_REPOSITORY_BASE com um dos nomes base do repositório suportados indicados nos upstream suportados do pacote do SO para repositórios remotos do Yum.
• YUM_REPOSITORY_PATH com o resto do URL do repositório a montante que quer colocar em cache no seu repositório remoto após a base do repositório.

Por exemplo, o seguinte comando cria um repositório remoto para pacotes Yum denominado my-repo na região us-east1 no Google Cloud projeto my-project para o repositório a montante 9-stream/BaseOs/x86_64/os. O URL completo do repositório é 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"

Ir

Os repositórios remotos do Go do Artifact Registry só suportam o 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

Substitua o seguinte:

• REMOTE-REPOSITORY-NAME é o nome do repositório. Para cada localização do repositório num projeto, os nomes dos repositórios têm de ser exclusivos.
• PROJECT_ID é o ID do projeto. Se esta flag for omitida, é usado o projeto atual ou predefinido.

• LOCATION é a localização regional ou multirregional do repositório. Pode omitir esta sinalização se definir uma predefinição. Para ver uma lista de localizações suportadas, execute o comando gcloud artifacts locations list.

• DESCRIPTION é uma descrição opcional do repositório. Não inclua dados confidenciais, uma vez que as descrições dos repositórios não são encriptadas.

• REMOTE-REPOSITORY-DESCRIPTION é uma descrição da configuração do repositório externo para este repositório remoto.

Por exemplo, o comando seguinte cria um repositório remoto com o nome my-repo na região us-east1 no projeto 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
    }
  }
}

Onde

• PROJECT-IDé o Google Cloud ID do projeto.
• LOCATION é a localização do repositório.
• REPOSITORY_ID é o ID do repositório.
• DESCRIPTIONé a descrição opcional do repositório. Não inclua dados confidenciais, uma vez que as descrições dos repositórios não são encriptadas.
• KEYé o nome da chave do Cloud Key Management Service, se estiver a usar chaves de encriptação geridas pelo cliente (CMEK) para encriptação. Omita este argumento para usar a predefinição, as chaves de encriptação geridas pela Google.
• CONFIG_DESCRIPTIONé a descrição opcional da origem remota.
• O DRY_RUN_STATUS determina se as políticas de limpeza eliminam artefactos ou apenas registam os artefactos que seriam eliminados se definissem políticas de limpeza no repositório. Omita se não quiser adicionar políticas de limpeza ao repositório. * true: define as políticas para serem executadas no modo de execução de ensaio. Não são eliminados artefactos no modo de teste. * false: aplica as políticas de limpeza. Os artefactos são eliminados ou mantidos consoante as políticas. Para mais informações sobre as políticas de limpeza, consulte o artigo Configure políticas de limpeza.
  • POLICY_NAME é o nome da política de limpeza.
  • TAG_STATE é o estado da etiqueta ao qual aplicar a política. Os valores são tagged, untagged e any. any aplica-se a artefactos etiquetados e não etiquetados. Se um repositório tiver etiquetas imutáveis ativadas, não é possível eliminar os artefactos etiquetados.
  • TAG_PREFIX e TAG_PREFIX_N são prefixos de etiquetas aos quais a política se aplica.
  • PKG_PREFIX e PKG_PREFIX_N são prefixos de pacotes para aplicar a política.
  • TIME_SINCE_UPLOAD é o tempo desde que uma versão do artefacto foi carregada para o repositório, especificado como uma duração. Pode especificar durações de segundos, minutos, horas ou dias anexando s, m, h ou d, respetivamente.
  • KEEP_COUNT é o número de versões por pacote de um artefacto a manter no seu repositório.

Maven

Se não especificar uma política de versão, o Artifact Registry cria um repositório Maven que armazena versões de lançamento e instantâneos de pacotes por predefinição.

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

Onde

• PROJECT-IDé o Google Cloud ID do projeto.
• LOCATION é a localização do repositório.
• REPOSITORY_ID é o ID do repositório.
• DESCRIPTIONé a descrição opcional do repositório. Não inclua dados confidenciais, uma vez que as descrições dos repositórios não são encriptadas.
• KEYé o nome da chave do Cloud Key Management Service, se estiver a usar chaves de encriptação geridas pelo cliente (CMEK) para encriptação. Omita este argumento para usar a predefinição, as chaves de encriptação geridas pela Google.
• CONFIG_DESCRIPTIONé a descrição opcional da origem remota.
• O DRY_RUN_STATUS determina se as políticas de limpeza eliminam artefactos ou apenas registam os artefactos que seriam eliminados se definissem políticas de limpeza no repositório. Omita se não quiser adicionar políticas de limpeza ao repositório. * true: define as políticas para serem executadas no modo de execução de ensaio. Não são eliminados artefactos no modo de teste. * false: aplica as políticas de limpeza. Os artefactos são eliminados ou mantidos consoante as políticas. Para mais informações sobre as políticas de limpeza, consulte o artigo Configure políticas de limpeza.
  • POLICY_NAME é o nome da política de limpeza.
  • TAG_STATE é o estado da etiqueta ao qual aplicar a política. Os valores são tagged, untagged e any. any aplica-se a artefactos etiquetados e não etiquetados. Se um repositório tiver etiquetas imutáveis ativadas, não é possível eliminar os artefactos etiquetados.
  • TAG_PREFIX e TAG_PREFIX_N são prefixos de etiquetas aos quais a política se aplica.
  • PKG_PREFIX e PKG_PREFIX_N são prefixos de pacotes para aplicar a política.
  • TIME_SINCE_UPLOAD é o tempo desde que uma versão do artefacto foi carregada para o repositório, especificado como uma duração. Pode especificar durações de segundos, minutos, horas ou dias anexando s, m, h ou d, respetivamente.
  • KEEP_COUNT é o número de versões por pacote de um artefacto a manter no seu repositório.

Para armazenar versões de instantâneos e lançamentos em repositórios diferentes, especifique uma política de versões para o repositório através de um bloco maven_config. Este bloco suporta as seguintes definições:

• version_policy define a política de versões com um dos seguintes valores:
  • VERSION_POLICY_UNSPECIFIED: armazene o instantâneo e publique pacotes. Esta é a predefinição.
  • RELEASE: apenas pacotes de lançamento na loja.
  • SNAPSHOT: armazena apenas pacotes de capturas instantâneas.
• allow_snapshot_overwrites configura um repositório com uma política de versões SNAPSHOT para aceitar instantâneos não únicos que substituam as versões existentes no repositório.

O exemplo seguinte define um repositório Maven com uma política de versão de lançamento.

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

Onde

• PROJECT-IDé o Google Cloud ID do projeto.
• LOCATION é a localização do repositório.
• REPOSITORY_ID é o ID do repositório.
• DESCRIPTIONé a descrição opcional do repositório. Não inclua dados confidenciais, uma vez que as descrições dos repositórios não são encriptadas.
• KEYé o nome da chave do Cloud Key Management Service, se estiver a usar chaves de encriptação geridas pelo cliente (CMEK) para encriptação. Omita este argumento para usar a predefinição, as chaves de encriptação geridas pela Google.
• CONFIG_DESCRIPTIONé a descrição opcional da origem remota.
• O DRY_RUN_STATUS determina se as políticas de limpeza eliminam artefactos ou apenas registam os artefactos que seriam eliminados se definissem políticas de limpeza no repositório. Omita se não quiser adicionar políticas de limpeza ao repositório. * true: define as políticas para serem executadas no modo de execução de ensaio. Não são eliminados artefactos no modo de teste. * false: aplica as políticas de limpeza. Os artefactos são eliminados ou mantidos consoante as políticas. Para mais informações sobre as políticas de limpeza, consulte o artigo Configure políticas de limpeza.
  • POLICY_NAME é o nome da política de limpeza.
  • TAG_STATE é o estado da etiqueta ao qual aplicar a política. Os valores são tagged, untagged e any. any aplica-se a artefactos etiquetados e não etiquetados. Se um repositório tiver etiquetas imutáveis ativadas, não é possível eliminar os artefactos etiquetados.
  • TAG_PREFIX e TAG_PREFIX_N são prefixos de etiquetas aos quais a política se aplica.
  • PKG_PREFIX e PKG_PREFIX_N são prefixos de pacotes para aplicar a política.
  • TIME_SINCE_UPLOAD é o tempo desde que uma versão do artefacto foi carregada para o repositório, especificado como uma duração. Pode especificar durações de segundos, minutos, horas ou dias anexando s, m, h ou d, respetivamente.
  • KEEP_COUNT é o número de versões por pacote de um artefacto a manter no seu repositório.

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

Onde

• PROJECT-IDé o Google Cloud ID do projeto.
• LOCATION é a localização do repositório.
• REPOSITORY_ID é o ID do repositório.
• DESCRIPTIONé a descrição opcional do repositório. Não inclua dados confidenciais, uma vez que as descrições dos repositórios não são encriptadas.
• KEYé o nome da chave do Cloud Key Management Service, se estiver a usar chaves de encriptação geridas pelo cliente (CMEK) para encriptação. Omita este argumento para usar a predefinição, as chaves de encriptação geridas pela Google.
• CONFIG_DESCRIPTIONé a descrição opcional da origem remota.
• O DRY_RUN_STATUS determina se as políticas de limpeza eliminam artefactos ou apenas registam os artefactos que seriam eliminados se definissem políticas de limpeza no repositório. Omita se não quiser adicionar políticas de limpeza ao repositório. * true: define as políticas para serem executadas no modo de execução de ensaio. Não são eliminados artefactos no modo de teste. * false: aplica as políticas de limpeza. Os artefactos são eliminados ou mantidos consoante as políticas. Para mais informações sobre as políticas de limpeza, consulte o artigo Configure políticas de limpeza.
  • POLICY_NAME é o nome da política de limpeza.
  • TAG_STATE é o estado da etiqueta ao qual aplicar a política. Os valores são tagged, untagged e any. any aplica-se a artefactos etiquetados e não etiquetados. Se um repositório tiver etiquetas imutáveis ativadas, não é possível eliminar os artefactos etiquetados.
  • TAG_PREFIX e TAG_PREFIX_N são prefixos de etiquetas aos quais a política se aplica.
  • PKG_PREFIX e PKG_PREFIX_N são prefixos de pacotes para aplicar a política.
  • TIME_SINCE_UPLOAD é o tempo desde que uma versão do artefacto foi carregada para o repositório, especificado como uma duração. Pode especificar durações de segundos, minutos, horas ou dias anexando s, m, h ou d, respetivamente.
  • KEEP_COUNT é o número de versões por pacote de um artefacto a manter no seu repositório.

Apt (pré-visualização)

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

Onde

• PROJECT-ID é o Google Cloud ID do projeto.
• LOCATION é a localização do repositório.
• REPOSITORY_ID é o ID do repositório.
• DESCRIPTION é a descrição opcional do repositório. Não inclua dados confidenciais, uma vez que as descrições dos repositórios não são encriptadas.
• CONFIG_DESCRIPTION é a descrição opcional da origem remota.
• REPOSITORY_BASE é a base do repositório público predefinido para o Apt. Os valores possíveis são DEBIAN e UBUNTU.
• REPOSITORY_PATH é o repositório específico da base. Por exemplo debian/dists/buster.

Yum (pré-visualização)

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

Onde

• PROJECT-ID é o Google Cloud ID do projeto.
• LOCATION é a localização do repositório.
• REPOSITORY_ID é o ID do repositório.
• DESCRIPTION é a descrição opcional do repositório. Não inclua dados confidenciais, uma vez que as descrições dos repositórios não são encriptadas.
• CONFIG_DESCRIPTION é a descrição opcional da origem remota.
• REPOSITORY_BASE é a base do repositório público predefinido para o Yum. Os valores possíveis são CENTOS, CENTOS_DEBUG, CENTOS_VAULT, CENTOS_STREAM, ROCKY e EPEL.
• REPOSITORY_PATH é o repositório específico da base. Por exemplo "centos/8-stream/BaseOS/x86_64/os.