# Meshery v1.0.6

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

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

## 호환성 변경 (4)

### `mesheryctl` 어댑터 명령의 오류 반환 동작 변경

- 영향 대상: `mesheryctl` 어댑터 명령 (추정)

이전에는 설정 조회, 어댑터 또는 메시 검증, 작업 요청, 작업 감시 응답에서 발생한 오류를 로그에만 남기고 명령은 nil을 반환했습니다. 이제 해당 경로에서 오류를 반환합니다. 배포, 제거, 검증 명령은 작업 오류를 반환하기 전에 스피너를 멈춥니다.

> - fixes: return error properly adapter  @Omkar-Ugal (#18391)

### 패턴이 없는 응답에 대한 `mesheryctl design apply`의 오류 처리

- 영향 대상: `mesheryctl design apply`

응답에 패턴이 없으면 명령이 `ErrDesignNotFound(patternName)`을 로그에 기록하고 nil을 반환했습니다.

근거: “if len(response.Patterns) == 0 { - utils.Log.Error(ErrDesignNotFound(patternName)) - return nil + return ErrDesignNotFound(patternName)” https://github.com/meshery/meshery/pull/18436

> - fix: design uses meshkit error properly + return error properl @Omkar-Ugal (#18436)

### `mesheryctl system restart`의 위치 인수 거부

- 영향 대상: `mesheryctl system restart`에 위치 인수를 전달하는 호출

이전에는 위치 인수를 하나 전달한 호출이 런타임 검사를 통과했지만, 이제 `Args` 검증에서 `utils.ErrInvalidArgument` 오류로 실패합니다.

근거: “Args: func(cmd *cobra.Command, args []string) error { + if len(args) > 0 { + return utils.ErrInvalidArgument(” https://github.com/meshery/meshery/pull/18359

> - [mesheryctl] system restart uses meshkit error properly + remove logrus @rishiraj38 (#18359)

### `mesheryctl system restart`의 조회 및 컴포넌트 확인 오류 반환

- 영향 대상: `mesheryctl system restart`

이전에는 설정 조회 오류와 Meshery 컴포넌트의 실행 여부를 확인하는 중 발생한 오류를 로그에 기록하고 명령은 nil을 반환했습니다. 이제 명령은 설정 오류를 그대로 반환하고, 컴포넌트 확인 오류는 `ErrRestartMeshery`로 감쌉니다.

근거: “running, err := utils.AreMesheryComponentsRunning(currPlatform) if err != nil { - utils.Log.Error(err) - return nil + return ErrRestartMeshery(err)” https://github.com/meshery/meshery/pull/18359

> - [mesheryctl] system restart uses meshkit error properly + remove logrus @rishiraj38 (#18359)

## 중요 수정 (9)

### [드러나지 않던 결함] 인증된 사용자 이벤트의 원격 저장 수정

- 영향 대상: 원격 provider로 전송되는 인증된 사용자 요청 핸들러 이벤트

이전에는 핸들러가 `PersistEvent`에 nil을 전달해 `GlobalTokenForAnonymousResults`가 선택됐습니다. 원격 provider는 이 토큰을 HTTP 401로 거부해 이벤트가 알림 없이 누락됐습니다. 이제 핸들러는 요청에 포함된 사용자 토큰을 전달하므로 이벤트를 원격으로 저장할 수 있습니다.

> - fix: pass user token to PersistEvent to prevent 401 errors @marblom007 (#18595)

### [드러나지 않던 결함] 시스템 이벤트 및 토큰이 빈 호출의 로컬 저장

- 영향 대상: 시스템이 시작한 이벤트 처리 및 `PersistEvent`

이전에는 사용자 요청 컨텍스트가 없는 시스템 시작 이벤트를 로컬에 저장하는 전용 메서드가 없었습니다. 사용할 수 있는 토큰이 없는 호출은 익명 토큰을 사용했지만 원격 제공자가 이를 거부해 이벤트가 조용히 유실될 수 있었습니다. 이제 `PersistSystemEvent`로 이러한 시스템 이벤트를 저장할 수 있으며, 토큰이 비어 있는 `PersistEvent` 호출은 원격 저장 대신 로컬 DB에 저장됩니다.

> - fix: pass user token to PersistEvent to prevent 401 errors @marblom007 (#18595)

### `SeedContent`에서 `seededUUIDs` 동시 추가 작업 동기화

- 영향 대상: `DefaultLocalProvider.SeedContent`를 통해 콘텐츠를 동시에 시드하는 서버 구성

이전에는 바깥쪽 goroutine과 내부 `Pattern` 케이스의 goroutine이 동기화 없이 공유 slice에 동시에 추가할 수 있었습니다.

> - Server: fix import ordering and seededUUIDs data race in UUID transition follow-up @yi-nuo426 (#18583)

### `GetUserByIDHandler`의 nil 사용자 조회 처리 수정

- 영향 대상: `GetUserByIDHandler`가 처리하는 사용자 조회

`GetUserByID`가 nil을 반환하면 핸들러가 응답을 작성하는 과정에서 nil 응답을 역참조할 수 있었습니다. 이제 이 경우 "user not found" 메시지와 함께 HTTP 404를 반환합니다.

> - fix: return 404 when GetUserByID returns nil response @arjunmehta-git (#18605)

### `K8sFSMMiddleware`의 nil ID 패닉 수정

- 영향 대상: `K8sFSMMiddleware`가 Kubernetes 컨텍스트를 처리하는 경우

미들웨어가 `KubernetesServerID`가 nil인 컨텍스트를 처리하면, 클러스터 내부 배포나 부분적인 클러스터 등록 상황에서도 패닉이 발생했습니다. 이제 해당 컨텍스트를 건너뛰고 처리를 계속합니다.

> - fix: guard against nil KubernetesServerID in K8sFSMMiddleware @mango766 (#18600)

### 토큰 갱신 재시도 전 프로바이더 요청 본문 복원

- 영향 대상: 서버 측 프로바이더 요청 (추정)

사용자가 유효한 새 세션으로 자신의 조직과 워크스페이스에 디자인을 저장할 때, 토큰 갱신 재시도 중 요청 본문이 이미 소진되어 400 오류가 반환될 수 있었습니다. 이제 재시도 전에 `GetBody`에서 본문을 복원합니다.

> - [Server] Restore body on provider retry @leecalcote (#17211)

### `persistEventRemote` 응답 본문 누수 수정

- 영향 대상: `persistEventRemote`를 통해 원격으로 저장되는 이벤트 (추정)

이 변경 전에는 원격 이벤트 저장 응답에서 `resp.Body`를 닫지 않아 연결 누수가 발생했습니다. 이제 응답 본문을 닫습니다.

> - fix: pass user token to PersistEvent to prevent 401 errors @marblom007 (#18595)

### 필터 핸들러의 nil 역참조 수정

- 영향 대상: 필터 핸들러 요청

필터 JSON 디코딩에 실패하고 `parsedBody` 또는 그 `FilterData`가 nil이면 핸들러에서 nil을 역참조할 수 있었습니다. 이제 일반적인 손상된 요청 설명을 사용하고 필터 저장 오류와 함께 HTTP 400을 반환합니다.

> - fix: pass user token to PersistEvent to prevent 401 errors @marblom007 (#18595)

### 성능 환경설정의 누락 값과 빈 Duration 처리 개선

- 영향 대상: 사용자 환경설정의 성능 탭 (`/user/preferences`)

비어 있는 `loadTestPrefs` 응답으로 Duration이 정의되지 않아 탭이 비정상 종료될 수 있었고, Duration을 비운 채 저장해도 비정상 종료될 수 있었습니다. 이제 누락된 값에는 `30s`를 포함한 기본값을 사용하며, Duration을 비워 제출하면 비정상 종료되는 대신 유효성 검사 오류가 표시됩니다.

> - [UI] Fix crash on Performance preferences tab @arjunmehta-git (#18587)

## 기능·개선 (3)

- Performance 기본 설정에서 일 단위 기간 허용
- Meshery 홈 페이지의 자동 정적 최적화 적용
- Kubernetes 네이티브 Pod 네트워크 SVG 아이콘 추가

## 의존성 갱신 (2)

그 외 2건 · 보안 언급 없음

- `- Bump go.opentelemetry.io/otel/exporters/otlp/otlptrace/otlptracehttp from 1.39.0 to 1.43.0 @[dependabot[bot]](https://github.com/apps/dependabot) (#18591)`
- `- Bump go.opentelemetry.io/otel/sdk from 1.40.0 to 1.43.0 @[dependabot[bot]](https://github.com/apps/dependabot) (#18590)`

## 기타 (20)

- mesheryctl performance-result UUID 필드를 `core.Uuid`로 전환
- `design apply`의 언마샬링 오류 직접 처리
- 재시작 명령의 플래그 검증
- Meshery 시스템 재시작 안내
- 재시작 명령의 상태 로그를 `utils.Log.Info`로 전환
- 재시작 확인 플래그 할당 위치 변경
- Provider UI 개발 커버리지 API 라우트 제거
- Design Configurator의 데이터베이스 카테고리 표시 여부 확인 제거
- Design Configurator E2E 모크 업데이트
- UI에서 성능 환경설정 정규화
- Meshery UI 프로젝트의 `axios` 의존성 제거
- `useMeshModelComponents.ts` 오류 메시지 문구 수정
- Provider UI 서브패스 설정을 `assetPrefix`에서 `basePath`로 전환
- 문서용 Noob Tester 워크플로 추가
- GoReleaser 설정의 v2 구문 전환
- 어댑터 테스트 워크플로의 선택적 `job_type` 매개변수
- 안정 릴리스 워크플로에서 `ctlrelease` 작업 조건에 표현식 구문 사용
- 7개 파일의 import 순서 수정
- OCI 모델 문서의 플레이스홀더 플로우 제목 제거
- 이전 문서 버전의 크롤러 색인 제한

---

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