DevOps 変更速度管理の一般的なエラー

  • リリースバージョン: Australia
  • 更新日 2026年03月12日
  • 所要時間:18分
  • DevOps 変更速度管理 で発生するエラーの根本原因を特定し、それらを解決する可能性のある対応する手順を確認します。

    ツール接続

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

    メッセージ アクション
    ツール名が入力されていないため、ツールを作成できません。ツール名を入力して、もう一度やり直してください。 ツール名を再入力します。
    ツール統合が選択されていないため、ツールを作成できません。正しいツール統合値を選択して、もう一度お試しください。 正しいツール統合値を選択します。
    ツールの URL が無効であるか正しくないため、ツールを作成できません。ツールの URL を再入力して、もう一度お試しください。 ツールの URL を再入力します。
    プラットフォームのバージョンを特定できないため、ツールを作成できません。glide.buildtag.last sys プロパティを作成して、もう一度お試しください。
    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://<instance name>.service-now.com/ と入力します。
    CreateDevOpsTool エイリアス認証情報が正しくないため、ツールを作成できません。認証情報レコードを更新して、もう一度お試しください。
    1. メッセージ内の認証情報レコードのリンクを選択します。ワークスペース UI からツールに接続している場合は、認証情報レコードのリンクを右クリックして、[新しいタブで開く] を選択します。
    2. 認証情報レコードページで、[ユーザー名] フィールドと [パスワード] フィールドに正しい認証情報を入力します。
    3. 変更を保存し、ツールへの接続を再試行します。
    CreateDevOpsTool エイリアスの接続 URL が正しくないため、ツールを作成できません。次の URL https://<instancename>.service-now.com を使用して、もう一度やり直してください。
    1. 移動先 すべての>接続と認証情報 > 接続と認証情報エイリアス をクリックし、 CreateDevOpsTool レコードを開きます。
    2. [接続] フォームで、[接続 URL] に https://<instance name>.service-now.com/ と入力します。
    接続エイリアスを作成するには、connection_admin ロールが必要です。システムアドミニストレーターにお問い合わせください。 このエラーは、ツールレコードの [接続エイリアス] フィールドが空の場合に発生します。ツール接続を作成するには、接続エイリアスが必要です。connection_admin ロールを持つユーザーのみが接続エイリアスを作成できます。アドミニストレーターなど、このロールを持つユーザーに連絡して、接続エイリアスを作成してもらう必要があります。
    ツール名が既に存在するため、ツールを作成できません。別の名前を入力して、もう一度やり直してください。 ツールには別の名前を使用します。
    有効な MID サーバー構成がツールにないため、ツールを作成できません。有効な 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. 移動先 フローデザイナー>プロセス自動化>すべて.
    2. フローデザイナーで、[サブフロー] タブを選択します。
    3. リストから DevOps デモ検証サブフローレコードを開きます。
    4. [アクション] セクションから、[アクションデザイナーでアクションを開く] ([アクションデザイナーでアクションを開く] アイコン) アイコンを選択して、DevOps デモ検証アクションレコードを開きます。
    5. [その他のアクション] メニュー > [コピーアクション] を選択します。[コピーアクション] ダイアログボックス
    6. アクションの新しい名前を入力し、アプリケーションとして DevOps 統合を選択して、[コピー] を選択します。
    7. コピーしたアクションで、[入力] > [REST ステップ] を選択します。
    8. [要求の詳細] セクションで、[リソースパス] フィールドにカスタムツールのリソースパスを入力します。[アクションを検証 (Validate action)] 画面
    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 記事と アトラシアンのドキュメントを参照してください。
    リモートホストからの予期しない動作:「https://bitbucket.org/account/signin/?next=%2F...%2Frest%2Fapi%2F1.0%2Fusers」への循環リダイレクト。 このエラーは、BitBucket Cloud インスタンスに接続しようとすると発生することがあります。BitBucket クラウドはサポートされていません。ServiceNow DevOps に接続するには、BitBucket Server インスタンスを使用する必要があります。MID サーバー経由で BitBucket インスタンスに接続します。ツールインスタンスがオンプレミスでホストされている場合は、MID サーバーが必要です。MID サーバーの詳細については、「MID サーバーの選択」を参照してください
    ツール URL の不一致: ServiceNow に入力されたツール URL:https://<入力した Jenkins インスタンスの URL> Jenkins に入力されたツール URL:https://<Jenkins に入力された Jenkins の場所の URL> Jenkins の [Jenkins >システムの管理] で、構成された Jenkins URL がここで入力したツール URL と同じであることを確認します。トラブルシューティングツールのオンボーディングエラーを参照してください。

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

    Jenkinsインスタンスから、 Jenkins を管理 > System > 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 を入力します。
    • [すべて] > [システムプロパティ] に移動し、com.snc.change_management.change_model.type_compatibility プロパティを有効にします。
    • ステップフォームに変更モデルを追加するか、パイプラインの属性を変更します。
    変更タイプまたは変更モデルがパイプライン用に構成されていないため、変更要求を作成できません。 ステップフォームに変更モデルまたはタイプを追加するか、パイプラインの属性を変更します。

    一般的なエラー

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

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

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

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

    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 にステージ間の壊れたリンクが表示されます。 [タスク実行] に移動し、[上流実行] 列に適切な上流リンク参照があることを確認します。