Skip to content

mdx: Helm 버전 선택 안내 및 문제 해결 섹션 업데이트 #591

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
jk-kim0 merged 2 commits into from
Jan 30, 2026
Merged

mdx: Helm 버전 선택 안내 및 문제 해결 섹션 업데이트 #591

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
8234ad8
mdx: Updates from Confluence
jk-kim0 Jan 30, 2026
b2682f9
mdx: 영어/일본어 번역 추가 (한국어 문서 변경 대응)
jk-kim0 Jan 30, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
11 changes: 8 additions & 3 deletions src/content/en/installation/installation/installing-on-aws-eks.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -551,10 +551,15 @@ config:
#### 4.3 QueryPie Installation

Install QueryPie ACP using Helm.

Select the Helm version according to the [Product Versions](../product-versions) of QueryPie ACP.

* QueryPie ACP 11.3.0 or later: Use the latest version of Helm Chart 1.5.0 or higher.
* QueryPie ACP before 11.3.0: Use Helm Chart 1.4.4.

The Chart version in this document is provided as an example.
```bash
helm upgrade --install poc querypie/querypie --version 1.4.4 -n querypie -f values.yaml
helm upgrade --install poc querypie/querypie --version 1.5.0 -n querypie -f values.yaml
```

Run database migration.
Expand Down Expand Up @@ -641,10 +646,10 @@ Key problem statuses and checks:
* `ImagePullBackOff`: Check Container Registry authentication information
* When using Docker Hub: Check `registry: docker.io` setting in `values.yaml`, verify `imagePullSecrets: []` setting
* When using Harbor: Verify `querypie-regcred` Secret creation
* `logrotator` image error: Check `logrotator.enabled: false` setting (logrotator image is not provided on Docker Hub)
* `logrotator` image error: Check `logrotator.enabled: false` setting (logrotator image is not provided on Docker Hub)
* `Pending`: Check if node resources are insufficient
* `CrashLoopBackOff`: Check application errors through logs
* `Table 'querypie.system_settings' doesn't exist` error: DB migration not executed → Need to run `migrate.sh runall` command
* `Table 'querypie.system_settings' doesn't exist` error: DB migration not executed → Need to run `migrate.sh runall` command

##### 5.2.2 Check Service Connections

Expand Down
11 changes: 8 additions & 3 deletions src/content/ja/installation/installation/installing-on-aws-eks.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -551,10 +551,15 @@ config:
#### 4.3 QueryPieインストール

Helmを使用してQueryPie ACPをインストールします。

QueryPie ACPの[製品バージョン](../product-versions)に従って、Helmバージョンを選択します。

* QueryPie ACP 11.3.0以降：Helm Chart 1.5.0以上の最新バージョンを使用してください。
* QueryPie ACP 11.3.0より前：Helm Chart 1.4.4を使用してください。

この文書のChartバージョンは例として示されたものです。
```bash
helm upgrade --install poc querypie/querypie --version 1.4.4 -n querypie -f values.yaml
helm upgrade --install poc querypie/querypie --version 1.5.0 -n querypie -f values.yaml
```

データベースマイグレーションを実行します。
Expand Down Expand Up @@ -641,10 +646,10 @@ kubectl logs <pod-name> -n querypie --previous # Check previous logs if restart
* `ImagePullBackOff`: Container Registry認証情報確認
* Docker Hub使用時：`values.yaml`で`registry: docker.io`設定確認、`imagePullSecrets: []`設定確認
* Harbor使用時：`querypie-regcred` Secret作成有無確認
* `logrotator`イメージエラー時：`logrotator.enabled: false`設定確認（Docker Hubではlogrotatorイメージが提供されません）
* `logrotator`イメージエラー時：`logrotator.enabled: false`設定確認（Docker Hubではlogrotatorイメージが提供されません）
* `Pending`: ノードのリソース不足の有無確認
* `CrashLoopBackOff`: ログを通じてアプリケーションエラー確認
* `Table 'querypie.system_settings' doesn't exist`エラー：DBマイグレーション未実行 → `migrate.sh runall`コマンド実行が必要
* `Table 'querypie.system_settings' doesn't exist`エラー：DBマイグレーション未実行 → `migrate.sh runall`コマンド実行が必要

##### 5.2.2 サービス接続確認

Expand Down
11 changes: 8 additions & 3 deletions src/content/ko/installation/installation/installing-on-aws-eks.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -551,10 +551,15 @@ config:
#### 4.3 QueryPie 설치

Helm을 사용하여 QueryPie ACP 를 설치합니다.

QueryPie ACP 의 [제품 버전](../product-versions)에 따라, Helm 버전을 선택합니다.

* QueryPie ACP 11.3.0 또는 이후: Helm Chart 1.5.0 이상의 최신 버전을 사용하세요.
* QueryPie ACP 11.3.0 이전: Helm Chart 1.4.4 를 사용하세요.

이 문서의 Chart 버전은 예시로 제시된 것입니다.
```bash
helm upgrade --install poc querypie/querypie --version 1.4.4 -n querypie -f values.yaml
helm upgrade --install poc querypie/querypie --version 1.5.0 -n querypie -f values.yaml
```

데이터베이스 마이그레이션을 실행합니다.
Expand Down Expand Up @@ -641,10 +646,10 @@ kubectl logs <pod-name> -n querypie --previous # Check previous logs if restart
* `ImagePullBackOff`: Container Registry 인증 정보 확인
* Docker Hub 사용 시: `values.yaml`에서 `registry: docker.io` 설정 확인, `imagePullSecrets: []` 설정 확인
* Harbor 사용 시: `querypie-regcred` Secret 생성 여부 확인
* `logrotator` 이미지 오류 시: `logrotator.enabled: false` 설정 확인 (Docker Hub에서는 logrotator 이미지가 제공되지 않음)
* `logrotator` 이미지 오류 시: `logrotator.enabled: false` 설정 확인 (Docker Hub에서는 logrotator 이미지가 제공되지 않음)
* `Pending`: 노드의 리소스 부족 여부 확인
* `CrashLoopBackOff`: 로그를 통해 애플리케이션 오류 확인
* `Table 'querypie.system_settings' doesn't exist` 오류: DB 마이그레이션 미실행 → `migrate.sh runall` 명령 실행 필요
* `Table 'querypie.system_settings' doesn't exist` 오류: DB 마이그레이션 미실행 → `migrate.sh runall` 명령 실행 필요

##### 5.2.2 서비스 연결 확인

Expand Down