Azure DevOps の組織・プロジェクト作成とパイプライン設定完全ガイド

2026年4月27日

Contents

1 1. 組織とプロジェクトの作成（前提条件）
2 2. リポジトリ準備とブランチ戦略
3 3. UI で最初のパイプラインを作成
- 3.1 3‑1. パイプライン作成フロー（Web UI）
- 3.2 3‑2. UI 作成で得られる主な利点
4 4. azure-pipelines.yml の基本構造と AI アシスト活用
5 5. Environments・Variable Groups・Key Vault による安全な設定管理
6 6. ベストプラクティス・エラー対策 & まとめ

スポンサードリンク

1. 組織とプロジェクトの作成（前提条件）

1‑1. 必要な権限

Project Collection Administrators または Contributor ロールが付与された Azure AD アカウント
権限が不足していると UI 操作や REST API がすべて失敗するため、最初に確認しておきましょう。

1‑2. 組織の作成手順

手順	内容
①	ブラウザで https://dev.azure.com/ にアクセスし、右上の Start をクリック
②	「組織名」を入力（例: `myorg`）→「続行」
③	必要に応じて Azure AD テナントを選択し、作成完了

ポイント：無料プランでも上記だけで組織が構築できます。企業利用の場合は、Organization Settings の Policies で MFA や条件付きアクセスの設定も検討してください。

1‑3. プロジェクトの新規作成

組織ホーム左メニュー → Projects → New project
必要項目を入力
Project name（例: SampleApp）
Visibility：Public または Private
Version control：Git（TFVC は非推奨）
Work item process：Agile / Scrum / Basic から選択
Create をクリックして完了

1‑4. 権限付与の確認

組織設定 → Security → Users
自分のアカウントが Project Collection Administrators または少なくとも Contributor に属しているかチェック

2. リポジトリ準備とブランチ戦略

2‑1. Git リポジトリの作成

手順	操作
①	プロジェクト画面左メニュー → Repos → Files
②	New repository をクリックし、名前 `sample-app`、Git を選択
③	必要なら README を自動生成し、Create

2‑2. ローカルクローンと初回プッシュ

git clone https://dev.azure.com/myorg/sample-app/_git/sample-app
cd sample-app
echo &quot;# Sample App&quot; &gt; README.md
git add .
git commit -m &quot;Initial commit&quot;
git push origin --set-upstream main   # Trunk‑Based の場合は main ブランチを使用

git clone https://dev.azure.com/myorg/sample-app/_git/sample-app

cd sample-app

echo "# Sample App" > README.md

git add .

git commit -m "Initial commit"

git push origin --set-upstream main # Trunk‑Based の場合は main ブランチを使用

2‑3. 推奨ブランチモデル

モデル	主なブランチ	用途
Trunk‑Based	`main`、`feature/`、`release/`	本番デプロイは常に `main` にマージし、CI が自動走行
軽量 Git Flow	`develop`、`feature/`、`release/`、`hotfix/*`	中規模以上のチーム向け。`develop` が統合ブランチになる

ポイント：小規模チームは main のみでも問題ありませんが、将来的に機能追加やリリース作業が増えることを想定し、最低限 feature/* と release/* を導入しておくとスムーズです。

3. UI で最初のパイプラインを作成

3‑1. パイプライン作成フロー（Web UI）

Pipelines → Create pipeline
リポジトリ選択：Azure Repos Git → sample-app
テンプレート選択：「Starter pipeline」（空の YAML）または言語別テンプレート
エディタに自動生成された YAML が表示されるので内容を確認し、Save and run をクリック

3‑2. UI 作成で得られる主な利点

即時ビルド実行：azure-pipelines.yml がリポジトリにコミットされると同時に CI が走ります。
YAML の雛形取得：生成されたコードをベースにカスタマイズでき、手書きミスが減少します。
可視化：左メニューの Runs で実行履歴やログが一目で把握可能

ポイント：UI から作成したパイプラインはあくまで「開始点」。本格的なテスト・デプロイ設定は YAML 編集で拡張してください。

4. `azure-pipelines.yml` の基本構造と AI アシスト活用

4‑1. 必須要素の概要

要素	説明
`trigger`	ビルドを自動起動するブランチやパスを定義
`pool`	実行エージェント（OS・イメージ）を指定
`stages`	大きなフェーズ（Build、Test、Deploy など）を分割
`jobs`	同一ステージ内で実行できるタスク集合
`steps`	実際のコマンド・タスクを記述

4‑2. 最小構成例

trigger:
  branches:
    include:
      - main

pool:
  vmImage: 'ubuntu-latest'

stages:
- stage: Build
  jobs:
  - job: Compile
    steps:
    - task: UseNode@2
      inputs:
        versionSpec: '20.x'
    - script: npm install
      displayName: 'Install dependencies'
    - script: npm run build
      displayName: 'Build project'

- stage: Deploy
  dependsOn: Build
  condition: succeeded()
  jobs:
  - deployment: WebApp
    environment: dev
    strategy:
      runOnce:
        deploy:
          steps:
          - task: AzureWebApp@1
            inputs:
              azureSubscription: 'MyServiceConnection'
              appName: 'sample-webapp-dev'
              package: $(System.DefaultWorkingDirectory)/**/*.zip

trigger:

branches:

include:

- main

pool:

vmImage: 'ubuntu-latest'

stages:

- stage: Build

jobs:

- job: Compile

steps:

- task: UseNode@2

inputs:

versionSpec: '20.x'

- script: npm install

displayName: 'Install dependencies'

- script: npm run build

displayName: 'Build project'

- stage: Deploy

dependsOn: Build

condition: succeeded()

jobs:

- deployment: WebApp

environment: dev

strategy:

runOnce:

deploy:

steps:

- task: AzureWebApp@1

inputs:

azureSubscription: 'MyServiceConnection'

appName: 'sample-webapp-dev'

package: $(System.DefaultWorkingDirectory)/**/*.zip

4‑3. AI アシスト（Azure DevOps AI Assist）活用手順

※2024 年 10 月時点の情報
Azure DevOps の AI Assist はプレビュー機能として提供されており、組織設定で有効化するだけで UI 上に「Generate with AI」ボタンが表示されます。正式リリース日や機能追加は Microsoft の公式アナウンスをご参照ください。

手順

組織設定 → Preview features → AI Assist を ON にする
パイプライン作成画面のテンプレート選択時に右上の Generate with AI ボタンが表示されるのでクリック
「自然言語プロンプト」を入力（例: Node.js アプリを Ubuntu ランナーでビルドし、Azure Web App (dev) にデプロイするパイプラインを書いて）
生成された YAML がエディタに表示されるので、レビュー → Save and run

AI Assist 利用時の留意点

プレビュー機能であるため、必ず出力内容を手動で確認し、組織独自のポリシー（例: セキュリティチェックや変数名）に合致しているか検証してください。
生成結果はテンプレート ですので、実際のビルド環境に合わせて pool や serviceConnection の名前を修正する必要があります。

4‑4. ポイントまとめ

基本構造（trigger → pool → stages → jobs → steps）を把握すれば、AI Assist が出力したコードでも容易にカスタマイズ可能。
AI Assist は「時間短縮」だけでなく、「ヒューマンエラー防止」の側面もあるため、導入前に プレビュー有効化 と レビュー体制 を整えておくことが重要です。

5. Environments・Variable Groups・Key Vault による安全な設定管理

5‑1. Environments の作成と承認ポリシー

手順	操作
①	Pipelines → Environments → New environment
②	名前（例: `dev`、`staging`、`prod`）を入力し、必要なら Resource（Kubernetes クラスタや Azure VM）を紐付ける
③	Approvals and checks タブで Manual approval や Branch protection を設定

Environments に対する承認は、デプロイ前に必ず担当者が確認できるガバナンス手段です。

5‑2. Variable Group と Azure Key Vault の連携

variables:
- group: dev-vars   # Azure DevOps の変数グループを参照

variables:

- group: dev-vars # Azure DevOps の変数グループを参照

作成手順

Pipelines → Library → + Variable group
名前 dev-vars、スコープ（対象環境）を選択
「Link secrets from an Azure key vault as variables」にチェックし、利用する Key Vault とシークレット名を指定

ポイント：Key Vault へのアクセスは、Azure DevOps のサービスプリンシパルに get 権限が付与されていることが前提です。アクセスポリシーの確認・設定も忘れずに。

5‑3. CI トリガーと PR ビルドの実装例

trigger:
  branches:
    include:
      - main
      - develop

pr:
  branches:
    include:
      - develop

trigger:

branches:

include:

- main

- develop

pr:

branches:

include:

- develop

main と develop のプッシュで CI が走り、develop に対する Pull Request 作成時にもビルドが自動実行されます。

5‑4. ポイントまとめ

Environments → Variable Groups → Key Vault の三層構造で、環境ごとに安全かつ承認制の設定を一元管理できる。
CI/PR ビルドは同じ変数グループを参照することで、コードとインフラ設定の同期が保たれます。

6. ベストプラクティス・エラー対策 & まとめ

6‑1. パイプライン設計のベストプラクティス

項目	推奨設定 / 手法
ステージ分割	`Build → Test → Deploy` の3段階で明確に分離し、`dependsOn` と `condition` で失敗時の流れを制御
キャッシュ活用	`Cache@2` タスクで `node_modules` や Maven リポジトリをキャッシュし、ビルド時間を最大30%短縮
ロギング強化	`variables: { system.debug: true }` で詳細ログ取得。失敗時は Azure Monitor の Log Analytics に転送
構文検証	VS Code の「Azure Pipelines」拡張や `az pipelines validate -f azure-pipelines.yml` を CI 前に実行
権限管理	Service Connection は Project スコープではなく Organization スコープで作成し、`Allow all pipelines to use this connection` を有効化

6‑2. よくあるエラーと対処法

エラー	原因	対策
YAML 構文エラー (`##[error]`)	インデント・コロン抜け等	VS Code の Linter で事前検証、エラーメッセージの行番号を確認
401/403 権限不足	Service Connection がプロジェクトスコープか、アクセスポリシー未設定	組織レベルに昇格し `Allow all pipelines...` を有効化
Key Vault シークレット取得失敗	Azure DevOps のサービスプリンシパルに `get` 権限がない	Key Vault → Access policies で該当プリンシパルに `Get` を付与
環境承認で止まる	Approvals & Checks に設定された担当者が不在	代替承認者を追加、もしくはテスト目的で一時的に Auto approve（限定的）を使用

6‑3. 全体のまとめ

組織・プロジェクトと適切な権限 を最初に確立することで、以降の操作がスムーズになる。
Git リポジトリとブランチ戦略 は CI の成功率を左右する重要要素。Trunk‑Based がシンプルで推奨される。
UI で作成したパイプライン は即時動作し、YAML 雛形として活用できるため、初心者のハードルが低い。
azure-pipelines.yml の基本構造 を把握した上で、AI Assist（プレビュー）を利用するとコード生成時間が大幅に短縮できる。
Environments・Variable Groups・Key Vault による設定管理は、セキュリティと承認フローの両立に不可欠。
ベストプラクティス（ステージ分割・キャッシュ・ロギング）＋エラー対策 を実装すれば、パイプラインは安定稼働し、障害対応コストも削減できる。

最終的なチェックリスト
- [ ] 組織・プロジェクトの権限が正しく付与されているか
- [ ] リポジトリとブランチモデルが CI フレンドリーになっているか
- [ ] 初回パイプラインは UI で作成し、YAML がコミット済みか
- [ ] azure-pipelines.yml に必須要素（trigger・pool・stages）が揃っているか
- [ ] AI Assist を有効化した場合は生成コードをレビューしたか
- [ ] Environments と変数管理が適切に設定され、Key Vault 連携ができているか
- [ ] ベストプラクティス（キャッシュ・ロギング等）が実装済みか

これらの項目を順番にクリアすれば、Azure DevOps 上で安全かつ高速な CI/CD パイプライン を構築できるはずです。ぜひ本ガイドを手元に置きながら、実際のプロジェクトへ適用してみてください。

スポンサードリンク

-Azure

comment コメントをキャンセル

: Azure

Azure AI Builder活用事例と導入手順｜OCR・感情分析・予知保全まで徹底解説

本記事では Azure AI Builder のノーコード AI 機能を中心に、Power Platform との連携方法や Azure AI Search・OpenAI との統合ポイント、請求書 OCR、顧客問い合わせの感情分析、予知保全、売上予測、チャットボット活用といった代表的シナリオを実装手順とともに紹介します。さらにライセンス形態や概算コスト、無料トライアル情報も網羅し、導入時のベストプラクティスまで解説しています。

: Azure

Azure Stack HCI 2025 年版の主要機能とハイブリッド管理ガイド

本稿では Azure Stack HCI 2025 年版の機能強化とハイブリッド管理方法、主要ベンダー事例を比較し、成功のポイントと失敗回避策を紹介します。

: Azure

Azure OpenAI Service 2026年大型アップデートと中小企業活用事例

Azure OpenAI Serviceは2026年1月にUI刷新とマルチモーダル・カスタムモデル拡張を加え、中小企業でも安全かつ迅速に導入できる基盤となりました。

: Azure

Azure Storage料金徹底解説とコスト削減5ステップ

Azure Storage の層別単価と課金開始タイミングを解説し、可視化・層最適化・予約容量導入・ライフサイクル管理・不要データ削除の5ステップでコストを大幅に抑える手順をまとめました。

: Azure

Azure DevOps と GitHub Actions 徹底比較：構成・料金・セキュリティと移行ベストプラクティス

本記事では、Azure DevOps と GitHub Actions の概念モデル・料金体系・セキュリティ機能を比較し、組織に最適な選択とハイブリッド移行のベストプラクティスを提示します。

YouTubeパートナープログラム2026必須条件とメンバーシップ設定ガイド

Node.js 20でトップレベルawaitを実務に活かす手順とサンプル

Azure DevOps の組織・プロジェクト作成とパイプライン設定完全ガイド

1. 組織とプロジェクトの作成（前提条件）

1‑1. 必要な権限

1‑2. 組織の作成手順

1‑3. プロジェクトの新規作成

1‑4. 権限付与の確認

2. リポジトリ準備とブランチ戦略

2‑1. Git リポジトリの作成

2‑2. ローカルクローンと初回プッシュ

2‑3. 推奨ブランチモデル

3. UI で最初のパイプラインを作成

3‑1. パイプライン作成フロー（Web UI）

3‑2. UI 作成で得られる主な利点

4. azure-pipelines.yml の基本構造と AI アシスト活用

4‑1. 必須要素の概要

4‑2. 最小構成例

4‑3. AI アシスト（Azure DevOps AI Assist）活用手順

手順

AI Assist 利用時の留意点

4‑4. ポイントまとめ

5. Environments・Variable Groups・Key Vault による安全な設定管理

5‑1. Environments の作成と承認ポリシー

5‑2. Variable Group と Azure Key Vault の連携

作成手順

5‑3. CI トリガーと PR ビルドの実装例

5‑4. ポイントまとめ

6. ベストプラクティス・エラー対策 & まとめ

6‑1. パイプライン設計のベストプラクティス

6‑2. よくあるエラーと対処法

6‑3. 全体のまとめ

4. `azure-pipelines.yml` の基本構造と AI アシスト活用