# Meshery v1.0.14

2026-04-29 · [元のリリースノート](https://github.com/meshery/meshery/releases/tag/v1.0.14) · [全体のまとめ](https://ratatosk.io/ja/releases/meshery/v1.0.14)

破壊的変更 7 · 非推奨 1 · 重大な修正 2 · 依存関係の更新 5 · その他の変更 23

## 破壊的変更 (7)

### イベントコンシューマーの正規 camelCase JSON キーへの切り替え

- 影響対象: Meshery UI の Event および Notification Center のコンシューマー、および `Event` または `EventsFilter` の JSON フィールド、もしくは `actedUpon` クエリパラメーターを使用するクライアント

以前は meshkit v1.0.6 の時点で、コンシューマーは `event.created_at`、`event.user_id`、`event.system_id` などのフィールドや、イベント概要の snake_case キーを引き続き読み取っていました。現在は正規の camelCase フィールドと概要キーを読み取ります。また、`getEventFilter` は従来の `acted_upon` クエリパラメーターもフォールバックとして受け付けます。

根拠: “`ui/rtk-query/notificationCenter.ts` - `getEventsSummary` `transformResponse` reads canonical summary keys (`countBySeverityLevel`, `totalCount`, `readCount`); leaves the `sort` URL param as `created_at` because it is the GORM column name, not a JSON field, and is whitelisted by `SanitizeOrderInput` (annotated with a comment to that effect)” https://github.com/meshery/meshery/pull/18987

> - chore(deps): bump meshkit v1.0.6 -> v1.0.7 + flip Event consumer reads @leecalcote (#18987)

### Meshery Server のエラーレスポンスを構造化 JSON に変更

- 影響対象: Meshery Server のハンドラーおよびプロバイダーのエラーレスポンスを利用するクライアント
- 必要な対応: schemas 側の変更は不要

以前は一部のエラー処理でプレーンテキストが返され、UI の RTK Query パーサーがクラッシュしていました。また、クライアントペイロードのアンマーシャル失敗で 500 が返ることがあり、ストリーミング開始後のエラーはステータスを変えずにダウンロード内容を破損させる可能性がありました。該当するステータスコードが修正され、ストリーミング開始後のエラーはダウンロード内容に追加されず、ログに記録されます。

根拠: “Migrates Meshery Server from plain-text HTTP error responses to structured JSON envelopes carrying full MeshKit error metadata (`code`, `severity`, `probable_cause`, `suggested_remediation`, `long_description`). Resolves the `SyntaxError: Unexpected token 'S', "Status Cod"... is not valid JSON` crash in the UI's RTK Query baseQuery and gives every Meshery client (UI, `mesheryctl`, Kanvas, Meshery Cloud) a stable, structured error contract.” https://github.com/meshery/meshery/pull/18919

> - fix(server): JSON error responses across handlers + provider layer @jamieplu (#18919)
> - fix(server): JSON error responses across handlers + provider layer @jamieplu (#18919)
> - fix(server): JSON error responses across handlers + provider layer @jamieplu (#18919)
> - fix(server): JSON error responses across handlers + provider layer @jamieplu (#18919)

### 対象サーバーパスにおける型付き MeshKit エラー

- 影響対象: Meshery サーバーのデザインインポート、パターン変換、アーティファクト圧縮、レジストリログのフラッシュ、エンティティ状態の更新、拡張機能のプロキシ処理、接続ステートマシン操作に関する各パス

以前は、これらの失敗に対して `{error: <stdlib msg>}` のみが返されていました。また、デザインインポートの `oneOf` 不変条件エラーは、他の 4xx 応答とは形式が異なっていました。これらの失敗が発生した場合、応答に `code`、`severity`、`probable_cause`、`suggested_remediation` が含まれるようになりました。デザインインポートの不変条件エラーには `ErrInvalidImportRequest` が使われ、他の 4xx 応答と同じ形式になります。

根拠: “Wrap bare-string `errors.New` returns in `resolveImportVariant` (design import oneOf invariant violations) with `ErrInvalidImportRequest`, so that arm of the design-import endpoint's 400 responses no longer differs in shape from its other 4xx responses.” https://github.com/meshery/meshery/pull/18955

> - fix(server): promote raw-err passthroughs to MeshKit codes (follow-up to #18919) @leecalcote (#18955)

### Meshmodel 登録時のログ書き込み失敗を HTTP 500 として報告

- 影響対象: `RegisterMeshmodelComponents` を使用するサーバー構成

登録中に `WriteLogsToFiles` が失敗した場合、内部のフラッシュ失敗は以前 HTTP 400 を返し、クライアントエラーとして分類されていました。

根拠: “`component_handler.go::RegisterMeshmodelComponents` — `WriteLogsToFiles` failure was returning 400; now 500. The flush is internal-only and not driven by caller input, so 4xx mis-classifies the failure as a client error.” https://github.com/meshery/meshery/pull/18955

> - fix(server): promote raw-err passthroughs to MeshKit codes (follow-up to #18919) @leecalcote (#18955)

### Extension プロキシの失敗時に HTTP 502 を返す変更

- 影響対象: `ExtensionsHandler` と `provider.ExtensionProxy` を使用するサーバー構成

リモートプロバイダーでのネットワーク、DNS、TLS、または 2xx 以外の応答による失敗に対し、`ExtensionsHandler` は従来 HTTP 500 を返していました。

根拠: “`extensions.go::ExtensionsHandler` — failure of `provider.ExtensionProxy` was returning 500; now 502. The failure is in the upstream remote provider (network, DNS, TLS, non-2xx response), not in this Meshery server, so 502 Bad Gateway is the correct passthrough status.” https://github.com/meshery/meshery/pull/18955

> - fix(server): promote raw-err passthroughs to MeshKit codes (follow-up to #18919) @leecalcote (#18955)

### Kubernetes 接続インターフェースの正規 camelCase への切り替え

- 影響対象: Kubernetes 接続のメタデータ、`GetK8sContexts` のクエリパラメーター、または `K8sContext` の GraphQL フィールドと UI フィールド

以前は、メタデータキーやクエリパラメーター、生成される GraphQL フィールドと UI フィールドに snake_case が使われていました。Meshery Cloud は正規形式と snake_case の両方のメタデータキーを受け入れ、正規形式のキーが優先されます。

根拠: “After this change, the canonical wire form is camelCase across struct, metadata blob, URL query, and graphql codegen, fully aligned with the canonical identifier-naming contract in `meshery/schemas`.” https://github.com/meshery/meshery/pull/18986

> - fix(wire-format): flip Kubernetes connection metadata literal keys to canonical camelCase (Phase 5b) @leecalcote (#18986)
> - fix(wire-format): flip Kubernetes connection metadata literal keys to canonical camelCase (Phase 5b) @leecalcote (#18986)

### MeshSync ハンドラーエラーの標準化ラッパーへの変更

- 影響対象: サーバーの MeshSync イベントハンドラーとストア更新ハンドラー (推定)

これらのハンドラーは以前、加工していないエラーをログに記録していました。現在は `ErrMeshsyncEvent` と `ErrMeshsyncStoreUpdates` を使用し、コード `meshery-server-1379` と `meshery-server-1380`、推定原因、推奨される対処方法を含めます。

根拠: “Currently, the `MeshsyncDataHandler` in `server/models/meshsync_events.go` logs raw errors instead of using Meshery's standardized error code system defined in `server/models/error.go`.” https://github.com/meshery/meshery/pull/18236

> - [Server] Implement Proper Error Codes for MeshSync Data Handler @workwithsarang (#18236)

## 非推奨 (1)

### レガシーな local-mirror JSON フィールドとシムの非推奨化

- 影響対象: Meshery サーバーの local-mirror 型と、`User`、`Role`、`Connection`、`Workspace`、`Event`、`MesheryPattern`、`MesheryResults`、`Mappings`、`Capabilities`、`Collaboration`、`Academy`、`MeshModels` を扱う UI 利用者
- 削除予定: Phase 6

Meshery Cloud が標準の camelCase フィールドを出力すると、従来の local-mirror 型では Go の JSON フィールド照合がアンダースコアをまたがないため、それらのフィールドが気づかれないまま破棄されていました。更新後の型ではこれらのフィールドをデコードします。移行していない下流の利用者向けには、非推奨期間中、レガシーフィールドと `MarshalJSON`／`UnmarshalJSON` のシムも引き続き残ります。

> - fix(wire-format): flip meshery server + UI to canonical camelCase (Phase 5) @leecalcote (#18974)
> - fix(wire-format): flip meshery server + UI to canonical camelCase (Phase 5) @leecalcote (#18974)
> - fix(wire-format): flip meshery server + UI to canonical camelCase (Phase 5) @leecalcote (#18974)

## 重大な修正 (2)

### [表面化しなかった不具合] ロードテストのSSEマーシャリングエラーをストリーム内で処理

- 影響対象: サーバーのSSEハンドラーを使うロードテスト

SSEレスポンスの処理中にロードテスト結果のJSONマーシャリングに失敗すると、ヘッダー送信後に `http.Error` がSSEのフレーミングを破損させ、レスポンスチャネルのバッファーが満杯になった場合にワーカーがブロックされたままになる可能性がありました。ハンドラーは `LoadTestResponse` のエラーイベントを送信し、チャネルが閉じるまで読み出すようになりました。

> - ci(server): flip forbidigo http.Error guard to blocking @leecalcote (#18927)

### MeshSync ハンドラーで想定外のオブジェクト型を検出

- 影響対象: server の MeshSync イベントハンドラーおよびストア更新ハンドラー

以前は、エラーイベントオブジェクトがエラーではない場合や、ストア更新オブジェクトが `[]interface{}` ではない場合に、型アサーションの検証がないままパニックすることがありました。現在は、そのようなオブジェクトを対応するエラーラッパーを通じてログに記録してスキップするため、ハンドラーは処理を続行できます。

> - [Server] Implement Proper Error Codes for MeshSync Data Handler @workwithsarang (#18236)

## 依存関係の更新 (5)

ほか5件（いずれもセキュリティへの言及なし）

- `- chore(deps): bump meshkit v1.0.6 -> v1.0.7 + flip Event consumer reads @leecalcote (#18987)`
- `- chore(deps): Bump github.com/olekukonko/tablewriter from 1.1.0 to 1.1.4 @[dependabot[bot]](https://github.com/apps/dependabot) (#16824)`
- `- Bump github.com/open-policy-agent/opa from 1.11.0 to 1.12.1 @[dependabot[bot]](https://github.com/apps/dependabot) (#16825)`
- `- Bump github.com/envoyproxy/go-control-plane/envoy from 1.35.0 to 1.36.0 @[dependabot[bot]](https://github.com/apps/dependabot) (#16826)`
- `- Bump postcss from 8.5.6 to 8.5.12 in /docs @[dependabot[bot]](https://github.com/apps/dependabot) (#18947)`

## その他の変更 (23)

- HTTP ユーティリティのバッファーエンコード後書き込みに関する回帰テスト
- 旧アプリケーションハンドラーファイルの削除
- コメントアウトされていた `getLatestKubeVersionFromRegistry` 関数の削除
- `SessionInjectorMiddleware` における一時的なプロバイダー処理の記述
- ローディング画面のフォント名統一と重複プリロードの削除
- MeshKit対応のAPIエラーのトースト表示
- コーディングエージェントのプロファイルをフルツールプロファイルに標準化
- Meshery Docs Noob Tester ワークフローからの未サポートな `copilot-requests` 権限の削除
- Meshery Code Contributor agent の GitHub ツール許可範囲を `github/*` に拡大
- Playwright テスト失敗時に PR E2E ワークフローが失敗
- Server CI の lint ガードによる全ファイルのチェック
- デフォルトのリモートプロバイダーURLを `https://cloud.meshery.io` に変更
- 安定版リリースワークフローの `release-notes-notification-email.yml` への切り替え
- リリースノートの準備とメール送信に使える再利用可能な GitHub Actions ワークフロー
- REST API リファレンスページのフォントファミリー更新
- REST API リファレンス概要から重複した件数の文を削除
- エラー契約ドキュメントにおける `forbidigo` lint の動作の明確化
- Phase 9 のブロッキングおよびストリーミング JSON レスポンスに関するエラー契約のドキュメント化
- CLI のエンドツーエンドテスト貢献ガイドのスペル修正
- v0.9 静的ドキュメントのライト／ダークモード切り替えアイコンの修正
- Dashboard Widgets のコントリビューション用ドキュメントの更新
- インテグレーションページの見出しとナビゲーション文言の改訂
- Alex Rudenkiy さんのコントリビューター紹介の追加

---

整理した内容は AI が作成するため誤っている可能性があり、無保証で提供されます。
