# Meshery v1.0.12

2026-04-24 · [릴리스 노트 원문](https://github.com/meshery/meshery/releases/tag/v1.0.12) · [전체 정리](https://ratatosk.io/ko/releases/meshery/v1.0.12)

보안 1 · 호환성 변경 10 · 폐기 예정 2 · 중요 수정 5 · 기능·개선 1 · 의존성 갱신 6 · 기타 19

## 보안 (1)

### 인증된 사용자에게 크리덴셜 소유권 귀속

- 영향 대상: `/api/integrations/credentials`의 크리덴셜 저장 및 업데이트 엔드포인트

요청의 `userId`에 다른 사용자의 UUID가 포함되면 해당 사용자 계정으로 크리덴셜을 생성하거나 업데이트할 수 있었습니다. 이제 핸들러는 역직렬화한 뒤 인증된 사용자를 소유자로 지정하므로, 요청 본문의 `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 서버 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 envelope는 `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)

### Connection 소비자의 `v1beta3/connection` 및 camelCase 필드 전환

- 영향 대상: connection 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` 스키마 전환

- 영향 대상: Meshery 또는 mesheryctl에서 `schedule`, `view`, `key`, `credential`, `user`, `organization` 리소스를 사용하는 클라이언트와 조직 페이지 응답을 읽는 클라이언트 (추정)

조직 페이지 envelope에서 `page_size`와 `total_count`가 각각 `pageSize`와 `totalCount`로 바뀝니다. 현재 views-in-workspace 응답 리더는 이전 키를 사용합니다.

근거: “`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 표기도 계속 허용되며, 두 표기가 모두 있으면 표준 값이 우선합니다. 구현에서는 특히 다섯 개의 count 필드에 이 처리를 추가합니다.

근거: “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 엔드포인트의 중첩 design 필드 여러 표기 지원

- 영향 대상: `POST /api/pattern` 요청 본문
- 제거 시점: 미상

이전에는 중첩된 design에 `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, 환경, 이벤트 로그 설정 및 workspace 요청 흐름
- 제거 시점: 다음 스키마 버전 증가 시점, `v1beta2` 태그 전환 시

UI는 영향을 받는 쿼리 및 본문 필드에서 이전에 `connection_id`, `organization_id`, `event_log_level`을 보냈습니다. 이제 camelCase 키를 보내며, 핸들러는 지원 중단 유예 기간 동안 기존 표기와의 호환성을 유지합니다. 여기에는 Kubernetes ping 쿼리와 workspace 뮤테이션 인자에 대한 폴백도 포함됩니다.

> - 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 mutator 값 건너뛰기

- 영향 대상: edge-non-binding 정책, wallet 정책 또는 계층형 정책

`patchMutatorsAction`에서 mutator 필드가 `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 응답
- 로컬 `user` import 별칭을 `userV1beta2`로 변경
- `AGENTS.md`에 식별자 명명 의무와 camelCase 와이어 계약 추가
- `make server`에서 `PORT` 및 `USE_GO_POLICY_ENGINE` 환경 변수 재정의
- 도달할 수 없는 애플리케이션 저장 메서드와 미사용 단일 저장 헬퍼 제거
- Notification Center 이벤트 행 레이아웃 수정
- Meshery 푸터 즐겨찾기 아이콘 색상 불일치 수정
- Designs 테이블에서 Actions 드롭다운을 한 번에 하나씩만 열도록 변경
- CodeQL 스캔 대상에서 `docs/meetings/**` 제외
- 2026년 4월 23일 회의록에 Sulagna 소개 추가
- Chinmay 소개 프로필 추가
- Yash Mahakal 회의 문서 추가
- REST API 문서 템플릿의 중복 태그 레이블 처리
- Meshery 번들의 OpenAPI 포함 규칙 문서화
- 생성 문서의 REST API 리소스 알파벳순 정렬
- 회의록에 참석 안내 추가
- CodeQL 스캔에서 `docs/meetings/**` 아래 회의록 제외

---

정리 내용은 AI가 작성하므로 틀릴 수 있으며, 보증 없이 제공합니다.
