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 est 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.

  • Toutes les contraintes au niveau du système ou de l'utilisateur concernant le nombre d'ID de processus autorisés, telles que celles configurées avec ulimit -u, doivent 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 lors de l'exécution des agents de transfert.

    Les clients qui utilisent Podman pour créer des conteneurs d'agent doivent spécifier une valeur --pids-limit suffisamment élevée pour accueillir les threads de l'agent du service de transfert de stockage. La valeur --pids-limit par défaut est 2048, 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 applique les restrictions d'échelle suivantes aux agents et aux tâches 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. Activez Google Storage Transfer API.

    Activer l'API

Installer Docker

Installez Docker Community Edition sur une machine Linux physique ou virtuelle en procédant comme suit :

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 permettre au conteneur Docker de s'authentifier avec vos identifiants par défaut gcloud, créez un volume Docker contenant un fichier avec les identifiants par défaut de votre application en exécutant la commande suivante:

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

Étape suivante