From efb5adc639332de95c0af1f6ea5da9fa244e3a18 Mon Sep 17 00:00:00 2001 From: wbsong111 Date: Wed, 20 Aug 2025 15:05:06 +0900 Subject: [PATCH] Add custom-values.yaml, CUSTOM-README.md, BUILD-README.md --- charts/starrocks-operator/BUILD-README.md | 74 ++++++++++++++++++++ charts/starrocks-operator/CUSTOM-README.md | 74 ++++++++++++++++++++ charts/starrocks-operator/custom-values.yaml | 42 +++++++++++ 3 files changed, 190 insertions(+) create mode 100644 charts/starrocks-operator/BUILD-README.md create mode 100644 charts/starrocks-operator/CUSTOM-README.md create mode 100644 charts/starrocks-operator/custom-values.yaml diff --git a/charts/starrocks-operator/BUILD-README.md b/charts/starrocks-operator/BUILD-README.md new file mode 100644 index 0000000..c4767d9 --- /dev/null +++ b/charts/starrocks-operator/BUILD-README.md @@ -0,0 +1,74 @@ +# StarRocks Operator 버전 갱신 가이드 +StarRocks Operator Helm Chart의 버전의 갱신할 경우 작업의 시작은 항상 main에서 이루어져야 한다. + +## 1. git 작업 환경 구성 +- 서비스 카탈로그 git 다운로드 +``` +$ git clone https://github.com/paasup/dip-catalog.git +``` + +- 작업 브랜치로 체크아웃 +``` +$ git checkout -b update-starrocks-operator/1.11.0 +``` + +## 2. 차트 갱신 +- BUILD-README.md, CUSTOM-README.md, custom-values.yaml을 제외한 파일 삭제 + ``` sh + # chart 디렉토리로 이동 + cd ~/dip-catalog/charts/starrocks-operator + + # 파일 삭제 전 삭제할 파일 목록 확인 + find . -mindepth 1 \( -name "CUSTOM-README.md" -o -name "BUILD-README.md" -o -name "custom-values.yaml" \) -prune -o -print + + # 파일 삭제 + find . -mindepth 1 \( -name "CUSTOM-README.md" -o -name "BUILD-README.md" -o -name "custom-values.yaml" \) -prune -o -exec rm -rf {} + + ``` + +- starrocks-operator 차트 다운로드 + ``` sh + # charts 디렉토리로 이동 + cd ~/dip-catalog/charts + + # helm repo 추가 + helm repo add starrocks https://starrocks.github.io/operator + helm repo update + + # helm 차트 조회 + helm search repo starrocks/operator + + # helm 차트 다운로드 + helm pull starrocks/operator --version=1.11.0 + + # 차트 압축 해제 및 이름 변경 + tar xzvf operator-*.tgz + mv -r operator/* starrocks-operator + + # 필요 없는 파일 삭제 + rm -rf operator + rm operator-*.tgz + ``` + +## 3. github에 tag 추가 +- 갱신작업 진행후 commit +``` +$ git add . +$ git commit -m "update-starrocks-operator/1.11.0" +``` + +- main 브랜치에 체크아웃 후 merge +``` +$ git checkout main +$ git merge update-starrocks-operator/1.11.0 +``` + +- git에 push 후 작업 브랜치 삭제 +``` +$ git push -u origin main +$ git branch -d update-starrocks-operator/1.11.0 +``` + +- git tag 추가 후 push +``` +$ git tag starrocks-operator/1.11.0 +$ git push origin starrocks-operator/1.11.0 \ No newline at end of file diff --git a/charts/starrocks-operator/CUSTOM-README.md b/charts/starrocks-operator/CUSTOM-README.md new file mode 100644 index 0000000..14ee432 --- /dev/null +++ b/charts/starrocks-operator/CUSTOM-README.md @@ -0,0 +1,74 @@ + +# StarRocks Operator 배포 + +## 1. 배포 방법 + +### 1) 배포시 주의 사항 + +- StarRocks Operator는 StarRocks 클러스터를 관리하는 Kubernetes Operator입니다 +- 배포 전 적절한 RBAC 권한이 설정되어 있어야 합니다 +- Kubernetes 1.18.0 이상 버전이 필요합니다 + +### 2) 배포 방법 + +``` sh +git clone https://github.com/paasup/dip-catalog.git +cd charts/starrocks-operator +helm upgrade starrocks-operator ./ -f custom-values.yaml --install -n starrocks-operator --create-namespace +``` + +## 2. custom-values.yaml 설명 + +- custom-values.yaml에 정의된 값에 대한 설명이다. + +### 1) 기본 설정 + +| Name | 설명 | 기본값 | +| ---------------------- | ------------------------------------------------------------ | ------ | +| `timeZone` | 시간대 설정 | `"Asia/Shanghai"` | +| `image.repository` | 오프라인 설치 시에 설정. 내부 저장소 타겟으로 변경 | `"starrocks/operator"` | +| `image.tag` | 이미지 태그 설정 | `"v1.11.0"` | +| `image.pullPolicy` | 이미지 Pull 정책 | `"IfNotPresent"` | + +### 2) Resource 설정 + +``` yaml +resources: + limits: + cpu: 500m + memory: 512Mi + requests: + cpu: 500m + memory: 400Mi +``` + +### 3) Node Selector 설정 + +``` yaml +nodeSelector: + kubernetes.io/os: linux + +tolerations: [] + +affinity: {} +``` + +### 4) Webhook 설정 + +``` yaml +webhook: + enabled: true + port: 9443 + certManager: + enabled: false +``` + +### 5) Monitoring 설정 + +``` yaml +metrics: + enabled: true + port: 8080 + serviceMonitor: + enabled: false +``` diff --git a/charts/starrocks-operator/custom-values.yaml b/charts/starrocks-operator/custom-values.yaml new file mode 100644 index 0000000..fcbb599 --- /dev/null +++ b/charts/starrocks-operator/custom-values.yaml @@ -0,0 +1,42 @@ +# StarRocks Operator Custom Values + +timeZone: Asia/Seoul + +# Operator image configuration +image: + repository: starrocks/operator + tag: "v1.11.0" + pullPolicy: IfNotPresent + +# Resource limits and requests +resources: + limits: + cpu: 500m + memory: 512Mi + requests: + cpu: 500m + memory: 400Mi + +# Node selector +nodeSelector: + kubernetes.io/os: linux + +# Tolerations +tolerations: [] + +# Affinity +affinity: {} + +# Webhook configuration +webhook: + enabled: true + port: 9443 + certManager: + enabled: false + +# Metrics configuration +metrics: + enabled: true + port: 8080 + serviceMonitor: + enabled: false \ No newline at end of file