デスクトップ版の Studio では Integration Service のコネクタとアクティビティを読み込めない

Automation Suite 2025.10.0–2025.10.2 で typecache ルーティングの問題が原因で、デスクトップ版の Studio に Integration Service のコネクタとアクティビティが表示されない場合の回避策。

注:

この問題は、Automation Suite 2025.10.0 から 2025.10.2 に影響します。この問題は 2025.10.3 で解決されています。

説明

デスクトップ版の Studio では、[アクティビティ] パネルに Integration Service のコネクタとアクティビティが表示されません。intsvcs-periodic サービスのログに、次のエラーが含まれています。

org.springframework.web.servlet.NoHandlerFoundException:
No endpoint GET /v3/element/typecache/api/Studio/Packages

これは、ルーティングの設定ミスが原因で発生します。デスクトップ版の Studio はパス /v3/element/typecache/...でコネクタ情報を要求しますが、クラスター内のルーティングでは、/v3/element プレフィックスを削除せずにこの要求が intsvcs-periodic サービスに転送されます。このサービスには、プレフィックス付きのパスに対して登録されているハンドラーがなく、404 Not Foundが返されます。

注:

Studio Web はこの問題の影響を受けません。

解決策

手順 1 — 影響を受けることを確認する

次のコマンドを実行して、 intsvcs-periodic ログに 404 エラーがないかどうかを確認します。

kubectl -n uipath logs deploy/intsvcs-periodic -c periodic --since=1h \
  | grep "No endpoint GET /v3/element/typecache"

コマンドが出力を返す場合は、この問題が発生しています。

ステップ 2 — VirtualService の書き換えを適用する

1. VirtualService (kubectl の略 vs ) を開いて編集します。

   kubectl -n uipath edit vs intsvcs-periodic-vs
   

2. standard-url-periodic-elementPath という名前のルールを見つけて、route: キーの真上に次の 2 行を追加します。

   rewrite:
     uri: /
   

   更新後、ルールは次のようになります。

   uri:
     prefix: /v3/element/
   name: standard-url-periodic-elementPath
   retries:
     attempts: 3
     perTryTimeout: 20s
     retryOn: connect-failure,refused-stream
   rewrite:
     uri: /
   route:
     - destination:
         host: intsvcs-periodic.uipath.svc.cluster.local
         port:
           number: 80
   timeout: 60s
   

3. 保存してエディターを閉じます。Kubernetes は変更をただちに適用します。

手順 3 — 書き換えを確認する

次のコマンドを実行して、保存された VirtualService 定義を読み取り、書き換えルールが適用されていることを確認します。このコマンドでは、 jq を使用して JSON 出力から書き換えフィールドのみを抽出します。

kubectl -n uipath get vs intsvcs-periodic-vs -o json \
  | jq '.spec.http[] | select(.name=="standard-url-periodic-elementPath").rewrite'

期待される出力:

{
  "uri": "/"
}

手順 4 — デスクトップ版の Studio で検証する

デスクトップ版の Studio で [アクティビティ] パネルを再度開き、Integration Service のコネクタとアクティビティが表示されることを確認します。