Azure Pipelines と ServiceNow の変更管理を統合する

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

開発チームと IT チーム間のコラボレーションを向上させるために、Azure Pipelines では ServiceNow との統合がサポートされています。 Teams は、変更に関連するリスクを軽減し、リリース パイプラインに変更管理ゲートを含めることで、情報技術インフラストラクチャ ライブラリ (ITIL) などのサービス管理手法に従うことができます。

このチュートリアルでは、次の作業を行う方法について説明します。

• ServiceNow インスタンスを構成する。
• ServiceNow 変更管理プロセスをリリース ゲートとして含めます。
• リリース パイプラインから変更管理プロセスを監視します。
• 配置の結果で ServiceNow 変更要求が更新された状態を保持する。

前提条件

• ServiceNow の非開発インスタンスに HI アカウントを持っている。
• 拡張機能をインストールするための組織レベルのアクセス許可を持つ Azure DevOps organization と project があります。
• Classic リリース パイプライン、または環境にデプロイする YAML パイプラインを Azure DevOps プロジェクトに配置します。
• ゲートと承認の手順を理解し、従ってデプロイを制御し承認とチェックをしてください。

ServiceNow インスタンスを構成する

1. ServiceNow インスタンスに Azure Pipelines 拡張機能をインストールします。 ServiceNow ストアからのアプリのインストールの詳細については、「Buying Overview」を参照してください。 インストールを完了するには、 HI 資格情報が必要です。

2. ServiceNow で、Azure Pipelines サービス アカウントの新しいユーザーを作成し、 x_mioms_azpipeline.pipelinesExecution ロールを付与します。

   

Azure DevOps の組織とプロジェクトを設定する

1. Azure DevOps 組織で、 ServiceNow Change Management 拡張機能をインストールします。

   

2. Azure DevOps プロジェクトで、 Basic 認証 または OAuth2 認証を使用して、新しい ServiceNow サービス接続を作成します。 詳細については、「 サービス接続の作成」を参照してください。

   

パイプラインを構成する

ServiceNow 統合は、クラシック リリース パイプラインまたは環境にデプロイする YAML パイプラインに追加できます。

クラシック

ServiceNow Change Management のデプロイ前ゲートを追加する

1. Azure Pipelines リリース パイプラインで、 Pre-deployment conditions アイコンを選択します。

2. 展開条件画面で、Gates を展開して有効にし展開ゲートの横にある Add を選択しServiceNow Change Management 展開前ゲートを選択します。

   

YAML

ServiceNow Change Management チェックを追加する

1. Azure DevOps プロジェクトで、左側のメニューで Pipelines>Environments を選択し、YAML パイプラインのデプロイ先の環境を選択します。

2. [ Approvals and checks タブで、 + を選択して新しいチェックを追加し、 ServiceNow Change Management を選択して追加します 環境に確認します。

   

ServiceNow Change Management の設定を構成する

1. ServiceNow 変更管理設定画面の ServiceNow 接続で、前に作成した ServiceNow サービス接続を選択します。

   

2. フォームの残りの部分を次のように入力します。

   設定	説明
   操作	[新しい変更要求の作成選択するか既存の変更要求を使用。
   変更の種類	[ 標準、 標準、または Emergency を選択します。
   簡単な説明	変更の概要を入力します。
   変更要求のスケジュール	必要に応じて、ServiceNow ワークフローで受け入れた変更のスケジュールを入力します。 計画開始日および計画終了日に、UTC の日付と時刻を yyyy-MM-ddTHH:mm:ssZ の形式で入力します。
   説明	必要に応じて、変更の詳細な説明を入力します。
   カテゴリ	必要に応じて、変更のカテゴリ ( Hardware、 Network、 Software など) を選択。
   優先順位	必要に応じて、変更の優先順位を選択します。
   リスク	必要に応じて、変更のリスク レベルを選択します。
   影響	必要に応じて、変更がビジネスに与える影響を選択します。
   構成項目	必要に応じて、変更が適用される構成項目を選択します。
   割り当てグループ	必要に応じて、変更が割り当てられているグループを選択します。
   詳細>追加の変更要求パラメーター	フィールドの横にある省略記号を選択し、 追加 を選択してパラメーターを追加します。 名前は、ラベルではなくフィールド名で、u_backout_planなどのu_で始まる必要があります。 値は ServiceNow で有効である必要があります。 無効なエントリは無視されます。
   成功の基準	変更要求の状態を選択するかAdvanced 成功条件をします。
   変更要求の望ましい状態	ゲートが成功し、パイプラインを続行するために必要な変更要求の状態値を選択します。
   高度な成功条件	ゲートが成功するタイミングを制御する式を入力します。 変更要求は、ServiceNow からの応答で root['result'] として定義されます。 たとえば、and(eq(root['result'].state, 'New'),eq(root['result'].risk, 'Low')) のようにします。 詳細については、「式」をご覧ください。
   出力変数>参照名	デプロイ ワークフローで出力変数を使用できるようにするには、参照名を指定します。 エージェントレス ジョブのプレフィックスとして PREDEPLOYGATE を使用して、ゲート変数にアクセスできます。 たとえば、参照名が gate1 に設定されている場合は、変数 $(PREDEPLOYGATE.gate1.CHANGE_REQUEST_NUMBER)を使用して変更要求番号を取得できます。
   変数リスト	CHANGE_REQUEST_NUMBER は変更要求の数です。 CHANGE_SYSTEM_ID は、変更要求のシステム ID です。

クラシック

パイプラインを更新する

1. リリース パイプラインの最後に、タスク Update ServiceNow Change Request を含む Agentless ジョブを追加します。

2. タスク設定フォームの ServiceNow 接続で、ServiceNow サービス接続を選択します。

3. Change 要求番号で、更新する ServiceNow 変更要求番号を入力します。

4. 更新の状態を選択し、変更要求の更新状態で変更要求に設定する状態を選択または入力します。

5. Work Notes Advancedで、必要に応じて、変更要求の更新に追加する作業ノートを入力します。

   

Note

実行中に変更要求フィールドが更新されない場合、ServiceNow 変更要求の更新タスクは失敗します。 無効なフィールドや値がこのタスクに渡されると、ServiceNow で無視されます。

リリースを作成する

[リリースの作成] を選択して、新しいリリースを開始します。

パイプラインにより、以前に作成した配置前条件の一部として、ServiceNow で新しい変更要求が作成されるはずです。

パイプラインは、すべてのゲートが同じサンプル間隔内で成功するまで待機します。 変更番号を検査するには、状態アイコンを選択してパイプラインのログを表示します。

変更要求は ServiceNow でキューに登録され、変更所有者はそれを表示できます。

新しい変更要求をトリガーしたリリース パイプラインは、 Azure DevOps Pipeline metadata セクションにあります。

変更を実装する準備が整い、 Implement 状態に移動すると、パイプラインは実行を再開し、ゲートの状態は ucceeded を返す必要があります。

変更要求は、デプロイ後に自動的に閉じます。

YAML

YAML タスクを追加する

変更要求を更新するには、次の server ジョブ UpdateServiceNowChangeRequest@2 タスクを YAML パイプラインに追加します。

stages:
- stage: Stage1
  jobs:
  - deployment: DeployLatest
    environment: <environment-name>
  ...
  - job: UpdateChangeRequest
    steps:
    - task: UpdateServiceNowChangeRequest@2
      displayName: 'Update ServiceNow Change Request'
      inputs:
        ServiceNowConnection: '<service-connection-name>'
        NewStatus: '<status-to-set>'
        WorkNotes: '<work-notes-for-change-request>'
        otherParameters: '{"u_<field-name>": "<valid-value>"}'
pool: server

次に例を示します。

パイプラインを実行する

パイプラインを保存し、実行します。 新しい変更要求が自動的に作成され、パイプラインが一時停止し、チェックが完了するまで待機します。 チェックが完了すると、パイプラインによって実行が再開されます。

変更要求は、デプロイ後に自動的に閉じます。

よく寄せられる質問

サポートされている ServiceNow のバージョンは何ですか?

Azure Pipelines ServiceNow 拡張機能は、キングストン、ロンドン、ニューヨーク、パリ、ケベック、ローマ、サンディエゴ、東京、ユタのリリースをサポートしています。

どのような種類の変更要求がサポートされていますか?

Azure Pipelines ServiceNow 統合では、通常、標準、緊急の変更要求がサポートされます。

他の変更プロパティ操作方法設定しますか?

追加の変更要求パラメーターフィールドまたはotherParametersで、さらに変更プロパティを指定できます。 キーと値のペアの JSON 形式を使用します。名前は、ラベルではなくフィールド名で、プレフィックスとして u_。

変更要求のカスタム フィールドをより多くの変更要求パラメーターで更新できますか?

変更要求でユーザー設定フィールドを定義する場合は、[セット変換マップのインポート カスタム フィールドのマッピングを追加する必要があります。

カテゴリ、状態、およびその他のフィールドに設定されたドロップダウン値を確認するにはどうすればよいですか?

Change Management Core と Change Management - ドロップダウンを機能させるには、ServiceNow インスタンスで状態モデル プラグインがアクティブである必要があります。 詳細については、「アップグレードの変更管理および変更要求の状態の更新を参照してください。

リソース

• Configure your release pipelines for safe deployments
• リリース ゲートとしての X センチメント
• GitHub issues as a release gate
• カスタム ゲートの作成に関するページ。
• ServerTaskHelper Library の例

関連するコンテンツ

• リリース ゲートと承認の概要
• 承認とチェックを定義する
• 手動介入を設定する
• ゲートと承認を使用してデプロイを制御する
• ステージ、依存関係および条件を追加する
• リリース トリガー