# Meshery v1.0.14

2026-04-29 · [릴리스 노트 원문](https://github.com/meshery/meshery/releases/tag/v1.0.14) · [전체 정리](https://ratatosk.io/ko/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: <cstdlib 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`가 실패하면 내부 flush 실패는 이전에 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`를 사용하는 서버 설정

원격 provider에서 네트워크, 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 필드와 shim 지원 중단 예정

- 영향 대상: `User`, `Role`, `Connection`, `Workspace`, `Event`, `MesheryPattern`, `MesheryResults`, `Mappings`, `Capabilities`, `Collaboration`, `Academy`, `MeshModels`를 사용하는 Meshery 서버의 local-mirror 타입 및 UI 소비자
- 제거 시점: Phase 6

Meshery Cloud가 표준 camelCase 필드를 내보낼 때, 이전 local-mirror 타입은 Go의 JSON 매칭이 밑줄 경계를 넘지 못해 해당 필드를 조용히 누락했습니다. 업데이트된 타입은 이제 해당 필드를 디코딩합니다. 마이그레이션하지 않은 다운스트림 소비자를 위해 지원 중단 기간에는 레거시 필드와 `MarshalJSON`/`UnmarshalJSON` shim도 유지됩니다.

> - 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 핸들러의 예상치 못한 객체 유형 확인

- 영향 대상: 서버 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`의 일시적 provider 처리 문서화
- 로딩 화면 글꼴 이름 일치 및 중복 프리로드 제거
- 토스트에서 MeshKit 형식에 맞춘 API 오류 표시
- 코딩 에이전트 프로필을 전체 도구 프로필로 표준화
- Meshery Docs Noob Tester 워크플로에서 지원되지 않는 `copilot-requests` 권한 제거
- Meshery Code Contributor 에이전트의 GitHub 도구 허용 범위 확대: `github/*`
- Playwright 테스트 실패로 PR E2E 워크플로 실패
- 서버 CI 린트 가드의 전체 파일 검사
- 기본 원격 provider URL을 `https://cloud.meshery.io`로 변경
- 안정 릴리스 워크플로의 `release-notes-notification-email.yml` 전환
- 릴리스 노트 준비 및 이메일 발송을 위한 재사용 가능한 GitHub Actions 워크플로
- REST API 레퍼런스 페이지 글꼴 변경
- REST API 레퍼런스 개요의 중복 개수 문장 제거
- 오류 계약 문서의 `forbidigo` 린트 동작 명확화
- Phase 9 블로킹 및 스트리밍 JSON 응답 오류 계약 문서화
- CLI 엔드투엔드 테스트 기여 문서의 맞춤법 수정
- v0.9 정적 문서의 라이트·다크 모드 전환 아이콘 수정
- Dashboard Widgets 기여 문서 업데이트
- 통합 페이지의 제목과 탐색 문구 수정
- Alex Rudenkiy 기여자 소개 추가

---

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