# Meshery v1.0.12

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

セキュリティ 1 · 破壊的変更 10 · 非推奨 2 · 重大な修正 5 · 機能・改善 1 · 依存関係の更新 6 · その他の変更 19

## セキュリティ (1)

### 認証済みユーザーに紐づく認証情報の所有権

- 影響対象: `/api/integrations/credentials` の認証情報保存・更新エンドポイント

リクエストに別のユーザーの UUID を `userId` として含めると、そのユーザーのアカウントで認証情報が作成または更新される可能性がありました。ハンドラーはアンマーシャリング後に認証済みユーザーを所有者として設定するため、リクエスト本文の `userId` で所有者が決まることはなくなりました。

> - fix(security,docs): address review feedback on #18886 @leecalcote (#18887)

## 破壊的変更 (10)

### パターンおよびフィルターのリクエストでの正規キー受け付け

- 影響対象: パターンまたはフィルターのリクエスト本文を送信する構成

以前は、これらのリクエスト本文で正規の camelCase キー `patternData`、`cytoscapeJSON`、`filterData` の代わりに snake_case のフィールド名が使われていました。現在はどちらの表記も受け付けます。両方が指定された場合は、正規キーの値が解析結果に使われます。

根拠: “- applies canonical-wins precedence when both spellings are present.” https://github.com/meshery/meshery/pull/18900

> - fix(remote-provider,handlers): canonical camelCase wrapper keys + dual-accept on request bodies @leecalcote (#18900)

### ワークスペースおよび環境 API フィールドの camelCase への切り替え

- 影響対象: Meshery server API または `mesheryctl` を通じてアクセスするワークスペースおよび環境リソース (推定)

従来、`v1beta1` のワイヤーフィールドでは `page_size` や `organization_id` などの snake_case 名が使われていました。移行後の `v1beta3` フィールドでは、`pageSize` や `organizationId` などの camelCase 名が使われます。

根拠: “Wire form flips to canonical camelCase (`pageSize` / `totalCount` / `organizationId` / `createdAt` / `updatedAt` / `deletedAt` / `designId` / `environmentId` / `teamId` / `viewId` / `workspaceId`) on `Workspace`, `AvailableWorkspace`, `WorkspacePage`, `MesheryDesignPage`, and every mapping page.” https://github.com/meshery/meshery/pull/18889

> - chore(schemas): repoint workspace + environment consumers to canonical-casing versions (Phase 3) @leecalcote (#18889)

### Meshery リソース API と CLI 出力スキーマの更新

- 影響対象: Meshery API または `mesheryctl` 経由でアクセスする Component、design、model リソース (推定)

リソース利用側は、従来の `v1beta1/*` インポートから、正規の大文字・小文字表記を使ったスキーマバージョンに移行します。API のエンベロープでは `Count` が `TotalCount` に変更され、`pageSize`／`totalCount` と従来の `page_size`／`total_count` の両方を受け付け、出力します。`mesheryctl component view` は、従来の `created_at` と `updated_at` に代わり、`createdAt`、`updatedAt`、`deletedAt` を出力します。

根拠: “Final Phase 3 consumer-repoint commit for meshery. Migrates the three previously-deferred resources — `component`, `pattern`/`design`, and `model` — from the legacy `v1beta1/*` import paths onto the canonical-casing versions” https://github.com/meshery/meshery/pull/18894

> - chore(schemas): repoint component + design + model consumers to canonical-casing versions (Phase 3 - final) @leecalcote (#18894)

### 接続データの利用側での `v1beta3/connection` と camelCase フィールドへの移行

- 影響対象: 接続 API データ、または `mesheryctl connection` コマンドの出力を使用する環境 (推定)

従来、利用側では `v1beta1/connection` と、`user_id`、`created_at`、`updated_at`、`deleted_at`、`page_size`、`total_count`、`status_summary` などのフィールドを使用していました。現在は `v1beta3/connection` と、対応する camelCase フィールドである `userId`、`createdAt`、`updatedAt`、`deletedAt`、`pageSize`、`totalCount`、`statusSummary` を使用します。

> - chore(schemas): repoint connection consumers to v1beta3 (Phase 3) @leecalcote (#18890)

### `mesheryctl connection view` の YAML 出力で空のフィールドを省略

- 影響対象: `mesheryctl connection view` の YAML 出力

`userId`、`deletedAt`、`environments` が nil または空の場合、YAML 出力にそのキーが含まれなくなりました。

根拠: “v1beta3 also adds `yaml:"...,omitempty"` on nullable fields on `Connection` (`userId`, `deletedAt`, `environments`). `mesheryctl connection view`'s YAML output therefore no longer emits those keys when nil/empty — the expected-output goldens are regenerated to reflect this.” https://github.com/meshery/meshery/pull/18890

> - chore(schemas): repoint connection consumers to v1beta3 (Phase 3) @leecalcote (#18890)

### Meshery リソース利用側の `v1beta2` スキーマへの移行

- 影響対象: `schedule`、`view`、`key`、`credential`、`user`、`organization` リソースを利用する Meshery または mesheryctl の利用側、および組織ページのレスポンスを読み取るクライアント (推定)

組織ページのレスポンスエンベロープで、`page_size` と `total_count` が `pageSize` と `totalCount` に変更されます。ワークスペース内のビューのレスポンスを読み取る処理は、現在も古いキーを使用しています。

根拠: “`server/models/organization.go` — import flip + canonicalized JSON tags on the Meshery-local `OrganizationsPage` envelope (`totalCount`, `pageSize`). `Page` stays `page`.” https://github.com/meshery/meshery/pull/18886

> - chore(schemas): repoint low-risk resources to canonical-casing versions (Phase 3) @leecalcote (#18886)

### Meshery のワイヤーキーを正規の camelCase に変更

- 影響対象: 影響を受けるワイヤーフィールドまたはパフォーマンスプロファイルのソートを使用するインテグレーションおよび UI フロー (推定)
- 削除予定: 不明

列挙されたフィールドでは、snake_case ではなく camelCase が使われるようになりました。また、パフォーマンス UI は `?order=lastRun desc` を出力します。非推奨期間中は、受信 JSON で従来の snake_case 表記も引き続き受け付けられ、両方が指定された場合は正規の値が優先されます。この処理が追加されたのは、具体的には5つのカウントフィールドです。

根拠: “Ten wire keys move to canonical camelCase to match the schema contract; the legacy snake_case spellings remain dual-accepted on inbound JSON for the deprecation window so unmigrated producers (remote provider, Kanvas) and unmigrated query-string callers keep working. Canonical wins when both spellings are present.” https://github.com/meshery/meshery/pull/18914

> - fix: Phase 2.K cascade — flip deferred 10 wire keys (server + UI) @leecalcote (#18914)
> - fix: Phase 2.K cascade — flip deferred 10 wire keys (server + UI) @leecalcote (#18914)

### 無効なレスポンスのエラーコード衝突の修正

- 影響対象: mesheryctl の無効なレスポンスエラーと、そのエラーコードのチェック

以前は両方のエラーコードに `mesheryctl-1231` が使われていたため、MeshKit Error Codes Utility Runner の CI チェックが失敗し、そのチェックを必須とする PR がブロックされていました。無効なレスポンスのエラーには `mesheryctl-1232` を使用し、レジストリ公開エラーでは引き続き `mesheryctl-1231` を使用します。

> - fix(mesheryctl): resolve duplicate error code mesheryctl-1231 @leecalcote (#18905)

### `mesheryctl registry publish` の構造化エラー返却

- 影響対象: `mesheryctl registry publish` コマンドの使用

無効なシステム、公開エラー、またはクリーンアップエラーが発生した場合、コマンドは失敗をログに記録し、`nil` を返していました。現在は、これらの失敗に対してコード `mesheryctl-1231` を持つ `ErrPublish` エラーを返します。

根拠: “- err = fmt.Errorf("invalid system: %s", system) // update to meshkit + return ErrPublish(fmt.Errorf("invalid system: %s", system), system)” https://github.com/meshery/meshery/pull/18392

> - [mesheryctl] Add e2e BATS test for registry publish command @Git-HimanshuRathi (#18392)
> - [mesheryctl] Add e2e BATS test for registry publish command @Git-HimanshuRathi (#18392)

### クエリーパラメーター名の `orgId` と `userId` への変更

- 影響対象: `orgID` または `user_id` のクエリー引数を使用する API 呼び出し元、リモートプロバイダーのリクエスト、UI RTK フック

影響を受けるハンドラーとリモートプロバイダーの URL では、以前は `orgID` を使用していました。一方、UI RTK フックと呼び出し元では `orgID` および／または `user_id` を使用していました。テスト対象の workspaces ハンドラーでは `?orgId=abc` は成功し、`?orgID=abc` は 400 を返します。UI とリモートプロバイダーのリクエストは、現在は正規の camelCase 名を使用します。

根拠: “TestGetWorkspacesHandler_RequiresOrgIdCaseSensitive` — recording spy provider asserts canonical `?orgId=abc` succeeds (provider receives the value), legacy `?orgID=abc` and missing parameter both return 400.” https://github.com/meshery/meshery/pull/18875

> - fix: align identifier naming (orgID -> orgId) in handlers, remote-provider, and UI RTK hooks @leecalcote (#18875)
> - fix: align identifier naming (orgID -> orgId) in handlers, remote-provider, and UI RTK hooks @leecalcote (#18875)

## 非推奨 (2)

### Pattern エンドポイントが複数のネストされたデザインフィールド表記を受け入れ

- 影響対象: `POST /api/pattern` リクエストボディ
- 削除予定: 不明

以前、`DesignPostPayload` がネストされたデザインに対して受け入れていたのは `design_file` のみでした。現在は `designFile`、`patternFile`、`design_file`、`pattern_file` を受け入れ、標準表記を優先します。マーシャリング時には `designFile` と `design_file` を出力し、別表記の `patternFile` と `pattern_file` は出力しません。

> - fix(handlers): dual-accept designFile/patternFile on POST /api/pattern @leecalcote (#18888)

### リクエストキーの camelCase への切り替え

- 影響対象: Kubernetes ping、環境、イベントログ設定、ワークスペースの各リクエストフロー
- 削除予定: 次回のスキーマバージョン更新時、`v1beta2` のタグが切り替わる時点

影響対象のクエリおよびボディ項目では、UI は以前 `connection_id`、`organization_id`、`event_log_level` を送信していました。現在は camelCase のキーを送信します。非推奨期間中、ハンドラーは従来の表記との互換性を維持します。これには、Kubernetes ping クエリのフォールバックと、ワークスペースのミューテーション引数も含まれます。

> - fix(ui,handlers): canonical camelCase wire keys in rtk-query (Option B Phase 2 tail) @leecalcote (#18904)

## 重大な修正 (5)

### インポートしたデザイン名の保持

- 影響対象: デザインのインポート (推定)

インポートデータに名前が含まれていない場合、サーバーが変換時に生成された名前を上書きしていたため、ファイル名ではなく「Autogenerated」と表示されていました。現在は変換後の名前を保持し、変換でも名前が生成されなかった場合に限り、拡張子を除いたファイル名を使用します。

> - [Server] Use file name instead of "Autogenerated" for imported designs @guan404ming (#17415)

### [表面化しなかった不具合] SaveMesheryPattern の送信ラッパーキーの修正

- 影響対象: リモートプロバイダーの `SaveMesheryPattern` 呼び出し (推定)

呼び出しのたびに、meshery-cloud は `pattern_data` を認識できず、パターン本文を黙って破棄していました。ラッパーは現在、クラウドの契約で想定されるキー `patternData` を送信します。

> - fix(remote-provider,handlers): canonical camelCase wrapper keys + dual-accept on request bodies @leecalcote (#18900)

### 接続ごとの環境取得結果の上書きを防止

- 影響対象: 環境が関連付けられた接続 (推定)

複数の接続で環境を取得する際、GORM がスライス用に昇格された基底配列を再利用していたため、ある接続の結果が別の接続の結果を上書きすることがありました。各ループの反復で環境クエリ用の新しいスライスを宣言するようになりました。

> - chore(deps): bump meshkit to v1.0.5 + unblock master Docker build @leecalcote (#18896)

### nil のミューテーター値をスキップするポリシーエンジン

- 影響対象: edge-non-binding、wallet、または階層型ポリシー

`patchMutatorsAction` 内でミューテーターのフィールドが `nil` に解決された場合、大規模なデザインでは同一のパッチが繰り返され、`MAX_RE_EVALUATION_DEPTH` を使い切ってタイムアウトすることがありました。

> - [Server] Fix policy engine infinite loop on nil mutator values @guan404ming (#18853)

### mesheryctl の API 応答処理で無効な応答を報告

- 影響対象: モデルのインポートを含む、HTTP 応答を処理する mesheryctl の API 操作 (推定)

以前は nil の応答や本文がチェックされずに使用され、本文の読み取りエラーはそのまま返されていました。現在は nil の入力に対してコード `mesheryctl-1232` の `ErrGenerateDataForInvalidResponse` を返し、本文の読み取りエラーは `utils.ErrReadFromBody` でラップします。ヘルパー名は `GenerateDataFromBodyResponse` に変更されました。

> - refactor(mesheryctl): update function names and improve error handling in meshery API @lekaf974 (#18631)

## 機能・改善 (1)

- `OrganizationsPage` エンベロープでの両方のキー表記の出力と受け入れ

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

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

- `- chore(deps): pin schemas v1.1.1 (drop pseudo-version) @leecalcote (#18902)`
- `- chore(deps): bump meshkit to v1.0.5 + unblock master Docker build @leecalcote (#18896)`
- `- [Chore]: Update to Sistent v0.20.0 @l5io (#18912)`
- `- chore(ui): bump @sistent/sistent to v0.19.0 (Phase 2.K) @leecalcote (#18911)`
- `- chore(deps): bump @meshery/schemas to ^1.1.0 @leecalcote (#18884)`
- `- Bump uuid from 13.0.0 to 14.0.0 in /ui @[dependabot[bot]](https://github.com/apps/dependabot) (#18871)`

## その他の変更 (19)

- 送信側フィルターラッパーでの `filterData` の使用
- `EnvironmentData` エイリアスの参照先を `v1beta3/environment` に変更
- ワークスペースと環境の検証エラーの JSON 返却
- ローカルユーザーインポートのエイリアスを `userV1beta2` に変更
- 識別子命名の義務化と camelCase ワイヤー契約の `AGENTS.md` への追加
- `make server` における `PORT` と `USE_GO_POLICY_ENGINE` の環境変数による上書き
- 到達不能なアプリケーション保存メソッドと未使用の単一保存ヘルパーの削除
- Notification Center イベント行のレイアウト修正
- Meshery フッターのお気に入りアイコンの色の不一致を修正
- Designs テーブルの Actions メニューを一度に1つだけ開く動作
- CodeQL スキャン対象からの `docs/meetings/**` の除外
- 2026年4月23日の議事録にSulagnaの紹介を追加
- Chinmayの紹介プロフィールの追加
- Yash Mahakal の会議資料の追加
- REST API ドキュメントテンプレートにおける重複タグラベルの解決
- Meshery バンドルへの OpenAPI 含有ルールの文書化
- 生成ドキュメント内の REST API リソースのアルファベット順ソート
- 会議メモに出席案内を追加
- CodeQL スキャンでの `docs/meetings/**` 配下の議事録の除外

---

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