mcpField
A
azure-devops-cli

azure-devops-cli

github.com/rysweetクラウド・DevOps7683 回インストール22 週間前に更新
リポジトリ

azure-devops-cli について

azure-devops-cli は Azure CLI から Azure DevOps を管理するスキルで、開発・運用ワークフローを対象とします。プロジェクト、パイプライン、作業項目、リポジトリ、成果物を扱い、自動化やクエリの例も含みます。

主な機能

  1. 01組織とプロジェクトの管理
  2. 02パイプラインの一覧表示と実行
  3. 03作業項目の検索と更新
  4. 04リポジトリとプルリクエストの管理
  5. 05成果物フィードとパッケージの操作
  6. 06REST API と JMESPath クエリの利用

活用シーン

  1. 01CI/CD パイプラインの実行と監視
  2. 02プルリクエストのレビューと更新
  3. 03スプリント作業項目の検索
  4. 04プロジェクトやチームデータのエクスポート

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/rysweet/amplihack --skill azure-devops-cli

インストール後、Claude Code で/azure-devops-cliを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

README.md
examples/
artifacts-reference.md
boards-reference.md
pipelines-reference.md
repos-reference.md
examples/workflows/
ci-cd-automation.md
release-management.md
team-collaboration.md
tests/
test-scenarios.md

詳細

Azure DevOps CLI スキル

クイックスタート

インストールと認証
# Install Azure DevOps CLI extension
az extension add --name azure-devops

# Authenticate (choose one method)
az login                                    # Interactive browser login
az devops login --organization https://dev.azure.com/YOUR_ORG  # PAT token login

# Configure defaults (recommended)
az devops configure --defaults organization=https://dev.azure.com/YOUR_ORG project=YOUR_PROJECT

# Verify setup
az devops project list
設定パターン
# Set defaults to avoid repeating --organization and --project
az devops configure --defaults organization=https://dev.azure.com/myorg project=myproject

# List current configuration
az devops configure --list

# Use Git aliases for common commands
az devops configure --defaults use-git-aliases=true

# Common output formats
--output table    # Human-readable tables (default)
--output json     # JSON for scripting
--output tsv      # Tab-separated values

グループ別の基本コマンド

1. DevOps（組織とプロジェクト）
# List projects
az devops project list --organization https://dev.azure.com/myorg

# Create project
az devops project create --name "MyProject" --visibility private

# Show project details
az devops project show --project MyProject

# Delete project
az devops project delete --id PROJECT_ID --yes

# Manage users/teams
az devops user list
az devops team list --project MyProject
2. Pipelines（ビルドとリリース）
# List pipelines
az pipelines list --project MyProject

# Run a pipeline
az pipelines run --name "MyPipeline" --branch main

# Show pipeline runs
az pipelines runs list --pipeline-ids 123

# Show run details
az pipelines runs show --id RUN_ID

# Create pipeline from YAML
az pipelines create --name "NewPipeline" --repository myrepo --branch main --yml-path azure-pipelines.yml
3. Boards（作業項目とスプリント）
# List work items
az boards query --wiql "SELECT [System.Id], [System.Title] FROM WorkItems WHERE [System.State] = 'Active'"

# Create work item
az boards work-item create --type "User Story" --title "New Feature" --assigned-to [email protected]

# Update work item
az boards work-item update --id 123 --state "In Progress"

# Show work item
az boards work-item show --id 123

# List iterations/sprints
az boards iteration project list
4. Repos（Git リポジトリ）
# List repositories
az repos list --project MyProject

# Create repository
az repos create --name "myrepo" --project MyProject

# List pull requests
az repos pr list --repository myrepo --status active

# Create pull request
az repos pr create --repository myrepo --source-branch feature/new --target-branch main --title "New Feature"

# Show PR details
az repos pr show --id PR_ID
5. Artifacts（パッケージ管理）
# List feeds
az artifacts feed list

# Create feed
az artifacts feed create --name "myfeed" --project MyProject

# List packages
az artifacts universal list --feed myfeed --project MyProject

# Publish package
az artifacts universal publish --feed myfeed --name mypackage --version 1.0.0 --path ./dist

# Download package
az artifacts universal download --feed myfeed --name mypackage --version 1.0.0 --path ./download

よくあるワークフロー

ワークフロー 1：CI/CD パイプラインの自動化
# Create pipeline, run it, and monitor
az pipelines create --name "API-Build" --repository myrepo --yml-path ci/azure-pipelines.yml
az pipelines run --name "API-Build" --branch main
az pipelines runs show --id RUN_ID --open  # Opens in browser
ワークフロー 2：プルリクエストレビューの自動化
# List active PRs, show details, add comment
az repos pr list --repository myrepo --status active --output table
az repos pr show --id 456 --open
az repos pr update --id 456 --status approved
ワークフロー 3：作業項目の一括作成
# Create multiple work items from template
for title in "Feature A" "Feature B" "Feature C"; do
  az boards work-item create --type "User Story" --title "$title" --assigned-to [email protected]
done
ワークフロー 4：パイプラインステータスダッシュボード
# Get recent pipeline runs with status
az pipelines runs list --top 10 --query "[].{Name:pipeline.name, Status:status, Result:result, Started:startTime}" --output table
ワークフロー 5：リポジトリのクローンの自動化
# List all repos and clone them
az repos list --query "[].{Name:name, URL:remoteUrl}" --output tsv | while IFS=$'\t' read -r name url; do
  git clone "$url" "./$name"
done
ワークフロー 6：スプリント計画の支援
# List current sprint work items
az boards query --wiql "SELECT [System.Id], [System.Title], [System.State] FROM WorkItems WHERE [System.IterationPath] = @CurrentIteration" --output table
ワークフロー 7：リリースゲートの確認
# Check if all PRs are approved before release
PENDING=$(az repos pr list --status active --query "length([?status!='approved'])")
if [ "$PENDING" -eq 0 ]; then
  az pipelines run --name "Release-Pipeline"
fi
ワークフロー 8：アーティファクトのバージョン管理
# Publish versioned artifact with timestamp
VERSION="1.0.$(date +%Y%m%d%H%M%S)"
az artifacts universal publish --feed myfeed --name myapp --version "$VERSION" --path ./build
ワークフロー 9：チームダッシュボードのデータ
# Export team metrics to JSON
az devops project show --project MyProject > project.json
az pipelines runs list --top 50 > recent-runs.json
az repos pr list --status all > all-prs.json
ワークフロー 10：環境の同期
# Copy pipeline variables across environments
az pipelines variable list --pipeline-name "MyPipeline" --output json > vars.json
# Edit vars.json as needed
az pipelines variable-group create --name "Production" --variables @vars.json

トラブルシューティング

よくある問題

認証の失敗：

# Clear cached credentials
az account clear
az login

# Use PAT token directly
export AZURE_DEVOPS_EXT_PAT=your_personal_access_token
az devops login

既定の設定：

# Reset defaults if commands fail
az devops configure --defaults organization="" project=""
# Then set explicitly in each command
az pipelines list --organization https://dev.azure.com/myorg --project MyProject

拡張機能の問題：

# Update Azure DevOps extension
az extension update --name azure-devops

# Check extension version
az extension show --name azure-devops

クエリ構文：

# WIQL queries require proper escaping
az boards query --wiql "SELECT [System.Id] FROM WorkItems WHERE [System.State] = 'Active' AND [System.AssignedTo] = '[email protected]'"

高度なパターン

REST API へのアクセス
# Direct REST API calls for unsupported operations
az devops invoke --area build --resource builds --route-parameters project=MyProject --api-version 6.0 --http-method GET

# POST with JSON body
az devops invoke --area git --resource repositories --route-parameters project=MyProject --http-method POST --in-file payload.json
JMESPath を使ったスクリプト作成
# Complex queries using JMESPath
az pipelines runs list --query "[?result=='failed'].{Pipeline:pipeline.name, Branch:sourceBranch, Time:finishedDate}" --output table

# Filter and transform data
az repos pr list --query "[?targetRefName=='refs/heads/main' && status=='active'].{ID:pullRequestId, Title:title, Author:createdBy.displayName}"
エイリアスと関数
# Create shell aliases for common commands
alias azdo-pipelines="az pipelines list --output table"
alias azdo-prs="az repos pr list --status active --output table"
alias azdo-builds="az pipelines runs list --top 20 --output table"

# Function for quick PR creation
azdo-pr() {
  az repos pr create --source-branch "$(git branch --show-current)" --target-branch main --title "$1" --open
}

詳細情報

包括的なコマンドリファレンスと高度なワークフローについては、以下を参照してください。

  • コマンドリファレンスの全編：examples/pipelines-reference.md、examples/boards-reference.md、examples/repos-reference.md、examples/artifacts-reference.md
  • 高度なワークフロー：examples/workflows/ci-cd-automation.md、examples/workflows/release-management.md、examples/workflows/team-collaboration.md
  • テストシナリオ：tests/test-scenarios.md

参考資料

コメント

Markdown 対応