# opentelemetry-collector 버전 갱신 가이드

> **카탈로그 업데이트 방식**: 기존 버전 디렉토리는 유지하고, 신규 버전 디렉토리를 새로 생성한다.
> `manifests/helm/opentelemetry-collector/<new-version>/` 디렉토리를 직접 추가하는 방식으로 관리한다.

## 1. git 작업 환경 구성

- dip-catalog git 다운로드
```sh
git clone https://github.com/paasup/dip-catalog.git
```

- 작업 브랜치로 체크아웃
```sh
git checkout -b update-opentelemetry-collector/<new-version>
```

## 2. helm chart 업데이트

### 1) 기존 버전 디렉토리 복사

신규 버전 디렉토리를 기존 버전에서 복사하여 시작한다.
`BUILD-README.md`, `CUSTOM-README.md`, `custom-values.yaml`가 함께 복사된다.

```sh
cd ~/dip-catalog/manifests/helm/opentelemetry-collector

# 기존 버전에서 신규 버전 디렉토리 복사
cp -r 0.156.2 <new-version>
```

### 2) 업스트림 차트 파일 업데이트

신규 버전 디렉토리에서 업스트림 차트 파일만 교체한다.
`BUILD-README.md`, `CUSTOM-README.md`, `custom-values.yaml`는 유지한다.

```sh
cd ~/dip-catalog/manifests/helm/opentelemetry-collector

# helm repo 추가
helm repo add open-telemetry https://open-telemetry.github.io/opentelemetry-helm-charts
helm repo update

# 신규 버전 차트 다운로드 후 압축 해제
helm pull open-telemetry/opentelemetry-collector --version="<new-version>"
tar xzvf opentelemetry-collector-<new-version>.tgz -C <new-version> --strip-components=1

# 불필요한 파일 삭제
rm opentelemetry-collector-<new-version>.tgz
```

## 3. git push 및 tag 추가

```sh
git add .
git commit -m "update opentelemetry-collector/<new-version>"
git checkout main
git merge update-opentelemetry-collector/<new-version>
git push -u origin main
git branch -d update-opentelemetry-collector/<new-version>
git tag opentelemetry-collector/<new-version>
git push origin opentelemetry-collector/<new-version>
```

## 4. 차트 버전 정보

- opentelemetry-collector/0.156.2
  - Chart version: 0.156.2
  - App version: 0.152.0
  - 업스트림: https://open-telemetry.github.io/opentelemetry-helm-charts
  - 이미지: otel/opentelemetry-collector-contrib (contrib 배포판)