Requisitos para transferências de sistema de arquivos
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Antes de criar um job de transferência do sistema de arquivos, é necessário ativar as APIs
necessárias e instalar o Docker.
Se você receber erros ao realizar a configuração inicial, confirme se o usuário
que fez login tem permissão para executar as etapas de configuração. Em muitos casos,
essas permissões não estão disponíveis para todos os usuários, e talvez seja necessário
entrar em contato com um administrador do projeto para receber ajuda.
Requisitos do sistema
Para usar o Serviço de transferência do Cloud Storage em transferências do sistema de arquivos, você precisa do seguinte:
A porta TCP 443 (HTTPS) está aberta para conexões de saída.
Os requisitos de máquina do agente de transferência estão listados abaixo:
Um servidor Linux ou máquina virtual de 64 bits
compatível com o Docker (em inglês) capaz de acessar os dados que você quer transferir.
O Docker Community Edition
(links em inglês) é compatível com sistemas operacionais CentOs, Debian, Fedora e Ubuntu.
Para usar outros sistemas operacionais Linux,
consulte Docker Enterprise (links em inglês).
Pelo menos 8 GB de memória por contêiner e pelo menos quatro CPUs para ser mais
eficaz.
Qualquer restrição no nível do sistema ou do usuário no número de IDs de processos permitidos, como configurado com ulimit -u, precisa considerar o número de agentes que você planeja executar. Cada processo de agente pode criar até
centenas de linhas de execução. Recomendamos remover os limites de ID do processo ao executar
agentes de transferência.
Os clientes que usam o Podman para criar contêineres de agente precisam especificar um valor --pids-limit alto o suficiente para acomodar as linhas de execução do agente do Serviço de transferência do Cloud Storage. O valor padrão de --pids-limit é 2.048, o que pode causar problemas
ao executar mais de um agente. Recomendamos definir --pids-limit=-1
para permitir IDs de processo ilimitados por contêiner.
Restrições de escalonamento em jobs e agentes
O Serviço de transferência do Cloud Storage tem as restrições de escala a seguir para jobs e agentes de
transferência:
Menos de um bilhão de arquivos por job
O limite de largura de banda precisa ser maior que 1 MBps
Para permitir que o contêiner do Docker autentique com suas credenciais padrão do gcloud, execute o comando a seguir para criar um volume do Docker contendo um arquivo com suas credenciais padrão do aplicativo.
[[["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."],[],[],null,["# Requirements for file system transfers\n\nBefore you create a file system transfer job, you'll need to enable required\nAPIs and install Docker.\n\nIf you receive errors while performing first-time setup, confirm that the user\nyou logged in with has permissions required to perform the set up steps. In many\ncases, these permissions are not available to all users, and you may need to\ncontact a project administrator for assistance.\n\nSystem requirements\n-------------------\n\nTo use Storage Transfer Service for file system transfers, you need:\n\n- A POSIX-compliant source and/or destination.\n\n- A Cloud Storage bucket without a\n [retention policy](/storage/docs/bucket-lock). To transfer to a bucket with\n a retention policy, see\n [Transfer to a bucket with a retention policy](/storage-transfer/docs/on-prem-agent-details#retention_policy).\n\n- TCP port 443 (HTTPS) open for outbound connections.\n\nThe transfer agent machine requirements are listed below:\n\n- A [Docker](https://docker.com)-supported 64-bit Linux\n server or virtual machine that can access the data you plan to transfer.\n [Docker Community Edition](https://docs.docker.com/install/linux/docker-ce/binaries/),\n supports CentOs, Debian, Fedora, and Ubuntu operating systems.\n\n To use other Linux operating systems, see\n [Docker Enterprise](https://docs.docker.com/ee/supported-platforms/).\n- At least 8 GB of memory per container and at least four CPUs to be most\n effective.\n\n- Any system-level or user-level constraints on the number of allowed\n process IDs, such as configured with `ulimit -u`, must account for the\n number of agents you plan to run. Each agent process can create up to many\n hundreds of threads. We recommend removing process ID limits when running\n transfer agents.\n\n Customers using [Podman](https://podman.io/) to create agent containers\n should specify a\n `--pids-limit` value high enough to accommodate Storage Transfer Service agent\n threads. The default `--pids-limit` value is 2048, which may cause issues\n when running more than one agent. We recommend setting `--pids-limit=-1`\n to allow unlimited process IDs per container.\n\nScaling restrictions on jobs and agents\n---------------------------------------\n\nStorage Transfer Service has the following scale restrictions on transfer jobs and\nagents:\n\n- Fewer than one billion files per job\n- Bandwidth cap must be over 1MBps\n- Up to 100 agents per agent pool\n- Up to 800 agent pools per project\n\nEnable APIs\n-----------\n\n1.\n\n\n Enable the Google Storage Transfer API.\n\n\n [Enable the API](https://console.cloud.google.com/flows/enableapi?apiid=storagetransfer)\n\nInstall Docker\n--------------\n\nIf you're using Google Cloud CLI or Docker to\n[install and run transfer agents](/storage-transfer/docs/managing-on-prem-agents#install-agent),\ninstall Docker Engine on a physical or virtual Linux machine.\n\nIf you're using Podman to install and run transfer agents, skip directly to\nthe\n[Podman-specific installation instructions](/storage-transfer/docs/managing-on-prem-agents#podman). \n\n curl -fsSL https://get.docker.com -o get-docker.sh\n\n sudo sh get-docker.sh\n\n sudo systemctl enable docker --now\n\nIf you encounter an installation error, see\n[Troubleshooting](https://docs.docker.com/install/linux/linux-postinstall/#troubleshooting).\n\nAllow Docker to authenticate\n----------------------------\n\nTo allow the Docker container to authenticate with your `gcloud` default\ncredentials, create a Docker volume containing a file with your application\ndefault credentials by running the following command: \n\n sudo docker run -ti --name gcloud-config google/cloud-sdk gcloud auth application-default login\n\nWhat's next?\n------------\n\n- [Configure Google Cloud permissions](/storage-transfer/docs/file-system-permissions)\n- [Create an agent pool](/storage-transfer/docs/on-prem-agent-pools)\n- [Install transfer agents](/storage-transfer/docs/managing-on-prem-agents)\n- [Create a transfer job](/storage-transfer/docs/create-transfers)\n- [Maximize transfer agent performance](/storage-transfer/docs/on-prem-agent-best-practices)"]]
