# Meshery v1.0.19

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

호환성 변경 4 · 중요 수정 4 · 의존성 갱신 7 · 기타 20

## 호환성 변경 (4)

### Go 정책 엔진의 타입 지정 `v1alpha3` 관계 변환

- 영향 대상: Go 정책 엔진에서 등록된 `v1alpha3` 관계와 그 밖의 관계 값을 변환하는 경우

이전에는 일치하는 타입 케이스가 없는 관계 값에 일반 JSON 마샬링/언마샬링 폴백을 적용했습니다. 이제 `v1alpha3` 값과 포인터에는 `RelationshipV1alpha3ToV1beta2`를 사용하고, default 케이스에 도달한 값은 오류 없이 건너뜁니다.

근거: “- add a typed v1alpha3-to-v1beta2 relationship bridge for the Go policy engine” https://github.com/meshery/meshery/pull/19100

> - [Server] Replace JSON schema-version bridges with typed copies @ritzorama (#19100)

### `event_trackers.metadata` 키의 camelCase 전환

- 영향 대상: 영향을 받는 메타데이터 키를 사용하는 `event_trackers.metadata` 소비자
- 필요 조치: 백필 마이그레이션 불필요

영향을 받는 핸들러는 이전에 `connection_id`, `view_link`, `design_name`, `design_id` 같은 키를 내보냈지만, 새 이벤트 행에서는 대신 camelCase 키를 사용합니다. 기존 행의 레거시 키는 그대로 유지되며, `?design_id=` URL 쿼리 파라미터는 변경되지 않습니다.

근거: “`event_trackers` is an append-only audit log, so no backfill migration is needed. Old rows remain under their legacy keys as historical records; new rows comply going forward.” https://github.com/meshery/meshery/pull/19099

> - fix(events): flip event metadata keys to canonical camelCase @leecalcote (#19099)

### `mesheryctl workspace`의 `v1beta3` 모델 전환

- 영향 대상: `mesheryctl workspace create`, `mesheryctl workspace list`, `mesheryctl workspace view` (추정)

이번 릴리스 전에는 이 명령들이 `v1beta1` 워크스페이스 모델을 사용했고, 여기에는 `organization_id`, `created_at` 같은 필드가 있었습니다. 업그레이드하면 워크스페이스 데이터가 `v1beta3` 모델을 사용하며, `organizationId`, `createdAt` 같은 camelCase 이름으로 바뀝니다.

> - [mesheryctl] Align mesheryctl workspace with v1beta3 @PragalvaXFREZ (#19020)

### Meshery UI 빌드의 Node 22 전환

- 영향 대상: Meshery UI를 빌드하거나 UI의 Node 패키지 또는 Docker 빌드 베이스를 사용하는 설정 (추정)

이전에는 UI 패키지가 Node 20을 허용했고, Docker 빌드에는 `node:20-alpine`을 사용했으며, 기여자 문서에는 Node 20 LTS가 명시되어 있었습니다. 이제 패키지는 Node `^22.13.0 || >=24`를 요구하고, Docker 빌드에는 `node:22-alpine`을 사용하며, 문서에는 Node 22 LTS가 명시되어 있습니다.

> - Chore: Upgrade to Node 22 and React 19 @leecalcote (#19083)
> - Chore: Upgrade to Node 22 and React 19 @leecalcote (#19083)
> - Chore: Upgrade to Node 22 and React 19 @leecalcote (#19083)

## 중요 수정 (4)

### Meshery 로그인 리디렉션에서 요청된 인앱 경로 보존

- 영향 대상: 인앱 목적지가 있는 Meshery 로그인 플로우. `InitiateLogin` 및 레거시 `?ref=` 호출자 포함

이전에는 중간 provider 경유 과정에서 `ref`가 누락되거나 다른 값으로 바뀌면 사용자가 Meshery에 존재하지 않는 `/login` 경로로 이동해 404를 받을 수 있었습니다. 이제 `InitiateLogin`은 요청된 경로를 `RefCookieName`에 저장합니다. `TokenHandler`는 이 값을 먼저 사용하고, 값이 없으면 `?ref=`와 `/`를 차례로 폴백으로 사용합니다. 사용 후에는 쿠키를 삭제합니다.

> - fix(auth): own post-login redirect locally in Meshery via cookie @leecalcote (#19119)

### `mesheryctl perf` 프로파일 경로의 빈 슬라이스 처리 수정

- 영향 대상: `mesheryctl perf`에서 사용하는 `loadGenerators` 또는 엔드포인트 슬라이스가 비어 있는 프로파일

`loadGenerators`가 없는 프로파일의 결과를 `mesheryctl perf result`가 포맷할 때 패닉이 발생할 수 있었습니다. 인접한 경로에서도 첫 번째 엔드포인트나 로드 제너레이터를 바로 인덱싱했습니다. 이제 영향을 받는 조회는 슬라이스가 비어 있으면 빈 문자열을 반환합니다.

> - [mesheryctl] Fix perf result panic on empty load generators @leecalcote (#19122)

### `ConnectionStateChip` 메뉴 컨텍스트 런타임 오류 수정

- 영향 대상: 메뉴 컨텍스트 밖에서 `ConnectionStateChip`을 렌더링하는 Meshery UI 연결 플로우

메뉴 컨텍스트 밖에서 상태 칩을 `MenuItem`으로 감싸면 중첩 구조가 잘못되어 `MenuListContext` 런타임 오류가 발생했습니다. 이제 오류가 발생하지 않으며 칩의 라벨, 아이콘, 색상은 변경되지 않았습니다.

> - fix: /management/connections MUI  MenuList issue @saurabhraghuvanshii (#19132)

### Meshery 이벤트 버스 페이로드 키를 camelCase로 수정

- 영향 대상: 페어링된 meshery-extensions 통합으로 디자인이나 뷰를 여는 Meshery 이벤트 버스 퍼블리셔를 사용하는 설정

퍼블리셔는 `view_id`를 보내고 컨슈머는 `viewId`를 읽어 런타임에 뷰 ID가 정의되지 않았습니다. 페어링된 meshery-extensions 변경으로 양쪽 모두 `viewId`를 사용합니다. 저장소 간 버전이 일치하지 않으면 이벤트가 처리되지 않을 수 있습니다.

> - fix(wire-format): canonicalize OPEN_*_EXTENSIONS event-bus payloads + ViewInfoModal props @leecalcote (#19136)

## 의존성 갱신 (7)

그 외 7건 · 보안 언급 없음

- `- [Chore]: Bump meshery/schemas to v1.2.13 @l5io (#19145)`
- `- [Chore]: Bump meshery/schemas to v1.2.12 @l5io (#18013)`
- `- chore(deps): bump @meshery/schemas ^1.2.12 + @sistent/sistent ^0.21.5 @leecalcote (#19140)`
- `- chore(deps): bump @sistent/sistent to ^0.21.4 @leecalcote (#19128)`
- `- chore(deps): Bump picomatch from 2.3.1 to 4.0.4 in /ui @[dependabot[bot]](https://github.com/apps/dependabot) (#19101)`
- `- [UI] Upgrade to mui-datatables v7.1.0 @ritzorama (#19098)`
- `- Chore: Upgrade to Node 22 and React 19 @leecalcote (#19083)`

## 기타 (20)

- MeshSync 디하이드레이션과 디자인 하이드레이션에 타입이 지정된 얕은 복사 적용
- `mesheryctl model init` 테스트의 플래그 상태 초기화
- Workspace 명령에서 이제 `orgId` 전송
- `mesheryctl system config`의 표준화된 오류 처리
- Docker Compose 복구 안내 메시지 오타 수정
- `ViewInfoModal`의 camelCase props 사용
- Meshery UI에서 빈 `/test` 페이지 제거
- 문서 업데이트 및 과거 회의 기록 제거
- 최초 기여자 워크플로를 에이전트 기반 워크플로로 전환
- E2E 확장 테스트의 TypeScript 마이그레이션
- Docs Noob Tester 워크플로의 다운로드 및 발견 보고서 업데이트
- `build-ui-and-server.yml`에서 Docker edge 푸시와 Docker Hub 설명 단계 제거
- Meshery 모델 정의의 `schemas.meshery.io` 네임스페이스 사용
- 문서 문구 정리 및 오래된 회의 기록 제거
- 첫 기여자 워크플로를 에이전트형 워크플로로 전환
- UI 엔드투엔드 테스트 `extensions.spec.js`의 TypeScript 전환
- Minikube 설치, UI 기여 및 프로바이더 문서 업데이트
- 어댑터 이미지 경로를 `meshery/`로 전환
- 문서 정리
- Meshery UI의 React 의존성 `^19.2.5` 업데이트

---

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