Fichiers et répertoires dans Azure Batch

Dans Azure Batch, chaque tâche a un répertoire de travail sous lequel il peut créer des fichiers et des répertoires. Ce répertoire de travail peut être utilisé pour stocker le programme exécuté par la tâche, les données qu’il traite et la sortie du traitement qu’il effectue. Tous les fichiers et répertoires d’une tâche appartiennent à l’utilisateur de la tâche.

Le service Batch expose une partie du système de fichiers sur un nœud en tant que répertoire racine. Ce répertoire racine se trouve sur le lecteur de stockage temporaire de la machine virtuelle, et non directement sur le lecteur du système d’exploitation.

Les tâches peuvent accéder au répertoire racine en référençant la variable d’environnement AZ_BATCH_NODE_ROOT_DIR . Pour plus d’informations sur l’utilisation de variables d’environnement, consultez Paramètres d’environnement pour les tâches.

Structure de répertoire racine

Le répertoire racine contient la structure de répertoires suivante :

• applications : contient des informations sur les détails des packages d’application installés sur le nœud de calcul. Les tâches peuvent accéder à ce répertoire en référençant la variable d’environnement AZ_BATCH_APP_PACKAGE .

• fsmounts : le répertoire contient tous les systèmes de fichiers montés sur un nœud de calcul. Les tâches peuvent accéder à ce répertoire en référençant la variable d’environnement AZ_BATCH_NODE_MOUNTS_DIR . Pour plus d’informations, consultez Monter un système de fichiers virtuel sur un pool Batch.

• partagé : ce répertoire fournit un accès en lecture/écriture à toutes les tâches qui s’exécutent sur un nœud. Toute tâche qui s’exécute sur le nœud peut créer, lire, mettre à jour et supprimer des fichiers dans ce répertoire. Les tâches peuvent accéder à ce répertoire en référençant la variable d’environnement AZ_BATCH_NODE_SHARED_DIR .

• démarrage : ce répertoire est utilisé par une tâche de démarrage comme répertoire de travail. Tous les fichiers téléchargés sur le nœud par la tâche de démarrage sont stockés ici. La tâche de démarrage peut créer, lire, mettre à jour et supprimer des fichiers sous ce répertoire. Les tâches peuvent accéder à ce répertoire en référençant la variable d’environnement AZ_BATCH_NODE_STARTUP_DIR .

• volatile : ce répertoire est à des fins internes. Il n’existe aucune garantie que tous les fichiers de ce répertoire ou que le répertoire lui-même existe à l’avenir.

• workitems : ce répertoire contient les répertoires pour les travaux et leurs tâches sur le nœud de calcul.

  Dans le répertoire workitems , un répertoire Tasks est créé pour chaque tâche qui s’exécute sur le nœud. Ce répertoire est accessible en référençant la variable d’environnement AZ_BATCH_TASK_DIR .

  Dans chaque répertoire Tâches , le service Batch crée un répertoire de travail (wd) dont le chemin unique est spécifié par la variable d’environnement AZ_BATCH_TASK_WORKING_DIR . Ce répertoire fournit un accès en lecture/écriture à la tâche. La tâche peut créer, lire, mettre à jour et supprimer des fichiers sous ce répertoire. Ce répertoire est conservé en fonction de la contrainte RetentionTime spécifiée pour la tâche.

  Les fichiers stdout.txt et stderr.txt sont écrits dans le dossier Tâches pendant l'exécution de la tâche.

Important

Lorsqu’un nœud est supprimé du pool, tous les fichiers stockés sur le nœud sont supprimés.

Emplacement du répertoire racine du lot

La valeur de la variable d’environnement de nœud de calcul sera déterminée par la taille de la AZ_BATCH_NODE_ROOT_DIR machine virtuelle et la présence d’un disque temporaire local.

Disque temporaire local présent	Type de système d'exploitation	Valeur AZ_BATCH_NODE_ROOT_DIR
Non	Linux	/opt/batch/data
Oui	Linux	/mnt/batch ou /mnt/resource/batch
Non	Fenêtres	C:\batch\data
Oui	Fenêtres	D:\batch

Ces valeurs de variable d’environnement sont des détails d’implémentation et ne doivent pas être considérées comme immuables. Comme ces valeurs peuvent changer à tout moment, l’utilisation de variables d’environnement au lieu de coder en dur la valeur est recommandée.

Étapes suivantes

• Découvrez la gestion et la détection des erreurs dans Azure Batch.