Variables d'environnement de travail

Lorsque vous créez un travail ou un traitement de travail, vous pouvez fournir des variables d'environnement personnalisées et des arguments de ligne de commande.

Contraintes
  • Variables d'environnement personnalisées : nombre total de caractères dans les paires clé-valeur pour toutes les variables d'environnement personnalisées. Ne peut pas dépasser 20 000 caractères.
  • Arguments de ligne de commande : l'entrée dans le champ des arguments de ligne de commande ne peut pas dépasser 4 000 caractères.

Avec un traitement de travail, les variables d'environnement fournies par le service suivantes sont automatiquement disponibles :

Variables d'environnement fournies par le service

Nom

Description

TENANCY_OCID

OCID de la location à laquelle appartient le travail.

PROJECT_OCID

OCID du projet auquel le travail est associé.

PROJECT_COMPARTMENT_OCID

OCID du compartiment du projet auquel le travail est associé.

JOB_OCID

OCID du travail associé.

JOB_COMPARTMENT_OCID

OCID du compartiment auquel le travail est associé.

JOB_ARTIFACT_FILE_NAME

Nom de fichier de l'artefact de travail téléchargé.

JOB_RUN_OCID

OCID du traitement de travail.

JOB_RUN_COMPARTMENT_OCID

OCID du compartiment du traitement de travail.

FQDN Nom de domaine qualifié complet du noeud qui peut être utilisé pour que les noeuds communiquent avec d'autres noeuds.

Outre les variables d'environnement de traitement de travail de service, vous pouvez également utiliser les variables d'environnement suivantes :

Variables d'environnement facultatives

Nom

Description

CONDA_ENV_TYPE

Type d'environnement conda : service ou published.

CONDA_ENV_SLUG

Slug d'environnement conda de service. Par exemple : database_p37_cpu_v2 pour l'environnement conda Oracle Database on Python 3.7 (version 2.0).

CONDA_ENV_REGION

Région d'environnement conda publié.

CONDA_ENV_OBJECT_NAME

Nom d'objet d'environnement conda publié.

CONDA_ENV_NAMESPACE

Espace de noms Object Storage d'environnement conda publié.

CONDA_ENV_BUCKET

Bucket Object Storage d'environnement conda publié.

JOB_RUN_ENTRYPOINT

Obligatoire pour les fichiers ZIP ou TAR. Spécifie le fichier de point d'entrée dans l'artefact de travail à exécuter.

Variables d'environnement des travaux distribués
Nom Description
NODE_RANK

Classement généré par le système affecté au code NODE.

Le rang est un entier continu, croissant entre 0 et le nombre de noeuds moins 1.

NODE_GROUP_NAME Nom du groupe de noeuds fourni par l'utilisateur.

NCCL_SOCKET_IFNAME

GLOO_SOCKET_IFNAME

JR_SOCKET_IFNAME

Nom de l'interface réseau. Pour plus d'informations, reportez-vous aux sections suivantes 

Documentation NVIDIA sur les variables d'environnement

Documentation Pytorch sur les variables d'environnement

CLUSTER_NODES_METADATA_FILE Chemin d'accès au fichier contenant les métadonnées des noeuds de cluster.
INITIAL_CLUSTER_SIZE

Nombre total de noeuds de cluster sur tous les groupes de noeuds d'exécution de travail au moment du démarrage.

Seule la taille de cluster initiale est indiquée.

FQDN Nom de domaine qualifié complet du noeud qui peut être utilisé pour que les noeuds communiquent avec d'autres noeuds.
Variables pour l'utilisation de votre propre conteneur
Important

Ces variables concernent uniquement la version 1 de Bring Your Own Container. Pour obtenir les dernières informations sur la configuration de l'utilisation de votre propre conteneur à l'aide des configurations d'environnement, reportez-vous à Création d'un travail.
Définissez les variables d'environnement suivantes pour un travail d'utilisation de votre propre conteneur lors de sa création :
Clé Type de valeur Exemple de valeur Description

CONTAINER_CUSTOM_IMAGE

Chaîne (requise)

iad.ocir.io/ociodscdev/jobrun

Chemin complet de la balise, de l'image et du référentiel Oracle Container Registry (OCIR) au format canonique. Par exemple :

<region>.ocir.io/<registry>/<image>:<tag>

Important : l'utilisation de vos propres travaux de conteneur ne prend pas en charge l'extraction d'images de conteneur inter-région. Par exemple, lorsque vous exécutez votre propre travail de conteneur dans une région IAD (Ashburn), vous ne pouvez pas extraire d'images de conteneur à partir d'OCIR (Oracle Cloud Container Registry) dans la région PHX (Phoenix).

CONTAINER_ENTRYPOINT

Chaîne[]

`"ls", "-l"`

ENTRYPOINT pour l'exécution d'image de conteneur sous forme de liste de chaînes.

Acceptez CMD en tant qu'arguments supplémentaires.

CONTAINER_CMD

Chaîne[]

`"-a", "-h"`

`"ls", "-l", "-a", "-h"`

CMD pour l'exécution de conteneur sous forme de liste de chaînes.

Utilisez CMD comme arguments pour ENTRYPOINT ou comme seule commande à exécuter en l'absence de ENTRYPOINT.