# Meshery v1.0.54

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

호환성 변경 2 · 중요 수정 1 · 의존성 갱신 2 · 기타 2

## 호환성 변경 (2)

### 컨트롤러 헬퍼 심볼의 올바른 표기로 변경

- 영향 대상: 컨트롤러 헬퍼를 사용하는 서버 코드와 `AddMeshsynDataHandlers`를 가져오는 사용자 지정 코드

헬퍼와 호출 지점에서 오타가 있던 `Meshsyn`/`meshsyn` 이름을 올바른 표기인 `Meshsync`/`meshsync`로 변경했습니다. `AddMeshsynDataHandlers`의 별칭은 더 이상 없으므로, 이 심볼을 가져오는 사용자 지정 코드에 영향을 줍니다.

근거: “Searched GitHub across the `meshery` org and broader public code for `AddMeshsynDataHandlers` usage outside this repo. All hits were forks of `meshery/meshery` itself (same file/line) - no genuine external consumer imports this symbol as a package API, so no deprecated alias is kept.” https://github.com/meshery/meshery/pull/20501

> - [server] Fix Meshsyn->Meshsync typo in controller helper symbols @leecalcote (#20501)

### `resyncCluster`에서 MeshSync 삭제 오류 노출

- 영향 대상: `resyncCluster` GraphQL 리졸버를 호출하는 설정

MeshSync 정리에 실패하면 리졸버는 모든 실패에 대해 `ErrEmptyHandler`를 반환해 실제 삭제 오류를 알기 어려웠습니다. 이제 삭제 오류를 `ErrFlushMeshSyncData`로 감싸 반환하고 로그에 기록하며, 컨텍스트 이름과 서버 정보도 함께 남깁니다.

근거: “`FlushMeshSyncData` and the `resyncCluster` resolver now share this single helper, removing the duplicated block. The resolver also surfaces the real delete error instead of the misleading `ErrEmptyHandler` it previously returned for any failure.” https://github.com/meshery/meshery/pull/20502

> - [Server] Fix FlushMeshSyncData stale table-name subqueries leaking MeshSync data @leecalcote (#20502)

## 중요 수정 (1)

### 삭제된 클러스터의 MeshSync 인벤토리 정리 수정

- 영향 대상: Kubernetes 서버 ID를 참조하는 마지막 연결 삭제 후 MeshSync 인벤토리 정리

Kubernetes 서버 ID를 참조하는 마지막 연결이 삭제되면, 플러시 과정에서 자식 행을 조회하는 하위 쿼리가 존재하지 않는 `objects` 테이블을 사용해 오류가 발생했고 해당 클러스터의 리소스 행과 자식 행이 남았습니다. 이제 해당 행을 삭제하며, 부모 리소스 행보다 자식 행을 먼저 삭제하고 다른 클러스터의 행은 그대로 둡니다.

> - [Server] Fix FlushMeshSyncData stale table-name subqueries leaking MeshSync data @leecalcote (#20502)
> - [Server] Fix FlushMeshSyncData stale table-name subqueries leaking MeshSync data @leecalcote (#20502)
> - [Server] Fix FlushMeshSyncData stale table-name subqueries leaking MeshSync data @leecalcote (#20502)

## 의존성 갱신 (2)

그 외 2건 · 보안 언급 없음

- `- upgrade to meshkit v1.0.21 @arjunmehta-git (#20506)`
- `- Chore: upgrade meshsync and operator @arjunmehta-git (#20505)`

## 기타 (2)

- Docs Docker 환경을 Hugo 0.157.0으로 업데이트
- `performance.spec.ts`와 `telemetry.spec.ts`에서 Common UI 중복 테스트 제거

---

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