ScriptRunConfig Clase

Representa información de configuración para enviar una ejecución de entrenamiento en Azure Machine Learning.

Un scriptRunConfig empaqueta la información de configuración necesaria para enviar una ejecución en Azure ML, incluido el script, el destino de proceso, el entorno y las configuraciones específicas del trabajo distribuido.

Una vez configurada y enviada una ejecución de script con submit, se devuelve .ScriptRun

Constructor De clase ScriptRunConfig.

Constructor

ScriptRunConfig(source_directory, script=None, arguments=None, run_config=None, _telemetry_values=None, compute_target=None, environment=None, distributed_job_config=None, resume_from=None, max_run_duration_seconds=2592000, command=None, docker_runtime_config=None)

Parámetros

Nombre	Description
source_directory Requerido	str Directorio local que contiene archivos de código necesarios para una ejecución.
script Requerido	str Ruta de acceso del archivo relativa a la source_directory del script que se va a ejecutar.
arguments Requerido	list o str Argumentos opcionales de la línea de comandos que se van a pasar al script de entrenamiento. Los argumentos se pasan en pares, por ejemplo, ['–arg1', arg1_val, '–arg2', arg2_val].
run_config Requerido	RunConfiguration Configuración de ejecución opcional que se va a usar.
_telemetry_values Requerido	dict Solo para uso interno.
compute_target Requerido	AbstractComputeTarget o str Destino de proceso donde se realizará el entrenamiento. Puede ser un objeto ComputeTarget, el nombre de un objeto ComputeTarget existente o la cadena "local". Si no se especifica ningún destino de proceso, se usará la máquina local.
environment Requerido	Environment Entorno que se va a usar para la ejecución. Si no se especifica ningún entorno, azureml.core.runconfig.DEFAULT_CPU_IMAGE se usará como imagen de Docker para la ejecución.
distributed_job_config Requerido	TensorflowConfiguration, MpiConfiguration o PyTorchConfiguration Para los trabajos que requieren configuraciones adicionales específicas del trabajo distribuido.
resume_from Requerido	DataPath DataPath que contiene los archivos de punto de control o modelo desde los que reanudar el experimento.
max_run_duration_seconds Requerido	Tiempo máximo permitido para la ejecución. El sistema intentará cancelar automáticamente la ejecución si tardó más de este valor. :type max_run_duration_seconds: int
command Requerido	list[str] o str Comando que se va a enviar para la ejecución. La propiedad command también se puede usar en lugar de script/arguments. No se pueden usar las propiedades de comandos y argumentos ni del script ni del argumento para enviar una ejecución. Para enviar un archivo de script mediante la propiedad command - ['python', 'train.py', '–arg1', arg1_val] Para ejecutar un comando real - ['ls']
docker_runtime_config Requerido	DockerConfiguration Para los trabajos que requieren configuraciones específicas del entorno de ejecución de Docker.
source_directory Requerido	str Directorio local que contiene archivos de código necesarios para una ejecución.
script Requerido	str Ruta de acceso del archivo relativa a la source_directory del script que se va a ejecutar.
arguments Requerido	list[str] Argumentos opcionales de la línea de comandos que se van a pasar al script de entrenamiento. Los argumentos se pasan en pares, por ejemplo, ['–arg1', arg1_val, '–arg2', arg2_val].
run_config Requerido	RunConfiguration Configuración de ejecución opcional que se va a usar.
_telemetry_values Requerido	dict Solo para uso interno.
compute_target Requerido	AbstractComputeTarget o str Destino de proceso donde se realizará el entrenamiento. Puede ser un objeto ComputeTarget, el nombre de un objeto ComputeTarget existente o la cadena "local". Si no se especifica ningún destino de proceso, se usará la máquina local.
environment Requerido	Environment Entorno que se va a usar para la ejecución. Si no se especifica ningún entorno, azureml.core.runconfig.DEFAULT_CPU_IMAGE se usará como imagen de Docker para la ejecución.
distributed_job_config Requerido	TensorflowConfiguration o MpiConfiguration o PyTorchConfiguration Para los trabajos que requieren configuraciones adicionales específicas del trabajo distribuido.
resume_from Requerido	DataPath DataPath que contiene los archivos de punto de control o modelo desde los que reanudar el experimento.
max_run_duration_seconds Requerido	int Tiempo máximo permitido para la ejecución. El sistema intentará cancelar automáticamente la ejecución si tardó más de este valor.
command Requerido	list[str] o str Comando que se va a enviar para la ejecución. La propiedad command también se puede usar en lugar de script/arguments. No se pueden usar las propiedades de comandos y argumentos ni del script ni del argumento para enviar una ejecución. Para enviar un archivo de script mediante la propiedad command - ['python', 'train.py', '–arg1', arg1_val] Para ejecutar un comando real - ['ls']
docker_runtime_config Requerido	DockerConfiguration Para los trabajos que requieren configuraciones específicas del entorno de ejecución de Docker.

Comentarios

El SDK de Azure Machine Learning proporciona una serie de clases interconectadas diseñadas para ayudarle a entrenar y comparar modelos de aprendizaje automático relacionados con el problema compartido que están solucionando.

actúa Experiment como un contenedor lógico para estas ejecuciones de entrenamiento. Un objeto ScriptRunConfig se usa para configurar la información necesaria para enviar una ejecución de entrenamiento como parte de un experimento. Cuando se envía una ejecución mediante un objeto ScriptRunConfig, el método submit devuelve un objeto de tipo ScriptRun. A continuación, el objeto ScriptRun devuelto proporciona acceso mediante programación a información sobre la ejecución de entrenamiento. ScriptRun es una clase secundaria de Run.

El concepto clave que se debe recordar es que hay diferentes objetos de configuración que se usan para enviar un experimento, en función de qué tipo de ejecución desea desencadenar. A continuación, el tipo del objeto de configuración informa de la clase secundaria Run you get back from the submit method (Ejecutar que se obtiene del método submit). Cuando se pasa un objeto ScriptRunConfig en una llamada al método de envío del experimento, se devuelve un objeto ScriptRun. Algunos ejemplos de otros objetos de ejecución devueltos son AutoMLRun (devueltos para una ejecución de AutoML) y PipelineRun (devueltos para una ejecución de canalización).

En el ejemplo siguiente se muestra cómo enviar un script de entrenamiento en la máquina local.

   from azureml.core import ScriptRunConfig, Experiment

   # create or load an experiment
   experiment = Experiment(workspace, 'MyExperiment')
   # create or retrieve a compute target
   cluster = workspace.compute_targets['MyCluster']
   # create or retrieve an environment
   env = Environment.get(ws, name='MyEnvironment')
   # configure and submit your training run
   config = ScriptRunConfig(source_directory='.',
                            script='train.py',
                            arguments=['--arg1', arg1_val, '--arg2', arg2_val],
                            compute_target=cluster,
                            environment=env)
   script_run = experiment.submit(config)

En el ejemplo siguiente se muestra cómo enviar un script de entrenamiento en el clúster mediante la propiedad command en lugar de script y argumentos.

   from azureml.core import ScriptRunConfig, Experiment
   # create or load an experiment
   experiment = Experiment(workspace, 'MyExperiment')
   # create or retrieve a compute target
   cluster = workspace.compute_targets['MyCluster']
   # create or retrieve an environment
   env = Environment.get(ws, name='MyEnvironment')
   # configure and submit your training run
   config = ScriptRunConfig(source_directory='.',
                            command=['python', 'train.py', '--arg1', arg1_val],
                            compute_target=cluster,
                            environment=env)
   script_run = experiment.submit(config)

En el ejemplo siguiente se muestra cómo ejecutar un comando en el clúster.

   from azureml.core import ScriptRunConfig, Experiment
   # create or load an experiment
   experiment = Experiment(workspace, 'MyExperiment')
   # create or retrieve a compute target
   cluster = workspace.compute_targets['MyCluster']
   # create or retrieve an environment
   env = Environment.get(ws, name='MyEnvironment')
   # configure and submit your training run
   config = ScriptRunConfig(source_directory='.',
                            command=['ls', '-l'],
                            compute_target=cluster,
                            environment=env)
   script_run = experiment.submit(config)

Para obtener más ejemplos que muestran cómo trabajar con ScriptRunConfig, consulte:

• en el artículo Selección y uso de un destino de proceso para entrenar el modelo

• estos cuadernos de entrenamiento

Atributos

MAX_DURATION_SECONDS_DEFAULT

MAX_DURATION_SECONDS_DEFAULT = 2592000