az ml job create --file pipeline.yml --workspace-name <workspace> --resource-group <group>ML pipeline
An ML pipeline is an Azure Machine Learning workflow that connects repeatable training, evaluation, registration, or scoring steps.
Source: Microsoft Learn - Create and run component-based ML pipelines Reviewed 2026-05-16T06:53:13Z
- Exam trap
- Changing ML pipeline without checking dependent resources, owner approval, monitoring signals, and rollback steps first.
- Production check
- Confirm the resource name, subscription, region, scope, owner tag, and production environment before making any change.
Article details and learning context
- Aliases
- Azure ML pipeline, machine learning pipeline, pipeline job
- Difficulty
- intermediate
- CLI mappings
- 4
- Last verified
- 2026-05-16T06:53:13Z
Understand the concept
In plain English
An ML pipeline is an Azure Machine Learning workflow that links component or command steps into a repeatable process. A pipeline can prepare data, train a model, evaluate results, register an artifact, and run batch scoring with clear dependencies between steps. It replaces ad hoc notebook handoffs with a graph that Azure can execute, monitor, and reproduce. Treat it as the orchestration layer for ML work: child jobs run the code, while the pipeline controls order, inputs, outputs, and evidence.
Why it matters
ML pipeline matters because it turns a design choice into something operators, developers, security reviewers, and FinOps owners can inspect. Without a clear definition, teams may change the wrong setting, misread symptoms, or accept weak defaults. The value is not just the feature itself; it is the evidence trail around it. A strong implementation shows who owns the setting, what workload depends on it, how it is monitored, and what should happen before a change reaches production. That makes support faster and reduces surprise during audits, migrations, scale events, and incidents. Record the owner, evidence, rollback step, and monitoring signal before release.
Official wording and source
Microsoft Learn describes Azure Machine Learning pipelines as jobs that connect child jobs into a directed workflow. Pipeline jobs define component steps, inputs, outputs, dependencies, compute, and execution settings so teams can automate training, evaluation, registration, or scoring as reproducible MLOps workflows.
Technical context
Technically, ML pipeline sits in the Azure Machine Learning workflow layer for pipeline jobs, component jobs, inputs, outputs, data dependencies, compute targets, environments, and step lineage. It is represented as a pipeline job definition with child jobs, dependency graph, input and output bindings, component references, compute choices, settings, and run status, and it usually depends on an ML workspace, components or command jobs, environments, compute, data assets, datastores, model registry, identity, and optional schedules or CI/CD triggers. The boundary is the pipeline orchestrates step order and data flow, while child jobs execute code and produce artifacts.
Exam context
Compare with
Where it is used
Where you see it
- In Azure Machine Learning studio, pipelines appear in job graphs, pipeline job details, component steps, input and output panes, metrics, logs, and schedule configuration, for review, release approval, and audit.
- In CLI or REST output, they appear with pipeline job names, child job status, dependency graph, component references, compute choices, input bindings, output paths, and errors.
- In release reviews, they appear when teams discuss training automation, repeatable evaluation, model registration steps, batch scoring, approval evidence, and reproducible workflow design, when operators need evidence during support.
Common situations
- Run multi-step ML workflows repeatably.
- Connect components with defined inputs and outputs.
- Automate training, evaluation, and registration.
- Inspect failed pipeline steps during support.
Illustrative Azure scenarios
These examples show how the concept can affect design and operations. They are illustrative scenarios, not customer claims.
Scenario 01 Claims model release pipeline Scenario, objectives, solution, measured impact, and takeaway.
HarborShield Insurance had separate notebooks for claim severity modeling, causing slow handoff and inconsistent evaluation.
- Run feature, training, and evaluation steps in order.
- Cut model release preparation by 50%.
- Preserve intermediate outputs for review.
- Block registration when evaluation fails.
The team created an Azure ML pipeline with reusable components for data validation, feature generation, training, and evaluation. The pipeline accepted a registered data asset and wrote outputs to governed storage. A final step emitted pass-fail metrics used by the model approval workflow. Operators submitted the pipeline through CLI and attached job graph evidence to the release ticket before registering the model. The implementation team captured before-and-after evidence, named the support owner, and added a rollback checkpoint so the change could be repeated safely during later releases. They also documented validation commands, expected healthy signals, escalation contacts, and the operational decision that would trigger a rollback during production support. The design review treated configuration, identity, monitoring, cost ownership, and incident response as one operating pattern instead of separate portal tasks.
- Release preparation time dropped from ten days to four.
- Evaluation failures blocked two weak models before registration.
- Intermediate outputs were available for reviewer inspection.
- Notebook-to-production handoff became a repeatable workflow.
An ML pipeline turns scattered ML steps into a governed workflow with traceable evidence.
Scenario 02 Retail forecast refresh Scenario, objectives, solution, measured impact, and takeaway.
BrightCart Retail needed to refresh demand forecasts across regions, but each analyst had a different script sequence.
- Standardize weekly forecast refresh steps.
- Run regional training in parallel where safe.
- Track every model back to its pipeline job.
Data scientists converted the refresh process into a pipeline job with components for data extraction, feature creation, model training, and evaluation. Each region passed through the same component versions, and outputs were tagged with forecast week. The platform team used CLI to submit the pipeline, inspect child jobs, and rerun failed regions. Azure Monitor alerts notified support if a pipeline step exceeded expected duration. The implementation team captured before-and-after evidence, named the support owner, and added a rollback checkpoint so the change could be repeated safely during later releases. They also documented validation commands, expected healthy signals, escalation contacts, and the operational decision that would trigger a rollback during production support. The design review treated configuration, identity, monitoring, cost ownership, and incident response as one operating pattern instead of separate portal tasks.
- Weekly refresh duration dropped by 37%.
- Regional failures no longer blocked every forecast.
- Model lineage tied each forecast to a pipeline job.
- Support effort during refresh fell by 44%.
Pipelines are practical when the sequence of ML work matters as much as the code itself.
Scenario 03 Factory quality automation Scenario, objectives, solution, measured impact, and takeaway.
ForgeLine Manufacturing wanted a repeatable retraining process when new factory images were labeled for defect detection.
- Automate data validation, training, and scoring tests.
- Reduce manual retraining steps by 70%.
- Keep GPU jobs within quota.
- Produce release evidence for plant managers.
The ML platform team built a pipeline with validation, augmentation, training, evaluation, and registration candidate steps. The pipeline used GPU compute only for training and CPU compute for validation and reporting. CLI output showed child job status and compute usage, while job artifacts contained evaluation metrics and sample predictions. Plant managers approved release only when the pipeline passed the defined threshold. The implementation team captured before-and-after evidence, named the support owner, and added a rollback checkpoint so the change could be repeated safely during later releases. They also documented validation commands, expected healthy signals, escalation contacts, and the operational decision that would trigger a rollback during production support. The design review treated configuration, identity, monitoring, cost ownership, and incident response as one operating pattern instead of separate portal tasks.
- Manual retraining steps fell by 82%.
- GPU usage stayed within approved quota.
- Failed data validation stopped one bad training run.
- Plant release meetings used pipeline evidence instead of ad hoc reports.
A pipeline gives ML operations a repeatable path from new data to deployable model evidence.
Azure CLI
Azure CLI is useful for ML pipeline because it creates repeatable evidence instead of relying on portal screenshots. Operators can inspect scope, state, identity, policy, resource properties, deployment settings, ML assets, compute, storage security, or related capacity before approving a change. CLI output also fits automation, audit packages, rollback reviews, and incident handoffs, which makes ML pipeline easier to govern consistently.
Useful for
- Inventory ML pipeline configuration across resource groups, subscriptions, workspaces, storage accounts, endpoints, assets, or compute targets before release review.
- Inspect live ML pipeline state during troubleshooting, audit evidence collection, migration planning, access review, or rollback validation.
- Create or update related settings through approved automation when the Azure CLI command group safely supports the operation.
- Export JSON output for change tickets, compliance review, drift detection, owner handoff, and post-incident analysis.
Before you run a command
- Confirm tenant, subscription, resource group, workspace, endpoint, storage account, compute name, data asset, or deployment scope before running commands.
- Verify your role assignment allows the read, write, security, monitoring, data, or machine learning action you plan to perform.
- Choose JSON, table, or TSV output intentionally so results can be reviewed, scripted, or attached as evidence.
- For production changes, confirm maintenance window, rollback path, cost impact, dependent owners, and monitoring coverage first.
What the output tells you
- The output shows whether ML pipeline exists, where it is scoped, and which Azure resource, workspace, identity, endpoint, or asset owns the setting.
- State, region, SKU, scale, identity, network, datastore, version, path, endpoint, or job fields separate configuration problems from workload symptoms.
- Repeated output over time can prove drift, confirm remediation, or show whether a deployment reached the intended resource.
- Errors usually reveal missing permissions, wrong scope, unsupported region, extension gaps, identity restrictions, quota problems, or a dependent resource that was not approved.
Mapped commands
Command group
az ml job show --name <pipeline-job> --workspace-name <workspace> --resource-group <group>az ml job list --workspace-name <workspace> --resource-group <group>az ml component list --workspace-name <workspace> --resource-group <group>Architecture context
Architecturally, ML pipeline belongs to the AI and Machine Learning domain and connects to machine learning workspace, ml component, pipeline job, ml component, ml job. Treat it as a design boundary with explicit ownership, scope, dependencies, and evidence. Record the owner, evidence, rollback step, and monitoring signal before release.
- Security
- From a security angle, ML pipeline should be reviewed for identity, permission scope, data exposure, secret handling, network reachability, and audit evidence. The common risk is building pipelines that pass secrets through parameters, reference unapproved data, hide sensitive outputs, or let broad identities publish production artifacts. Security teams should check who can create, update, delete, invoke, read, or bypass it, and whether those permissions are direct, inherited, or automated through pipelines. For production use, prefer managed identity, least privilege, private access, encryption, monitored changes, and clear exception ownership wherever the Azure service supports them. Record the owner, evidence, rollback step, and monitoring signal before release.
- Cost
- Cost impact for ML pipeline is direct through compute for each step, storage for intermediate outputs, environment builds, retries, and idle clusters; indirect through less manual release work. Direct cost may appear through compute hours, retained capacity, storage operations, data movement, registry builds, idle nodes, premium features, or monitoring volume. Indirect cost appears when weak ownership causes idle resources, duplicated work, failed access attempts, unnecessary reruns, or prolonged support work. FinOps reviews should identify who pays, what metric drives the bill, and whether cheaper settings still meet the workload requirement. Do not optimize cost by weakening security, durability, compliance, or recovery commitments without documenting the tradeoff.
- Reliability
- Reliability for ML pipeline depends on how it behaves during deployment, scale, maintenance, dependency loss, retry, recovery, and operator error. The key reliability question is whether the workflow can rerun deterministically, recover failed steps, preserve intermediate outputs, and prove which component version produced the model. Some impact is direct, such as capacity availability, data access, reproducible execution, endpoint continuity, or workflow recovery. Other impact is indirect, because the setting controls how quickly teams can detect drift and restore known good state. Operators should record dependencies, rollback options, retry behavior, and health signals so incidents start with evidence instead of guesswork.
- Performance
- Performance for ML pipeline depends on step parallelism, compute selection, data transfer mode, caching, component runtime, environment preparation, dependency graph shape, and output materialization. The useful signals include startup delay, request latency, job duration, queue time, data read speed, image build time, dependency resolution, capacity saturation, or operator time to diagnose problems. Teams should measure before and after important changes instead of assuming the setting improves performance. Good evidence includes Azure Monitor metrics, job logs, CLI output, application traces, storage diagnostics, endpoint metrics, activity records, and the time support staff need to isolate the bottleneck. Record the owner, evidence, rollback step, and monitoring signal before release.
- Operations
- Operationally, ML pipeline needs a repeatable inspection path. Teams should know which portal blade, CLI command, REST call, metric chart, activity log, diagnostic table, or deployment artifact shows the live state. Runbooks should explain normal ownership, approved change windows, rollback steps, and what evidence to capture after a change. For production environments, avoid undocumented portal-only edits. Use CLI, scripts, tags, source-controlled definitions, and monitoring so support staff can compare actual configuration with the intended design quickly during releases, incidents, and audits. Record the owner, evidence, rollback step, and monitoring signal before release. Validate live state before changing dependent workloads or closing the change.
Common mistakes
- Changing ML pipeline without checking dependent resources, owner approval, monitoring signals, and rollback steps first.
- Assuming a portal label tells the whole story instead of validating live state through CLI, logs, diagnostics, access records, or activity history.
- Granting broad permissions for convenience when a narrower role, managed identity, read-only query, group assignment, or scoped automation path would work.
- Optimizing cost or speed while ignoring security, reliability, compliance, data-governance, or model-lineage requirements.