Azure Pipelines task library 管理チェックリスト:v272/v273リリース波の導入・設定・周知

Azure Pipelines task library を管理している場合、2026年4月20日時点の「Coordinated Azure Pipelines Tasks v272/v273 release wave lands」で最初にやるべきことは、本番パイプラインの即時変更ではなく、影響タスクの棚卸し、設定差分の確認、代表パイプラインでの検証、関係者への周知です。

今回の v272/v273 は、単一タスクの小さな修正ではなく、Azure 関連タスク、テスト、パッケージ、FTP、SQL デプロイ、Node ランタイム移行、脆弱性対応、非推奨タスクがまたがる更新波として捉えるべきです。特に IT admins、operations owners、deployment planners は、「どのパイプラインが影響を受けるか」「どの順番で展開するか」「開発チームに何を依頼するか」をチェックリスト化してから動くと、不要な障害対応を減らせます。

目次

Azure Pipelines task library の v272/v273 で管理者が見るべき要点

Azure Pipelines task library は、ビルド、テスト、デプロイ、ツール導入などを担うタスク群の管理対象です。Azure Pipelines の「ライブラリ」画面で扱う変数グループやセキュアファイルとは別物として整理してください。公式ドキュメント上の Azure Pipelines ライブラリは、変数グループとセキュリティで保護されたファイルを扱うアセット管理機能です。タスク管理と混同すると、確認すべき設定画面や権限がずれます。(Microsoft Learn)

今回見るべき中心は、GitHub の microsoft/azure-pipelines-tasks リリースです。v272 は Sprint 272 として 2026年3月31日に公開され、複数の Azure 系タスクで task-lib や azure-arm-rest 共通パッケージの更新、AzureCLI V2/V3 の task-lib 5.2.8 への更新、PublishTestResults、UniversalPackages、VSTest などの修正が含まれています。(GitHub)

v273 は Sprint 273 として 2026年4月20日に公開され、@azure/msal-browser 関連の脆弱性対応、azure-arm-rest 更新、AzureCLI V1 などの非推奨化、Node 24 移行、FtpUploadV2 の basic-ftp 更新、SQL DACPAC 系タスクのセキュリティ修正などが含まれています。(GitHub)

管理者視点では、次の4点を優先して確認します。

優先度確認対象理由最初のアクション
高Azure 系デプロイタスク認証、サービス接続、依存パッケージ更新の影響が出やすい使用タスクとサービス接続を一覧化する
高非推奨タスク将来の運用リスクが高いAzureCLI@1 などの利用状況を洗い出す
高SQL / FTP / PowerShell 系タスクセキュリティ修正が含まれる本番相当の検証環境で再実行する
中テスト・成果物・パッケージ系タスク結果収集、ツール導入、キャッシュで差分が出ることがあるテスト結果とアーティファクト出力を比較する
中セルフホストエージェントNode 移行やツール取得の影響を受けやすいエージェント、プロキシ、ネットワーク制限を確認する

影響を受けやすいタスクを先に棚卸しする

v272/v273 を受けて、管理者は「全パイプラインを一括で直す」のではなく、「影響を受ける可能性が高いパイプラインを先に見つける」ことが重要です。

特に以下のタスクを使っている YAML、Classic Pipeline、テンプレート、タスクグループを検索します。

領域確認したいタスク例見るべきポイント
Azure デプロイAzureCLI、AzurePowerShell、AzureFunctionApp、AzureWebApp、AzureRmWebAppDeployment、AzureResourceManagerTemplateDeployment、AzureFileCopy、AzureKeyVaultサービス接続、認証方式、Azure CLI / PowerShell の出力、デプロイ後の疎通
App Service / FunctionsAzureAppServiceManage、AzureAppServiceSettings、AzureFunctionApp、AzureFunctionAppContainerスロット、アプリ設定、Key Vault 参照、デプロイ方式
SQL デプロイSqlAzureDacpacDeployment、SqlDacpacDeploymentOnMachineGroupDACPAC 実行、DeployReport / DriftReport / Script の出力パス、引数のクォート
FTPFtpUpload接続、証明書、パッシブモード、アップロード後のファイル差分
テストVSTest / VsTest、PublishTestResultsテスト検出、結果ファイル、失敗時の条件、リトライ検出
パッケージ・成果物UniversalPackages、DownloadBuildArtifacts、DownloadPackage、NuGetToolInstallerツール取得、キャッシュ、プロキシ、成果物のバージョン
非推奨候補AzureCLI V1、DownloadGitHubNpmPackage V1、DownloadGitHubNugetPackage V1移行計画、担当チーム、期限

v273 では AzureCLI V1、DownloadGitHubNpmPackageV1、DownloadGitHubNugetPackageV1 の非推奨化が明記されています。すぐに停止すると断定するのではなく、まず利用箇所、代替手段、移行期限を管理台帳に入れるのが現実的です。(GitHub)

タスクバージョンの自動更新ルールを確認する

Azure Pipelines のタスクはバージョン管理されます。YAML では AzureCLI@2 のように @ の後ろでメジャーバージョンを指定します。Microsoft Learn では、パイプラインは通常、新しいマイナーバージョンを自動的に使用し、新しいメジャーバージョンは手動で変更するまで指定済みメジャーバージョンを使い続けると説明されています。(Microsoft Learn)

つまり、管理者が見るべき差分は次のようになります。

steps:
- task: AzureCLI@2
  inputs:
    azureSubscription: 'prod-service-connection'
    scriptType: 'bash'
    scriptLocation: 'inlineScript'
    inlineScript: |
      az version

この例では AzureCLI@2 のメジャーバージョンは固定されています。ただし、同じメジャーバージョン内のマイナー更新は自動的に反映される可能性があります。そのため、「メジャーバージョンを変えていないから影響はない」と考えるのは危険です。

一方で、次のように古いメジャーバージョンを使っている場合は、移行計画の対象にします。

steps:
- task: AzureCLI@1

v273 では AzureCLI V1 の非推奨化が含まれているため、該当パイプラインは優先的に確認します。ただし、いきなり AzureCLI@2 や AzureCLI@3 に置き換えるのではなく、入力パラメーター、認証方式、スクリプトの互換性、組織で利用可能なタスクバージョンを確認してから移行します。

導入前チェックリスト

v272/v273 の更新波を受けて、管理者が実行するチェックリストは次の順番で進めると安全です。

影響範囲の棚卸し

チェック項目実施内容完了条件
YAML の検索リポジトリ全体で AzureCLI@、AzurePowerShell@、VSTest@、SqlAzureDacpacDeployment@ などを検索対象ファイルとブランチが一覧化されている
テンプレートの確認共通テンプレート、再利用 YAML、パイプラインテンプレートを確認直接利用と間接利用を区別できている
Classic Pipeline の確認UI 上のタスク一覧、タスクグループ、リリース定義を確認YAML 以外の利用箇所が漏れていない
実行頻度の確認毎日実行、本番リリース時のみ、手動実行などに分類検証優先度を決められる
所有者の確認アプリ担当、運用担当、承認者を記録問い合わせ先が明確になっている

棚卸しでは、タスク名だけでなく、エージェントプール、サービス接続、環境、最終成功日時、直近の失敗履歴も一緒に記録します。更新後に障害が起きたとき、原因がタスク更新なのか、外部サービスなのか、既存の不安定要因なのかを切り分けやすくなります。

組織設定とタスク制限の確認

Azure Pipelines では、組み込みタスクや Marketplace タスクの利用を組織設定で制御できます。Microsoft Learn では、組織設定の Pipelines 配下にある Task restrictions で、組み込みタスク、Marketplace タスク、またはその両方を無効化できると説明されています。Marketplace タスクを無効にすることは、パイプラインのセキュリティ向上につながる場合があります。(Microsoft Learn)

確認すべき項目は次のとおりです。

設定確認すること判断基準
Built-in tasks組み込みタスクが無効化されていないか通常は有効のままにする
Marketplace tasksMarketplace タスクの利用を許可しているか不要なら制限を検討する
Custom tasks独自タスクが組み込みタスク名と衝突していないか名前衝突がある場合は GUID 参照を検討する
権限タスクや拡張機能を追加できるユーザーが広すぎないか管理者・運用所有者に限定する
監査タスク追加・変更の履歴を追えるか変更管理チケットと紐付ける

カスタムタスクを使っている組織では、タスク名の衝突にも注意が必要です。公式ドキュメントでは、カスタムタスク名が組み込みタスク名と一致する場合、パイプラインでは組み込みタスクが使用されるため、一意のタスク GUID で参照できると説明されています。(Microsoft Learn)

サービス接続の差分確認

v272 の Azure Pipelines リリースノートでは、サービス接続の管理ページで接続タイプや認証方式などの追加情報を表示でき、これらのフィールドでフィルターできるようになったと説明されています。ただし、追加のサービス接続詳細は新しく作成されたサービス接続でのみ利用可能で、機能は2〜3週間でロールアウトされるとされています。(Microsoft Learn)

このため、管理者は次のように確認します。

確認項目見る場所注意点
接続タイプProject settings > Service connections古い接続では詳細が出ない場合がある
認証方式Service connection の詳細または一覧フィルターSecret ベースか Workload identity federation かを確認
利用パイプラインService connection の権限・承認設定全パイプライン許可になっていないか確認
期限切れ資格情報サービスプリンシパル、証明書、シークレットタスク更新と同時に期限切れが表面化することがある
環境別の接続dev / stg / prod本番だけ設定が古いケースに注意

Azure Resource Manager のサービス接続については、Microsoft は Workload identity federation の利用を推奨しており、既存のサービス接続も条件を満たす場合は変換できると説明しています。新規作成時に「Grant access permission to all pipelines」を選ぶと全パイプラインが接続を使えるため、個別承認の方が推奨されています。(Microsoft Learn)

展開順序チェックリスト

v272/v273 のようなタスク更新波では、展開順序を誤ると「どの変更で壊れたか」が分からなくなります。以下の順で進めると、影響を分離しやすくなります。

フェーズ対象実施内容次へ進む条件
事実確認管理者v272/v273 のリリース内容、該当タスク、非推奨タスクを整理影響候補タスクが一覧化されている
棚卸し全パイプラインYAML、Classic、テンプレート、タスクグループを検索重要度と所有者が付いている
検証環境低リスクパイプラインdev 環境で代表ジョブを再実行失敗が再現性のあるものか判断できる
ステージング本番相当構成サービス接続、エージェント、成果物出力を本番相当にするログ、成果物、デプロイ結果に差分がない
本番低リスク影響の小さいサービス監視を強めて段階的に実行失敗率、実行時間、出力に異常がない
本番高リスクDB、基幹、外部公開サービスメンテナンス枠または承認フロー付きで実行ロールバック手順が確認済み
事後確認管理者・運用失敗チケット、ログ、移行残を整理非推奨タスクの移行計画が更新されている

本番前の検証では、「パイプラインが成功したか」だけでなく、次の項目まで確認します。

確認項目具体的に見るもの
実行時間以前より極端に長くなっていないか
認証ログサービス接続、Azure CLI、Azure PowerShell の認証で警告が出ていないか
成果物出力ファイル名、パス、バージョン、サイズが想定どおりか
テスト結果失敗件数、スキップ件数、結果ファイルの取り込みが変わっていないか
デプロイ結果App Service、Function、SQL、Storage などの実リソースが更新されているか
後続ジョブ依存ステージ、通知、承認、ロールバックジョブが動くか

設定差分を見るときの実務ポイント

AzureCLI / AzurePowerShell は「タスク」だけでなく「中のコマンド」を見る

AzureCLI や AzurePowerShell のタスク更新では、タスク自体の依存パッケージだけでなく、実行されるコマンドの前提も確認します。

たとえば、次のようなパイプラインでは、az version、az account show、対象リソースへの読み取り操作を最初に入れておくと、認証問題を早く発見できます。

steps:
- task: AzureCLI@2
  displayName: 'Precheck Azure CLI and service connection'
  inputs:
    azureSubscription: 'stg-service-connection'
    scriptType: 'bash'
    scriptLocation: 'inlineScript'
    inlineScript: |
      az version
      az account show
      az group show --name rg-sample-stg

本番デプロイの直前に初めて失敗を検出するのではなく、読み取り専用のプリチェックを先に実行するのが安全です。

Node 24 移行タスクはセルフホストエージェントで重点確認する

v273 では AppCenterDistributeV3、DownloadBuildArtifactsV0、AzureSpringCloudV0 などで Node 24 への移行が含まれています。(GitHub)

Microsoft ホステッドエージェントでは問題が出にくい場合でも、セルフホストエージェントでは次の差分が表面化することがあります。

確認対象見るべき内容
エージェントバージョン古いエージェントを使い続けていないか
プロキシタスク実行時の外部通信が許可されているか
証明書社内 CA、SSL インスペクション環境で失敗しないか
ツールキャッシュ既存キャッシュに依存していないか
コンテナー実行タスクがホスト実行かコンテナー実行か

「タスクの更新だからエージェントは関係ない」と切り分けるのは早すぎます。特に、成果物ダウンロード、ツール導入、外部サービス接続は、エージェントのネットワーク条件に左右されます。

SQL DACPAC は引数と出力パスを重点的に確認する

v273 では SqlAzureDacpacDeploymentV1 と SqlDacpacDeploymentOnMachineGroupV0 に対して、Invoke-Expression が使われる箇所のセキュリティ修正が含まれています。また SqlAzureDacpacDeploymentV1 では DeployReport、DriftReport、Script アクションの /OutputPath 競合修正も含まれています。(GitHub)

SQL デプロイ系では、次の点を確認します。

確認項目例
追加引数スペース、括弧、クォートを含む値が正しく渡るか
出力パスレポートやスクリプト出力が想定フォルダーに作られるか
権限SQL 接続ユーザーが必要最小権限で動作するか
失敗時の挙動デプロイ失敗時に後続ジョブが止まるか
ロールバック直前の DACPAC、バックアップ、変更スクリプトが用意されているか

SQL は「パイプライン成功」と「業務上安全」が一致しない領域です。デプロイ後にスキーマ差分、主要クエリ、アプリ接続まで確認してください。

周知チェックリスト

リリース波への対応では、管理者だけが詳細を把握していても不十分です。開発チーム、運用チーム、セキュリティ担当、リリース承認者に、必要な粒度で周知します。

周知先伝える内容依頼事項
開発チーム影響可能性のあるタスク名、検証対象ブランチ、報告期限初回実行ログの確認、古いタスクの申告
運用チーム本番展開の順序、監視対象、障害時の連絡経路失敗率、実行時間、デプロイ後監視
セキュリティ担当脆弱性対応、Marketplace タスク、非推奨タスク例外利用の承認、移行期限の設定
リリース承認者本番反映日、対象サービス、ロールバック方針承認条件の確認
ヘルプデスクよくある問い合わせ、一次切り分けビルドID、パイプライン名、エラー抜粋の収集

そのまま使える周知文の例は次のとおりです。

件名: Azure Pipelines task library v272/v273 更新波に伴うパイプライン確認依頼

Azure Pipelines task library の v272/v273 更新により、Azure デプロイ、SQL、FTP、テスト、成果物取得、パッケージ関連タスクで影響確認が必要です。

対象候補:
- AzureCLI / AzurePowerShell / AzureFunctionApp / AzureWebApp / AzureFileCopy
- SqlAzureDacpacDeployment / SqlDacpacDeploymentOnMachineGroup
- FtpUpload
- VSTest / VsTest / PublishTestResults
- UniversalPackages / DownloadBuildArtifacts / NuGetToolInstaller
- AzureCLI@1、DownloadGitHubNpmPackage@1、DownloadGitHubNugetPackage@1 を利用しているパイプライン

依頼事項:
1. 対象タスクを含むパイプラインを dev または stg で再実行してください。
2. 初回実行ログで認証、成果物、テスト結果、デプロイ結果を確認してください。
3. AzureCLI@1 などの非推奨対象を利用している場合は、移行予定を連絡してください。
4. 失敗時は、パイプライン名、実行ID、対象タスク、エラー抜粋を添えて報告してください。

本番展開は、検証完了後に段階的に実施します。

失敗しやすいポイントと回避策

失敗しやすいポイント起きる問題回避策
YAML だけを検索するClassic Pipeline やタスクグループを見落とすUI 定義、リリース定義、共通テンプレートも確認する
メジャーバージョン固定だけで安心するマイナー更新の影響を見逃す代表パイプラインを必ず再実行する
サービス接続の新UIだけで判断する古い接続の詳細が表示されず、確認漏れになる既存接続は個別に認証方式と期限を確認する
非推奨タスクを後回しにする将来のリリース時に急な移行が必要になる今回の台帳に移行期限と担当者を入れる
セルフホストエージェントを検証しない本番だけプロキシや証明書で失敗する本番と同じエージェントプールで stg 検証する
成功/失敗だけを見る成果物やテスト結果の取り込み不備を見逃す出力ファイル、テスト件数、デプロイ後状態を比較する
ロールバックを過信するClassic Release で戻し方が手作業になる変更前の定義、タスク入力、スクリーンショットを保存する

Microsoft Learn では、YAML パイプラインで変更後に問題がある場合は履歴タブから変更を戻せる一方、リリースパイプラインでは古いバージョンへ復元できず、手動で戻して保存する必要があると説明されています。(Microsoft Learn)

管理台帳に入れるべき項目

v272/v273 対応を一度きりの作業で終わらせず、今後のスプリント更新にも使える管理台帳を作ると運用が楽になります。

項目記入例
パイプライン名webapp-prod-deploy
種別YAML / Classic / Release
リポジトリ・定義場所org/project/repo/path/azure-pipelines.yml
対象タスクAzureCLI@2、AzureRmWebAppDeployment@4
関連サービス接続prod-arm-wif
エージェントプールself-hosted-linux-prod
重要度高
所有者App Platform Team
最終検証日2026-04-22
検証結果stg 成功、本番は承認待ち
非推奨タスクなし / AzureCLI@1 あり
次アクションAzureCLI@1 移行設計、5月末まで

この台帳は、次回以降の Azure Pipelines task library 更新でもそのまま使えます。特にグローバル組織では、タイムゾーンや担当チームが分散しているため、「誰が、どのパイプラインを、いつ確認したか」を明確に残すことが重要です。

最終確認チェックリスト

本番反映前に、以下を完了しているか確認してください。

チェック完了基準
v272/v273 の変更点を確認した影響タスクと非推奨タスクを一覧化済み
YAML / Classic / テンプレートを棚卸しした間接利用を含めて対象が見えている
タスク制限を確認したBuilt-in / Marketplace / Custom task の方針が明確
サービス接続を確認した認証方式、権限、期限、利用パイプラインを確認済み
セルフホストエージェントを確認したプロキシ、証明書、ツール取得に問題がない
代表パイプラインを再実行したdev / stg で成功し、成果物とデプロイ結果を確認済み
周知を送った開発、運用、セキュリティ、承認者に依頼済み
ロールバック手順を用意したYAML 履歴、Classic 手動復旧、成果物、DB 対応を確認済み
非推奨タスクの移行計画を作った担当者と期限が決まっている

Azure Pipelines task library の v272/v273 更新は、単なるリリースノート確認で終わらせず、棚卸し、設定確認、検証、周知、段階展開の流れで管理することが重要です。まずは影響タスクを含むパイプラインを一覧化し、サービス接続とエージェント条件を確認してください。そのうえで、低リスク環境から再実行し、非推奨タスクの移行計画を同時に進めるのが、今回のリリース波に対する最も安全な対応です。

この記事を書いた人

実務の現場で詰まりがちなポイントを地図にするITブログ「IT trip」を運営。Windows/Office(Teams・Excel)からSQL、サーバ運用、ガジェットまで、再現性のある手順と“なぜそうなるか”を丁寧に解説します。読んだらすぐ試せること、そして迷った人の次の一歩が見えることを大切にしています。

コメント

コメントする

目次