As transferências baseadas em agentes do Serviço de transferência do Cloud Storage são compatíveis com endpoints regionais do Cloud Storage. Quando um endpoint regional do Cloud Storage é especificado, todo o tráfego de transferência de dados pelo agente para ou de um bucket do Cloud Storage permanece na região Google Cloud . Todos os buckets do Cloud Storage envolvidos na transferência, incluindo os intermediários para transferências entre sistemas de arquivos, precisam estar localizados na região especificada. Caso contrário, a transferência vai falhar.
Quando um endpoint regional não é especificado, o agente de transferência se conecta ao endpoint global, que encaminha o tráfego de maneira ideal, mas não garante o confinamento regional dos dados em trânsito.
Os endpoints regionais não são compatíveis com transferências sem agente.
Especificar um endpoint regional
Os endpoints são especificados no nível do agente de transferência. O agente precisa ser instalado
usando o comando docker.
Para especificar um endpoint regional, use a flag --gcs-api-endpoint ao
instalar um agente de transferência usando docker run:
sudo docker run --ulimit memlock=64000000 -d --rm \ --volumes-from gcloud-config \ -v HOST_DIRECTORY:CONTAINER_DIRECTORY \ gcr.io/cloud-ingest/tsop-agent:latest \ --project-id=PROJECT_ID \ --hostname=$(hostname) \ --agent-pool=POOL_NAME \ --gcs-api-endpoint=storage.LOCATION.rep.googleapis.com
A flag aceita todas as regiões únicas do Cloud Storage, além das multirregiões US e EU. Consulte
Locais de buckets para ver uma lista completa.
Consistência do endpoint regional em pools de agentes
Ao especificar um pool de agentes para um agente de transferência, saiba que o Serviço de transferência do Cloud Storage não impõe endpoints regionais uniformes em todos os agentes desse pool. Isso significa que você pode misturar inadvertidamente agentes que têm um endpoint regional específico com agentes que não têm no mesmo pool. Como resultado, o pool pode rotear o tráfego pelo endpoint global.
Para garantir que o tráfego permaneça na região desejada, inclua apenas agentes com o mesmo endpoint regional em um determinado pool de agentes.