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

  • リリースバージョン: Xanadu
  • 更新日 2024年08月01日
  • 所要時間：19分

    • 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 ロールを持つユーザーのみが接続エイリアスを作成できます。アドミニストレーターなど、このロールを持つユーザーに連絡して、接続エイリアスを作成してもらう必要があります。
    <toolname> ツール名が既に存在するため、ツールを作成できません。別の名前を入力して、もう一度やり直してください。 ツールには別の名前を使用します。
    <toolname> に有効な MID サーバー構成がないため、ツールを作成できません。有効な MID サーバーを設定して、もう一度お試しください。
    1. ワークスペースを使用している場合は、MID サーバーが実行中で到達可能であるかどうかを確認します。
    2. カタログとレコードプロデューサーを使用している場合は、MID サーバーが実行中で、アプリケーションが DevOps で機能が REST で到達可能であるかどうかを確認します。
    DevOps データモデルスコープに使用できる接続および資格情報エイリアスがないため、ツールを作成できません。新しい接続および資格情報エイリアスを作成して、もう一度お試しください。

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

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

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

    1. 別の認証情報を使用します。
    2. 既存の認証情報がアクティブな接続で使用されているかどうかを確認します。
    接続レコードの作成中の技術的な問題により、ツールを作成できません。
    1. [ All > Process Automation > Flow Designer > Executions] に移動します。
    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 フィールドで、[Data > Lookup records] セクションから [Connection & Credential Alias (接続および資格情報エイリアス)] レコードを選択します。
      3. [apiversion] フィールドで、[データ>サブフロー入力] セクションから API バージョンを選択します。
      4. 変更内容を保存します。
    16. [公開] を選択してサブフローを公開します。
    17. [DevOps > 統合] > [統合機能] に移動し、[検証] アクションでレコードを作成します。

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

      [統合機能] 関連タブ
    18. ステップ 16 で作成したサブフローを統合機能レコードに関連付けます。
    接続の問題により、ツールを作成できません。<validate_subflow_name>サブフローで詳細を確認し、もう一度お試しください。
    1. [ All > Process Automation > Flow Designer > Executions] に移動します。
    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」になります。<c0/> URL「https://github.com/settings/apps/<test-app>」では、「<test-app>」が<c1/>アプリのスラッグ名です。GitHubGitHub詳細については、 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 サーバーの選択」を参照してください。 
    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 を入力します。
    • [All > System Properties (すべてのシステムプロパティ)] に移動し、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 にステージ間の壊れたリンクが表示されます。 [タスク実行] に移動し、[上流の実行] 列に適切な上流リンク参照があることを確認します。