# Meshery v1.0.51

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

보안 1 · 호환성 변경 1 · 중요 수정 6 · 기능·개선 3 · 의존성 갱신 6 · 기타 18

## 보안 (1)

### Meshery 오퍼레이터 차트 보안 강화 및 메트릭 업데이트

- 영향 대상: 메트릭을 스크레이핑하는 설정과 오퍼레이터 배포 값을 제공하는 설정을 포함해 `meshery-operator` Helm 차트를 사용하는 설치 (추정)
- 추가 조치: 메트릭 스크레이퍼용 `meshery-metrics-reader` ClusterRole

기존 차트는 `kube-rbac-proxy` 사이드카를 사용하고, 사용하지 않는 포트 10000을 노출하는 Service를 제공했으며, 프로브와 보안 컨텍스트가 없었습니다. 업그레이드 시 훅 Job이 CRD를 다시 적용합니다. Helm은 업그레이드 중 `crds/`의 CRD를 업데이트하지 않으므로, 이 작업으로 기존 클러스터에 오래된 CRD가 남지 않도록 합니다.

> - feat(operator-chart): modernize to operator v1.0.0 — CRD updates on upgrade, opt-in conversion webhook, release-driven publishing @alexquincy (#20410)

## 호환성 변경 (1)

### 지원하지 않는 HTTP 메서드에 대한 구조화 오류 응답

- 영향 대상: `ServerEventConfigurationHandler`가 처리하는 요청 (추정)
- 필요 조치: 프런트엔드 또는 OpenAPI 변경 불필요

지원하지 않는 HTTP 메서드로 요청하면 핸들러는 이전에 최소한의 JSON 오류를 반환했지만, 이제 오류 메타데이터를 포함한 MeshKit 구조화 오류 응답을 반환합니다. HTTP 상태 코드는 405 Method Not Allowed로 유지됩니다.

근거: “This PR standardizes the response for unsupported HTTP methods in `ServerEventConfigurationHandler` by replacing the ad-hoc JSON error helper with Meshery's structured MeshKit error framework.” https://github.com/meshery/meshery/pull/20163

> - [refactor] Standardize Method Not Allowed error in ServerEventConfigu… @emphor11 (#20163)

## 중요 수정 (6)

### [드러나지 않던 결함] Meshery cloud 자격 증명 응답 역직렬화 수정

- 영향 대상: `RemoteProvider.GetUserCredentials`를 통한 meshery-cloud 자격 증명 조회 (추정)

`RemoteProvider.GetUserCredentials`가 `totalCount`/`pageSize`로 표기된 envelope가 포함된 meshery-cloud 응답을 역직렬화할 때 자격 증명 값이 조용히 zero value가 되었습니다. 이제 cloud 응답에서 값을 올바르게 역직렬화합니다.

> - [Server] Bump github.com/meshery/schemas to v1.3.22 @leecalcote (#20395)

### 워크스페이스 활동 위젯의 쿼리 오류 처리 수정

- 영향 대상: `WorkspaceActivityWidget`을 렌더링하는 구성

워크스페이스 쿼리가 실패하면 위젯은 오류 상태 대신 빈 목록을 표시했습니다. 이제 `WidgetErrorFallback`을 표시합니다.

> - [UI] Guard dashboard widgets against null data and add consistent error/empty states @leecalcote (#20390)

### `LatestBlogs` 빈 결과 처리 수정

- 영향 대상: `LatestBlogs` 위젯

데이터를 가져오지 못하거나 2xx가 아닌 응답을 받으면 게시물이 없는 것처럼 표시됐습니다. 이제 이런 경우를 실제 빈 결과가 아니라 오류로 처리합니다.

> - [UI] Guard dashboard widgets against null data and add consistent error/empty states @leecalcote (#20390)

### `KubernetesConnectionChart` 로딩 및 오류 처리 추가

- 영향 대상: `KubernetesConnectionChart`

쿼리가 아직 진행 중일 때 차트는 실제 결과가 비어 있는 경우와 똑같이 '연결 없음' 상태를 표시했습니다. 이제 쿼리가 실행되는 동안 로딩 상태를 표시하고 오류를 처리합니다.

> - [UI] Guard dashboard widgets against null data and add consistent error/empty states @leecalcote (#20390)

### `MesheryTreeView` 빈 상태 렌더링 수정

- 영향 대상: 검색어가 없는 `MesheryTreeView`

이전에는 중복된 조건 때문에 로딩이 완료된 뒤에도 빈 상태 메시지 대신 로딩 스피너가 계속 표시되었습니다. 이제 레코드가 없으면 메시지가 표시됩니다.

> - fix(ui): render empty state when loading completes @KumarNirupam1 (#20222)

### Getting Started 대시보드 위젯 시작 시 크래시 수정

- 영향 대상: Getting Started 위젯이 있는 Meshery UI 대시보드 (추정)

대시보드를 처음 불러올 때 비동기 `loadOrg()`가 완료될 때까지 `state.ui.organization`이 null이어서, `currentOrg`에서 `id`를 구조 분해하는 중 위젯이 크래시를 일으켰습니다. 이제 시작 중 `currentOrg`가 null이어도 위젯이 크래시를 일으키지 않습니다.

> - [UI] Guard dashboard widgets against null data and add consistent error/empty states @leecalcote (#20390)

## 기능·개선 (3)

- Helm 설치 및 업그레이드 훅으로 갱신되는 오퍼레이터 CRD (사용 조건: `crds.updateJob.enabled`를 활성화해야 하며 기본값은 `true`입니다.)
- `meshery-operator` Helm chart의 선택적 CRD 변환 웹훅 (사용 조건: `webhook.enabled=true` 설정; 서빙 인증서에 cert-manager v1을 사용할 때는 `webhook.certManager.enabled=true`를 선택적으로 설정)
- 오퍼레이터 버전별 `meshery-operator` 차트 게시 (사용 조건: 첫 오퍼레이터 버전 차트를 게시하기 위해 `release-ver: 1.0.0`으로 `Release Meshery Operator Chart` 워크플로를 수동으로 한 번 실행)

## 의존성 갱신 (6)

그 외 6건 · 보안 언급 없음

- `- sync go.mod @aabidsofi19 (#20400)`
- `- chore(deps): bump @sistent/sistent from 0.21.25 to 0.21.26 in /ui @[dependabot[bot]](https://github.com/apps/dependabot) (#20389)`
- `- chore(deps): bump @sistent/sistent from 0.21.25 to 0.21.26 in /provider-ui @[dependabot[bot]](https://github.com/apps/dependabot) (#20383)`
- `- chore(deps): bump js-yaml from 5.1.0 to 5.2.0 in /ui @[dependabot[bot]](https://github.com/apps/dependabot) (#20387)`
- `- chore(deps): bump xstate from 5.32.2 to 5.32.3 in /provider-ui @[dependabot[bot]](https://github.com/apps/dependabot) (#20388)`
- `- chore(deps): bump @meshery/schemas from 1.3.15 to 1.3.18 in /provider-ui @[dependabot[bot]](https://github.com/apps/dependabot) (#20385)`

## 기타 (18)

- Meshery 메인테이너 문서 업데이트
- Kanvas 확장 컴포넌트 이름 변경
- 모델 검색 및 가져오기 엔드투엔드 테스트 업데이트
- `/ui` eslint 의존성을 10.6.0으로 업그레이드
- `/provider-ui` 개발 의존성 `eslint`를 10.6.0으로 업그레이드
- 대시보드 위젯 오류용 공통 폴백
- 사용자 ID 확인 후 디자인을 조회하는 `MyDesignsWidget`
- Kubernetes 컨텍스트 메뉴의 별도 모두 선택 체크박스
- 고아 `policies/wasm` 파일 제거 및 Rego 린팅 경로 업데이트
- Rego 린트·테스트 워크플로의 `open-policy-agent/setup-regal@v1` 전환
- `mesheryctl` CI 워크플로에서 현재 문서 페이지를 제거하는 경로 수정
- Meshery 업그레이드 가이드와 오퍼레이터 라이프사이클 및 개념 문서
- 회의록에 참석 안내 추가
- Sample Apps 가이드의 잘못된 이미지 참조 수정
- Meshery Operator 빌드·테스트·배포 및 OLM 번들 기여 가이드
- 커뮤니티 토론 포럼 링크의 discuss.meshery.io 사용 전환
- 라이트 모드에서 문서 사이드바 텍스트 가시성 개선
- 문서 스크롤바 스타일 개선

---

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