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

DevOps 拡張機能をインストールして構成しAzure 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 エージェントアーティファクト登録 カスタムタスク

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

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

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

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

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

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

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

  注:

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

  ServiceNow DevOps ビルドソナー登録タスクは、リリースパイプラインではサポートされていません。
• セキュリティスキャン:
  • 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 コンフィグがインストールされている場合、または This property decides whether to create a Generic Connection on configure operation for Azure DevOps プロパティが無効になっている場合にのみ構成する必要があります。この手順が不要な場合、Webhook はトークンベースの認証を使用して構成されます。
   Password (パスワード)	DevOps 統合ユーザーのパスワード。 注: 統合ユーザー名とパスワードを入力するステップは、DevOps コンフィグがインストールされている場合、または This property decides whether to create a Generic Connection on configure operation for Azure DevOps プロパティが無効になっている場合にのみ構成する必要があります。この手順が不要な場合、Webhook はトークンベースの認証を使用して構成されます。
   API トークン	エンドポイントに接続するための API トークン。
   サービス接続名	DevOps 接続を入力
   すべてのパイプラインにアクセス許可を付与する	チェックボックスをオンにします。

例

図 : 1. Azure パイプライン:ServiceNow DevOps サービス接続ベーシック認証方法

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

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

Azure DevOps の ServiceNow DevOps 拡張機能を使用して、Azure ビルド (CI) パイプラインで 変更コントロール、成果物、およびパッケージを構成します。

始める前に

必要なロール:sn_devops.admin

手順

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

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

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

例

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

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

での Azure リリース (CD) パイプラインの設定 DevOps

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

始める前に

必要なロール:sn_devops.admin

このタスクについて

注:

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

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

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

手順

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

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

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

   

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

   • リポジトリ名、およびビルドパイプライン名 (DeployableRepo など)。
   • ビルドパイプラインアーティファクトの名前プロパティ、およびリリースパイプラインアーティファクトのソースエイリアスプロパティ (BuildDrop など)。

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

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

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

例

図 : 6. アーティファクトのセットアップ - パイプラインソースを構築

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