PublishedPipeline Třída
Představuje kanál, který se má odeslat bez kódu Pythonu, který ho vytvořil.
Kromě toho lze publikovanýpipeline použít k opětovnému odeslání Pipeline s různými PipelineParameter hodnotami a vstupy.
Inicializace publishedPipeline
:p aaram koncový bod ADRESA URL koncového bodu REST pro odesílání spuštění kanálu pro tento kanál. :type endpoint: str :p aram total_run_steps: Počet kroků v tomto kanálu :type total_run_steps: int :p aram workspace: Pracovní prostor publikovaného kanálu. :type workspace: azureml.core.Workspace :p aram continue_on_step_failure: Zda pokračovat v provádění dalších kroků v Spuštění kanálu
Pokud se krok nezdaří, výchozí hodnota je false.
Konstruktor
PublishedPipeline(name, graph_id, description, version, published_pipeline_id, status, endpoint, total_run_steps, workspace, continue_on_step_failure=None, _pipeline_provider=None, **kwargs)
Parametry
| Name | Description |
|---|---|
|
name
Vyžadováno
|
Název publikovaného kanálu. |
|
graph_id
Vyžadováno
|
ID grafu pro tento publikovaný kanál. |
|
description
Vyžadováno
|
Popis publikovaného kanálu. |
|
version
Vyžadováno
|
Publikovaná verze kanálu. |
|
published_pipeline_id
Vyžadováno
|
ID publikovaného kanálu. |
|
status
Vyžadováno
|
Stav publikovaného kanálu (Aktivní nebo Zakázáno). |
|
endpoint
Vyžadováno
|
Adresa URL koncového bodu REST, která odešle spuštění pro tento kanál. |
|
total_run_steps
Vyžadováno
|
Početkrokůch |
|
workspace
Vyžadováno
|
Pracovní prostor publikovaného kanálu. |
|
continue_on_step_failure
Vyžadováno
|
Zda pokračovat v provádění dalších kroků v PipelineRun, pokud krok selže. Výchozí hodnota je false. |
|
_pipeline_provider
Vyžadováno
|
<xref:azureml.pipeline.core._workflow_provider._PublishedPipelineProvider>
Poskytovatel publikovaného kanálu. |
|
kwargs
Vyžadováno
|
Vlastní argumenty klíčových slov, vyhrazené pro budoucí vývoj |
|
name
Vyžadováno
|
Název publikovaného kanálu. |
|
graph_id
Vyžadováno
|
ID grafu pro tento publikovaný kanál. |
|
description
Vyžadováno
|
Popis publikovaného kanálu. |
|
version
Vyžadováno
|
Publikovaná verze kanálu. |
|
published_pipeline_id
Vyžadováno
|
ID publikovaného kanálu. |
|
status
Vyžadováno
|
Stav publikovaného kanálu (Aktivní nebo Zakázáno). |
|
_pipeline_provider
Vyžadováno
|
<xref:azureml.pipeline.core._workflow_provider._PublishedPipelineProvider>
Poskytovatel publikovaného kanálu. |
|
kwargs
Vyžadováno
|
Vlastní argumenty klíčových slov, vyhrazené pro budoucí vývoj |
Poznámky
Publikovanýpipeline lze vytvořit z objektu nebo z objektu PipelinePipelineRun.
Příklad publikování z kanálu je následující:
from azureml.pipeline.core import Pipeline
pipeline = Pipeline(workspace=ws, steps=steps)
published_pipeline = pipeline.publish(name="My_New_Pipeline",
description="My New Pipeline Description",
version="1.0",
continue_on_step_failure=True)
K publikování z pipelineRunu použijte:
from azureml.pipeline.core import PipelineRun
pipeline_run = PipelineRun(experiment=Experiment(ws, "Pipeline_experiment"), run_id="run_id")
published_pipeline = pipeline_run.publish_pipeline(name="My_New_Pipeline",
description="My New Pipeline Description",
version="1.0",
continue_on_step_failure=True)
Poznámka: Parametr continue_on_step_failure určuje, jestli provádění kroků v kanálu bude pokračovat, pokud jeden krok selže. Výchozí hodnota je False, což znamená, že když jeden krok selže, spuštění kanálu se zastaví a zruší všechny spuštěné kroky.
Odešle publikovanoupipeline pomocí submit. Při volání odeslání se vytvoří PipelineRun objekty StepRun pro každý krok pracovního postupu.
Příklad odeslání publikovanéhopipeline je následující:
from azureml.pipeline.core import PublishedPipeline
published_pipeline = PublishedPipeline.get(workspace=ws, id="published_pipeline_id")
pipeline_run = experiment.submit(published_pipeline)
Při odesílání publikovanéhopipeline je možné zadat několik volitelných nastavení. Patří mezi ně:
continue_on_step_failure: Jestli chcete pokračovat v provádění dalších kroků v spuštění kanálu, pokud krok selže, volitelné. Pokračovat v provádění budou pouze kroky, které nemají žádnou závislost na výstupu neúspěšného kroku. Pokud je k dispozici, toto nastavení parametru přepíše nastavení kanálu.
pipeline_parameters: Parametry spuštění kanálu, slovník {name: value}. Další podrobnosti najdete v PipelineParameter.
parent_run_id: Můžete zadat ID spuštění pro nastavení nadřazeného spuštění tohoto spuštění kanálu, který se odráží v runHistory. Nadřazené spuštění musí patřit do stejného experimentu jako kanál, který se odesílá.
Příklad odeslání PublishedPipeline pomocí těchto nastavení:
from azureml.pipeline.core import PublishedPipeline
published_pipeline = PublishedPipeline.get(workspace=ws, id="published_pipeline_id")
pipeline_run = experiment.submit(published_pipeline,
continue_on_step_failure=True,
pipeline_parameters={"param1": "value1"},
parent_run_id="<run_id>")
Všechny publikované kanály mají koncový bod REST. S koncovým bodem kanálu můžete aktivovat spuštění kanálu z externích systémů, jako jsou klienti mimo Python. Informace o ověřování při volání koncovýchbodůch https://aka.ms/pl-restep-auth
Použití koncového bodu umožňuje "spravovanou opakovatelnost" ve scénářích dávkového bodování a opětovném natrénování, například. Další informace najdete v tématu https://aka.ms/pl-first-pipeline.
Metody
| disable |
Nastavte publikovaný kanál na Zakázáno a není možné ho spustit. |
| enable |
Nastavte publikovaný kanál na Aktivní a můžete ho spustit. |
| get |
Získejte publikovaný kanál. |
| get_all |
Získejte všechny publikované kanály v aktuálním pracovním prostoru. ZASTARALÉ: Tato metoda je zastaralá ve prospěch metody PublishedPipeline list . |
| get_graph |
Získejte graf publikovanéhopipeline. |
| get_step_names |
Získejte seznam názvů kroků v publikovanémpipeline. |
| list |
Získejte všechny publikované kanály v aktuálním pracovním prostoru. |
| save |
Uložte YAML kanálu do souboru. V současné době se pro export YAML podporují jenom kanály, které se skládají z modulů ModuleStep. |
| submit |
Odešlete publikovaný kanál. To je ekvivalent použití submit. Vrátí odeslanou PipelineRunhodnotu . Tento objekt slouží k monitorování a zobrazení podrobností o spuštění. |
disable
Nastavte publikovaný kanál na Zakázáno a není možné ho spustit.
disable()
enable
Nastavte publikovaný kanál na Aktivní a můžete ho spustit.
enable()
get
Získejte publikovaný kanál.
static get(workspace, id, _workflow_provider=None, _service_endpoint=None)
Parametry
| Name | Description |
|---|---|
|
workspace
Vyžadováno
|
Pracovní prostor, ve který byl publikovaný kanál vytvořen. |
|
id
Vyžadováno
|
ID publikovaného kanálu. |
|
_workflow_provider
|
<xref:azureml.pipeline.core._aeva_provider._AevaWorkflowProvider>
Zprostředkovatel pracovního postupu. Default value: None
|
|
_service_endpoint
|
Koncový bod služby. Default value: None
|
Návraty
| Typ | Description |
|---|---|
|
A PublishedPipeline objekt. |
get_all
Získejte všechny publikované kanály v aktuálním pracovním prostoru.
ZASTARALÉ: Tato metoda je zastaralá ve prospěch metody PublishedPipeline list .
static get_all(workspace, active_only=True, _service_endpoint=None)
Parametry
| Name | Description |
|---|---|
|
workspace
Vyžadováno
|
Pracovní prostor, na který byl publikovaný kanál vytvořen. |
|
active_only
|
Zda se mají vrátit pouze publikované kanály, které jsou aktuálně aktivní. Default value: True
|
|
_service_endpoint
|
Koncový bod služby. Default value: None
|
Návraty
| Typ | Description |
|---|---|
|
Seznam PublikovanýPipeline objekty. |
get_graph
Získejte graf publikovanéhopipeline.
get_graph(_workflow_provider=None)
Parametry
| Name | Description |
|---|---|
|
_workflow_provider
|
<xref:azureml.pipeline.core._aeva_provider._AevaWorkflowProvider>
Zprostředkovatel pracovního postupu. Default value: None
|
Návraty
| Typ | Description |
|---|---|
|
Graf. |
get_step_names
Získejte seznam názvů kroků v publikovanémpipeline.
get_step_names(_workflow_provider=None)
Parametry
| Name | Description |
|---|---|
|
_workflow_provider
|
<xref:azureml.pipeline.core._aeva_provider._AevaWorkflowProvider>
Zprostředkovatel pracovního postupu. Default value: None
|
Návraty
| Typ | Description |
|---|---|
|
Seznam názvů kroků v publikovanémpipeline. |
list
Získejte všechny publikované kanály v aktuálním pracovním prostoru.
static list(workspace, active_only=True, _service_endpoint=None)
Parametry
| Name | Description |
|---|---|
|
workspace
Vyžadováno
|
Pracovní prostor, ve který byl publikovaný kanál vytvořen. |
|
active_only
|
Zda se mají vrátit pouze publikované kanály, které jsou aktuálně aktivní. Default value: True
|
|
_service_endpoint
|
Koncový bod služby. Default value: None
|
Návraty
| Typ | Description |
|---|---|
|
Seznam PublikovanýPipeline objekty. |
save
Uložte YAML kanálu do souboru.
V současné době se pro export YAML podporují jenom kanály, které se skládají z modulů ModuleStep.
save(path=None, _workflow_provider=None)
Parametry
| Name | Description |
|---|---|
|
path
|
Cesta k uložení YAML do. Pokud je cesta adresář, uloží se soubor YAML kanálu na cestě nebo pipeline_name.yml. Pokud cesta není Žádná, použije se aktuální adresář. Default value: None
|
|
_workflow_provider
|
<xref:azureml.pipeline.core._aeva_provider._AevaWorkflowProvider>
Zprostředkovatel pracovního postupu. Default value: None
|
Návraty
| Typ | Description |
|---|---|
submit
Odešlete publikovaný kanál. To je ekvivalent použití submit.
Vrátí odeslanou PipelineRunhodnotu . Tento objekt slouží k monitorování a zobrazení podrobností o spuštění.
submit(workspace, experiment_name, pipeline_parameters=None, _workflow_provider=None, _service_endpoint=None, parent_run_id=None, continue_on_step_failure=None)
Parametry
| Name | Description |
|---|---|
|
workspace
Vyžadováno
|
Pracovní prostor pro odeslání publikovaného kanálu. |
|
experiment_name
Vyžadováno
|
Název experimentu, do který se má odeslat. |
|
pipeline_parameters
|
Slovník parametrů pro přiřazení nových hodnot {název parametru, hodnota parametru}. Další podrobnosti najdete v PipelineParameter. Default value: None
|
|
_workflow_provider
|
<xref:azureml.pipeline.core._aeva_provider._AevaWorkflowProvider>
Zprostředkovatel pracovního postupu. Default value: None
|
|
_service_endpoint
|
Koncový bod služby. Default value: None
|
|
parent_run_id
|
Volitelné ID spuštění, které se nastaví pro nadřazené spuštění tohoto kanálu, což se projeví v runHistory. Nadřazené spuštění musí patřit do stejného experimentu, do kterého se tento kanál odesílá. Default value: None
|
|
continue_on_step_failure
|
Jestli chcete pokračovat v provádění dalších kroků v PipelineRunu, pokud se krok nezdaří, volitelné. V případě potřeby přepíše nastavení kanálu. Default value: None
|
Návraty
| Typ | Description |
|---|---|
|
Odeslaná spuštění kanálu. |
Atributy
continue_on_step_failure
Získá hodnotu continue_on_step_failure nastavení.
Návraty
| Typ | Description |
|---|---|
|
Hodnota |
description
endpoint
Získejte adresu URL koncového bodu REST pro spuštění publikovaného kanálu.
Návraty
| Typ | Description |
|---|---|
|
Adresa URL koncového bodu REST pro spuštění publikovaného kanálu. |