DevOps チェンジベロシティへのオンボードJenkins - クラシック

  • リリースバージョン: Xanadu
  • 更新日 2024年08月01日
  • 所要時間:3分
  • Jenkins インスタンスを接続してパイプラインを検出して追跡し、エンドツーエンドのトレーサビリティと変更の自動化のためにオーケストレーションタスクをインポートします。

    始める前に

    必要なロール:sn_devops.admin または sn_devops.tool_owner

    Jenkins 用の ServiceNow DevOps プラグインをインストールして有効にします。すでにインストールしている場合は、最新バージョンに更新してください。手順については、「Jenkinsプラグインの構成」を参照してください。

    このタスクについて

    アクション:
    • DevOpsツールレコードを送信するときに、Jenkinsに接続して Webhook URL を取得します。
    • オーケストレーションタスクとパイプラインを検出します。
    • タスク実行とステップ実行のレコードをインポートします。
    注:
    Jenkins API トークンを使用して、Jenkins との接続を認証できます。詳細については、「API トークン認証を使用した Jenkins への接続」を参照してください。

    手順

    1. Jenkins に自動的に接続して Webhook URL を取得するためのツールレコードを DevOps に作成します。
      1. 移動先 DevOps > ツール > 新規作成 (従来) レコードを作成します
      2. ツール名を入力し、ツールの詳細を入力します。
        ツール統合 Jenkins
        ツール URL

        Jenkins ツール URL

        例:

        https://jenkins.com

        ツールユーザー名 Jenkins ユーザー名
        ツールパスワード/アクセストークン Jenkins パスワード、アクセストークン、または生成した API トークン。
        注:
        API トークンを生成するには、「 API トークン認証を使用した Jenkins への接続」を参照してください。

        Jenkins に接続するために資格情報に必要なすべてのアクセス許可の一覧については、「DevOpsツールに必要な権限 のアクセス許可Jenkins」を参照してください。

      3. MID サーバーに接続されているオンプレミスツールの [MID サーバー] を選択します。
        [アプリケーション] の値は自動的に [ DevOps ] に設定され、[機能] の値は [REST] に設定されます。
      4. [送信] をクリックします。
        ツールが正常に接続されました。
    ツールの作成が成功すると、ツールレコードページに移動します。
    1. ツールへのアクセスを制御する場合は、ツールへのアクセス権を付与する必要があるグループを [アクセス] タブの [保守担当者] フィールドに追加します。
      グループ内のユーザーが実行できるタスクは、割り当てられたロールによって異なります。
      • DevOps ツールオーナーロール:ツールを表示および編集できます。
      • DevOps アプリオーナーロール:ツールを表示し、ツールのオブジェクト (プラン、リポジトリ、パイプラインなど) の関連付け、検出、履歴データのインポート、パイプラインステップの変更 (該当する場合) を実行できます。
      • DevOps 管理者ロール:すべてのツールを編集できます。
      • その他の DevOps ロール:ツールを表示できます。
      注:
      DevOpsロールを持つユーザーを含むグループのみが[保守担当者]フィールドで選択できます。

      ツールへのアクセスを制限することを選択した場合、[ すべてのアプリ所有者がツールオブジェクトを表示してアプリケーションに関連付けることができる ] オプションを選択できるようになります。このオプションを使用すると、 DevOps アプリオーナーロールを持つすべてのユーザーがツールにアクセスできます。選択すると、ツールのオブジェクトの表示、関連付け、検出、履歴データのインポート、およびパイプライン ステップの変更 (該当する場合) が可能になります。

    2. [ 検出 ] をクリックして、既存のオーケストレーションタスク (Jenkins ステージ) とパイプラインを検出します。
      注:
      オーケストレーションタスクとパイプラインは、 sn_devops.discover.folder.depth プロパティで指定されたレベルにネストされたフォルダーに対して検出されます。詳細については、「 DevOps とともにインストールされるプロパティ」を参照してください。
      対応する関連リストにレコードが追加されます。
    3. [オーケストレーションタスク] 関連リストから検出されたレコードを開き、[ インポート ] 関連リンクをクリックして、オーケストレーションタスクから履歴データをインポートします。
      インポートされたタスク実行レコードとステップ実行レコードは、対応する関連リストに追加されます。