Поделиться через


PipelineDraft Класс

Представляет изменяемый конвейер, который можно использовать для отправки выполнений и создания опубликованных конвейеров.

Используйте PipelineDrafts для выполнения итерации по конвейерам. PipelineDraft можно создать с нуля, из другого PipelineDraft или существующих конвейеров: Pipeline, PublishedPipeline или PipelineRun.

Инициализация PipelineDraft.

Наследование
builtins.object
PipelineDraft

Конструктор

PipelineDraft(workspace, id, name=None, description=None, experiment_name=None, tags=None, properties=None, graph_draft_id=None, parent_pipeline_id=None, parent_pipeline_run_id=None, parent_step_run_ids=None, parent_pipeline_draft_id=None, last_submitted_pipeline_run_id=None, _pipeline_draft_provider=None)

Параметры

Имя Описание
workspace
Обязательно

Объект рабочей области для этого PipelineDraft.

id
Обязательно
str

Идентификатор PipelineDraft.

name
Обязательно
str

Имя PipelineDraft.

description
Обязательно
str

Описание PipelineDraft.

experiment_name
Обязательно
str

Имя эксперимента для PipelineDraft.

tags
Обязательно

Словарь необязательных тегов для PipelineDraft.

properties
Обязательно

Словарь необязательных свойств для PipelineDraft.

graph_draft_id
Обязательно
str

Идентификатор черновика графа, связанного с PipelineDraft.

parent_pipeline_id
Обязательно
str

Идентификатор родительского PublishedPipeline.

parent_pipeline_run_id
Обязательно
str

Идентификатор родительского PipelineRun.

parent_step_run_ids
Обязательно

Список идентификаторов StepRun родительского PipelineRun.

parent_pipeline_draft_id
Обязательно
str

Идентификатор родительского PipelineDraft.

last_submitted_pipeline_run_id
Обязательно
str

Идентификатор последнего отправленного PipelineRun.

_pipeline_draft_provider
Обязательно
<xref:azureml.pipeline.core._aeva_provider._AevaPipelineDraftProvider>

(Только для внутреннего использования.) Поставщик PipelineDraft.

workspace
Обязательно

Объект workspace для этого PipelineDraft.

id
Обязательно
str

Идентификатор PipelineDraft.

name
Обязательно
str

Имя PipelineDraft.

description
Обязательно
str

Описание PipelineDraft.

experiment_name
Обязательно
str

Имя эксперимента для PipelineDraft.

tags
Обязательно

Словарь тегов для PipelineDraft.

properties
Обязательно

Словарь свойств для PipelineDraft.

graph_draft_id
Обязательно
str

Идентификатор черновика графа, связанного с PipelineDraft.

parent_pipeline_id
Обязательно
str

Идентификатор родительского объекта PublishedPipeline.

parent_pipeline_run_id
Обязательно
str

Идентификатор родительского PipelineRun.

parent_step_run_ids
Обязательно

Список идентификаторов StepRun родительского PipelineRun.

parent_pipeline_draft_id
Обязательно
str

Идентификатор родительского PipelineDraft.

last_submitted_pipeline_run_id
Обязательно
str

Идентификатор последнего отправленного PipelineRun.

_pipeline_draft_provider
Обязательно
<xref:azureml.pipeline.core._aeva_provider._AevaPipelineDraftProvider>

Поставщик PipelineDraft.

Комментарии

PipelineDraft можно создать из Pipeline с помощью функции create. Пример представлен ниже.


   from azureml.pipeline.core import Pipeline, PipelineDraft
   from azureml.pipeline.steps import PythonScriptStep

   train_step = PythonScriptStep(name="Training_Step",
                                 script_name="train.py",
                                 compute_target=aml_compute_target,
                                 source_directory=".")
   pipeline = Pipeline(workspace=ws, steps=[train_step])
   pipeline_draft = PipelineDraft.create(workspace=ws,
                                         name="TestPipelineDraft",
                                         description="draft description",
                                         experiment_name="helloworld",
                                         pipeline=pipeline,
                                         continue_on_step_failure=True,
                                         tags={'dev': 'true'},
                                         properties={'train': 'value'})

Параметр конвейера PipelineDraft.create()pipeline может быть PublishedPipeline, PipelineRun или другим PipelineDraft.

Чтобы отправить запуск из PipelineDraft, используйте метод submit_run:


   pipeline_run = pipeline_draft.submit_run()

Чтобы обновить PipelineDraft, используйте метод update. Функцию update() в черновике конвейера можно использовать для обновления имени, описания, имени эксперимента, назначений параметров конвейера, продолжения при сбое шага и конвейера, связанного с PipelineDraft.


   new_train_step = PythonScriptStep(name="New_Training_Step",
                                     script_name="train.py",
                                     compute_target=aml_compute_target,
                                     source_directory=source_directory)

   new_pipeline = Pipeline(workspace=ws, steps=[new_train_step])

   pipeline_draft.update(name="UpdatedPipelineDraft",
                         description="has updated train step",
                         pipeline=new_pipeline)

Методы

create

Создание PipelineDraft.

delete

Удаление PipelineDraft.

get

Получение PipelineDraft с заданным идентификатором.

get_graph

Получение графа, связанного с PipelineDraft.

list

Получение всех черновиков конвейера в рабочей области.

publish

Публикация PublishedPipeline из PipelineDraft.

save

Сохранение PipelineDraft YAML в файл.

submit_run

Отправка PipelineRun из PipelineDraft.

update

Обновление PipelineDraft.

Указанные поля будут обновлены.

create

Создание PipelineDraft.

static create(workspace, pipeline, name=None, description=None, experiment_name=None, pipeline_parameters=None, continue_on_step_failure=None, tags=None, properties=None, _workflow_provider=None, _service_endpoint=None)

Параметры

Имя Описание
workspace
Обязательно

Объект рабочей области, к которому будет принадлежать этот PipelineDraft.

pipeline
Обязательно

Конвейер или опубликованный конвейер.

name
str

Имя PipelineDraft; требуется только при создании из Pipeline.

значение по умолчанию: None
description
str

Описание PipelineDraft; требуется только при создании из Pipeline.

значение по умолчанию: None
experiment_name
str

Имя эксперимента для PipelineDraft; требуется только при создании из Pipeline.

значение по умолчанию: None
pipeline_parameters

Необязательный словарь назначений параметров конвейера для PipelineDraft; требуется только при создании из Pipeline.

значение по умолчанию: None
continue_on_step_failure

Указывает, следует ли продолжить PipelineRun при сбое выполнения шага для PipelineDraft; требуется только при создании из Pipeline.

значение по умолчанию: None
tags

Необязательный словарь тегов для PipelineDraft, необходимый только при создании из Pipeline.

значение по умолчанию: None
properties

Необязательный словарь свойств для PipelineDraft, необходимый только при создании из Pipeline.

значение по умолчанию: None
_service_endpoint
str

Конечная точка службы.

значение по умолчанию: None
_workflow_provider
<xref:azureml.pipeline.core._aeva_provider._AevaWorkflowProvider>

(Только для внутреннего использования.) Поставщик рабочих процессов.

значение по умолчанию: None

Возвращаемое значение

Тип Описание

Созданный PipelineDraft.

delete

Удаление PipelineDraft.

delete(_workflow_provider=None)

Параметры

Имя Описание
_workflow_provider
<xref:azureml.pipeline.core._aeva_provider._AevaWorkflowProvider>

(Только для внутреннего использования.) Поставщик рабочих процессов.

значение по умолчанию: None

get

Получение PipelineDraft с заданным идентификатором.

static get(workspace, id, _workflow_provider=None, _service_endpoint=None)

Параметры

Имя Описание
workspace
Обязательно

Рабочая область, в которой создан объект PipelineDraft.

id
Обязательно
str

Идентификатор PipelineDraft.

_workflow_provider
<xref:azureml.pipeline.core._aeva_provider._AevaWorkflowProvider>

(Только для внутреннего использования.) Поставщик рабочих процессов.

значение по умолчанию: None
_service_endpoint
str

Конечная точка службы.

значение по умолчанию: None

Возвращаемое значение

Тип Описание

Объект PipelineDraft

get_graph

Получение графа, связанного с PipelineDraft.

get_graph(_workflow_provider=None)

Параметры

Имя Описание
_workflow_provider
<xref:azureml.pipeline.core._aeva_provider._AevaWorkflowProvider>

(Только для внутреннего использования.) Поставщик рабочих процессов.

значение по умолчанию: None

Возвращаемое значение

Тип Описание

Объект Graph.

list

Получение всех черновиков конвейера в рабочей области.

static list(workspace, tags=None, _workflow_provider=None)

Параметры

Имя Описание
workspace
Обязательно

Рабочая область, в которой необходимо показать список черновиков.

tags

Если указан этот параметр, возвращает черновики, соответствующие указанным значениям {"tag": "value"}.

значение по умолчанию: None
_workflow_provider
<xref:azureml.pipeline.core._aeva_provider._AevaWorkflowProvider>

(Только для внутреннего использования.) Поставщик рабочих процессов.

значение по умолчанию: None

Возвращаемое значение

Тип Описание

Список объектов PipelineDraft.

publish

Публикация PublishedPipeline из PipelineDraft.

publish(_workflow_provider=None)

Параметры

Имя Описание
_workflow_provider
<xref:azureml.pipeline.core._aeva_provider._AevaWorkflowProvider>

(Только для внутреннего использования.) Поставщик рабочих процессов.

значение по умолчанию: None

Возвращаемое значение

Тип Описание

Созданный PublishedPipeline.

save

Сохранение PipelineDraft YAML в файл.

save(path=None, _workflow_provider=None)

Параметры

Имя Описание
path
str

Путь для сохранения YAML. Если путь является каталогом, файл YAML PipelineDraft сохраняется по адресу path/pipeline_name.yml. Если путь имеет значение None, используется текущий каталог.

значение по умолчанию: None
_workflow_provider
<xref:azureml.pipeline.core._aeva_provider._AevaWorkflowProvider>

(Только для внутреннего использования.) Поставщик рабочих процессов.

значение по умолчанию: None

Возвращаемое значение

Тип Описание

submit_run

Отправка PipelineRun из PipelineDraft.

submit_run(_workflow_provider=None)

Параметры

Имя Описание
_workflow_provider
<xref:azureml.pipeline.core._aeva_provider._AevaWorkflowProvider>

(Только для внутреннего использования.) Поставщик рабочих процессов.

значение по умолчанию: None

Возвращаемое значение

Тип Описание

Отправленный PipelineRun.

update

Обновление PipelineDraft.

Указанные поля будут обновлены.

update(pipeline=None, name=None, description=None, experiment_name=None, tags=None, pipeline_parameters=None, continue_on_step_failure=None, _workflow_provider=None)

Параметры

Имя Описание
pipeline

Обновленный конвейер для черновика.

значение по умолчанию: None
name
str

Имя PipelineDraft.

значение по умолчанию: None
description
str

Описание PipelineDraft.

значение по умолчанию: None
experiment_name
str

Имя эксперимента для PipelineDraft.

значение по умолчанию: None
tags

Словарь тегов для PipelineDraft.

значение по умолчанию: None
pipeline_parameters

Назначения параметров конвейера для PipelineDraft.

значение по умолчанию: None
continue_on_step_failure

Следует ли продолжать PipelineRun, если происходит сбой выполнения шага для PipelineDraft.

значение по умолчанию: None
_workflow_provider
<xref:azureml.pipeline.core._aeva_provider._AevaWorkflowProvider>

(Только для внутреннего использования.) Поставщик рабочих процессов.

значение по умолчанию: None

Атрибуты

description

Получение описания PipelineDraft.

Возвращаемое значение

Тип Описание
str

Строка описания.

id

Получение идентификатора PipelineDraft.

Возвращаемое значение

Тип Описание
str

Идентификатор.

last_submitted_pipeline_run_id

Получение идентификатора последнего отправленного PipelineRun в PipelineDraft.

Возвращаемое значение

Тип Описание
str

Идентификатор PipelineRun.

name

Получение имени PipelineDraft.

Возвращаемое значение

Тип Описание
str

Имя.

parent_pipeline_draft_id

Получение идентификатора родительского PipelineDraft в PipelineDraft.

Возвращаемое значение

Тип Описание
str

Идентификатор PipelineDraft.

parent_pipeline_id

Получение идентификатора родительского PublishedPipeline в PipelineDraft.

Возвращаемое значение

Тип Описание
str

Идентификатор PublishedPipeline.

parent_pipeline_run_id

Получение идентификатора родительского PipelineRun в PipelineDraft.

Возвращаемое значение

Тип Описание
str

Идентификатор PipelineRun.

parent_step_run_ids

Получение идентификатора родительского PipelineRun в PipelineDraft.

Возвращаемое значение

Тип Описание

Список идентификаторов StepRun.

properties

Получение свойств PipelineDraft.

Возвращаемое значение

Тип Описание

Словарь свойств.

tags

Получение тегов PipelineDraft.

Возвращаемое значение

Тип Описание

Словарь тегов.