での一般的なエラー DevOps チェンジベロシティ

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

    • DevOps チェンジベロシティで発生するエラーの根本原因を特定し、それを解決できる可能性がある対応する手順を確認します。

    ツール接続

    次の表に、ツール接続プロセスでツールの詳細を入力した後に [ 送信 ] または [接続 ] ボタンを選択したときに発生する可能性があるエラーを解決するために必要な手順を示します。

    メッセージ アクション
    ツール名が入力されていないため、ツールを作成できません。ツール名を入力して、もう一度やり直してください。 ツール名を再入力します。
    ツール統合が選択されていないため、ツールを作成できません。正しいツール統合値を選択して、もう一度お試しください。 正しいツール統合値を選択します。
    ツールの URL が無効であるか正しくないため、ツールを作成できません。ツールの URL を再入力して、もう一度お試しください。 ツールの URL を再入力します。
    プラットフォームのバージョンを特定できないため、ツールを作成できません。glide.buildtag.last システムプロパティを作成して、もう一度お試しください。
    1. 次のように移動する。 DevOps >管理>プロパティ.
    2. glide.buildtag.last sysプロパティが存在するかどうかを確認します。
    3. そうでない場合は、 glide.buildtag.last sys プロパティを作成します。
    関連付けられた CreateDevOps ツール接続が無効であるため、ツールを作成できません。有効な接続エイリアスを作成して、もう一度お試しください。
    1. 次のように移動する。 すべての > 接続および認証情報 > 接続および認証情報エイリアス をクリックし、CreateDevOpsTool レコードを開きます。
    2. [接続] 関連リストで、レコードを作成し、接続の名前を入力します。
    3. 接続フォームで、[ 認証情報 フィールド] ルックアップ リストを選択し、[ 新規 ] を選択してアドミン認証情報を作成します。
    4. [基本認証情報] を選択し、名前を入力します。
    5. アドミンのユーザー名とパスワードを入力します (DevOps 環境のツールにアクセスするために必要)。

      connection_adminロールを持つユーザーは、HTTP 接続を構成できます。

    6. 接続フォームで、[接続 URL] に https://<インスタンス名>.service-now.com/ を入力します。
    CreateDevOpsTool エイリアス認証情報が正しくないため、ツールを作成できません。認証情報レコードを更新して、もう一度お試しください。
    1. メッセージ内の 認証情報レコード のリンクを選択します。ワークスペース UI からツールに接続している場合は、認証情報レコードのリンクを右クリックし、[ 新しいタブで開く] を選択します。
    2. 認証情報レコードページで、[ ユーザー名 ] フィールドと [パスワード ] フィールドに正しい認証情報を入力します。
    3. 変更を保存し、ツールへの接続を再試行します。
    CreateDevOpsTool エイリアスの接続 URL が正しくないため、ツールを作成できません。URL:https://<instancename>.service-now.com を使用して、もう一度お試しください。
    1. 次のように移動する。 すべての > 接続および認証情報 > 接続および認証情報エイリアス をクリックし、CreateDevOpsTool レコードを開きます。
    2. 接続フォームで、[接続 URL] に https://<インスタンス名>.service-now.com/ を入力します。
    接続エイリアスを作成するには、connection_admin ロールが必要です。システムアドミニストレーターにお問い合わせください。 このエラーは、ツールレコードの接続エイリアスフィールドが空である場合に発生します。ツール接続を作成するには、接続エイリアスが必要です。connection_admin ロールを持つユーザーのみが接続エイリアスを作成できます。アドミニストレーターなどのこのロールを持つユーザーに連絡し、作成済みの接続エイリアスを取得する必要があります。
    ツール名<toolname> が既に存在するため、ツールを作成できません。別の名前を入力して、もう一度お試しください。 ツールに別の名前を使用します。
    有効な MID サーバー構成が <toolname> にないため、ツールを作成できません。有効な MID サーバーを設定して、もう一度お試しください。
    1. ワークスペースを使用している場合は、MID サーバーが実行中で到達可能かどうかを確認します。
    2. カタログとレコードプロデューサーを使用している場合は、MID サーバーが実行されていて、アプリケーションが DevOps で、機能が REST であるかどうかを確認します。
    DevOps データモデルスコープで利用可能な接続および認証情報エイリアスがないため、ツールを作成できません。新しい接続および資格情報エイリアスを作成して、もう一度お試しください。

    このエラーは OAuth 認証で発生します。

    1. 次のように移動する。 すべての > 接続および認証情報 > 接続および認証情報エイリアス.
    2. アプリケーションを使用して新しいエイリアスを DevOps データモデルとして作成します。
    認証情報レコードの作成中の技術的な問題により、ツールを作成できません。
    1. 次のように移動する。 すべての>プロセス自動化>フローデザイナー>の実行.
    2. エラーの詳細を確認するには、sn_devops.devops_create_credentials サブフローの最新の実行を確認します。
    アクティブなレコードの認証情報とドメインの組み合わせがすでに存在するため、ツールを作成できません。

    このエラーは OAuth 認証で発生します。

    1. 別の認証情報を使用します。
    2. 既存の認証情報がアクティブな接続で使用されているかどうかを確認します。
    接続レコードの作成中の技術的な問題により、ツールを作成できません。
    1. 次のように移動する。 すべての>プロセス自動化>フローデザイナー>の実行.
    2. エラーの詳細を把握するには sn_devops.create_connection_for_tool アクションの最新の実行を確認します。
    次の理由により、ツールを作成できません:
    • 検証サブフローが構成されておらず、
    • 関連するツール統合に同じサブフロー名の統合機能レコードが存在しません。
    サブフローを構成し、検証アクションとツール統合のサブフロー名を使用して統合機能レコードを作成して、もう一度お試しください。

    このエラーは、カスタムツール統合の場合にのみ発生します。

    1. 次のように移動する。 [All] > [Process Automation] > [Flow Designer].
    2. [フローデザイナー] ページで、[ サブフロー ] タブを選択します。
    3. リストから DevOps デモ検証サブフロー レコードを開きます。
    4. [アクション] セクションで、[アクションデザイナーでアクションを開く] アイコン ([アクションデザイナーでアクションを開く] アイコン) を選択して、DevOps デモ検証アクションレコードを開きます。
    5. コピーアクション> [その他のアクション] メニューを選択します。[コピーアクション] ダイアログボックス
    6. アクションの新しい名前を入力し、 アプリケーションを DevOps 統合として選択して、[ コピー] を選択します。
    7. コピーされたアクションで、 REST ステップ> [入力] を選択します。
    8. [要求の詳細] セクションで、[ リソースパス ] フィールドにカスタムツールのリソースパスを入力します。アクション画面の検証
    9. [ クエリパラメーター ] フィールドにカスタムツールの API バージョンを入力します。
    10. 変更を保存します。
    11. [ 公開] を選択してアクションを公開します。
    12. DevOps デモ検証サブフローレコードに戻ります。
    13. [ その他のアクション] メニュー> [サブフローのコピー] を選択します。
    14. サブフローの新しい名前を入力し、アプリケーションを DevOps 統合として選択して、[ コピー] を選択します。
    15. コピーしたサブフローで、 DevOps デモの [アクションを検証 ] アクションを削除し、ステップ 11 で作成したアクションを追加します。新しいアクションレコードを追加
      1. [ アクション ] フィールドで、ステップ 11 で作成したアクションを選択します。
      2. aliasGR フィールドで、[データ>ルックアップレコード] セクションから接続および資格情報エイリアスレコードを選択します。
      3. [apiversion] フィールドで、[データ>サブフロー入力] セクションから API バージョンを選択します。
      4. 変更を保存します。
    16. [ 公開] を選択してサブフローを公開します。
    17. 次のように移動する。 DevOps >統合>統合機能 をクリックし、 検証 アクションを使用してレコードを作成します。

      詳細については、「 DevOps ツール統合の作成」を参照してください。

      [統合機能] 関連タブ
    18. ステップ 16 で作成したサブフローを統合機能レコードに関連付けます。
    接続の問題により、ツールを作成できません。詳細について <validate_subflow_name> サブフローを確認し、もう一度お試しください。
    1. 次のように移動する。 すべての>プロセス自動化>フローデザイナー>の実行.
    2. エラーの詳細を把握するには<validate_subflow_name>サブフローの最新の実行を確認します。
    ツール認証情報が無効です。有効な認証情報を入力して、もう一度お試しください。 ツールの正しいユーザー名/パスワードを再入力します。
    サーバーからの応答がないため、ツールを作成できません。有効なツール URL を入力するか、サーバーが稼働しているかどうかを確認して、もう一度お試しください。
    1. ツールの URL を再入力します。
    2. MID サーバーを確認してください。
    接続 URL が正しくありません。確認してください

    URL を使用して、もう一度お試しください。

    		 ツールの URL を再入力します。
    GitHub アプリのスラッグ名が正しくないため、ツールを接続できません。正しい GitHub アプリのスラッグ名を入力して、もう一度お試しください。 GitHubアプリのスラッグ名は、GitHubアプリの設定ページで確認できます。GitHubアプリのスラッグ名は、GitHubアプリの URL に適した名前です。たとえば、「Test App」という名前のGitHubアプリを作成した場合、対応する URL に適したGitHubアプリのスラッグ名は test-app になります。GitHub URL:「https://github.com/settings/apps/test-app」の「test-app」はGitHubアプリのスラッグ名です。詳細については、 GitHub のドキュメントを参照してください。
    パスワード値が長すぎるため、暗号化後に切り捨てられる可能性があります。パスワードの長さを短くするか、フィールドサイズを大きくしてください。 2023 年 1 月 18 日より、Jira は Atlassian アカウントの API トークンの長さを延長しました。拡張された文字長に対応するには、discovery_credentialsテーブルの最大パスワード値を 255 より大きくする必要があります。詳細については、 KB1269878 KB 記事と Atlassian ドキュメントを参照してください。
    リモートホストからの予期しない動作:「https://bitbucket.org/account/signin/?next=%2F...%2Frest%2Fapi%2F1.0%2Fusers」への循環リダイレクト。 このエラーは、BitBucket Cloud インスタンスに接続しようとすると発生する可能性があります。BitBucket Cloud はサポートされていません。ServiceNow DevOps に接続するには、BitBucket Server インスタンスを使用する必要があります。MID サーバー経由で BitBucket インスタンスに接続します。ツールインスタンスがオンプレミスでホストされている場合は、MID サーバーが必要です。MID サーバーの詳細については、「MID サーバーの選択」を参照してください。 
    Mismatch in tool URL:
Tool URL entered in ServiceNow below: https://<URL of the Jenkins instance you entered>
Tool URL entered in Jenkins: https://<Jenkins location URL entered in Jenkins>
In Jenkins, under Manage Jenkins > System, check that your configured Jenkins URL is the same as the Tool URL entered here.
See the troubleshooting tool on-boarding errors.

    このエラーは、DevOps に入力された Jenkins URL が、Jenkins インスタンスに入力された Jenkins URL と異なる場合に発生します。

    Jenkinsインスタンスから、 Jenkins の管理 > システム > Jenkins の場所. ここで入力した Jenkins URL は、DevOps で入力した Jenkins インスタンスの URL と一致する必要があります。

    ツール権限

    このセクションでは、ワークスペースプレイブックを使用して DevOps ツールを作成するときにツール権限エラーを解決するために必要な手順を示します。ツール権限確認ガイドラインは、ワークスペースからツールに接続するとポップアップに表示されます。

    アクション

    権限がない場合は、次の手順を実行します。

    • 外部 DevOps ツールで指定された認証情報の権限を更新します。ポップアップで [更新 ] を選択して、チェックを再度実行します。
    • ポップアップを閉じ、別の認証情報を使用して、もう一度 [接続 ] を選択します。権限確認のポップアップに、新しく入力した認証情報の結果が表示されます。
    • [影響度] 列を確認し、影響度がユースケースに影響しない場合は、[ 続行 ] を選択します。
    すべての権限チェックが成功した場合:
    • [ 続行 ] を選択して、プレイブックの次のステップに進みます。
    • 結果にエラーが表示された場合は、[ 更新] を選択してもう一度試してください。
    • エラーが解決しない場合は、[ レコードあたりのツール権限確認タイムアウト (ミリ秒)] プロパティを更新して、もう一度お試しください。
    ツール権限確認タイムアウトプロパティ

    ツール接続プロセス中に、システムはフォアグラウンドで権限検証を実行し、ツール接続ページを制限します。権限の検証ごとに、外部ツールに対して REST API 呼び出しが行われ、権限の可用性が評価されます。REST API 応答時間は、ネットワーク設定によって異なる場合があります。遅延を避けるために、権限をエラーとしてマークする前にシステムが外部ツールからの応答を取得するまで待機する時間を指定できます。この時間は、[ レコードあたりのツール権限チェックタイムアウト (ミリ秒)] プロパティ (sn_devops.permission_check_timeout)を使用して指定できます。一部の権限チェックでエラーが発生している場合は、タイムアウト値を増やして、[権限] ポップアップで [ 更新 ] を選択します。

    ツール通知

    次の表に、コミットの詳細、パイプライン実行の詳細、プル要求の詳細、テストサマリーの取得などのシナリオで発生する可能性があるエラーを解決するために必要な手順を示します。

    理由 アクション
    認証情報が無効であるか、必要な最小限の権限がありません。
    • サードパーティツールの認証情報に必要なスコープがあるかどうかを確認します。ワークスペース UI を使用している場合は、ツールレコードに移動して、 その他のアクション ( [その他のアクション] アイコン) > 認証情報の権限を確認 必要な権限について確認します。
    • サードパーティツールの正しいユーザー名/パスワードを入力したかどうかを確認します。ワークスペース UI を使用していて、ツールの認証情報を更新する場合は、ツールレコードに移動して、 その他のアクション ( [その他のアクション] アイコン) > 認証情報の権限を確認. 認証情報の更新の詳細については、「 でのサードパーティツールの認証情報の更新 DevOps チェンジベロシティ」を参照してください。
    サーバーからの応答がありません。サーバーの接続状態を確認して、もう一度やり直してください。
    • DevOps ツールサーバーが到達可能で応答性が高いことを確認します。
    • MID サーバーが設定されている場合は、サーバーが稼働中かどうかを確認します。
    要求を処理できません。 Webhook に関連付けられているインスタンスの最大数を超えているかどうかを確認します。GitHub でこのエラーが発生した場合は、20 を超えるインスタンスを Webhook に関連付けているかどうかを確認してください。
    認証情報に、必要な最小限の権限がありません。 サードパーティツールの認証情報に必要なスコープがあるかどうかを確認します。ワークスペース UI を使用している場合は、ツールレコードに移動して、 その他のアクション ( [その他のアクション] アイコン) > 認証情報の権限を確認 必要な権限について確認します。
    MID サーバー構成が無効です。有効な MID サーバーを設定して、もう一度お試しください。 MID サーバーが実行中で到達可能かどうかを確認します。
    接続 URL が無効です。有効な URL を入力して、もう一度お試しください。
    1. 次のように移動する。 すべての > 接続および認証情報 > 接続および認証情報エイリアス をクリックし、必要な接続および認証情報レコードを開きます。
    2. [接続] 関連リストから、関連する 接続 フォームを開きます。
    3. [接続] フォームで、サードパーティツールの接続 URL が正しいかどうかを確認します。
    レート制限を超えました。{0}後に再試行します。

    レート制限は、アプリまたはユーザーが特定の期間内に実行できる API 呼び出しの数です。レート制限は、ネットワークトラフィックを制限して、ユーザーがシステムリソースを使い果たすのを防ぐ手法です。サードパーティツールで許可されている最大レート制限を超えた場合、このエラーが発生する可能性があります。
    必要なスコープが認証情報にありません。 サードパーティツールの認証情報に必要なスコープがあるかどうかを確認します。ワークスペース UI を使用している場合は、ツールレコードに移動して、 その他のアクション ( [その他のアクション] アイコン) > 認証情報の権限を確認 必要な権限について確認します。

    変更要求

    次の表に、変更要求の作成中に発生する可能性があるエラーを解決するために必要な手順を示します。

    エラー アクション
    タイプ互換性フラグが無効であるため、変更要求を作成できません。システムプロパティでタイプ互換性フラグを有効にするか、ServiceNow のステップレコードで変更モデルを設定するか、パイプラインに適切な変更モデル Sys ID を入力します。
    • [すべての>システムプロパティ] に移動し、com.snc.change_management.change_model.type_compatibilityプロパティを有効にします。
    • ステップフォームに変更モデルを追加するか、パイプラインの属性を変更します。
    変更タイプまたは変更モデルがパイプライン用に構成されていないため、変更要求を作成できません。 ステップフォームに変更モデルまたはタイプを追加するか、パイプラインの属性を変更します。

    一般的なエラー

    この表は、DevOps 変更速度管理アプリケーションの操作中に発生する可能性があるいくつかの一般的なエラーを解決するために必要な手順を示しています。

    問題 アクション
    インポート要求が進行していません

    ツール (Jenkins、 Jira、 GitHub など) のインポートを実行しているときにインポート要求が [要求済み] ステータスのままになる時間が長すぎる場合は、インポート要求を削除して再試行してください。

    注:
    既存の要求を削除して、同じ範囲のインポートを再試行します。
    ツールの接続に失敗する

    HTTP 接続フォームの [接続 URL ] フィールドの末尾のスラッシュ (「/」) を削除します。
    変更管理下にある Jenkins ジョブに変更要求は作成されません 次のことを確認します。
    • インスタンスのツール統合が正しく設定されている。
    • インスタンスでタスクが同期されました。
    • タスクとアプリのステップがインスタンスで構成されている。
    タスクが変更管理下にある場合、変更要求の作成はサポートされません。
    • パイプラインの一部ではない (スタンドアロンタスクなど)。
    • パイプラインの最初のものです。
    • パイプライン内にありますが、ユーザーは変更管理下にあるタスクに対して手動で SCM チェックアウトを直接トリガーまたは実行します (したがって、パイプラインを最初からトリガーすることはありません)。
    Jenkins 変更管理下のジョブをブロックしない (変更要求の承認を待機しない)

    Jenkinsの場所が構成されていることを確認します。

    次のように移動する。 Jenkins > Jenkins の管理 > システムの構成 をクリックし、[Jenkinsの場所] セクションの [Jenkins URL] フィールドのホスト名を指定します。

    注:
    キャッシュの問題を回避するには、最初にフォームを開いたときに [Jenkins URL] フィールドに既に値が含まれている場合でも、[保存] をクリックします。
    ステータスが未接続のペイロードログで発生するイベント
    手動構成モードを使用して手動で行った接続で次のいずれかの変更を行うと、接続は自動的に切断されます。
    • ツールに関連付けられたエイリアス
    • ツールの種類
    • エイリアスに追加された同じドメインの新しいアクティブな HTTP 接続
    • 同じドメインの既存の HTTP 接続がアクティブ化されました
    • HTTP 接続の接続 URL
    • HTTP 接続の認証情報
    • HTTP 接続の MID サーバー 設定を使用する

    手動構成モードに入り、再接続します。
    REST API TimeoutException/FlowObjectAPIException が原因で失敗またはエラーが発生した受信イベントの再試行
    Retry Errored Inbound Eventsスケジュール済みジョブを更新して、Errorステータスの受信イベントの処理を再試行します。
    • エラーまたは例外のリストを更新して、イベント処理を再試行する例外を指定します。
    • デフォルトの Maximum Retry 数を変更します。
    詳細については、「エラーが発生した受信イベントを再試行」を参照してください。

    SonarQube ツールがないために SonarQube スキャンが行われないため、 ServiceNow DevOps でのパイプライン実行は先に進まず、無期限に待機します。

    ソフトウェア品質受信イベントでは、処理の詳細フィールドに次のエラーメッセージが表示されます。「それぞれの SonarQube ツールが正常に作成されたかどうかを確認します。そうでない場合は、SonarQube ツールを作成し、受信イベントを再試行してください。

    コード品質スキャンのすべての SonarQube ステップで、ユーザーは ServiceNow DevOps インスタンスで SonarQube ツールを作成する必要があります。

    詳細については、「SonarQubeとDevOps チェンジベロシティとの統合」を参照してください。
    パイプライン UI にステージ間の壊れたリンクが表示されます。 [タスク実行] に移動し、[上流の実行] 列に適切な上流リンク参照があることを確認します。