DevOps 編のまとめ|Azure DevOps と GitHub の導入チェックリスト、実機で出たエラー一覧、廃止の予定(DevOps 編 18)

DevOps

はじめに

DevOps 編の 18 回目は、シリーズのまとめ。
D0〜D17 の要点、導入のチェックリスト、Azure Pipelines と GitHub Actions の選び方、実機で出たエラーと直し方、廃止・変更の予定を 1 ページにまとめる。

シリーズの最初の回は全体像と無料枠だった。

Azure の DevOps 系サービスの全体像とは|Azure DevOps と GitHub の違い・無料枠・組織の作成(DevOps 編 0)
Azure の DevOps 系サービスの全体像を整理。Azure DevOps と GitHub の違い、Bicep などの役割、無料枠(5 ユーザー、月 1,800 分)を解説し、組織の作成とサブスクリプションへのリンクを実機で確認。

前回は監視と保守だった。

監視と保守とは|Application Insights のアラートでデプロイを止める流れを実機で確かめ、DevOps の指標と保持ポリシーを整理(DevOps 編 17)
監視と保守を整理。Application Insights と OpenTelemetry で計測し、アラート中は Azure Pipelines のチェックでデプロイを止める流れを実機で確認。リード タイムと保持ポリシーも解説。

全体の地図

DevOps の流れ(計画、コード、ビルド、テスト、リリース、運用と監視)に、各回を置くと次のようになる。
認証とシークレット(D15)とセキュリティ スキャン(D16)は、特定の段階ではなく全体にかかわる。

DevOps 編の全体の地図

Azure DevOps は、作業の計画、コードでの共同作業、ビルド、テスト、運用環境へのデプロイに必要なものをまとめたクラウドのプラットフォーム。
GitHub やほかの Git プロバイダーとも統合でき、GitHub のリポジトリと Azure Boards や Azure Pipelines を組み合わせることもできる。

公式ドキュメント:Azure DevOpsとは | Microsoft Learn

回ごとの要点

回テーマ覚えておくこと
D0全体像Azure DevOps は Basic 5 人、Microsoft ホステッド 1 ジョブ(月 1,800 分)、セルフホステッド 1 ジョブ、Artifacts 2 GiB が無料
D1Azure Boardsプロセスは作ったあと継承プロセスでカスタマイズする。
チームのエリアにサブエリアを含めないと、スプリントの集計に入らない
D2Wikiプロジェクト Wiki とコード Wiki。
中身は Git の Markdown で、作業項目のリンクは # の前に半角スペースが要る
D3Azure Repos機能ブランチ+プル要求で main へ。
必須のポリシーがあると直接 push は TF402455 で拒否される
D4GitHub のルールセット無料プランでは公開リポジトリだけ。
直接 push、強制 push、保護したタグの付け替えを止める
D5CI/CD とはテストが失敗すると Deploy は「Skipped due to conditions」になり、本番は前のバージョンのまま
D6Azure Pipelines の基本${{ }} はコンパイル時、$[ ] はジョブの前、$( ) はタスクの前に評価される。
ビルド検証で、テストが通らない PR は完了できない
D7再利用と統制extends テンプレート、変数グループ、環境の承認、ブランチ コントロール、必須テンプレート
D8GitHub Actionsステージはなく、ジョブの needs で組む。
環境の必須レビューアーと OIDC で Azure にサインイン
D9エージェント基盤セルフホステッドは外向きのポーリング。
Managed DevOps Pools はジョブごとに新しいマシン。
VM と MDP のクォータは別
D10パッケージ管理ビルド サービスは既定で Collaborator で、発行には Feed Publisher が要る。
同じ版はもう一度発行できない
D11テストLoad Testing は不合格の条件でパイプラインを止められる。
Test Plans の計画やスイートの作成には Basic + Test Plans が要る
D12デプロイ戦略スロットのスワップ、Traffic %、機能フラグ。
スロット固有の設定とマネージド ID はスワップされない
D13Bicepwhat-if で変更を確かめ、デプロイ スタックで削除の拒否を決める。
拒否設定には専用の権限が要る
D14ARM テンプレートと TerraformTerraform は state で差分を出し、手作業の変更も plan に出る。
state は Azure Storage に置き、Entra ID で認証できる
D15認証とシークレットサービス接続はワークロード ID フェデレーション。
RG の共同作成者では Key Vault のシークレットは読めない
D16セキュリティ スキャンDependabot、CodeQL、プッシュ保護。
チェックの失敗でマージを止めるには、ルールセットで必須にする
D17監視と保守OpenTelemetry で計測し、アラート中は「Query Azure Monitor alerts」のチェックでデプロイを止める

導入チェックリスト

新しくプロジェクトを始めるときに確認したい項目を、分野ごとに並べた。
右の列は詳しく扱った回。

計画とコード

確認すること回
プロセス(Basic、Agile、Scrum、CMMI)を決め、カスタマイズは継承プロセスで行うD1
チームとエリアの対応を決める(サブエリアを含めるか)D1
コードに関わる人は Basic、計画だけの人は利害関係者にするD1
main に必須のポリシー(レビュー担当者、作業項目のリンク、コメントの解決、ビルド検証)を付けるD3、D6
GitHub ではルールセットで既定のブランチとリリースのタグを守るD4
公開リポジトリでは、コミットに個人のメール アドレスが入らない設定にするD4

CI/CD

確認すること回
YAML パイプラインにし、トリガーとパス フィルターで必要なときだけ動かすD6
Build と Deploy を分け、テストが失敗したらデプロイしないD5
共通の処理はテンプレートにし、本番は extends と必須テンプレートで形を決めるD7
本番の環境に承認とブランチ コントロールを付けるD7、D8
アラート中はデプロイしないように「Query Azure Monitor alerts」を付けるD17
スロットや機能フラグで、戻しやすいデプロイにするD12
エージェントのクォータ(VM と Managed DevOps Pools は別)を先に確かめるD9

IaC

確認すること回
Bicep ならリンターのルールを bicepconfig.json で決め、パイプラインでも同じルールで止めるD13
デプロイ前に what-if(Terraform なら plan)で変更を確かめるD13、D14
Terraform の state はリモートに置き、共有キーではなく Entra ID で認証するD14
消されると困るリソースは、デプロイ スタックの拒否設定で守るD13

セキュリティ

確認すること回
Azure へのサービス接続はワークロード ID フェデレーション(GitHub Actions は OIDC)にするD15、D8
サービス接続のスコープはリソース グループなどに絞り、データ プレーンのロールは別に付けるD15
シークレットは Key Vault に置き、ログのマスクを過信しないD15
Dependabot、CodeQL、プッシュ保護を有効にするD16
パッケージのフィードの権限(Collaborator と Feed Publisher)を確かめるD10

テストと運用

確認すること回
負荷テストに不合格の条件を付けて、パイプラインで止めるD11
アプリを OpenTelemetry で計測し、Application Insights に送るD17
失敗率や応答時間のアラートと、通知先のアクション グループを作るD17
標準の可用性テストを 5 か所以上から動かすD17
保持ポリシー(実行、成果物、パッケージ)を決めるD17

Azure Pipelines と GitHub Actions の選び方

このシリーズで両方を使った結果から、違いを次のように整理する。

観点Azure PipelinesGitHub Actions
ソースAzure Repos、GitHub、Bitbucket Cloud などGitHub のリポジトリ
構成ステージ > ジョブ > ステップ。
1 つの YAML にステージを書ける
ワークフロー > ジョブ > ステップ。
ステージはなく、needs でつなぐ
デプロイ前の制御環境やサービス接続の承認とチェック(ブランチ コントロール、必須テンプレート、Azure Monitor アラートの照会など)環境の保護ルール(必須レビューアー、デプロイ ブランチの制限)
Azure への接続サービス接続(ワークロード ID フェデレーション)OpenID Connect
実行環境Microsoft ホステッド、セルフホステッド、Managed DevOps PoolsGitHub ホステッド ランナー、セルフホステッド ランナー
組み合わせる機能Azure Boards、Azure Test Plans、Azure ArtifactsGitHub Projects、GitHub Packages、Dependabot、CodeQL
こういうとき向いているもの
コードが GitHub にあり、公開リポジトリのセキュリティ機能も使いたいGitHub Actions
承認やチェックで本番のデプロイを細かく統制したいAzure Pipelines
手動テストの管理(Test Plans)や、Boards と一体で運用したいAzure Pipelines(Azure DevOps)
コードは GitHub、計画とデプロイは Azure DevOps組み合わせ(Azure Boards アプリ、Pipelines のソースに GitHub)

実機で出たエラーと直し方

各回の「実機でつまずいた点」を 1 つの表にまとめた。
クォータや権限のように、どの環境でも起こりうるものが多い。

回エラー・症状原因と直し方
D1This item cannot be reordered because it is owned by another teamチームのエリアにサブエリアが含まれていなかった。
チームの設定で「Include sub areas」を選ぶ
D2#番号 が作業項目のリンクにならない全角の文字の直後に # を書いていた。
# の前に半角スペースを入れる
D4This commit will be authored by(個人のメール アドレス)GitHub の「Keep my email addresses private」をオンにする
D5、D12Operation cannot be completed without additional quota.東日本の F1 / S1 の上限が 0 だった。
西日本で作るか、クォータの引き上げを申請する
D6TF402455: Pushes to this branch are not permitted必須のポリシーがあるブランチは PR でしか更新できない
D7Mapping values are not allowed in this context.script の値の「: 」がキーと値の区切りと読まれた。
script: | のブロック形式にする
D7Required template が FailedRepository に「プロジェクト/リポジトリ」と入れていた。
リポジトリ名だけにする
D9standardBasv2Family の上限が 0 などVM と Managed DevOps Pools のクォータを確かめ、使えるサイズにする
D10refusing to allow an OAuth App to create or update workflow without workflow scopeトークンに workflow スコープがなかった
D13DeploymentStackTenantRegistrationFailed初めて拒否設定を使うときに出た。
数分おいて再実行すると通った
D13DeploymentStackActionForbidden(manageDenySetting)サービス プリンシパルに「Azure Deployment Stack 所有者」を付ける
D14terraform: command not foundubuntu-latest に Terraform がなかった。
版を固定してインストールするステップを足す
D15Caller is not authorized to perform action on resource.RBAC の Key Vault に「キー コンテナー シークレット ユーザー」を付ける
D16Pull Request has merge conflicts「@dependabot rebase」で Dependabot に作り直させる
D17F1 では Application Insights が選べないコードで Microsoft OpenTelemetry Distro を入れて計測する

廃止・変更の予定

各回で確認した廃止の予定を、日付の順に並べた。

廃止・変更の予定
日付対象すること
2026 年 11 月 30 日Azure Test Plans の Windows 版テスト ランナー クライアントWeb ベースのテスト ランナーに移る
2027 年Azure DevOps のパブリック プロジェクト既存のものはプライベートに変換される。
公開したいなら GitHub を検討する
2027 年 2 月 22 日Azure Deployment Environmentsワークフローをほかのサービスやパートナーのソリューションに移す
2027 年 7 月 1 日Azure DevOps 発行者(vstoken.dev.azure.com)ワークロード ID フェデレーションのサービス接続を Microsoft Entra 発行者にする
2028 年 9 月 30 日Application Insights の URL ping テスト標準テストに移す

公式ドキュメント:
手動テストの実行 | Microsoft Learn
プロジェクトの可視性をプライベートに変更する | Microsoft Learn
Azure Deployment Environments とは | Microsoft Learn
Azure Resource Manager サービス接続を使用して Azure に接続する | Microsoft Learn
Application Insights 可用性テスト | Microsoft Learn

まとめ

・DevOps の流れ(計画、コード、ビルド、テスト、リリース、運用と監視)を、Azure DevOps か GitHub、またはその組み合わせで回す。
・main は必須のポリシーやルールセットで守り、変更はプル要求とビルド検証を通す。
・本番へのデプロイは、環境の承認とチェックで統制し、アラート中は止める。
・Azure への接続はワークロード ID フェデレーション(OIDC)にし、シークレットは Key Vault に置く。
・IaC は what-if や plan で変更を確かめてから適用する。
・クォータと権限のエラーは多くの回で出た。
先に上限とロールを確かめる。
・廃止の予定(2026 年 11 月〜2028 年 9 月)を確認し、早めに移行する。

公式ドキュメント:
Azure DevOpsとは | Microsoft Learn
承認とチェックを定義する | Microsoft Learn

コメント

タイトルとURLをコピーしました