Skip to content

Releases

v0.2.0-alpha.5

v0.2.0-alpha.5 Pre-release
Pre-release

Choose a tag to compare

@github-actions github-actions released this 16 Nov 09:28

v0.2.0-alpha.5

한국어

  • 지정된 절대 경로 실행 파일만 허용하는 선택적 exec 인증. 기본 차단, 비대화형·시간/출력 제한, 토큰과 오류 원문 비출력. 이 옵션은 인증 서버 통신을 동반할 수 있습니다.
  • AKS 조회 JSON의 클러스터·현재 버전·조회 시각·다음 제공 후보를 대조합니다. 전체 업그레이드 경로 승인은 아닙니다.
  • 1.35.9·1.36.5·1.37.1 정확한 패치 스키마를 추가하고, 실제 description 필드가 누락되던 번들 축약 오류를 수정했습니다. 모든 공식 원본 해시를 검증했습니다.
  • scan cel 및 MCP scan_cel: 공식 Kubernetes 라이브러리 기반 로컬 CRD CEL·oldSelf 검사와 비용 제한.
  • diff --crd-defaults --crd-conversion: 로컬 기본값과 strategy None 변환을 선택적으로 반영하며 Webhook 변환은 실행하지 않습니다.
  • 공식 근거의 일부 애드온 카탈로그, 노드 런타임·로컬 OCI 플랫폼/digest 근거 검사.
  • Service→Pod/targetPort 분석과 포트·프로토콜별 Hubble 관측 연결.
  • 요구사항을 반영한 노드풀·canary 템플릿, 목표 스키마·label/quantity·HCL 문법 검증. 실행은 기본 비활성.
  • 양국어 문서·로드맵을 현재 구현과 실제 환경 검증 경계에 맞춰 정리했습니다.

실제 AKS 변경, admission webhook, 앱 실행/커널 검증, CNI/클라우드 방화벽 실통신, Terraform provider 적용, 데이터 이전은 수행하지 않습니다. 공급자 근거와 스냅샷의 최신성·진위는 별도 확인해야 합니다.

English

  • Add opt-in exec authentication for an explicitly approved absolute executable, with noninteractive execution, bounded time/output and no credential/error-output logging. This option may contact identity services.
  • Cross-check local AKS upgrade-profile exports against cluster, current version, capture age and next offered candidates; never certify an entire future path.
  • Add pinned 1.35.9/1.36.5/1.37.1 schemas. Fix schema reduction dropping legitimate properties named description; verify all official source hashes.
  • Add scan cel / MCP scan_cel using the pinned Kubernetes CEL implementation, explicit old objects and bounded evaluation cost.
  • Add opt-in local CRD defaulting and strategy None conversion for drift; never invoke conversion webhooks.
  • Add selected vendor-sourced add-on rules, Node runtime inventory and local OCI platform/digest checks.
  • Follow Service selectors/targetPort to supplied Pods and attach protocol/port-matched Hubble evidence.
  • Generate parameterized node-pool/canary review templates with schema, label/quantity and HCL syntax checks; execution remains disabled by default.
  • Reconcile bilingual guides and roadmap with implemented behavior and environmental validation boundaries.

No live AKS change, admission webhook execution, workload/kernel execution, dataplane/firewall probing, Terraform provider application or data movement is performed. Local exported evidence is not independently authenticated.

v0.2.0-alpha.4

v0.2.0-alpha.4 Pre-release
Pre-release

Choose a tag to compare

@github-actions github-actions released this 15 Nov 22:38

v0.2.0-alpha.4

한국어

  • plan aks: 가변 버전, 기존 AKS 업그레이드, 아키텍처 변경 요구사항과 로컬 애드온 호환성 근거를 함께 검토합니다. 실제 업그레이드 경로·복구 리허설·PDB/여유 용량 확인을 필수 조치로 표시합니다.
  • generate: 새 디렉터리에 검토용 Terraform 노드풀, 기본 비활성 Helm 차트, replica 0 manifest, 검수 체크리스트를 생성합니다. 배포와 원본 워크로드 자동 변환은 하지 않습니다.
  • scan path: 두 Pod의 ingress/egress 정책, selector, port, IPBlock을 정적으로 평가합니다. 불충분한 근거는 unknown이며 실통신 보증이 아닙니다.
  • CRD map/set 목록의 순서 차이를 처리하고 managedFields 관리자 근거를 추가합니다. 소유권 근거만으로 수정·삭제를 권고하지 않습니다.
  • API 수정 시점을 첫 영향 버전에 맞추고 dockershim/토큰/PSP 변경 및 노드 OS·런타임 의존성 검토를 추가합니다.
  • Jobs/ReplicaSets/HPA 수집과 알려진 구버전의 beta API 선택을 추가합니다.
  • mcp --profile에 운영자가 고정한 plan_aks 도구를 제공합니다. 생성/배포 도구는 노출하지 않습니다.

Linux 우선 검증 릴리스입니다. 실제 AKS 실행, 공급자 호환성 근거의 독립 검증, Terraform provider 실행, CEL/admission·API 변환은 포함하지 않습니다. 모든 분석은 로컬이며 명시적인 collect만 선택한 API 서버와 통신합니다.

English

  • Add plan aks for variable upgrade ranges, in-place AKS architecture requirements and operator-supplied add-on evidence. Require actual offered-route, recovery, disruption and capacity reviews.
  • Add generate for local review-only Terraform user-pool, disabled Helm canary, zero-replica manifest and acceptance checklist in a new directory. No deployment or production workload conversion.
  • Add scan path for two-Pod ingress/egress policy intent, selectors, ports and IPBlocks with explicit unknown results; this is not reachability testing.
  • Compare CRD map/set lists using supplied schemas and include recorded field-manager hints without overwrite/deletion recommendations.
  • Place API deadlines at the first affected version; add dockershim/token/PSP milestones and node runtime/OS dependency reviews.
  • Collect Jobs/ReplicaSets/HPAs and select known older served beta APIs.
  • Expose plan_aks via an operator-fixed MCP profile; no generation or deployment tool.

Linux-first validation. Live AKS execution, independent vendor-matrix verification, Terraform provider execution, CEL/admission and API conversion remain outside coverage. Offline by default; only explicit collection contacts the selected API server.

v0.2.0-alpha.3

v0.2.0-alpha.3 Pre-release
Pre-release

Choose a tag to compare

@github-actions github-actions released this 15 Nov 22:23

v0.2.0-alpha.3

한국어

  • scan/plan/diff 보고서를 필수·조건부·선택 조치 요약과 현재 상태/권장 상태 비교 중심으로 개선했습니다.
  • 문제별 이유, 다음 조치, 검증 방법과 공식 근거를 제공합니다. HTML의 원본 근거·해시는 펼쳐볼 수 있습니다.
  • --lang ko로 한국어 설명을 선택할 수 있습니다. 기본은 영어이며 원본 근거 문구는 영어로 남을 수 있습니다. JSON/MCP 계약은 유지합니다.
  • CPU·메모리 적정값은 실측 필요로 표시하며, 임의의 수치나 자동 패치를 생성하지 않습니다. drift는 무조건 되돌리기 권고가 아닙니다.
  • README를 빠른 시작·실제 보고서 미리보기·명령어 색인·펼쳐보는 터미널 예시로 재구성했습니다. 영어 기본과 별도 한국어판을 유지합니다.

보고서 표현을 개선한 알파 릴리스입니다. 실제 앱/커널 호환성, 패치별 의미 검증, 자동 인프라 생성 등 기존 검사 한계는 그대로 적용됩니다. Linux/macOS와 Windows 64/32비트, 두 명령 이름을 유지합니다.

English

  • Redesign scan/plan/diff reviews around required/conditional/optional counts and current-versus-recommended comparisons.
  • Show reasons, next actions, verification and references; keep original evidence and hashes in expandable HTML details.
  • Add --lang en|ko for readable review explanations. English is the default; original evidence may remain English. JSON and MCP contracts are unchanged.
  • Require measurements for numeric CPU/memory sizing; do not invent resource values or generate automatic patches. Drift is not a blind-revert recommendation.
  • Reorganize the English/Korean READMEs around quick start, real report previews, a command index and expandable terminal examples, with documented primary references.

This alpha improves presentation without extending compatibility guarantees or applying changes. Existing inspection limits and Linux/macOS/Windows amd64/x86 distributions remain.

v0.2.0-alpha.2

v0.2.0-alpha.2 Pre-release
Pre-release

Choose a tag to compare

@github-actions github-actions released this 15 Nov 11:48

v0.2.0-alpha.2

한국어

  • 검사·차이 비교·계획·수집 요약에 --format markdown 및 --format html 추가. versions도 두 형식을 지원합니다.
  • Markdown 표/목록과 독립 실행형 HTML 보고서에 JSON과 같은 근거·미검사 항목을 유지합니다. HTML은 외부 리소스나 스크립트를 로딩하지 않습니다.
  • README에 모든 명령의 설명, 실행/저장 예시, 결과 해석 및 종료 코드를 추가했습니다. 실제 생성한 Markdown/HTML 예제도 제공합니다.
  • 입력 문자열의 마크업을 이스케이프하며 출력 실패를 오류로 처리합니다. 발견 사항이 있는 보고서의 종료 코드 1을 유지합니다.

Linux/macOS/Windows amd64·x86 배포 범위와 두 명령 이름을 유지합니다. 이 릴리스는 보고서 표현을 확장하며 검사 범위와 기존 한계는 변경하지 않습니다.

English

  • Add --format markdown and --format html for inspection, drift, plans and collection summaries; versions supports both formats too.
  • Preserve JSON report evidence and unchecked areas in Markdown tables/lists and standalone HTML. HTML loads no external assets or scripts.
  • Document every command with usage, saved-report examples, interpretation and exit codes; include generated Markdown/HTML examples.
  • Escape input-controlled markup, report output-write failures and preserve findings exit code 1.

Retains Linux/macOS and Windows amd64/x86 distributions and both command names. This release expands presentation without changing inspection coverage or existing limitations.

v0.2.0-alpha.1

v0.2.0-alpha.1 Pre-release
Pre-release

Choose a tag to compare

@github-actions github-actions released this 15 Nov 11:32

v0.2.0-alpha.1

한국어

Kubernetes 검사 엔진을 확장한 알파 버전입니다. Go/Helm/kubectl 없이 Linux, macOS, Windows 10+에서 실행할 수 있습니다. Windows x86/amd64와 두 명령 kubewiser, kubewise 지원을 유지합니다. Windows ZIP에는 EXE 하나와 두 명령 등록용 설치 스크립트가 포함됩니다.

  • 공식 Kubernetes 1.16~1.37 .0 OpenAPI 스키마 22개 내장, 출처/해시 공개, CRD 로컬 검증, unknown field/type/required 검사.
  • deprecated/removed API 규칙, 조건부 권고, List 재귀 처리, 입력 제한과 위치/근거/미검사 결과.
  • 명시한 클러스터·namespace의 GET 전용 스냅샷 수집. 속도·페이지·시간·개수 제한, RBAC 누락 기록, Secret 제외와 지정 필드 제거.
  • 로컬 Helm 렌더링 및 snapshot drift 비교. 외부 의존 다운로드나 apply 없음.
  • 버전별 업그레이드 단계·조치, kubelet skew 확인, 기존 Hubble 기록과 NetworkPolicy 격리 의도 분석, EKS/AKS/GKE 이전 의존 계획.
  • 같은 엔진의 MCP 도구 확장. 모델이 파일 경로나 클러스터 범위를 바꿀 수 없으며 수집 도구는 명시적으로 활성화할 때만 제공.

변경 사항: 보고서 형식 v2, JSON 기본 출력, 소스 빌드 최소 Go 1.26. 실행 파일에는 Go 설치 불필요. 분석은 오프라인이며 텔레메트리가 없습니다. 명시적 수집은 선택한 API 서버와 통신합니다. MCP 클라이언트의 데이터 처리는 별도입니다.

범위: 마이너 .0 스키마 기준으로 패치별 의미 차이, admission/CEL, 실제 앱·커널 호환성, 완전한 네트워크 허용 경로, 자동 인프라 생성/데이터 이전은 검증하지 않습니다. Helm values.schema.json과 live lookup은 사용하지 않습니다. 인증 exec 플러그인/프록시는 차단합니다. 운영 클러스터나 실제 Windows 10 장비에서 검증했다는 의미는 아닙니다.

English

This alpha expands the inspection engine while retaining standalone Linux/macOS and Windows 10+ amd64/x86 distributions and the equivalent kubewiser / kubewise commands. Windows ZIPs ship one EXE and a script registering both names through hardlinks. No Go, Helm or kubectl installation is needed to run the binaries.

  • Embed 22 official Kubernetes 1.16–1.37 .0 OpenAPI bundles with source URLs and hashes; validate local CRDs, unknown fields, types and schema-required fields.
  • Separate API deprecation/removal and conditional recommendations; recursively inspect Lists with bounded inputs, source positions, evidence and unchecked areas.
  • Collect explicit context/namespace snapshots using bounded GET-only requests, pagination, time/item limits, gap reporting and targeted redaction; never collect Secrets.
  • Render local vendored Helm charts and compare desired resources with snapshots; no dependency downloads or apply operations.
  • Generate minor upgrade steps/actions and kubelet skew checks; analyze existing Hubble flows, NetworkPolicy isolation intent and EKS/AKS/GKE migration dependencies.
  • Expose the same engine through scoped MCP tools; model-controlled paths and cluster scope are not accepted. Collection requires explicit operator opt-in.

Changes: report format v2, JSON default output and Go 1.26 minimum for source builds. Runtime analysis is offline with no telemetry. Explicit collection contacts the selected API server. MCP client/model data handling is separate.

Limits: .0 schemas do not establish patch-specific semantics, admission/CEL correctness, actual application/kernel compatibility or complete network reachability. No infrastructure template generation or data migration is performed. Helm values.schema.json and live lookup are not used; exec auth plugins and proxies are blocked. Mock/API and CI validation are not production-cluster or physical Windows 10 validation. See repository documentation for exact coverage.

kubewiser v0.1.0-alpha.5 — 자동 명령 등록 / Automatic command registration

Choose a tag to compare

@github-actions github-actions released this 15 Nov 10:46

kubewiser v0.1.0-alpha.5

한국어 | English

한국어

Windows 두 명령 자동 등록

Windows ZIP은 kubewiser.exe 한 개와 install.ps1을 제공합니다. 압축을 푼 폴더에서 PowerShell로 한 번 실행하세요:

.\install.ps1
kubewiser --version
kubewise --version

설치기는 사용자 로컬 폴더에 EXE 한 벌을 설치하고 하드링크로 두 이름을 등록한 뒤 사용자 PATH를 추가합니다. 두 파일명이 보이지만 같은 파일 데이터를 참조합니다. PowerShell 별칭이나 프로필 수정 없이 PowerShell/CMD 모두 사용할 수 있습니다. 기존 터미널 앱은 저장된 PATH 반영을 위해 재시작이 필요할 수 있습니다.

관리자 권한·네트워크 연결은 필요 없습니다. 로컬 NTFS 등 하드링크 지원 파일시스템이 필요하며 미지원 시 복제하지 않고 실패합니다. 다운로드한 스크립트가 정책에 의해 차단되면 조직의 서명/차단 해제 절차를 따르세요. 설치기가 실행 정책을 낮추지는 않습니다.

같은 버전 재설치는 멱등이며, 다른 바이너리는 새 해시별 디렉터리에 설치됩니다. 이전 버전 디렉터리와 PATH 항목은 자동 삭제하지 않습니다. 설치 충돌은 기존 파일을 덮어쓰지 않고 거부합니다. 이전 PowerShell 별칭이나 시스템 PATH의 동명 명령이 있으면 해제/정리가 필요할 수 있습니다.

고도화 계획

로드맵과 레퍼런스를 추가했습니다. P0 입력/보고서 → P1 로컬 스키마/버전 규칙 → P2 읽기 전용 수집 → P3 Helm/drift → 업그레이드·관측·클라우드 이전 순서입니다. 이 단계들은 계획이며 이번 릴리스에 구현된 검사 기능이 아닙니다.

검증·제약

Windows PowerShell 5.1에서 설치·재실행·충돌 보호와 CMD/PowerShell 두 명령 실행을 검증합니다. Windows 32/64비트 모두 제공하며 CI는 Windows Server 2022/WOW64입니다. Windows 10 실기기 검증은 미완료입니다. Windows는 미서명, macOS는 Developer ID 서명·공증 미적용입니다. 기존 초기 알파 검사 범위(1.16~1.32 입력, YAML 및 일부 API 제거 규칙)와 미검사 항목은 유지됩니다. 외부 텔레메트리·자동 리포팅·스키마 다운로드는 추가하지 않았습니다. MCP 클라이언트의 외부 전달은 별도입니다.

English

Automatic registration of both Windows commands

Windows ZIPs include one kubewiser.exe plus install.ps1. Run once in PowerShell from the extracted directory:

.\install.ps1
kubewiser --version
kubewise --version

The installer places one executable in user-local storage, creates two hardlink names, and updates user PATH. Two names are visible, but they share the same file data. PowerShell and CMD work without shell aliases or profile changes. Restart existing terminal applications if needed to refresh PATH.

No administrator privileges or network requests are required. A local hardlink-capable filesystem such as NTFS is required; unsupported filesystems fail instead of copying a second executable. Follow organizational signing/unblocking procedures if script execution policy prevents installation. The installer does not weaken execution policy.

Same-version installation is idempotent. Different binaries use separate content-hash directories; old version directories and PATH entries are retained for manual cleanup. Conflicting files are not overwritten. Existing aliases or same-name commands earlier in system PATH may require cleanup.

Development plan

Added a roadmap and primary references: input/report quality, local schemas/version rules, read-only snapshots, Helm/drift, then upgrade/observability/cloud migration. These are planned stages, not newly implemented inspection features.

Validation and limits

Windows PowerShell 5.1 tests cover installation, repeat runs, conflict protection, and both commands in PowerShell/CMD. Windows x86/x64 are provided; CI uses Windows Server 2022/WOW64, not Windows 10 devices. Windows binaries remain unsigned; macOS binaries are not Developer ID signed or notarized. Existing alpha inspection scope (1.16–1.32 inputs, YAML and selected removed API rules) and unchecked areas are unchanged. No external telemetry, automatic reporting or schema downloads are added. MCP client forwarding is a separate concern.

kubewiser v0.1.0-alpha.4 — Windows 단일 EXE / Single Windows executable

Choose a tag to compare

@github-actions github-actions released this 15 Nov 10:35

kubewiser v0.1.0-alpha.4

한국어 | English

한국어

Windows 배포 ZIP에는 이제 kubewiser.exe 하나만 포함됩니다. 중복 kubewise.exe는 제외했습니다. Windows 32비트(x86)는 windows_386.zip, 64비트는 windows_amd64.zip을 선택하세요. Go·WSL 설치는 필요 없습니다.

두 명령 사용

압축을 푼 폴더의 PowerShell에서:

Set-Alias -Name kubewise -Value (Resolve-Path .\kubewiser.exe).Path
.\kubewiser.exe --version
kubewise --version
kubewise scan files --target-version 1.32 --format json "C:\deploy manifests"

현재 PowerShell 세션에 적용됩니다. 영구 등록은 PowerShell 프로필($PROFILE)에 실제 설치 경로를 지정해 Set-Alias -Name kubewise -Value 'C:\Tools\kubewiser\kubewiser.exe'를 추가하세요. kubewiser도 경로 없이 실행하려면 실행 파일 폴더를 PATH에 추가합니다. CMD의 현재 대화형 세션에서는 doskey kubewise="C:\Tools\kubewiser\kubewiser.exe" $*를 사용할 수 있습니다. 별칭은 실제 실행 파일이 아니므로 MCP 클라이언트·배치 스크립트에는 kubewiser.exe의 절대 경로를 사용하세요.

유지 사항 및 검증

  • Linux·macOS 배포본은 두 실행 이름을 계속 제공합니다. 소스 설치 경로 cmd/kubewise도 유지됩니다.
  • Windows amd64/386 CI에서 단일 EXE와 PowerShell 별칭의 JSON 결과·종료 코드 일치를 검증합니다.
  • Windows 10이 대상이나 자동 테스트는 Windows Server 2022/WOW64에서 수행합니다. Windows 10 실기기 검증은 미완료입니다. Windows는 미서명, macOS는 Developer ID 서명·공증 미적용입니다.
  • 초기 알파 검사 범위(YAML·일부 제거된 API, 목표 입력 1.16~1.32)는 변경되지 않습니다. 전체 스키마·클러스터·마이그레이션 검사는 미구현입니다.
  • 외부 텔레메트리·자동 리포팅은 없습니다. MCP 결과의 외부 전달은 클라이언트 설정에 달려 있습니다.
  • Assets의 checksums.txt와 다운로드한 파일의 SHA-256을 비교하세요 (Get-FileHash 파일명 -Algorithm SHA256).

English

Windows ZIPs now contain only kubewiser.exe. The duplicate kubewise.exe is removed. Choose windows_386.zip for 32-bit x86 or windows_amd64.zip for 64-bit Windows. No Go or WSL installation is needed.

Using both names

In PowerShell, from the extracted folder:

Set-Alias -Name kubewise -Value (Resolve-Path .\kubewiser.exe).Path
.\kubewiser.exe --version
kubewise --version
kubewise scan files --target-version 1.32 --format json "C:\deploy manifests"

This applies to the current PowerShell session. For persistence, add Set-Alias -Name kubewise -Value 'C:\Tools\kubewiser\kubewiser.exe' to your PowerShell profile ($PROFILE), using the actual installation path. Add the executable directory to PATH for the bare kubewiser command. In an interactive CMD session, use doskey kubewise="C:\Tools\kubewiser\kubewiser.exe" $*. Aliases are not standalone executables: configure MCP clients and batch scripts with the absolute kubewiser.exe path.

Retained behavior and validation

  • Linux/macOS archives retain both executable names. The cmd/kubewise source installation path remains available.
  • Windows amd64/386 CI verifies matching JSON results and exit codes between the single EXE and its PowerShell alias.
  • Targets Windows 10; automated tests use Windows Server 2022/WOW64. Windows 10 device validation is not complete. Windows binaries are unsigned; macOS binaries are not Developer ID signed or notarized.
  • Initial alpha inspection scope is unchanged (YAML and selected removed APIs, target inputs 1.16–1.32). Full schema, live-cluster and migration inspection remain unimplemented.
  • No external telemetry or automatic reporting. External forwarding of MCP results depends on the client.
  • Compare the download SHA-256 with checksums.txt in Assets (Get-FileHash FILENAME -Algorithm SHA256).

kubewiser v0.1.0-alpha.3 — 두 명령·Windows 32비트 / Dual commands & Windows x86

Choose a tag to compare

@github-actions github-actions released this 15 Nov 10:30

kubewiser v0.1.0-alpha.3

한국어 | English

한국어

추가 기능

  • kubewiser와 kubewise 두 명령 지원. 공통 CLI를 사용하며 옵션, 검사 결과, 종료 코드, MCP 동작이 같습니다. 버전 출력의 제품명은 둘 다 kubewiser입니다.
  • 모든 배포 파일에 두 실행 파일 포함. Windows는 kubewiser.exe와 kubewise.exe이며 셸 별칭이나 Go 설치가 필요 없습니다.
  • Windows 10 32비트 x86 ZIP 추가: kubewiser_v0.1.0-alpha.3_windows_386.zip.
  • Windows 64비트는 windows_amd64.zip을 사용하세요. Linux·macOS amd64/arm64도 계속 제공합니다. 배포 파일 6개 모두 SHA-256 체크섬 제공.

사용

압축을 풀고 PowerShell에서 실행합니다. 다운로드한 ZIP의 SHA-256을 checksums.txt와 비교하려면 Get-FileHash 파일명 -Algorithm SHA256을 사용하세요.

.\kubewiser.exe --version
.\kubewise.exe --version
.\kubewise.exe scan files --target-version 1.32 --format json "C:\deploy manifests"
.\kubewise.exe mcp --input "C:\deploy manifests"

Linux·macOS에서는 두 실행 파일을 PATH에 포함된 폴더에 설치하면 됩니다. Go 소스 설치 경로도 cmd/kubewiser와 cmd/kubewise 두 개를 제공합니다.

검증 및 제약

  • Windows amd64와 386 각각 CI에서 테스트·빌드·실행하며, 한글·공백 경로와 두 명령의 JSON 결과 및 종료 코드 일치를 확인합니다.
  • CI는 Windows Server 2022이며 32비트 실행은 WOW64를 사용합니다. Windows 10 또는 순수 32비트 OS 실기기 검증은 수행하지 않았습니다.
  • Windows는 서명 미적용, macOS는 Developer ID 서명·공증 미적용입니다. Windows ARM64와 Linux/macOS 32비트 배포본은 포함하지 않습니다.
  • 초기 알파 검사 범위는 그대로입니다: YAML 문법·중복 키·필수 문자열·일부 제거된 API. 목표 버전 입력은 1.16~1.32이며 전체 호환성을 보증하지 않습니다.
  • 전체 스키마·List 내부 검사·Helm 직접 렌더링·클러스터 수집/drift·네트워크/OS/앱 영향·클라우드 이전·자동 수정은 미구현입니다.
  • 외부 텔레메트리·자동 리포팅은 없습니다. MCP 결과(경로·해시·검사 정보)의 클라우드 전달 여부는 연결한 클라이언트 설정에 달려 있습니다.

English

Additions

  • Both kubewiser and kubewise commands are supported through one shared CLI. Options, inspection results, exit codes and MCP behavior are identical. Both version banners retain the product name kubewiser.
  • Every archive contains both executables (kubewiser.exe and kubewise.exe on Windows). No shell alias or Go installation is required.
  • Added a Windows 10 32-bit x86 ZIP: kubewiser_v0.1.0-alpha.3_windows_386.zip.
  • Use windows_amd64.zip on 64-bit Windows. Linux/macOS amd64/arm64 remain available. Checksums cover all six archives.

Usage

Extract the archive and run from PowerShell. Compare the ZIP's SHA-256 with checksums.txt using Get-FileHash FILENAME -Algorithm SHA256.

.\kubewiser.exe --version
.\kubewise.exe --version
.\kubewise.exe scan files --target-version 1.32 --format json "C:\deploy manifests"
.\kubewise.exe mcp --input "C:\deploy manifests"

On Linux/macOS, install both executables into a directory on PATH. Go source installation supports both cmd/kubewiser and cmd/kubewise.

Validation and limitations

  • Windows amd64 and 386 CI runs tests, builds and executables, checking Unicode/spaced paths and identical JSON output/exit codes for both commands.
  • CI uses Windows Server 2022; 32-bit executables run under WOW64. Windows 10 and native 32-bit OS device validation has not been performed.
  • Windows executables are unsigned; macOS binaries are not Developer ID signed or notarized. Windows ARM64 and Linux/macOS 32-bit archives are not included.
  • Initial alpha inspection coverage is unchanged: YAML syntax, duplicate keys, required strings and selected removed APIs. Target inputs are 1.16–1.32, not a guarantee of complete compatibility.
  • Full schemas, List item inspection, direct Helm rendering, live collection/drift, network/OS/application impact, cloud migration and automatic remediation are not implemented.
  • No external telemetry or automatic reporting is added. Forwarding MCP results (paths, hashes, findings) to cloud services depends on the connected client's settings.

kubewiser v0.1.0-alpha.2 — Windows 10 x64 지원 / Windows 10 x64 support

Choose a tag to compare

@github-actions github-actions released this 15 Nov 10:21

kubewiser v0.1.0-alpha.2

한국어 | English

한국어

변경 사항

  • Windows 10 이상 x64(Intel/AMD)용 ZIP 배포본 추가: kubewiser_v0.1.0-alpha.2_windows_amd64.zip.
  • Go·WSL 설치 없이 PowerShell/CMD에서 kubewiser.exe 실행.
  • Windows CI: 검사 엔진·MCP 테스트, 정적 검사, 실행 파일 빌드, 한글·공백 경로와 JSON 결과 검증.
  • 기존 Linux·macOS amd64/arm64 배포 유지. 전체 배포 파일의 SHA-256 체크섬 제공.
  • 한국어·영어 릴리스 노트를 저장소에서 관리하고 릴리스 자동화에 반영.

Windows 설치와 실행

Assets에서 Windows ZIP과 checksums.txt를 다운로드합니다. 아래 해시를 체크섬 파일의 해당 항목과 비교한 후 압축을 해제하세요.

Get-FileHash .\kubewiser_v0.1.0-alpha.2_windows_amd64.zip -Algorithm SHA256
Expand-Archive .\kubewiser_v0.1.0-alpha.2_windows_amd64.zip -DestinationPath .\kubewiser
cd .\kubewiser
.\kubewiser.exe --version
.\kubewiser.exe scan files --target-version 1.32 --format json "C:\deploy manifests"
.\kubewiser.exe mcp --input "C:\deploy manifests"

더블클릭하는 GUI가 아닌 콘솔 프로그램입니다. CLI 옵션은 입력 경로 앞에 지정합니다. 종료 코드: 0=수행한 검사에서 발견 사항 없음, 1=발견 사항 있음, 2=인자/실행 오류.

지원 범위 및 검증 한계

  • Windows 10 64비트가 대상이며 32비트·ARM64 Windows 배포본은 포함하지 않습니다.
  • Go 공식 최소 요구사항에 따라 Windows 10을 대상으로 합니다. 자동 실행 검증은 Windows Server 2022에서 수행하며, Windows 10 실기기 검증을 완료했다는 의미는 아닙니다.
  • Windows 실행 파일은 Authenticode 서명 미적용이며 SmartScreen 경고가 표시될 수 있습니다. macOS는 Developer ID 서명·공증 미적용입니다.
  • 검사 기능은 초기 알파 범위입니다: YAML 문법·중복 키·필수 문자열·일부 제거된 API 검사. 목표 버전 입력은 1.16~1.32이며 전체 호환성을 보증하지 않습니다.
  • 전체 스키마, List 내부 항목, Helm 직접 렌더링, 클러스터 수집·drift, 네트워크·OS·앱 영향, 클라우드 이전·자동 수정은 미구현입니다. Helm은 별도 렌더링이 필요합니다.
  • 외부 텔레메트리·자동 리포팅은 없습니다. MCP는 연결한 클라이언트에 파일 경로·해시·검사 정보를 반환하므로 클라우드 전송 여부는 클라이언트 설정에 달려 있습니다.

English

Changes

  • Added a Windows 10+ x64 (Intel/AMD) ZIP: kubewiser_v0.1.0-alpha.2_windows_amd64.zip.
  • Run kubewiser.exe from PowerShell or CMD without installing Go or WSL.
  • Added Windows CI for scanner/MCP tests, static checks, executable builds, Unicode/spaced paths, and JSON output.
  • Retained Linux/macOS amd64/arm64 archives. SHA-256 checksums cover every distribution archive.
  • Bilingual release notes are now maintained in the repository and used by release automation.

Windows installation and usage

Download the Windows ZIP and checksums.txt from Assets. Compare the hash with its entry in the checksum file before extraction.

Get-FileHash .\kubewiser_v0.1.0-alpha.2_windows_amd64.zip -Algorithm SHA256
Expand-Archive .\kubewiser_v0.1.0-alpha.2_windows_amd64.zip -DestinationPath .\kubewiser
cd .\kubewiser
.\kubewiser.exe --version
.\kubewiser.exe scan files --target-version 1.32 --format json "C:\deploy manifests"
.\kubewiser.exe mcp --input "C:\deploy manifests"

This is a console application, not a double-click GUI. Place options before the input path. Exit codes: 0 = no findings in performed checks; 1 = findings; 2 = argument/operational failure.

Support and validation limits

  • Targets Windows 10 64-bit; Windows 32-bit and ARM64 binaries are not included.
  • Windows 10 is targeted according to the Go minimum requirements. Automated runtime checks run on Windows Server 2022, not a Windows 10 desktop. Windows 10 device validation has not been performed.
  • Windows binaries are not Authenticode-signed and may trigger SmartScreen. macOS binaries are not Developer ID signed or notarized.
  • Inspection remains initial-alpha functionality: YAML syntax, duplicate keys, required strings, and selected removed APIs. Accepted target versions are 1.16–1.32; this is not complete compatibility coverage.
  • Full schemas, List item inspection, direct Helm rendering, live collection/drift, network/OS/application impact, cloud migration, and automatic remediation are not implemented. Render Helm separately.
  • No external telemetry or automatic reporting is added. MCP returns paths, hashes and inspection data to its client; cloud forwarding depends on the client's configuration.

kubewiser v0.1.0-alpha.1 — 첫 알파 릴리스 / Initial Alpha Release

Choose a tag to compare

@github-actions github-actions released this 15 Nov 10:12

kubewiser v0.1.0-alpha.1

한국어 | English

한국어

첫 공개 알파 릴리스입니다. Kubernetes manifest를 오프라인으로 검사하는 CLI와 로컬 MCP 서버를 제공합니다. 전체 Kubernetes 진단 제품은 아직 개발 중입니다.

다운로드

Go 설치 없이 압축을 풀어 실행할 수 있습니다.

환경 파일
Linux Intel/AMD 64비트 kubewiser_v0.1.0-alpha.1_linux_amd64.tar.gz
Linux ARM64 kubewiser_v0.1.0-alpha.1_linux_arm64.tar.gz
macOS Intel kubewiser_v0.1.0-alpha.1_darwin_amd64.tar.gz
macOS Apple Silicon kubewiser_v0.1.0-alpha.1_darwin_arm64.tar.gz

아래 Assets에서 해당 파일을 다운로드하세요. 각 압축에는 kubewiser, LICENSE, README.md가 들어 있습니다. checksums.txt와 build-info.txt도 제공합니다.

포함된 기능

  • YAML 문법, 중복 매핑 키, 문서 형태, apiVersion/kind 필수 문자열 검사
  • 일부 제거된 Kubernetes API 탐지 및 변경 안내
  • 파일/디렉터리 및 다중 문서 YAML 입력
  • JSON 또는 텍스트 보고서: 규칙 ID, 위치, 파일 SHA-256, 공식 근거 URL, 미검사 범위
  • 로컬 stdio MCP scan_files: 입력 경로는 운영자가 실행 시 고정
  • --version: 버전, Git 커밋, 실행 플랫폼 표시

사용 예시

./kubewiser --version
./kubewiser scan files --target-version 1.32 --format json ./deploy
./kubewiser mcp --input /absolute/path/to/manifests

검사 옵션은 입력 경로 앞에 지정합니다. 종료 코드는 0=수행한 검사에서 발견 사항 없음, 1=발견 사항 있음, 2=인자/실행 오류입니다.

검증

Linux amd64/arm64 및 macOS Intel/Apple Silicon CI에서 테스트, 정적 검사, 빌드 및 버전 출력 실행을 검증했습니다. 릴리스 작업에서 배포 파일을 생성하고 SHA-256 체크섬을 확인합니다.

알려진 제약

  • 초기 규칙 표의 목표 버전 입력은 1.16~1.32입니다. 해당 버전의 모든 호환성을 검사한다는 의미는 아닙니다. 범위 밖 버전은 명시적으로 오류를 반환합니다.
  • 전체 Kubernetes/CRD 스키마, 모든 알 수 없는 필드, metadata/spec 의미 검증은 미구현입니다.
  • List 내부 항목은 검사하지 않으며 검토 필요 결과를 반환합니다.
  • Helm은 별도로 렌더링한 manifest를 입력해야 합니다.
  • 클러스터 수집, 상태 차이, 네트워크/OS/앱 영향 분석, 클라우드 이전 및 자동 수정은 미구현입니다.
  • 보고서는 미검사 범위를 포함하며, 종료 코드 0이 완전한 호환성을 보증하지 않습니다.
  • macOS 배포본은 Apple Developer ID 서명·공증이 적용되지 않았습니다. 다운로드 후 macOS 보안 승인이 필요할 수 있습니다.

데이터 처리

현재 실행 파일에는 외부 텔레메트리·통계·오류 리포팅·자동 업데이트 기능이 없습니다. CLI는 로컬 출력, MCP는 연결한 클라이언트로 결과를 반환합니다. MCP 결과에는 파일 경로·해시·검사 정보가 포함되며, 클라이언트가 클라우드 모델에 전달하는지는 클라이언트 설정에 달려 있습니다. 완전한 외부 전송 금지가 필요하면 로컬 실행과 외부 통신 차단을 함께 적용하세요.

설치 및 무결성 확인

압축 파일의 SHA-256을 checksums.txt의 해당 항목과 비교하세요. Linux는 sha256sum 파일명, macOS는 shasum -a 256 파일명을 사용합니다.

# Linux amd64 예시; 다른 플랫폼은 압축 파일명만 변경
 tar -xzf kubewiser_v0.1.0-alpha.1_linux_amd64.tar.gz
 mkdir -p "$HOME/.local/bin"
 install -m 0755 kubewiser "$HOME/.local/bin/kubewiser"
 export PATH="$HOME/.local/bin:$PATH"
 kubewiser --version

이후 터미널에서도 사용하려면 PATH 설정을 셸 설정 파일에 추가하세요.


English

This is the first public alpha release. It provides an offline Kubernetes manifest inspection CLI and a local MCP server. The broader Kubernetes diagnostics feature set is still under development.

Downloads

Extract and run the binary. No Go installation is required.

Platform Archive
Linux Intel/AMD 64-bit kubewiser_v0.1.0-alpha.1_linux_amd64.tar.gz
Linux ARM64 kubewiser_v0.1.0-alpha.1_linux_arm64.tar.gz
macOS Intel kubewiser_v0.1.0-alpha.1_darwin_amd64.tar.gz
macOS Apple Silicon kubewiser_v0.1.0-alpha.1_darwin_arm64.tar.gz

Download the matching archive from Assets below. Each archive contains kubewiser, LICENSE, and README.md. SHA-256 checksums and build metadata are available as checksums.txt and build-info.txt.

Included features

  • Checks for YAML syntax, duplicate mapping keys, document shape, and required apiVersion/kind strings
  • Detection of selected removed Kubernetes APIs, with migration guidance
  • File/directory input and multi-document YAML support
  • JSON or text reports with rule IDs, source locations, file SHA-256 hashes, official evidence URLs, and unchecked areas
  • Local stdio MCP scan_files tool; the operator fixes the input path at startup
  • --version output showing the version, Git commit, and runtime platform

Usage

./kubewiser --version
./kubewiser scan files --target-version 1.32 --format json ./deploy
./kubewiser mcp --input /absolute/path/to/manifests

Place scan options before the input path. Exit codes: 0 = no findings in the checks performed; 1 = findings detected; 2 = invalid arguments or operational failure.

Validation

Tests, static checks, builds, and version-output execution passed in CI on Linux amd64/arm64 and macOS Intel/Apple Silicon. The release workflow builds the distribution archives and verifies their SHA-256 checksums.

Known limitations

  • The initial rule table accepts target versions 1.16–1.32. This does not mean complete compatibility coverage for those releases. Targets outside this range return an explicit error.
  • Full Kubernetes/CRD schema validation, comprehensive unknown-field detection, and metadata/spec semantic validation are not implemented.
  • Items inside List documents are not inspected; these documents produce a review finding.
  • Helm charts must be rendered separately before inspection.
  • Live cluster collection, drift detection, network/OS/application impact analysis, cloud migration, and automatic remediation are not implemented.
  • Reports identify unchecked areas. Exit code 0 does not guarantee full compatibility.
  • macOS archives are not Apple Developer ID signed or notarized. macOS may require explicit security approval after download.

Data handling

The current executable has no external telemetry, analytics, error reporting, or automatic update functionality. The CLI writes results locally; MCP returns results to the connected client. MCP results include file paths, hashes, and inspection information. Whether a client forwards those results to a cloud model depends on its configuration. For environments that prohibit all external transmission, combine local execution with outbound network restrictions.

Installation and integrity verification

Compare the archive's SHA-256 hash with its entry in checksums.txt. Use sha256sum FILENAME on Linux or shasum -a 256 FILENAME on macOS.

# Linux amd64 example; substitute the archive name for other platforms.
tar -xzf kubewiser_v0.1.0-alpha.1_linux_amd64.tar.gz
mkdir -p "$HOME/.local/bin"
install -m 0755 kubewiser "$HOME/.local/bin/kubewiser"
export PATH="$HOME/.local/bin:$PATH"
kubewiser --version

Add the PATH setting to your shell configuration to use the command in future terminals.