# Meshery v1.0.2

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

호환성 변경 3 · 중요 수정 2 · 기능·개선 2 · 의존성 갱신 3 · 기타 10

## 호환성 변경 (3)

### 빈 값에 대한 워크스페이스 업데이트에서 필드 보존

- 영향 대상: `PUT /api/workspaces/{id}`를 통한 워크스페이스 업데이트

이전에는 `PUT /api/workspaces/{id}` 요청을 처리할 때 payload의 이름, 설명, 조직 값으로 저장된 값을 항상 덮어썼습니다. 이제 이름이 생략되거나 설명이 비어 있거나 조직이 nil이면 저장된 값이 그대로 유지됩니다.

근거: “- Use `WorkspaceUpdatePayload` for `PUT /api/workspaces/{id}` (name optional on update)” https://github.com/meshery/meshery/pull/18541

> - Upgrade to Meshery Schemas v1.0.4: enhance Workspace API @yi-nuo426 (#18541)

### `orgID`를 사용하는 워크스페이스 및 환경 조회 수정

- 영향 대상: `orgID` 쿼리 매개변수를 사용하는 워크스페이스 및 환경 핸들러 호출

호출자가 `orgID`를 전달해도 핸들러는 `orgId`를 찾았기 때문에, 프로바이더에 조직 ID가 전달되지 않아 Cloud가 HTTP 500을 반환했습니다. 이제 핸들러는 전달받은 값을 프로바이더에 전달하며, `orgID`가 비어 있는 요청에는 HTTP 400을 반환합니다.

> - Fix orgID query parameter case in workspace and environment handlers @yi-nuo426 (#18519)

### 로컬 Swagger UI 및 `swagger.yaml` 제공 제거

- 영향 대상: 로컬 Swagger UI 또는 `swagger.yaml` 엔드포인트를 사용하는 Meshery 서버 설치 환경 (추정)

REST API 레퍼런스는 이제 공개된 스키마 사이트와 `meshery/schemas` 저장소를 가리킵니다.

근거: “Replaced the embedded/generated reference with links to the published schemas site and the `meshery/schemas` repository.” https://github.com/meshery/meshery/pull/18521

> - Retire swagger-based REST API docs and point references to meshery/schemas @[copilot-swe-agent[bot]](https://github.com/apps/copilot-swe-agent) (#18521)
> - Retire swagger-based REST API docs and point references to meshery/schemas @[copilot-swe-agent[bot]](https://github.com/apps/copilot-swe-agent) (#18521)

## 중요 수정 (2)

### Meshery UI 환경 쿼리 매핑 수정으로 콘솔 404 해결

- 영향 대상: Meshery UI 환경 쿼리 (추정)

수정 전에는 환경 쿼리에서 저장소가 기대하는 `orgID` 파라미터를 사용하지 않아 콘솔에서 404가 반환됐습니다.

> - [UI] Fix console 404s for environments and icons @yi-nuo426 (#18556)

### 워크스페이스 쿼리의 조직 ID 대기

- 영향 대상: Meshery UI의 워크스페이스 데이터 테이블

이전에는 선택한 조직을 사용할 수 있기 전에 워크스페이스 쿼리가 실행되면 `orgID` 없이 `/api/workspaces`를 요청했습니다. 서버가 일반 텍스트로 응답해 클라이언트에서 JSON 파싱 오류가 발생했습니다.

> - [UI] Guard workspace query on org availability @yi-nuo426 (#18525)

## 기능·개선 (2)

- 워크스페이스 API에 디자인·뷰·팀 엔드포인트 7개 추가
- 워크스페이스 편집 양식에서 `name`을 그대로 둘 수 있음

## 의존성 갱신 (3)

그 외 3건 · 보안 언급 없음

- `- [Chore]: Update to Sistent v0.18.3 @l5io (#18554) - Bump @sistent/sistent to v0.18.2 and use editWorkspaceSchema @fitzergerald (#18544)`
- `- chore: upgrade meshery/schemas to v1.0.5 @yi-nuo426 (#18550)`
- `- chore(deps): bump vite from 7.3.1 to 7.3.2 in /ui @[dependabot[bot]](https://github.com/apps/dependabot) (#18524)`

## 기타 (10)

- Dockerfile에서 Swagger 파일 복사 제거
- Meshery 마이그레이션에서 워크스페이스 팀 및 뷰 매핑 테이블 생성
- `mesheryctl` workspace 스키마 처리 수정
- 워크스페이스 view 출력에 빈 `metadata` 필드 추가
- 워크스페이스 퍼시스터의 디버그 출력 제거
- Meshmodel 아이콘의 공유 이미지 경로 정규화
- Provider UI의 `next.config.js`에서 지원 중단 예정 ESLint 옵션 제거
- 지원 중단 예정이던 재사용 UI 및 서버 빌드 워크플로 제거
- Swagger로 생성한 REST API 문서와 로컬 spec 도구 폐지
- Swagger Make 타깃 및 로컬 게시 워크플로 제거

---

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