# Meshery v0.9.0

2026-03-23 · [릴리스 노트 원문](https://github.com/meshery/meshery/releases/tag/v0.9.0) · [전체 정리](https://ratatosk.io/ko/releases/meshery/v0.9.0)

호환성 변경 9 · 중요 수정 8 · 기능·개선 1 · 의존성 갱신 11 · 기타 93

## 호환성 변경 (9)

### 빈 `k8scontextID`를 사용하는 하드 리셋에서 클러스터 재동기화 건너뜀

- 영향 대상: 하드 리셋 중 클러스터 재동기화를 요청한 경우

데이터베이스를 재설정하는 동안 Kubernetes context 항목이 제거될 수 있는데도 `resyncCluster`가 해당 항목을 사용하려 해 Layer5 provider에서 오류가 발생했습니다. 이제 하드 리셋 경로에서는 재동기화를 건너뛰고 `model.StatusProcessing`을 반환합니다.

> - fix(resync): skip cluster resync when hardReset=true and k8scontextID is empty @Omkar-Ugal (#18038)

### `mesheryctl` 워크스페이스 목록 페이지네이션 적용

- 영향 대상: `mesheryctl exp workspace list` 사용

이전에는 이 명령이 페이지네이션 쿼리 파라미터 없이 워크스페이스를 가져왔습니다. 이제 플래그를 지정하지 않으면 첫 10개 워크스페이스를 요청합니다(API의 `page=0&pagesize=10`). `--page`는 1부터 시작하며 기본값은 `1`입니다. `--page-size`의 기본값은 `10`이며 최대 `100`까지 지정할 수 있습니다.

근거: “+ listWorkspaceCmd.Flags().IntVarP(&workspaceListFlags.Page, "page", "", 1, "page number for paginated results. (default: 1)")” https://github.com/meshery/meshery/pull/17967

> - refactor(mesheryctl): enhance workspace command using flags validator @lekaf974 (#17967)

### Meshery CLI set-context 응답 상태 코드 검증 수정

- 영향 대상: `mesheryctl system config` 또는 `mesheryctl connection create`가 수행하는 set-context API 호출

API가 2xx가 아닌 상태 코드를 반환해도 명령이 성공한 것처럼 보일 수 있었습니다. 이제 명령은 상태 코드와 응답 본문이 포함된 오류를 반환합니다. 2xx 응답은 이전처럼 정상 처리되며, 원시 응답 본문은 디버그 로그에 계속 남습니다.

근거: “Previously, mesheryctl system config and mesheryctl connection create did not validate the HTTP status code returned by the set-context API. As a result, the CLI could appear to succeed even when the API returned an error response (for example, 4xx or 5xx).” https://github.com/meshery/meshery/pull/17912

> - [mesheryctl] Use MakeRequest for set‑context API calls @dipanshurdev (#17912)

### 워크스페이스 조직 식별자를 `organization_id`로 변경

- 영향 대상: 워크스페이스 API 응답 및 CLI workspace-view 출력 (추정)

연결된 픽스처에서는 이전에 해당 식별자에 `org_id`를 사용했습니다.

근거: “+ "organization_id": "2d2c0b60-076a-4f0a-8a63-de538570a553",” https://github.com/meshery/meshery/pull/18126

> - upgrade to meshery/schemas v0.8.135 @leecalcote (#18126)

### 성능 결과 메트릭 필드 및 YAML 키 이름 변경

- 영향 대상: YAML 성능 결과 출력 및 `PerformanceResult.ServerMatrics`를 사용하는 코드 (추정)

YAML 키가 `servermatrics`에서 `servermetrics`로 바뀌지만, JSON 태그는 `server_metrics`로 유지됩니다. Go 필드명도 `ServerMatrics`에서 `ServerMetrics`로 바뀝니다. 두 프로바이더 모두에서 HTTP `StatusOK` 성공 경로의 `PublishMetrics()`가 조기 반환한 뒤 응답 본문을 닫지 않아 시간이 지나면서 연결과 파일 디스크립터가 누수됐지만, 이제는 응답 본문을 닫습니다.

근거: “- ServerMatrics interface{} `json:"server_metrics"` + ServerMetrics interface{} `json:"server_metrics"`” https://github.com/meshery/meshery/pull/17716

> - Fix HTTP response body leak in PublishMetrics and correct typos @Ironankit525 (#17716)

### `mesheryctl design list`에서 기본으로 전체 디자인 ID 표시

- 영향 대상: `mesheryctl design list` 명령 (추정)

이전에는 `--verbose`를 지정하지 않으면 디자인 ID가 잘려 표시됐습니다. 이제 플래그를 변경하지 않아도 기존 명령 호출로 전체 ID가 표시됩니다.

근거: “This requires full `id` which was only displayed in `mesheryctl design list --verbose`. I have added full design ID support in this PR on non-verbose mode (`mesheryctl design list`), to avoid confusion and better UX.” https://github.com/meshery/meshery/pull/17971

> - [mesheryctl] Show full design IDs in design list by default @PragalvaXFREZ (#17971)

### 워크스페이스 생성 시 필수 플래그와 `orgId` UUID 검증

- 영향 대상: `mesheryctl exp workspace create`를 통한 워크스페이스 생성

이전에는 `description`을 생략하면 오류가 발생했고, 기존 검사는 `orgId`가 UUID인지 확인하지 않았습니다. 이제 `description`을 생략하면 설명이 빈 워크스페이스가 생성되며, `orgId` 또는 `name`이 없거나 `orgId`가 UUID 형식이 아니면 검증에 실패합니다.

근거: “OrganizationID string `json:"orgId" validate:"required,uuid"`” https://github.com/meshery/meshery/pull/17967

> - refactor(mesheryctl): enhance workspace command using flags validator @lekaf974 (#17967)

### `mesheryctl system channel` 명령의 오류 반환

- 영향 대상: `mesheryctl system channel view`, `mesheryctl system channel set` 또는 `mesheryctl system channel switch`를 사용하는 환경 (추정)

이전에는 현재 컨텍스트를 가져오는 중 발생한 오류, 잘못된 컨텍스트 내용, 설정 쓰기 오류, 전환 확인 누락 등의 오류가 로그에만 기록되고 nil로 반환되어 명령이 호출자에게 오류를 전달하지 않았습니다. 반환되는 오류는 meshkit 스타일을 따릅니다.

> - refactor(mesheryctl): update system channel to use meshkit and return errors properly and update description @lekaf974 (#18122)
> - refactor(mesheryctl): update system channel to use meshkit and return errors properly and update description @lekaf974 (#18122)

### `mesheryctl` 모델 명령의 공통 플래그 검증

- 영향 대상: `mesheryctl` 모델 명령 사용

이전에는 `model generate`가 파일이나 인수 누락, 인수 초과를 명령별로 검사했습니다. 이제 공통 검증 경로에서 파일, 템플릿, 레지스터 값을 검증하며, 상대 경로와 절대 경로를 검증하는 태그도 추가됐습니다.

> - refactor(mesheryctl): model commands flags validation @lekaf974 (#17737)
> - refactor(mesheryctl): model commands flags validation @lekaf974 (#17737)
> - refactor(mesheryctl): model commands flags validation @lekaf974 (#17737)

## 중요 수정 (8)

### `system channel view` 및 `system provider view`의 오래된 컨텍스트 선택 문제 수정

- 영향 대상: `system channel view` 및 `system provider view` 명령

Cobra 명령 상태가 재사용되면 이전 persistent 플래그 상태가 남아, 특히 `--context`를 지정한 뒤 실행하는 명령에서 잘못된 결과나 기본 빈 결과를 선택할 수 있었습니다. 이제 임시 컨텍스트는 해당 실행에서 `--context`를 설정한 경우에만 사용하고, 그렇지 않으면 구성된 기본 컨텍스트를 사용합니다.

> - Stabilize mesheryctl system view output across reused Cobra command state @[copilot-swe-agent[bot]](https://github.com/apps/copilot-swe-agent) (#18140)

### `mesheryctl system status`의 Kubernetes 엔드포인트 표시 수정

- 영향 대상: 외부 엔드포인트를 검색할 수 있는 LoadBalancer 또는 NodePort Meshery 서비스가 있는 Kubernetes 배포

이전에는 엔드포인트가 오래되었거나 서비스의 실제 상태와 일치하지 않아도 상태에 설정된 로컬 엔드포인트가 표시됐습니다. 이제 검색된 외부 주소와 포트가 있으면 이를 표시하고, 설정된 엔드포인트와 다를 경우 `mesheryctl system dashboard`를 실행하도록 안내합니다.

> - [mesheryctl] Refactor endpoint discovery with shared helper function @PragalvaXFREZ (#17073)

### 깊이 제한 도달 시 관계 평가 결과 일부 반환

- 영향 대상: 중첩 관계가 있는 디자인

이전에는 깊게 중첩된 관계를 평가하다가 `MAX_RE_EVALUATION_DEPTH`에 도달하면 HTTP 500과 `evaluation depth exceeded` 오류가 반환됐습니다. 이제는 제한에 도달하기 전까지 처리한 관계 변경 사항을 부분 결과로 반환하고, HTTP 200을 응답하며 경고를 로그에 기록합니다.

> - fix(server): return partial result when evaluation depth is exceeded @dhakshin-raghav (#18120)

### 세션 동기화 중 nil preference로 인한 패닉 수정

- 영향 대상: 서버 세션 동기화 및 preference 로딩

저장된 preference가 없거나 저장된 JSON `null`이면 사용할 수 있는 preference가 없어져, `prefObj.MeshAdapters`를 할당하는 중 `SessionSyncHandler`에서 패닉이 발생할 수 있었습니다. preference 로딩에 실패하거나 결과가 nil인 경우에도 미들웨어에 preference가 전달되지 않을 수 있었습니다. 이제 저장된 행이 없으면 기본값을 반환하고, 미들웨어는 로딩에 실패하거나 결과가 nil이면 이 기본값을 사용합니다. 기본값에서는 `AnonymousUsageStats`와 `AnonymousPerfResults`가 활성화됩니다.

> - [Server] Prevent nil preference panic during session sync @fitzergerald (#18048)

### 채널 전환 명령의 nil 포인터 패닉 수정

- 영향 대상: `mesheryctl system channel switch` 명령

`config.GetMesheryCtl()` 호출이 실패하면 CLI는 오류를 로그에 남긴 뒤 계속 실행해 nil 포인터 패닉을 일으켰습니다. 이제는 설정 조회 오류를 반환합니다.

> - fix: Fixes nil pointer panic when config.GetMesheryCtl() fails @ARZU-V (#18106)

### 연결 삭제 시 존재하지 않는 연결 처리 수정

- 영향 대상: 서버 API 또는 `mesheryctl connection delete`를 통한 연결 삭제

요청한 연결 ID가 존재하지 않으면 CLI는 `no rows in result set` 응답을 오류로 처리했습니다. 이제 서버는 HTTP 404를 반환하고, `mesheryctl connection delete`는 경고를 로그에 남긴 뒤 성공적으로 종료됩니다.

> - fix: update connection deletion logic and error handling on server and cli @lekaf974 (#17910)

### 두 프로바이더에서 메트릭 응답 본문을 닫도록 수정

- 영향 대상: `DefaultLocalProvider` 또는 `RemoteProvider`를 통해 메트릭을 게시하는 설정

HTTP 200 응답에서 `PublishMetrics()`가 응답 본문을 닫기 전에 반환해 시간이 지나면서 HTTP 연결과 파일 디스크립터가 누수됐습니다. 이제 성공 경로에서도 응답 본문을 닫습니다.

> - Fix HTTP response body leak in PublishMetrics and correct typos @Ironankit525 (#17716)

### 로컬 메트릭 프로바이더의 마샬 오류 문구 수정

- 영향 대상: 로컬 메트릭 프로바이더 (추정)

마샬 오류 문구에 “Matrics”라고 적혀 있었고, 주석에는 “asyncronously”라고 적혀 있었습니다. 두 표기를 모두 바로잡았습니다.

> - Fix HTTP response body leak in PublishMetrics and correct typos @Ironankit525 (#17716)
> - Fix HTTP response body leak in PublishMetrics and correct typos @Ironankit525 (#17716)

## 기능·개선 (1)

- `mesheryctl exp workspace view`로 워크스페이스 세부 정보 조회

## 의존성 갱신 (11)

그 외 11건 · 보안 언급 없음

- `- Bump flatted from 3.4.1 to 3.4.2 in /install/docker-extension/ui @[dependabot[bot]](https://github.com/apps/dependabot) (#18071)`
- `- Bump flatted from 3.3.3 to 3.4.1 in /install/docker-extension/ui @[dependabot[bot]](https://github.com/apps/dependabot) (#17956)`
- `- Bump yauzl and hugo-extended in /docs-new @[dependabot[bot]](https://github.com/apps/dependabot) (#17961)`
- `- [Dependencies] Upgrade Meshery Server, UI, and mesheryctl to meshery/schemas v0.8.136 @leecalcote (#18127)`
- `- upgrade to meshery/schemas v0.8.135 @leecalcote (#18126)`
- `- Bump flatted from 3.3.4 to 3.4.2 in /ui @[dependabot[bot]](https://github.com/apps/dependabot) (#18070)`
- `- Bump flatted from 3.3.4 to 3.4.2 in /provider-ui @[dependabot[bot]](https://github.com/apps/dependabot) (#18072)`
- `- Bump next from 15.5.12 to 15.5.14 in /provider-ui @[dependabot[bot]](https://github.com/apps/dependabot) (#18074)`
- `- Bump github.com/buger/jsonparser from 1.1.1 to 1.1.2 @[dependabot[bot]](https://github.com/apps/dependabot) (#18073)`
- `- Bump google.golang.org/grpc from 1.77.0 to 1.79.3 @[dependabot[bot]](https://github.com/apps/dependabot) (#18050)`
- `- Chore: upgrade meshkit and schemas @fitzergerald (#18052)`

## 기타 (93)

- `GetWorkspaceByIdHandler`의 `orgID` 검증
- `ResyncResources` 머신 컨텍스트 오류 메시지 변경
- `api-doc` 및 `gen-test` 스킬에 YAML 프런트 매터 추가
- 정책 관계 테스트에서 `RelationshipDefinitionSelectorsPatch`를 사용하도록 변경
- LLM에 구애받지 않는 에이전트 정의와 스킬, 개발 훅 및 `AGENTS.md` 지침 추가
- Hugo로 이전한 문서 사이트 출시
- 문서 스타일시트 Sass 변수 참조 수정
- 카탈로그 파일의 `docs-new/catalog`에서 저장소 루트로 이동
- 문서 사이트 사이드바 레이아웃과 내비게이션 조정
- 문서 코드 블록 및 가이드 페이지 마크업 업데이트
- 새 `v0.8.214` 릴리스 페이지에 맞춘 문서 콘텐츠 동기화
- 문서 사이트의 `openapi.yml`을 업데이트된 OpenAPI 내용과 동기화
- 문서 릴리스 목록의 사용자 지정 정렬
- 최신 릴리스 문서 페이지의 빈 레이아웃
- `mesheryctl model` 도움말 예시 수정
- `mesheryctl` 채널 및 프로바이더 보기의 정렬된 컨텍스트 출력
- 워크스페이스 서버와 CLI의 lint·typecheck 문제 수정
- Meshery CLI의 중앙집중식 로거 초기화
- CLI 스키마 업그레이드 픽스처·골든 출력·테스트 업데이트
- CLI 스키마 필드 접근을 `.ID`에 맞게 수정
- `mesheryctl` 문서와 이미지를 새 문서 구조로 이전
- 관계 뷰 테스트의 골든 출력 업데이트
- Meshery Server의 워크스페이스 영속성에 `workspace.Workspace` 사용
- Docker 확장 UI `usePingServer`의 초기 확인 및 정리 시 인터벌 해제
- 워크스페이스 생성 시 `OrganizationID`의 UUID 검증
- 패턴 행 삭제 확인 처리 수정
- 디자인 구성 도구와 확장 링크의 엔드투엔드 테스트 신뢰성 향상
- `ConfirmationModal` 및 `CustomToolbarSelect`의 Material UI 아이콘을 Sistent 아이콘으로 교체
- mesheryctl e2e 성능 워크플로에서 액션 대신 명령어 사용
- E2E 워크플로에서 어댑터 배포에 임시 인증 파일 사용
- 워크플로 체크아웃의 `actions/checkout@v6` 고정 및 날짜 출력 수정
- 환경 변수의 브랜치 참조를 출력하는 풀 리퀘스트 핸들러
- `mesheryctl system channel` 도움말에 문서 링크 추가
- security-insights 라이선스 및 Copilot PR ref 처리 업데이트
- 디자인 구성기와 확장 링크 관련 UI 엔드투엔드 테스트 안정화
- E2E-results 커밋 단계 이름과 메시지에서 Jekyll 제거
- 문서 미리보기 워크플로의 `build-and-preview-docs.yml` 통합
- 두 이벤트 페이로드를 모두 처리하는 문서 미리보기 댓글 액션
- Security Insights 파일 경로 변경
- Hugo 문서 사이트 지원
- `mesheryctl` 문서를 레퍼런스 구조로 이전
- 문서 빌드의 Docsy·Hugo 업데이트와 Dart Sass 경고 수정
- 문서 기여자 에이전트 업데이트 및 콘텐츠 동기화
- 첫 PR 환영 문구에 HTTPS Slack 링크 적용
- Meshery README에 프로젝트 구조 개요 추가
- Meshery 태그가 붙은 주제를 표시하는 관련 토론 쇼트코드
- 문서화 회의 자료에 Nathanael Fetue의 GSoC 2026 소개 추가
- 문서 코드 블록용 복사 버튼 쇼트코드
- Hugo 코드 블록 스타일 설정 변경
- 모델 기여 페이지의 Model Schema 링크 업데이트
- 회의록에 Kavitha Karunakaran의 약력 추가
- 모델 기여 문서의 Model Schema 링크 업데이트
- 문서에 Taiwo Sholadoye의 회의 참석 기록 추가
- 03-19-2026이 포함된 주의 Himanshu Rathi 출석 기록 추가
- 회의 문서에 Dhakshin Raghav 소개 추가
- 03-19-2026 주간 출석 제출
- 문서에 Chetan Ahuja 소개 추가
- 문서에 Bhumika Garg 소개 추가
- Joy Gundu 회의록 업데이트
- `Yash-Mahakal.md`에 소개 메시지 추가
- Mahesh Nandigam의 회의 소개 추가
- OpenAPI 벤더 확장 기능을 다루는 스키마 기여 가이드
- 스키마 기여 가이드에 데이터베이스 컬럼 대응 필드의 `snake_case` 표기 명시
- 스키마 기여 가이드에 빌드 파이프라인 다이어그램 추가
- 스키마 기여 가이드에 데이터베이스 헬퍼 안내 추가
- 스키마 기여를 위한 추가 자료
- 3월 19일 회의록 색인에 참석 안내 추가
- Dockerfile의 카탈로그 복사 경로를 `/app/docs/data/catalog/`로 변경
- 문서 ignore 규칙을 루트 `.gitignore`에 통합
- 문서 편집 링크의 새 대상 경로 `docs/content/...`
- 영어 로컬라이제이션 파일에서 커뮤니티 섹션 제거
- 2026년 3월 13일 신규 참여자 모임에서 Pruthvi Raj D S의 참석 및 소개
- 개인 및 프로젝트 세부 정보가 담긴 `Nishant.md` 추가
- `Raunak.md` 파일 추가
- `EylulGeyik.md` 파일 추가
- `bishal-attendance.md` 추가
- 2026년 3월 13일 회의 참석자 추가
- 회의 문서에 Ahmed Sayed 소개 추가
- GSoC에서 Harpalsinh Sindhav 소개
- Taiwo Sholadoye의 회의 참석 기록 추가
- 회의록에 Harsh Raj 소개 추가
- `joy_gundu.md`에 회의 세부 정보 추가
- `Samanvai.md`에 소개 문구 추가
- `Yash-Mahakal.md`에 소개 메시지 추가
- `Hrishikesh.md` 회의록 파일 추가
- 03-12-2026 주간 소개 섹션 추가
- OpenSSF Best Practices Baseline 배지 추가
- Copilot PR 워크플로의 head-ref 패스스루 및 에코
- 두 `SECURITY-INSIGHTS.yml` 파일의 라이선스 표현식 갱신
- Copilot PR 핸들러 워크플로에서 PR 헤드 ref 정제
- 보안 인사이트 파일 위치 변경
- README에 프로젝트 구조 개요 추가
- 첫 이슈 및 PR 환영 댓글에 포함되는 HTTPS Slack 링크

---

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