Merge pull request #841 from fondoger/fondoger/ado-skill-update

Split azure-devops-cli SKILL.md into samller files

skills/azure-devops-cli/references/pipelines-and-builds.md

@@ -0,0 +1,245 @@
+# Pipelines, Builds & Releases
+
+## Table of Contents
+- [Pipelines](#pipelines)
+- [Pipeline Runs](#pipeline-runs)
+- [Builds](#builds)
+- [Build Definitions](#build-definitions)
+- [Releases](#releases)
+- [Release Definitions](#release-definitions)
+- [Universal Packages (Artifacts)](#universal-packages-artifacts)
+
+---
+
+## Pipelines
+
+### List Pipelines
+
+```bash
+az pipelines list --output table
+az pipelines list --query "[?name=='myPipeline']"
+az pipelines list --folder-path 'folder/subfolder'
+```
+
+### Create Pipeline
+
+```bash
+# From local repository context (auto-detects settings)
+az pipelines create --name 'ContosoBuild' --description 'Pipeline for contoso project'
+
+# With specific branch and YAML path
+az pipelines create \
+  --name {pipeline-name} \
+  --repository {repo} \
+  --branch main \
+  --yaml-path azure-pipelines.yml \
+  --description "My CI/CD pipeline"
+
+# For GitHub repository
+az pipelines create \
+  --name 'GitHubPipeline' \
+  --repository https://github.com/Org/Repo \
+  --branch main \
+  --repository-type github
+
+# Skip first run
+az pipelines create --name 'MyPipeline' --skip-run true
+```
+
+### Show Pipeline
+
+```bash
+az pipelines show --id {pipeline-id}
+az pipelines show --name {pipeline-name}
+```
+
+### Update Pipeline
+
+```bash
+az pipelines update --id {pipeline-id} --name "New name" --description "Updated description"
+```
+
+### Delete Pipeline
+
+```bash
+az pipelines delete --id {pipeline-id} --yes
+```
+
+### Run Pipeline
+
+```bash
+# Run by name
+az pipelines run --name {pipeline-name} --branch main
+
+# Run by ID
+az pipelines run --id {pipeline-id} --branch refs/heads/main
+
+# With parameters
+az pipelines run --name {pipeline-name} --parameters version=1.0.0 environment=prod
+
+# With variables
+az pipelines run --name {pipeline-name} --variables buildId=123 configuration=release
+
+# Open results in browser
+az pipelines run --name {pipeline-name} --open
+```
+
+## Pipeline Runs
+
+### List Runs
+
+```bash
+az pipelines runs list --pipeline {pipeline-id}
+az pipelines runs list --name {pipeline-name} --top 10
+az pipelines runs list --branch main --status completed
+```
+
+### Show Run Details
+
+```bash
+az pipelines runs show --run-id {run-id}
+az pipelines runs show --run-id {run-id} --open
+```
+
+### Pipeline Artifacts
+
+```bash
+# List artifacts for a run
+az pipelines runs artifact list --run-id {run-id}
+
+# Download artifact
+az pipelines runs artifact download \
+  --artifact-name '{artifact-name}' \
+  --path {local-path} \
+  --run-id {run-id}
+
+# Upload artifact
+az pipelines runs artifact upload \
+  --artifact-name '{artifact-name}' \
+  --path {local-path} \
+  --run-id {run-id}
+```
+
+### Pipeline Run Tags
+
+```bash
+# Add tag to run
+az pipelines runs tag add --run-id {run-id} --tags production v1.0
+
+# List run tags
+az pipelines runs tag list --run-id {run-id} --output table
+```
+
+## Builds
+
+### List Builds
+
+```bash
+az pipelines build list
+az pipelines build list --definition {build-definition-id}
+az pipelines build list --status completed --result succeeded
+```
+
+### Queue Build
+
+```bash
+az pipelines build queue --definition {build-definition-id} --branch main
+az pipelines build queue --definition {build-definition-id} --parameters version=1.0.0
+```
+
+### Show Build Details
+
+```bash
+az pipelines build show --id {build-id}
+```
+
+### Cancel Build
+
+```bash
+az pipelines build cancel --id {build-id}
+```
+
+### Build Tags
+
+```bash
+# Add tag to build
+az pipelines build tag add --build-id {build-id} --tags prod release
+
+# Delete tag from build
+az pipelines build tag delete --build-id {build-id} --tag prod
+```
+
+## Build Definitions
+
+### List Build Definitions
+
+```bash
+az pipelines build definition list
+az pipelines build definition list --name {definition-name}
+```
+
+### Show Build Definition
+
+```bash
+az pipelines build definition show --id {definition-id}
+```
+
+## Releases
+
+### List Releases
+
+```bash
+az pipelines release list
+az pipelines release list --definition {release-definition-id}
+```
+
+### Create Release
+
+```bash
+az pipelines release create --definition {release-definition-id}
+az pipelines release create --definition {release-definition-id} --description "Release v1.0"
+```
+
+### Show Release
+
+```bash
+az pipelines release show --id {release-id}
+```
+
+## Release Definitions
+
+### List Release Definitions
+
+```bash
+az pipelines release definition list
+```
+
+### Show Release Definition
+
+```bash
+az pipelines release definition show --id {definition-id}
+```
+
+## Universal Packages (Artifacts)
+
+### Publish Package
+
+```bash
+az artifacts universal publish \
+  --feed {feed-name} \
+  --name {package-name} \
+  --version {version} \
+  --path {package-path} \
+  --project {project}
+```
+
+### Download Package
+
+```bash
+az artifacts universal download \
+  --feed {feed-name} \
+  --name {package-name} \
+  --version {version} \
+  --path {download-path} \
+  --project {project}
+```