Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Ao criar um repositório, você precisa especificar o local dele. O
local escolhido determina onde o armazenamento do repositório é criado. É possível
criar repositórios nos seguintes tipos de locais:
Região é um lugar geográfico específico, como Tóquio ou Virgínia do Norte.
Multirregional é uma área geográfica grande, como Ásia ou
Estados Unidos, que contém dois ou mais lugares geográficos.
Um bom local equilibra custos de latência, disponibilidade e largura de banda para os consumidores de dados.
Use uma região para otimizar a latência e a largura de banda de rede para uploads
e downloads por sistemas localizados na mesma região.
Use um local multirregional quando quiser interagir com sistemas que estão
fora da rede do Google e distribuídos em grandes áreas geográficas
ou quando você quiser a maior disponibilidade que vem com a
redundância entre regiões.
Geralmente, o recomendável é armazenar os artefatos em um local que seja conveniente ou que
contenha a maioria dos usuários dos seus dados.
Embora não seja possível especificar um local de repositório de zonas do Compute Engine,
todas as instâncias de VM do Compute Engine que estão nas zonas de uma determinada região
têm desempenho semelhante ao acessar o armazenamento nessa região.
Para ver uma lista de locais de repositório compatíveis, execute o comando:
gcloudartifactslocationslist
Restrições de local
Sua organização pode ter requisitos específicos para o local de
armazenamento de dados. Se a política da organização incluir
restrições de local de recursos,
o Artifact Registry vai aplicar as restrições quando você criar um repositório.
A conformidade com a política da organização não é aplicada de forma retroativa nos repositórios
existentes. Para aplicar novas restrições de local a artefatos armazenados,
crie novos repositórios depois que a política da organização for aplicada e
migre artefatos dos repositórios antigos para os novos. É possível usar a ferramenta gcrane
para copiar imagens entre repositórios.
Regiões disponíveis
Continente
Nome do local regional
Descrição do local regional
América do Norte
northamerica-northeast1
Montreal
northamerica-northeast2
Toronto
northamerica-south1
Queretaro
us-central1
Iowa
us-east1
Carolina do Sul
us-east4
Norte da Virgínia
us-east5
Columbus
us-south1
Dallas
us-west1
Oregon
us-west2
Los Angeles
us-west3
Salt Lake City
us-west4
Las Vegas
América do Sul
southamerica-east1
São Paulo
southamerica-west1
Santiago
Europa
europe-central2
Varsóvia
europe-north1
Finlândia
europe-north2
Estocolmo
europe-southwest1
Madri
europe-west1
Bélgica
europe-west2
Londres
europe-west3
Frankfurt
europe-west4
Países Baixos
europe-west6
Zurique
europe-west8
Milão
europe-west9
Paris
europe-west10
Berlim
europe-west12
Turim
Oriente Médio
me-central1
Doha
me-central2
Damã
me-west1
Tel Aviv
Ásia
asia-east1
Taiwan
asia-east2
Hong Kong
asia-northeast1
Tóquio
asia-northeast2
Osaka
asia-northeast3
Seul
asia-south1
Mumbai
asia-south2
Délhi
asia-southeast1
Singapura
asia-southeast2
Jacarta
Austrália
australia-southeast1
Sydney
australia-southeast2
Melbourne
África
africa-south1
Johannesburgo
Multirregiões disponíveis
Os datacenters de um local multirregional estão espalhados por uma área geográfica geral. Por exemplo, um recurso criado na multirregião europe
permanece em vários data centers na União Europeia. Não é possível
configurar quais data centers são selecionados ou onde eles estão localizados na
multirregião.
Se você usa o streaming de imagens do Google Kubernetes Engine, o repositório do Artifact Registry precisa estar na mesma região que os nós do GKE ou em uma multirregião que corresponde à região em que os nós estão em execução. Exemplo:
Se os nós estiverem em us-east1, o streaming de imagens estará disponível para repositórios na região us-east1 ou na multirregião us, desde que o GKE e o Artifact Registry estejam em execução em locais de data center nos Estados Unidos.
Se os nós estiverem na região northamerica-northeast1, eles serão executados no Canadá. Nessa situação, o streaming de imagens está disponível apenas para repositórios na mesma região.
Nome multirregional
Descrição multirregional
asia
Data centers na Ásia
europe
Data centers na União Europeia1
us
Data centers nos Estados Unidos
1 Os dados de objetos adicionados a um repositório na multirregião europe
não são armazenados no data center europe-west2 ou europe-west6.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Informações incorretas ou exemplo de código","incorrectInformationOrSampleCode","thumb-down"],["Não contém as informações/amostras de que eu preciso","missingTheInformationSamplesINeed","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-08-18 UTC."],[[["\u003cp\u003eRepositories in Artifact Registry must be assigned a location, which can be either a specific region, like Tokyo, or a multi-region, such as Asia.\u003c/p\u003e\n"],["\u003cp\u003eChoosing a region helps optimize latency and network bandwidth for systems located in that same region, while multi-regions are better for interactions with systems outside the Google network or requiring high availability.\u003c/p\u003e\n"],["\u003cp\u003eStoring artifacts in the same region as Compute Engine VM instances can enhance performance, and while a specific zone cannot be selected for a repository, VMs within the same region will experience similar performance.\u003c/p\u003e\n"],["\u003cp\u003eOrganization policies may enforce location constraints on repositories, and if existing repositories need to adhere to these new constraints, new repositories must be created and artifacts migrated to them.\u003c/p\u003e\n"],["\u003cp\u003eMulti-regions include the geographic areas of \u003ccode\u003easia\u003c/code\u003e, \u003ccode\u003eeurope\u003c/code\u003e, and \u003ccode\u003eus\u003c/code\u003e, and when using Image streaming with Google Kubernetes Engine, the repository must be in the same region as the GKE nodes, or a multi-region corresponding to the nodes' region.\u003c/p\u003e\n"]]],[],null,["# Artifact Registry locations\n\nWhen you create a repository, you must specify its location. The\nchosen location determines where the repository storage is created. You can\ncreate repositories in the following types of locations:\n\n- *Region* is a specific geographic place, such as Tokyo or Northern Virginia.\n\n- *Multi-region* is a large geographic area, such as Asia or the\n United States, that contains two or more geographic places.\n\nArtifact Registry stores artifacts in the selected location in\naccordance with the [Service Specific Terms](/terms/service-terms).\n\nA good location balances latency, availability, and bandwidth costs for data\nconsumers.\n\n- Use a region to help optimize latency and network bandwidth for uploads and downloads by systems located in the same region.\n\n\u003c!-- --\u003e\n\n- Use a multi-region when you want to interact with systems that are outside of the Google network and distributed across large geographic areas, or when you want the higher availability that comes with being [redundant across regions](/storage/docs/availability-durability#cross-region-redundancy).\n\n\u003c!-- --\u003e\n\n- Generally, you should store your artifacts in a location that is convenient or\n contains the majority of the users of your data.\n\n- For Compute Engine\n\n - Storing data in the same region as your [Compute Engine VM instances](/compute/docs/instances) can provide better performance.\n - While you can't specify a Compute Engine zone repository location, all Compute Engine VM instances in zones within a given region have similar performance when accessing storage in that region.\n\nTo view a list of supported repository locations, run the command: \n\n gcloud artifacts locations list\n\nLocation constraints\n--------------------\n\nYour organization might have specific requirements for the location of\nstored data. If your organization policy includes\n[resource location constraints](/resource-manager/docs/organization-policy/defining-locations),\nArtifact Registry enforces the constraints when you create a repository.\n\nOrganization policy compliance isn't enforced retroactively on existing\nrepositories. To enforce new location constraints on existing stored artifacts,\ncreate new repositories after the organization policy is applied, and then\nmigrate artifacts from old repositories to the new ones. You can use the [gcrane](https://github.com/google/go-containerregistry/tree/main/cmd/gcrane)\ntool to copy images between repositories.\n\nAvailable regions\n-----------------\n\nAvailable multi-regions\n-----------------------\n\nA multi-regional location's data centers are spread across a general\ngeographical area. For example, a resource created in the `europe` multi-region\npersists in multiple data centers within the European Union. It is not possible\nto configure which data centers are selected or where they are located within\nthe multi-region.\n\nIf you use Google Kubernetes Engine [Image streaming](/kubernetes-engine/docs/how-to/image-streaming), your Artifact Registry\nrepository must be in the same [region](#location-r) as your GKE\nnodes, or in a multi-region that corresponds with the region where your nodes\nare running. For example:\n\n- If your nodes are in `us-east1`, Image streaming is available for repositories in the `us-east1` region or the `us` multi-region since both GKE and Artifact Registry are running in data center locations within the United States.\n- If your nodes are in the `northamerica-northeast1` region, the nodes are running in Canada. In this situation, Image streaming is only available for repositories in the same region.\n\n^1^ Object data added to a repository in the `europe` multi-region\nis not stored in the `europe-west2` or `europe-west6` data center.\n\nWhat's next\n-----------\n\n- [Create repositories](/artifact-registry/docs/repositories/create-repos)\n- [Learn more about location concepts](/docs/geography-and-regions)"]]
