カスタムアクションのAzure DevOpsとAzure DevOpsに ServiceNow DevOps 拡張機能を使用する

Azure DevOps の拡張機能をインストールして構成しDevOpsAzure パイプラインからDevOps 変更速度管理にビルド通知とリリース通知を送信します。

始める前に

必要なロール: sn_devops.admin

このタスクについて

Visual Studio Marketplace - Extensions for Azure DevOps の ServiceNow DevOps 拡張機能を使用して、Azure パイプラインを ServiceNow DevOps アプリケーションと統合できます。DevOps 変更速度管理 の成果物とパッケージの詳細については、「アーティファクトとパッケージ」を参照してください。

• [ServiceNow DevOps] サービス接続

  Azure パイプラインをに接続するために必要です ServiceNow

• ServiceNow DevOps リリースゲート

  Azure リリース (CD) パイプラインで変更管理を有効にするために必要です (デプロイ前の条件のみ)。

Azure ビルド (CI) パイプラインのカスタムタスク:

• エージェントレス (サーバー) ジョブ
  • ServiceNow DevOps Server アーティファクト登録 カスタムタスク

    エージェントレス (サーバー) ジョブがアーティファクトを ServiceNow インスタンスに登録するために必要です

  • ServiceNow DevOps Server パッケージ登録 カスタムタスク

    エージェントレス (サーバー) ジョブが ServiceNow インスタンスにパッケージを登録するために必要です

  • ServiceNow DevOps Server 変更の促進 カスタムタスク

    エージェントレス (サーバー) ジョブが Azure パイプラインの一部として ServiceNow 変更管理 で変更要求を自動的に作成するために必要です。

    注:

    ServiceNow DevOps Server 変更の促進タスクには、ServiceNow DevOps Server ジョブ通知タスクは必要ありません。
  • ServiceNow DevOps Server 変更の取得 カスタムタスク

    サーバージョブの特定の変更の詳細に基づいてパイプライン内の変更要求番号を取得するために必要です。

  • ServiceNow DevOps Server 変更の更新 カスタムタスク

    サーバージョブのパイプラインに関連付けられた変更要求の詳細を更新するために必要です。

• エージェントジョブ
  • ServiceNow DevOps Agent アーティファクト登録 カスタムタスク

    エージェントジョブが ServiceNow インスタンスにアーティファクトを登録するために必要です

  • ServiceNow DevOps エージェントパッケージ登録 カスタムタスク

    エージェントジョブが ServiceNow インスタンスにパッケージを登録するために必要

  • ServiceNow DevOps エージェントで変更カスタムタスクを取得

    エージェントジョブの特定の変更の詳細に基づいて、パイプライン内の変更要求番号を取得するために必要です。

  • ServiceNow DevOps エージェントで変更カスタムタスクを更新

    エージェントジョブのパイプラインに関連付けられた変更要求の詳細を更新するために必要です。

  注:

  ServiceNow DevOps エージェントアーティファクト登録タスクと ServiceNow DevOps エージェントパッケージ登録タスクは、リリースパイプラインではサポートされていません。
• ソフトウェア品質スキャン (SonarQube/SonarCloud)
  • ServiceNow DevOps ビルドソナー登録 カスタムタスク (ビルドパイプライン用)
  • ServiceNow DevOps リリースSonar 登録 カスタムタスク (リリースパイプライン用)
  注:

  ServiceNow DevOps Build Sonar Registration タスクは、リリースパイプラインではサポートされていません。
• セキュリティスキャン:
  • ServiceNow DevOps セキュリティ結果ビルド カスタムタスク (ビルドパイプライン用)
  • ServiceNow DevOps リリースセキュリティ結果 カスタムタスク (リリースパイプライン用)
  注:

  ServiceNow DevOps セキュリティ構築結果タスクは、リリースパイプラインではサポートされていません。

手順

1. Visual Studio Marketplace に移動し、ServiceNow DevOps 拡張機能を検索して、 [無料で入手] をクリックします。

   

2. Azure DevOps組織を選択し、 [インストール] を選択します。
3. Azure DevOpsプロジェクトから、 プロジェクトの設定 > パイプライン > サービス接続.
4. [新しいサービス接続] を選択し、一覧から [ServiceNow DevOps] を選択します。
5. [次へ] を選択し、次の詳細を入力します。

   認証手法	認証をトークンベースの方法と基本的な方法のどちらで行うかを選択します。
   ServiceNow インスタンス	https://<your-instance>.service-now.com/
   ツール ID	オーケストレーションツールの sys_id。 この値は、オーケストレーションツールフォームの「sys_id のコピー」コマンドを使用してコピーできます。ワークスペースを使用している場合は、Azure DevOps ツール接続フォームで [その他のフォームオプション () > [sys_id のコピー] を選択します。サービスカタログまたはクラシックを使用している場合は、Azure DevOpsツール接続フォームで [他のアクション] () > [sys_id のコピー] を選択します。
   ユーザー名	「devops.integration.user」と入力します。
   パスワード	DevOps 統合ユーザー向けパスワード
   API トークン	エンドポイントに接続するための API トークン。
   サービス接続名	DevOps Connection を入力
   すべてのパイプラインにアクセス許可を付与します	チェックボックスをオンにします。

例

図 : 1. Azure パイプライン:ServiceNow DevOps サービス接続の基本認証方法

図 : 2. Azure パイプライン: ServiceNow DevOps サービス接続トークンベースの認証方法

DevOpsで Azure ビルド (CI) パイプラインを設定する

Azure DevOps の ServiceNow DevOps 拡張機能を使用して、Azure ビルド (CI) パイプライン内の 変更管理 と成果物とパッケージを構成します。

始める前に

必要なロール: sn_devops.admin

手順

1. Azure DevOps インスタンスの Pipelines に移動します。
2. 変更管理を有効にするパイプラインを選択します。
3. [ビュー] を選択します。
   パイプラインの YAML エディターが、右側の [タスク] 検索ウィンドウと共に表示されます。
4. [タスク] ペインで必要なカスタムアクションを検索して選択します。

   カスタムアクション	ステップ
   ServiceNow DevOps Server Change Acceleration	[表示名] フィールドに「ServiceNow Change Acceleration」と入力します。 [ServiceNow エンドポイント] フィールドに「My Connection」と入力します。 [実行されたアップストリームジョブ] フィールドに、前のジョブを示す値を入力します。たとえば、サーバーの前のジョブは Test です。 [変更要求の詳細] フィールドで、パイプライン内から クローズコードと変更要求フィールド を設定します。 情報アイコンを選択すると、サンプル出力が表示されます。 変更の促進の詳細については、「変更の促進」を参照してください。
   ServiceNow DevOps エージェントアーティファクトレジストリ	[ServiceNow エンドポイント] フィールドに「My Connection」と入力します。 [アーティファクトペイロード] フィールドに、アーティファクトのリストを含む JSON を入力します。 アーティファクトの詳細については、「アーティファクトとパッケージ」を参照してください。
   ServiceNow DevOps エージェントパッケージレジストリ	[ServiceNow エンドポイント] フィールドに「My Connection」と入力します。 [パッケージ名] フィールドで、アーティファクトを含むパッケージ名を入力します。 [アーティファクトペイロード] フィールドに、ビルドの詳細とアーティファクトのリストを含む JSON を入力します。 アーティファクトの詳細については、「アーティファクトとパッケージ」を参照してください。
   ServiceNow DevOps Server 変更を取得	update-change-request-details-in-an-azure-devops-pipeline.html
   ServiceNow DevOps Server で変更を更新	update-change-request-details-in-an-azure-devops-pipeline.html
   ServiceNow DevOps エージェントが変更を取得	update-change-request-details-in-an-azure-devops-pipeline.html
   ServiceNow DevOps エージェントによる変更の更新	update-change-request-details-in-an-azure-devops-pipeline.html

5. [追加] を選択して、カスタム タスクを Azure パイプラインの [タスク] セクションに追加します。

例

図 : 3. Azure パイプライン: ServiceNow DevOps 変更の促進カスタムタスク

図 : 4. 変更要求の詳細の例

DevOps で Azure リリース (CI) パイプラインを設定する

Azure DevOps の ServiceNow DevOps 拡張機能を使用して、Azure リリース (CD) パイプラインで変更管理、成果物、およびパッケージを構成します。

始める前に

必要なロール: sn_devops.admin

このタスクについて

注:

Azure リリース (CD) パイプラインの変更管理は、デプロイ前のゲートでのみサポートされています。デプロイメント・ゲート前の変更要求は、そのステージの最初のジョブのステップ実行にマップされます。

Azure リリース パイプラインのフェーズは、ステップにマップされます。マルチ構成またはマルチエージェントジョブのステップ名には、パイプライン実行時に派生した実際のジョブ名ではなく、フェーズ名のみを含める必要があります。

スキップされたジョブのタスク実行は失敗としてマークされます。

手順

1. Azure DevOps Pipelines で、 パイプライン>リリースをクリックし、リリースパイプラインを選択します。
2. [編集] を選択して、パイプラインエディターを開きます。
3. ステージの展開前 () アイコンを選択し、切り替えボタンを選択して [ゲート (Gates)]を有効にします。
4. [+追加] を選択し、[ServiceNow DevOps リリースゲート (ServiceNow DevOps Release Gate)] を選択します。
5. [ServiceNow DevOps リリースゲート (ServiceNow DevOps Release Gate )] を選択し、ServiceNow エンドポイントを選択します。
6. リリースゲートの構成を終了し、[評価オプション (Evaluation options)] セクションを展開して以下のタイミングフィールドを設定します。

   ゲートの再評価間の時間 (The time between re-evaluation of gates)	再評価間隔 (分、時間、または日単位)。 変更要求がキャンセルまたは拒否された場合、Azure パイプライン リリース ゲートは、タイムアウトになるまで、構成された間隔で変更要求の状態を再評価し続けます。 変更要求が既に承認、却下、またはキャンセルされた後は、さらに再評価を試みても、ユーザーの介入は必要ありません。
   ゲートが失敗するまでのタイムアウト (The timeout after which gates fail)	タイムアウト値 (分、時間、または日単位)。 デプロイ前の条件が失敗した場合、ステージの後続のジョブは失敗としてマークされ、開始時刻と終了時刻はデフォルトで現在のシステム時刻になります。

   図 : 5. Azure リリースパイプラインの事前デプロイゲート構成

   

7. オプション: Azure リリース (CD) パイプラインで成果物を構成します。
   ビルドパイプラインをソースとして使用してアーティファクトを設定するには、これらの名前が一致する必要があります。

   • リポジトリ名とビルドパイプライン名 (DeployableRepo など)。
   • ビルドパイプライン成果物の名前プロパティと、リリースパイプライン成果物のソースエイリアスプロパティ (BuildDrop など)。

   ビルド パイプラインに加えて、他の 8 つのソースから成果物を選択できます。コミットと作業アイテムの詳細を追跡するには、次のルールに従います。

   • ソースがビルドパイプラインの場合、成果物のセマンティックバージョンプロパティの形式は MAJOR.MINOR.PATCH である必要があります (5.1.3 など)。
   • ソースがビルドパイプラインでない場合は、DevOpsArtifactSemanticVersionAPI 拡張インターフェイスを実装してセマンティックバージョンを定義します。

   アーティファクトの詳細については、「アーティファクトとパッケージ」を参照してください。

例

図 : 6. アーティファクトセットアップ：パイプラインソースをビルド

図 : 7. アーティファクトのセットアップ：リリースパイプライン