Conditions requises pour les transferts de système de fichiers

Avant de créer une tâche de transfert de système de fichiers, vous devez activer les API requises et installer Docker.

Si vous recevez des messages d'erreur lors de la configuration initiale, vérifiez que l'utilisateur avec lequel vous vous êtes connecté dispose des autorisations nécessaires pour effectuer la configuration. Dans de nombreux cas, ces autorisations ne sont pas disponibles pour tous les utilisateurs et vous devrez peut-être contacter un administrateur de projet pour obtenir de l'aide.

Configuration requise

Pour utiliser le service de transfert de stockage pour les transferts du système de fichiers, vous avez besoin des éléments suivants:

Les exigences de la machine de l'agent de transfert sont répertoriées ci-dessous:

  • Un serveur ou une machine virtuelle Linux 64 bits compatible avec Docker qui peut accéder aux données que vous prévoyez de transférer. Docker Community Edition, compatible avec les systèmes d'exploitation CentOS, Debian, Fedora et Ubuntu.

    Pour utiliser d'autres systèmes d'exploitation Linux, consultez la page sur Docker Enterprise.

  • Au minimum 8 Go de mémoire par conteneur et au moins quatre processeurs pour être plus efficace.

  • Toute contrainte au niveau du système ou de l'utilisateur concernant le nombre d'ID de processus autorisés, comme configuré avec ulimit -u, doit tenir compte du nombre d'agents que vous prévoyez d'exécuter. Chaque processus d'agent peut créer jusqu'à plusieurs centaines de threads. Nous vous recommandons de supprimer les limites d'ID de processus lorsque vous exécutez des agents de transfert.

    Les clients qui utilisent Podman pour créer des conteneurs d'agents doivent spécifier une valeur --pids-limit suffisamment élevée pour accueillir les threads d'agent du service de transfert de stockage. La valeur par défaut de --pids-limit est 2 048, ce qui peut entraîner des problèmes lors de l'exécution de plusieurs agents. Nous vous recommandons de définir --pids-limit=-1 pour autoriser un nombre illimité d'ID de processus par conteneur.

Restrictions liées au scaling des tâches et des agents

Le service de transfert de stockage présente les restrictions de scaling suivantes pour les tâches et les agents de transfert:

  • Le nombre de fichiers par tâche doit être inférieur à un milliard.
  • La limite de bande passante doit être supérieure à 1 Mbit/s.
  • Jusqu'à 100 agents par pool d'agents
  • Jusqu'à 800 pools d'agents par projet

Activer les API

  1. Enable the Google Storage Transfer API.

    Enable the API

Installer Docker

Si vous utilisez Google Cloud CLI ou Docker pour installer et exécuter des agents de transfert, installez Docker Engine sur une machine Linux physique ou virtuelle.

Si vous utilisez Podman pour installer et exécuter des agents de transfert, passez directement aux instructions d'installation spécifiques à Podman. 

curl -fsSL https://get.docker.com -o get-docker.sh

sudo sh get-docker.sh

sudo systemctl enable docker

Si des erreurs se produisent pendant l'installation, consultez la section Dépannage.

Autoriser Docker à s'authentifier

Pour que le conteneur Docker puisse s'authentifier avec vos identifiants par défaut gcloud, créez un volume Docker contenant un fichier qui inclut les identifiants par défaut de l'application en exécutant la commande suivante:

sudo docker run -ti --name gcloud-config google/cloud-sdk gcloud auth application-default login

Étape suivante