での Jenkins パイプラインのモデル化 DevOps

  • リリースバージョン: Yokohama
  • 更新日 2025年01月30日
  • 所要時間：5分

    • パイプラインをアプリにマッピングし、パイプラインステップDevOpsJenkinsステージにマッピングすることで、Jenkinsパイプラインをモデル化します。

    始める前に

    ServiceNow DevOps 用の Jenkins プラグインは、オーケストレーションツールがServiceNow DevOpsと通信し、パイプライン実行の特定の側面を制御できるように、変更の促進を有効にするために提供されています。

    Jenkins マーケットプレイスからプラグインをインストールします。Jenkins インスタンスの [Jenkins の管理] > [システム構成] > [プラグイン ] に移動します。ServiceNow DevOps プラグインを検索して選択し、[インストール] を選択します。

    必要なロール:sn_devops.admin

    このタスクについて

    スクリプト化されたパイプライン (Jenkinsfile) とフリースタイルジョブの両方がサポートされています。

    Jenkinsfile パイプラインの場合、パイプラインステップは手動ではなく自動的に作成、マッピングされ、オーケストレーションタスクに関連付けられます。

    手順

    1. パイプラインを DevOps のアプリにマッピングします。
      1. 次のように移動する。 DevOps > アプリ & パイプライン > アプリ をクリックし、パイプラインに関連付けるアプリケーションレコードを開きます。
      2. [パイプライン] 関連リストで、[ 編集... ] をクリックしてアプリに関連付けるパイプラインを選択するか、[ 新規 ] をクリックしてパイプラインを作成します。
        新しいパイプラインの場合は、Jenkins で指定されている完全なプロジェクト名を使用して、[ オーケストレーションパイプライン ] フィールドに入力します。
        注:
        パイプラインをアプリに関連付けると、インポート中にパイプラインステップもフェッチされます。
      3. [Submit (送信)] を選択します。
    2. パイプラインレコードを再度開き、[ 追跡 ] チェックボックスをオンにして、パイプラインからイベントが受信されるようにします。
      注:
      パイプラインをDevOpsと統合するには、[追跡] チェックボックスをオンにする必要があります。
    3. オーケストレーションタスクが作成されるように、Jenkinsの各パイプラインステージにマッピングするDevOpsステップを自動または手動で作成します。
      • 宣言型パイプラインまたはスクリプト化パイプラインの場合は、 Jenkins パイプラインを実行して、 DevOps でパイプラインステップを自動的に作成してマッピングします。

        実行中に Jenkins パイプラインからステップ通知を受信すると DevOps パイプラインステップが自動的に作成、マッピングされ、関連付けられます。

      • フリースタイルジョブの場合は、各パイプラインステップを手動で作成し、 Jenkins パイプラインジョブにマッピングします。

        [ステップ] 関連リストで [新規] をクリックして、Jenkinsパイプラインステージ ([オーケストレーションステージ] フィールド) ごとにDevOpsステップを作成します

        注:
        各ステップの [オーケストレーションステージ ] フィールド値では大文字と小文字が区別され、対応する Jenkins パイプラインステージの元の名前と一致する必要があります。
        [Name (名前)] パイプラインステップの名前。
        パイプライン ステップが構成されているパイプライン。
        タイプ パイプラインステップタイプ。
        • 構築とテスト
        • テスト
        • 展開
        • 展開とテスト
        • 手動
        • 製品展開
        順序

        ステップの実行順序。

        注:
        ステップの順序によって、 パイプライン UI のカードの順序が決まります。

        パイプライン UI のカードの順序は、タスクの実行順です。
        オーケストレーションステージ

        Jenkins パイプラインステージ名 (大文字と小文字を区別)。

        注:
        Jenkinsパイプラインステージにステップを関連付けるには、[オーケストレーションステージ] フィールドを設定する必要があります。
        ビジネスサービス ステップに適用される構成サービス。

        オーケストレーションタスクが作成されたら、[オーケストレーションタスク] 関連リスト内の各オーケストレーションタスクを DevOps パイプラインステップに関連付けます。

    4. オプション: パイプラインのタイプに基づいて、自動または手動で変更コントロールを有効にします。
      • 宣言型パイプラインまたはスクリプト化されたパイプラインの場合、パイプラインで snDevOpsChange スクリプトを使用した場合は、 Jenkins パイプラインを実行して変更コントロールを自動的に有効にします。フリースタイルジョブに提供されている手順に従って、手動で変更コントロールを有効にすることもできます。
      • フリースタイルジョブの場合は、ステップの [ 変更コントロール ] チェックボックスをオンにして、 変更の促進 と対応する構成フィールドを有効にします。
        注:
        変更を迅速化するには、ServiceNow 変更管理 をインストールする必要があります。
        変更受付

        変更要求が作成されたときにパイプラインが一時停止しないように、ステップの変更受付を有効にする場合に選択します。

        すべてのパイプラインデータが変更に含まれますが、パイプラインを続行するための承認は必要ありません。
        変更承認グループ

        変更要求の承認グループ。

        変更承認グループは、DevOps変更要求のアサイン先グループになります。

        注:
        承認者フィールドが空にならないように、選択したグループにメンバーとグループマネージャーがいることを確認してください。
        変更タイプ 作成する変更要求タイプ。
        • 標準 (デフォルト)
        • Standard
        • 緊急
        変更モデル 変更要求の変更モデル。詳細については、「DevOps 変更モデル」を参照してください。

        Template (テンプレート)

        注:
        このフィールドは、[ 変更タイプ ] が [通常] または [緊急] の場合にのみ表示されます。

        通常または緊急の変更要求のフィールドを自動入力するために使用するテンプレートのリスト。

        テンプレートを選択するか、新しいテンプレートを作成します。

        標準的な変更テンプレート

        注:
        このフィールドは、[ 変更タイプ ] が [標準] の場合にのみ表示されます。
        		 標準的な変更要求に使用する標準的な変更テンプレートのリスト。
        注:
        標準的な変更タイプの場合、このフィールドは必須です。
        変更をコントロールされた分岐

        (マルチブランチのみ)変更管理下にある分岐のカンマ区切りリスト。ワイルドカードがサポートされています。
    5. 次のように移動する。 DevOps > ツール > オーケストレーションツール をクリックし、 Jenkins ツールレコードで DevOps [Webhook URL ] フィールドの値をコピーします。
      Webhook URL には、ツールのsys_idなど、Jenkinsがメッセージを送信するDevOps場所が含まれています。

      https://<devops.integration.user>:<password>@<your-instance>.service-now.com/api/sn_devops/v1/devops/tool/event/{レコードのsys_id}

    例

    図 : 1. DevOpsアプリ
    DevOps パイプライン
    図 : 2. DevOps パイプライン
    DevOps パイプラインステップ
    図 : 3. DevOps パイプラインステップ
    DevOps パイプラインステージ