> For the complete documentation index, see [llms.txt](https://cocktailcloud.gitbook.io/cube/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://cocktailcloud.gitbook.io/cube/overview/release-note.md). # Release ## Latest History ### v1.3.5 > 2026.2.23 * Features * 쿠버네티스 패치 버전 업 : v1.31.13, v1.32.11, v1.33.7, v1.34.3 * 설치 대상 network 방화벽 점검 기능 (cubectl preflight) * Enhancement * 이미지 Repository 변경 ( cube.acloud.run/cube/cube:latest → registry.k3.acornsoft.io/cube/cube:latest) * ansible password 연결 방식 지원 ( private-key & password 방식 2종 지원) * Bugfixes * cubectl v1.2.2로 설치된 클러스터 cubectl v1.3를 사용해 업그레이드 오류 문제 * Python v3.6 이 설치된 노드 프로비저닝 오류 * Harbor 설치 시 간헐적 설치 오류 ### v1.3.4 > 2025.10.13 * Features * 쿠버네티스 버전 추가 지원 : v1.34.0 * 쿠버네티스 패치 버전 업 : v1.30.14, v1.31.12, v1.32.8, v1.33.4 * Container runtime cri-o 제공 * Kubeflow 지원 * UI provider별 개요 기능 * Gpu-operator image prepare 과정 추가 * 서버 이전으로 인한 이미지 명 변경(registry.k3.acornsoft.io/cube/cube:tag) * Bugfixes * Upgrade 시도 시 의도치 않은 playbook 실행 문제 수정 * Online 환경 containerd 설치 문제 수정 * Enhancements * UI package version upgrade * Documentations * Kubeflow 설치 문서 ### v1.3.3 > 2025.06.30 * Features * 쿠버네티스 버전 추가 지원 : v1.33.1 * 쿠버네티스 패치 버전 업 : v1.28.15, v1.29.15, v1.30.13, v1.31.9, v1.32.5 * Ubuntu24.04 지원 * Console - Provider(Openstack) 조회 기능 * Console cluster template 생성 기능 * Harbor trivy DB 최신화 * Bugfixes * API fetch 중 overlay가 정상적으로 동작하지 않던 문제 수정 * API에서 작동하지 않던 조건 문제 수정 * Template을 이용해서 Control Plane 설정 복사 시 모든 항목이 동일 적용되던 문제 수정 * DB에 저장된 정보와 실제 클러스터의 정합성 유지 * SSH 반복 접속 횟수 조정 * Enhancements * Docker CSAP 관련 Harbor 로직 변경 * Refactoring * Add control plane node 로직 변경 * Documentations * REST-API 문서 업데이트 ### v1.3.2 (hotfix) > 2025.05.12 * Features * Cilium CNI 제공 (addon 기능) * Bugfixes * 쿠버네티스 버전 업그레이드 후 인증서 만료일이 1년으로 변경되는 현상 * REST-API sync 요청 시 데이터베이스 저장 못하는 오류 * Enhancements * console card 컴포넌트 toggle 기능 제공 * console 클러스터 보기화면 kubeconfig download 기능 제공 외 * Refactoring * console 변수형식 개선, enum → const * console 에러 및 이미지 파일 소스 위치 변경 * Documentations * REST-API 문서 업데이트 * kubelet root 디렉토리 변경 방법 사용자 메뉴얼 * Cilium CNI addon 설치 사용자 메뉴얼 ## Upcoming Release * (기능) CUBE Web Console 업그레이드 * (기능) 설치 전 인프라 검증 및 설치 후 클러스터 검증 지원 * (개선) `cubectl.toml` 리뉴얼 ## Release History ### v1.3.1 > 2025.04.17 * Features * 쿠버네티스 버전 추가 지원 : v1.32.2 * 쿠버네티스 패치 버전 업 : v1.28.15, v1.29.15, v1.30.10, v1.31.6, EOS v1.27 * CUBE Web Console * 클러스터 생성, 목록, 조회, 제거 기능 * 프로바이더 목록, 생성, 조회, 삭제 기능 * 클러스터 템플릿 목록, 생성, 조회, 삭제 기능 * 클러스터 보안 취약점 개선 (CIS-Benchmark, 92.4%) * ARM CPU 아키텍처 지원 개선 * Oracle 9 리눅스 배포판 지원 * cis-driver-nsf 4.10.10 버전 업 ### v1.3.0 (hotfix) > 2025.01.03 * Features * EOS Linux distributions * CentOS 7,8 * RedHat7 * 컴포넌트 버전 업 * containerd : v1.6.28 → v1.7.24 * etcd : v3.5.7 → v3.5.17 * helm : v3.10.3 → v3.16.4 * docker-compose : v2.24.5 → v2.32.0 * regctl : v0.7.1 → v0.8.0 * 컨테이너 이미지 버전 업 * calico : v3.28.0 → v3.29.1 * haproxy : 2.9.4 → 3.1.1 * nginx : 1.25.3 → 1.27.3 * nfsplugin : \[v4.6.0, v4.8.0] → \[v4.6.0, v4.8.0, v4.9.0] * csi-provisioner : v4.0.0 → v5.0.2 * csi-snapshotter : v6.3.3 → v8.0.1 * csi-node-driver-registrar : v2.10.0 → v2.11.1 * livenessprobe : v2.12.0 → v2.13.1 * snapshot-controller : v6.3.3 → v8.0.1 ### v1.2.4 > 2024.12.17 * Features * 쿠버네티스 클러스터 OpenStack 자동 설치 * CUBE API (RESTful API) * "cubecli" to "CUBE" 마이그레이션 * `cubectl push` 명령어 - 리눅스 패키지 및 이미지 업로드 * `cubectl destroy localrepo` 명령어 * 애드온 버전 선택 설치 기능 * Kubernetes v1.31 지원 * GPU operator v24.9.0 지원 * 컴포넌트 버전 업 * metrics-server v0.7.2 * nfsplugin v4.8.0 * Bugfixes * 온라인 설치 시 redhat 계열 설치 안되는 현상 * audit-log를 false 일 경우 클러스터 생성 실패 오류 * 클러스터 boolean 타입 설치 옵션 default 값 지정 오류 * 동일 호스트 대상으로 폐쇄망으로 설치 후 온라인 재설치 안되는 현상 * redhat8, redhat7 멀티 설치 및 iptables 관련 오류 * 실행 런타임 오류 발생 후 ERROR\[0007] 디스플레이되고 끝나는 현상 * registry, repository 인벤토리 잘못 지정되는 현상 * upgrade 명령 실행 시 cubectl.toml 에 private-registry ip, private\_ip 둘다 기입했을 경우 설치 실패하는 현상 * control-plane 노드 추가 안되는 현상 * Improvement * 기본제공 'cubectl.toml\` 누락 옵션 반영 * kubelet extra-args 옵션 map 방식으로 처리 * 실행 Timeout 을 90분으로 증가, 단일 Task timeout 은 20분에서 60분으로 변경 * 패키지 다운로드 시 "VERSION" 을 입력하지 않을 경우 alpha, beta 버전이 다운로드 되는 현상 개선 * metrics-server control-plane 노드에 설치 * destroy, upgrade, update-kubeconfig 명령 node annotation 반영 * Enhancement * cubectl.toml 로컬 레파지토리 섹션 추가, private-registry 섹션과 분리 * CUBE API 데이터베이스 sqlite 적용 및 기타 기능 향상 * "private-key" Flag 필수 체크 ### v1.2.3 (hotfix) > 2024.10.31 * Features * 어노테이션을 통해 노드별로 SSH 계정, 포트 별도 지정 기능 * 어노테이션을 통해 노드 스케일-인 수행 시 노드별로 삭제 대상 노드 목록에서 제외 지정 기능 ### v1.2.2 > 2024.10.15 * Features * GPU Operator 애드온 다운로드 서비스 * metrics-server, network-cni(calico), haproxy 애드온 설치 여부 옵션 추가 * nfs-cis-driver v4.8.0으로 버전 업 * Control-Plane 스케일 인/아웃 기능 * Kubernetes v1.30 및 패치버전 추가 지원: v1.30.4, v1.29.8, v.28.13, v1.27.16 * Bugfixes * 버전 업그레이드 시 calico vxlan 모드인 경우 워크로드간 통신하지 못하는 현상, always 옵션 적용 * 온라인 설치 시 centos9에서 local repository 설정 누락 오류 * 클러스터 이름이 적용되지 않는 현상 * nfs-utils 패키지 설치 시 종속성 문제 - allowerasing 옵션 추가 * 멀티 클러스터에서 이미지 레지스트리 공유할 경우 인증서 다운로드 URL 가져오지 못하는 문제 * 설치옵션(extravars.cube) boolean type default 값 지정 오류 * 폐쇄망 설치 시 CentOS7 노드에서 패키지들 간 의존성 에러 발생 문제 * 폐쇄망 환경에서 podman archive 파일 찾지 못해 CUBECTL 실행하지 못하는 현상 * Improvement * CUBE 다운로드 서비스 개선 및 도메인 이슈 * 리눅스 Local Repository 지원 종료 및 URL 변경이슈 개선 - CentOS 8(stream), CentOS 7, RHEL 7 * 이미지 레지스트리 도메인과 IP간 변경 기능 * 이미지 레지스트리 admin 비밀번호 옵션 적용 * 워커노드 haproxy 헬스체크 포트 "8081" 에서 "8054"로 변경 * 온라인 모드로 설치한 클러스터를 페쇄망 환경으로 전환가능하도록 개선 * Enhancement * 버전이 지정되지 않은 CUBECTL 인 경우 CUBE 이미지를 항상 최신 버전(latest) 을 pull 하도록 개선 * CUBECTL 로그 개선 ### v1.2.1 (hotfix) > 2024.07.12 * Bugfixes * storage 서버 삭제 시 사용되지 않는 변수 삭제 * artifacts 로그 갯수 제한 * 실행 Timeout 시간 7200초로 증가 * calico vxlan mode default-value값 CrossSubnet 에서 Always 로 변경 * addon data-dir 파라미터 제거하고 values 파일에 default-value 지정 * 폐쇄망에서 storage server 설치되지 않는 현상 ### v1.2.0 > 2024.06.28 * Features * 리눅스 배포판 5종 추가 지원 (centos9 | rhel9 | rocky9 | ubuntu2304 | ubuntu2310) * 멀티 CPU Architecture 지원 (amd64, arm64) * 애드온 구조 개선 * 멀티 클러스터 프로비저닝 기능 * cubectl 실행 환경(Container Runtime) 추가 지원 (podman (default), docker, containerd) * 사설 레지스트리(harbor) IP 변경 기능 * Enhancement/Improvement * Default pod cird 수정 (10.4.0.0/16) * calico, metrics-server 컴포넌트 버전업 * Addons 별 차트 버전관리 방식 개선 * Refactoring * 멀티 클러스터 설치를 위한 구조 개선 * Bugfixes * v1.0.x 로 설치 클러스터 업그레이드 시 누락된 Image 추가 * 폐쇄망 Centos8 노드 설치 오류 * Storage 서버 패키지 설치 오류 ### v1.1.0 > 2024.03.20 * Features * Kubernetes Legacy Package Repositories Frozen 대응 * Kubernetes v1.28 지원 * Bugfixes * v1.0.x 로 설치 클러스터 업그레이드 시 누락된 Image 추가 * 폐쇄망 Centos8 노드 설치 오류 * Storage 서버 패키지 설치 오류 * Enhancement * 폐쇄망 설치 리눅스 패키지 종속성 관리 방식 개선 * Harbor HTTP 서비스 포트 8081번으로 변경 * Improvement * Addons 별 차트 버전관리 방식 개선 * Refactoring * Duplicate 코드 개선 * 폐쇄망 container image archive 파일 업로드 개선 * Documentation * Image Registry IP 또는 도메인 변경 매뉴얼 제공 ### v1.0.5 (hotfix) > 2024.01.16 * Bugfixes * "ubuntu2004/ubuntu2204" 단일 리눅스 배포판으로 구성된 클러스터에서 "Failed to update apt cache: E:Failed to fetch file:/data/localrepo/ubuntu2004/./Packages File not found" 오류 ### v1.0.4 > 2024.01.12 * Features * Worker-node calicoctl 설치 * GPU Time Slicing & MIG(multi instance GPU) Addon 지원 * umask 027 설정 호스트 설치 지원 * Enhancement * addon.toml "values\_file" 개선 ### v1.0.3 > 2023.12.05 * Bugfixes * 각 노드에서 파일 및 디렉토리 생성 시 항상 권한 지정하도록 수정 * private-registry를 포함한 클러스터에서 Update를 통해 추가된 노드에서 인증서가 없는 오류 * Update 시 이전 변경 사항 확인하는 과정에서 변경 대상 노드를 가져오지 못하는 오류 * lbip를 입력해도 masterip가 lbip로 입력되는 오류 * Improvement * Terraform/Openstack 기반 CI 파이프라인을 통한 테스트 자동화 반영 ### v1.0.2 > 2023.10.16 * Features * RedHat Enterprise Linux 7.9 지원 * Bugfixes * 리눅스 로컬 저장소 구성 시 Packages.gz 파일 권한 오류 * 폐쇄망 패키지 다운로드 오류 * Enhancement * 폐쇄망 설치 시 파일 유효성 체크 개선 * K8S 패치 버전까지 지정해서 폐쇄망 패키지 파일 다운로드 가능하도록 개선 * Refactoring * K8S 패치 버전까지 폐쇄망 패키지 파일 세분화 ### v1.0.1 > 2023.09.08 * Features * CentOS7 지원 (v7.8, v7.9) * 멀티 OS 지원 동시 설치 지원 (6종, 일부 os 기능 제한) * Kubernetes v1.27 지원 * 칵테일 다운로드 URL () 제공 * Bugfixes * 노드별로 다른 python 명령어 위치로 인해 발생하는 mitogen tool disable 오류 * 온라인 환경에서 사설 저장소만 설치할 경우 설치 오류 * `destroy` 시 이전 network-cni 설정 정보 유지되는 현상 * Cluster Configuration endpoint를 lb-ip로 지정하여 노드 join 안되는 현상 * 구버전의 cubectl로 설치한 클러스터가 v1.0.0 버전으로 업그레이드 안되는 오류 * 워커 노드수를 축소해서 업데이트 했을 경우 오류 메시지 출력 현상 * 워커 노드수를 0개에서 1개이상 증가 시킨후 `update` 실행 시 오류 * `update` 실행 시 신규 노드 경우 label 누락되는 현상 * 클러스터 프로비저닝 이후 추가된 노드에 대한 업그레이드 오류 * Improvement * etcd secret control-plane 노드에서 중복으로 생성되는 현상 개선 * api-server 인증서에 첫번째 컨트롤플랜 노드 ip가 포함되는 현상 개선 * Harbor 인증서 생성 방식 개선 * 폐쇄망 설치용 archive tar 파일 개선 및 버전 세분화 * Enhancement * GPU노드를 위한 nvidia 관련 패키지 추가 * calico v3.26 업그레이드 * 에드온 cis-driver-nfs 업그레이드 * Refactoring * 사용하지 않는 cubectl.toml 정리 * mitogen-v0.2.9(extends ansible tools) 제거 ### v1.0.0 > 2023.06.12 * Create a Cluster * Delete a Cluster * Add & Remove worker nodes * Kubernetes version upgrade --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://cocktailcloud.gitbook.io/cube/overview/release-note.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.