From 902a2a75c998afbe216c8ea0943e490165aca18d Mon Sep 17 00:00:00 2001 From: JK Date: Sat, 21 Feb 2026 16:26:05 +0900 Subject: [PATCH] docs(ko): proofread installation --- src/content/ko/installation.mdx | 1 - .../container-environment-variables.mdx | 2 -- .../optimizing-dbmaxconnectionsize.mdx | 1 - .../querypieweburl.mdx | 1 - src/content/ko/installation/installation.mdx | 1 - .../comparison-of-setupsh-and-setupv2sh.mdx | 2 -- .../installation-guide-setupv2sh.mdx | 2 -- .../installation-guide-simple-configuration.mdx | 2 -- .../installation/installing-on-aws-eks.mdx | 8 ++++---- .../ko/installation/license-installation.mdx | 1 - .../ko/installation/post-installation-setup.mdx | 16 ++++++++-------- src/content/ko/installation/prerequisites.mdx | 1 - .../configuring-rootless-mode-with-podman.mdx | 2 -- ...ribution-and-docker-podman-support-status.mdx | 1 - src/content/ko/installation/product-versions.mdx | 1 - .../querypie-acp-community-edition.mdx | 9 ++++----- .../mcp-configuration-guide.mdx | 2 -- .../server-configuration-requirements.mdx | 4 ++-- .../on-premise-vm-requirements.mdx | 1 - ...blic-cloud-production-server-requirements.mdx | 1 - ...server-configuration-requirements-summary.mdx | 4 ++-- ...m-architecture-and-network-access-control.mdx | 1 - 22 files changed, 20 insertions(+), 44 deletions(-) diff --git a/src/content/ko/installation.mdx b/src/content/ko/installation.mdx index 530c51b75..652d2eecf 100644 --- a/src/content/ko/installation.mdx +++ b/src/content/ko/installation.mdx @@ -19,4 +19,3 @@ QueryPie ACP는 모든 버전에 대해 사전 빌드된 Docker 이미지를 제 * [QueryPie ACP Community Edition](installation/querypie-acp-community-edition) * [MCP 설정 가이드](installation/querypie-acp-community-edition/mcp-configuration-guide) - diff --git a/src/content/ko/installation/container-environment-variables.mdx b/src/content/ko/installation/container-environment-variables.mdx index ffc479542..303c3c744 100644 --- a/src/content/ko/installation/container-environment-variables.mdx +++ b/src/content/ko/installation/container-environment-variables.mdx @@ -239,5 +239,3 @@ Redis 와 QueryPie Container 를 재시작하게 되면, QueryPie Container 가 ### 고급기능을 위한 환경변수 [Environment Variables for Advanced Setup - 10.3.x (KO)](https://querypie.atlassian.net/wiki/spaces/QCP/pages/954597480) 페이지를 참조하세요. - - diff --git a/src/content/ko/installation/container-environment-variables/optimizing-dbmaxconnectionsize.mdx b/src/content/ko/installation/container-environment-variables/optimizing-dbmaxconnectionsize.mdx index dedb70a94..c69d6c77b 100644 --- a/src/content/ko/installation/container-environment-variables/optimizing-dbmaxconnectionsize.mdx +++ b/src/content/ko/installation/container-environment-variables/optimizing-dbmaxconnectionsize.mdx @@ -152,4 +152,3 @@ QueryPie 이용자 수가 적고, 이용량 부하가 낮은 경우, `DB_MAX_CON `DB_MAX_CONNECTION_SIZE` 를 기본값 20이 아닌, 10 또는 5 로 낮추어 설정합니다. PoC 환경의 경우, `DB_MAX_CONNECTION_SIZE` 를 5 로 설정하여도, 일반적인 기능 테스트를 원활히 수행할 수 있습니다. - diff --git a/src/content/ko/installation/container-environment-variables/querypieweburl.mdx b/src/content/ko/installation/container-environment-variables/querypieweburl.mdx index 741829557..6807cf706 100644 --- a/src/content/ko/installation/container-environment-variables/querypieweburl.mdx +++ b/src/content/ko/installation/container-environment-variables/querypieweburl.mdx @@ -49,4 +49,3 @@ Okta에서는 Base URL 입력 시 반드시 https:// 프로토콜을 포함한 U 따라서, 도메인을 포함한 HTTPS URL을 사용하여 설정해 주세요. - diff --git a/src/content/ko/installation/installation.mdx b/src/content/ko/installation/installation.mdx index 9d7dd64d5..12ded97b2 100644 --- a/src/content/ko/installation/installation.mdx +++ b/src/content/ko/installation/installation.mdx @@ -45,4 +45,3 @@ Kubernetes 환경에서 제품을 설치하는 경우 AWS EKS, GCP GKE 등 Manag * AWS EKS 환경 : [AWS EKS 환경에서 설치하기](installation/installing-on-aws-eks) * Helm Chart : [https://github.com/chequer-io/querypie-deployment](https://github.com/chequer-io/querypie-deployment) - diff --git a/src/content/ko/installation/installation/comparison-of-setupsh-and-setupv2sh.mdx b/src/content/ko/installation/installation/comparison-of-setupsh-and-setupv2sh.mdx index 0624894b8..4c7f2a0bb 100644 --- a/src/content/ko/installation/installation/comparison-of-setupsh-and-setupv2sh.mdx +++ b/src/content/ko/installation/installation/comparison-of-setupsh-and-setupv2sh.mdx @@ -100,5 +100,3 @@ jk@host ~ % ./setup.v2.sh --universal # Directory ./querypie/ does not exist. QueryPie has not been installed on this system. Do you want to install QueryPie (11.1.1)? ``` - - diff --git a/src/content/ko/installation/installation/installation-guide-setupv2sh.mdx b/src/content/ko/installation/installation/installation-guide-setupv2sh.mdx index 64137dd9a..1decad6bf 100644 --- a/src/content/ko/installation/installation/installation-guide-setupv2sh.mdx +++ b/src/content/ko/installation/installation/installation-guide-setupv2sh.mdx @@ -180,5 +180,3 @@ Enter the license in PEM format. 설치가 완료된 후 운영 환경에 맞게 초기 설정을 진행해야 합니다. 자세한 설정 절차는 다음 문서를 참조하세요: [설치 후 초기 설정](../post-installation-setup) - - diff --git a/src/content/ko/installation/installation/installation-guide-simple-configuration.mdx b/src/content/ko/installation/installation/installation-guide-simple-configuration.mdx index 2a0b10bb9..b727dd3f4 100644 --- a/src/content/ko/installation/installation/installation-guide-simple-configuration.mdx +++ b/src/content/ko/installation/installation/installation-guide-simple-configuration.mdx @@ -300,5 +300,3 @@ READYZ | '--------------------------------------------------------' 설치가 완료된 후 운영 환경에 맞게 초기 설정을 진행해야 합니다. 자세한 설정 절차는 다음 문서를 참조하세요: [설치 후 초기 설정](../post-installation-setup) - - diff --git a/src/content/ko/installation/installation/installing-on-aws-eks.mdx b/src/content/ko/installation/installation/installing-on-aws-eks.mdx index 8c6a1012e..59b9bb1b8 100644 --- a/src/content/ko/installation/installation/installing-on-aws-eks.mdx +++ b/src/content/ko/installation/installation/installing-on-aws-eks.mdx @@ -373,7 +373,7 @@ helm repo list **참고** : 아래 예시는 Docker Hub를 사용하는 사례를 기준으로 합니다. Harbor Registry 사용 시 `registry: harbor.chequer.io`로 변경하세요. -설치할 제품 버전은 [제품 버전](../product-versions) 문서를 참조하여 지정하세요. +설치할 제품 버전은 [제품 버전](../product-versions) 문서를 참조해 지정하세요. ```yaml # -- appVersion: QueryPie version to install. This is an example value. @@ -594,13 +594,13 @@ kubectl logs pod/poc-querypie-0 -f kubectl port-forward -n querypie statefulsets/poc-querypie 80:80 ``` -이후, 처음 설정 과정을 진행합니다. +이후, 초기 설정을 수행합니다. * [라이선스 설치](../license-installation) -* [설치 후 초기 설정](../post-installation-setup)문서를 참조하여 공통 설정, 제품별 설정을 진행합니다. +* [설치 후 초기 설정](../post-installation-setup) 문서를 참조해 공통 설정과 제품별 설정을 수행합니다. 이것으로 제품 설치 과정이 완료되었습니다. -수고하셨습니다~! +수고하셨습니다. ### 5. 문제 해결 가이드 diff --git a/src/content/ko/installation/license-installation.mdx b/src/content/ko/installation/license-installation.mdx index 996951830..de29e0b84 100644 --- a/src/content/ko/installation/license-installation.mdx +++ b/src/content/ko/installation/license-installation.mdx @@ -225,4 +225,3 @@ ubuntu@querypie:~/querypie/10.2.4$ 지금까지, 기존 라이선스를 교체하여, 새로운 라이선스를 설치하는 과정을 살펴보았습니다. 수고하셨습니다. - diff --git a/src/content/ko/installation/post-installation-setup.mdx b/src/content/ko/installation/post-installation-setup.mdx index f00cadc73..6e20012c0 100644 --- a/src/content/ko/installation/post-installation-setup.mdx +++ b/src/content/ko/installation/post-installation-setup.mdx @@ -52,14 +52,14 @@ Database 연결 설정 과정에서 QueryPie MySQL 의 Hostname, Username, Passw * setup.v2.sh 로 설치한 경우: `.env` 파일 * setup.sh 로 설치한 경우: `compose-env` 파일 -환경변수 파일에 설정된 값 중 `DB_PASSWORD`, `REDIS_PASSWORD`, `KEY_ENCRYPTION_KEY` 등은 안전하게 보관하여야 합니다. +환경변수 파일에 설정된 값 중 `DB_PASSWORD`, `REDIS_PASSWORD`, `KEY_ENCRYPTION_KEY` 등은 안전하게 보관해야 합니다. 다른 사람에게 이 값을 노출하지 않도록 주의하여 주세요. 아래 `` 부분을 고객사의 Proxy 접속 IP 혹은 도메인으로 갈음하여 쿼리를 수행합니다. -해당 주소는 `http` `https` 와 같은 Scheme 을 붙여서는 안 됩니다. +해당 주소는 `http`, `https`와 같은 Scheme을 붙여서는 안 됩니다. ``` UPDATE querypie.proxies SET host = '' WHERE id = 1; @@ -86,10 +86,10 @@ QueryPie Database 에 접속하여, KAC 의 Proxy 접속을 위한 주소를 등 아래 `` 부분을 고객사의 Proxy 접속 IP 혹은 도메인으로 갈음하여 쿼리를 수행합니다. -특이사항으로 DAC/SAC 설정과는 다르게 `http` `https` 와 같은 Scheme을 자유롭게 입력 가능합니다. +특이사항으로 DAC/SAC 설정과는 다르게 `http`, `https`와 같은 Scheme을 자유롭게 입력할 수 있습니다. -설정 후, 내부적으로 등록한 주소에 맞는 TLS 인증서 발급을 위해 QueryPie Container 재기동이 필요합니다. +설정 후 내부적으로 등록한 주소에 맞는 TLS 인증서를 발급하기 위해 QueryPie Container 재기동이 필요합니다. ``` UPDATE querypie.k_proxy_setting SET host = 'https://'; @@ -111,16 +111,16 @@ WAC의 Proxy 접속 주소 설정은 Web Console 에서 수행 가능합니다. 자세한 설정 절차는 다음 문서를 참조하세요: [Web App Configurations에서 WAC 초기 설정하기](../administrator-manual/web-apps/wac-quickstart/initial-wac-setup-in-web-app-configurations) -설정 후, 내부적으로 등록한 주소에 맞는 TLS 인증서 발급을 위해 QueryPie Container 재기동이 필요합니다. +설정 후 내부적으로 등록한 주소에 맞는 TLS 인증서를 발급하기 위해 QueryPie Container 재기동이 필요합니다. ### 제품 설치가 완료되었습니다 -설치 후 초기 설정 과정을 진행한 것으로, QueryPie ACP 제품을 사용할 수 있는 준비가 완료되었습니다. -수고하셨습니다~! +설치 후 초기 설정을 완료했으므로 QueryPie ACP 제품을 사용할 준비가 완료되었습니다. +수고하셨습니다. -이후 다음의 문서를 참조하여, 관리자 설정을 진행하고, 제품을 사용할 수 있습니다. +이후 아래 문서를 참조해 관리자 설정을 진행하고 제품을 사용할 수 있습니다. * [관리자 매뉴얼](../administrator-manual) * [사용자 매뉴얼](../user-manual) diff --git a/src/content/ko/installation/prerequisites.mdx b/src/content/ko/installation/prerequisites.mdx index 7f0f59c6b..88164e873 100644 --- a/src/content/ko/installation/prerequisites.mdx +++ b/src/content/ko/installation/prerequisites.mdx @@ -106,4 +106,3 @@ Docker Compose 를 Compose Tool 이라고 합니다. * Linux OS 의 경우, Debian 9 or later, Ubuntu 16.04 or later, Fedora 30 or later 버전을 사용해야 합니다. * Linux OS 의 경우, headless 모드를 지원하지 않습니다. X-Window, VNC 등을 사용하여 GUI 환경에서 실행해야 합니다. * User Agent 를 사용하지 않고 웹 브라우저만을 이용해 QueryPie 를 사용하는 경우, 이 항목은 무시해도 됩니다. - diff --git a/src/content/ko/installation/prerequisites/configuring-rootless-mode-with-podman.mdx b/src/content/ko/installation/prerequisites/configuring-rootless-mode-with-podman.mdx index c895939b2..5acc7fc87 100644 --- a/src/content/ko/installation/prerequisites/configuring-rootless-mode-with-podman.mdx +++ b/src/content/ko/installation/prerequisites/configuring-rootless-mode-with-podman.mdx @@ -123,5 +123,3 @@ QueryPie를 원활히 운영하려면, `systemctl` 명령을 이용하여 system * Red Hat Enterprise Linux, Rootless Podman 환경에서 systemd service 를 이용해 container 를 자동으로 실행하기 * [https://www.redhat.com/en/blog/container-systemd-persist-reboot](https://www.redhat.com/en/blog/container-systemd-persist-reboot) * [https://docs.redhat.com/en/documentation/red_hat_enterprise_linux/8/html/building_running_and_managing_containers/assembly_porting-containers-to-systemd-using-podman_building-running-and-managing-containers](https://docs.redhat.com/en/documentation/red_hat_enterprise_linux/8/html/building_running_and_managing_containers/assembly_porting-containers-to-systemd-using-podman_building-running-and-managing-containers) - - diff --git a/src/content/ko/installation/prerequisites/linux-distribution-and-docker-podman-support-status.mdx b/src/content/ko/installation/prerequisites/linux-distribution-and-docker-podman-support-status.mdx index 7c95264ab..b79bfb1be 100644 --- a/src/content/ko/installation/prerequisites/linux-distribution-and-docker-podman-support-status.mdx +++ b/src/content/ko/installation/prerequisites/linux-distribution-and-docker-podman-support-status.mdx @@ -321,4 +321,3 @@ QueryPie Server는 두 엔진 모두에서 동등한 품질로 동작하도록 안정성 면에서 RHEL 및 Amazon Linux 대비 변동성이 있으므로, 장기 운영보다는 개발 및 테스트 환경에 적합합니다. QueryPie 운영 환경에 적합하지 않기에, 사용하지 않는 것을 권장합니다. - diff --git a/src/content/ko/installation/product-versions.mdx b/src/content/ko/installation/product-versions.mdx index 820cd5e03..f6718e8e7 100644 --- a/src/content/ko/installation/product-versions.mdx +++ b/src/content/ko/installation/product-versions.mdx @@ -51,4 +51,3 @@ Registry 위치: `harbor.chequer.io/querypie` Community / Standard / Enterprise Edition 모두 동일한 Container Image를 사용합니다. Registry 선택에 따른 기능 차이는 없습니다. - diff --git a/src/content/ko/installation/querypie-acp-community-edition.mdx b/src/content/ko/installation/querypie-acp-community-edition.mdx index 5d2386ff1..b536bb1f7 100644 --- a/src/content/ko/installation/querypie-acp-community-edition.mdx +++ b/src/content/ko/installation/querypie-acp-community-edition.mdx @@ -9,14 +9,14 @@ import { Callout } from 'nextra/components' ### 🧭 시작하기 전에 -**QueryPie Community Edition** 은 **QueryPie Enterprise** 에서 제공되는 핵심 기능을 체험할 수 있도록 합니다. +**QueryPie Community Edition**은 **QueryPie Enterprise**에서 제공되는 핵심 기능을 체험할 수 있도록 합니다. * Database Access Controller * System Access Controller * Kubernetes Access Controller * Web Access Controller -단, Community Edition은 **최대 5명의 사용자 활성화** 를 지원합니다. *(5명 이상을 등록해야 하는 경우,* [ *Standard Edition* ](https://www.querypie.com/plans?acp) *또는* [ *Enterprise Edition* ](https://www.querypie.com/plans?acp) *업그레이드를 고려해 주세요.)* +단, Community Edition은 **최대 5명의 사용자 활성화**를 지원합니다. *(5명 이상을 등록해야 하는 경우,* [ *Standard Edition* ](https://www.querypie.com/plans?acp) *또는* [ *Enterprise Edition* ](https://www.querypie.com/plans?acp) *업그레이드를 고려해 주세요.)* QueryPie는 일반적인 웹 애플리케이션 형태로 실행되며, 프록시 기반 네트워크 서버 기능도 포함하고 있습니다. @@ -246,11 +246,10 @@ QueryPie Community 설치 및 사용 중 궁금한 점이 있으면 [QueryPie AI 1. Integration 탭 → Install QueryPie Customer Center 클릭. 2. Preset 탭 → New Preset 선택 후 아래와 같이 입력하고 `Save Changes` 클릭: -* Name: `QueryPie` 를 입력(권장). -* MCP Servers & Tools: `Select All` 를 선택. +* Name: `QueryPie`를 입력(권장). +* MCP Servers & Tools: `Select All`을 선택. 1. Chat 탭 → `@QueryPie` 선택 후 질문 입력. 또한, [공식 QueryPie Discord 채널](https://discord.com/invite/Cu39M55gMk)에 참여하여 다른 사용자들과 질문과 경험을 공유할 수도 있습니다. - diff --git a/src/content/ko/installation/querypie-acp-community-edition/mcp-configuration-guide.mdx b/src/content/ko/installation/querypie-acp-community-edition/mcp-configuration-guide.mdx index d28ec3467..69a611178 100644 --- a/src/content/ko/installation/querypie-acp-community-edition/mcp-configuration-guide.mdx +++ b/src/content/ko/installation/querypie-acp-community-edition/mcp-configuration-guide.mdx @@ -313,5 +313,3 @@ ______ * 해당 Tool에 필요한 권한이 부여되어 있는지 확인 * 역할이 올바르게 할당되었는지 확인 * IP 허용 목록에 현재 IP가 포함되어 있는지 확인 - - diff --git a/src/content/ko/installation/server-configuration-requirements.mdx b/src/content/ko/installation/server-configuration-requirements.mdx index 6f5e10302..e3b78f85e 100644 --- a/src/content/ko/installation/server-configuration-requirements.mdx +++ b/src/content/ko/installation/server-configuration-requirements.mdx @@ -1,9 +1,9 @@ --- -title: '서버구성 요구사항' +title: '서버 구성 요구사항' confluenceUrl: 'https://querypie.atlassian.net/wiki/spaces/QM/pages/1690402874' --- -# 서버구성 요구사항 +# 서버 구성 요구사항 QueryPie를 설치, 운영하기 위한 서버의 하드웨어 성능과 처리 용량에 대한 가이드를 제공합니다. * [Public Cloud 운영서버 요구사항](server-configuration-requirements/public-cloud-production-server-requirements) diff --git a/src/content/ko/installation/server-configuration-requirements/on-premise-vm-requirements.mdx b/src/content/ko/installation/server-configuration-requirements/on-premise-vm-requirements.mdx index 8a996219d..86b9102c4 100644 --- a/src/content/ko/installation/server-configuration-requirements/on-premise-vm-requirements.mdx +++ b/src/content/ko/installation/server-configuration-requirements/on-premise-vm-requirements.mdx @@ -36,4 +36,3 @@ Production 환경의 운영을 위해, 다음과 같은 구성을 적용하는 높은 처리량이 필요한 경우 권장사양 : CPU 2 vCPUs, Memory 3 GiB 이상 - diff --git a/src/content/ko/installation/server-configuration-requirements/public-cloud-production-server-requirements.mdx b/src/content/ko/installation/server-configuration-requirements/public-cloud-production-server-requirements.mdx index c3af52270..c904df61e 100644 --- a/src/content/ko/installation/server-configuration-requirements/public-cloud-production-server-requirements.mdx +++ b/src/content/ko/installation/server-configuration-requirements/public-cloud-production-server-requirements.mdx @@ -157,4 +157,3 @@ QueryPie 는 기본사양의 VM 1대에서, DAC 기준으로 간단한 쿼리의 * QueryPie 를 신규 도입하는 경우, 내부 이용자에 대해 점진적으로 배포를 수행하며, VM 의 CPU, Memory, Disk IO 사용량 지표를 모니터링하고, 성능이 부족하지 않은지, 모니터링합니다. * 기존 사용 중인 접근제어 시스템이 있는 경우, 이용자의 사용량 지표를 제공받아, 분석합니다. 1일 또는 1주일 정도의 기간 동안, 이용자의 접속 건수, 쿼리 실행 건수, ResultSet 의 크기, 생성된 Audit Log 의 크기 등 사용량 지표를 필요로 합니다. - diff --git a/src/content/ko/installation/server-configuration-requirements/server-configuration-requirements-summary.mdx b/src/content/ko/installation/server-configuration-requirements/server-configuration-requirements-summary.mdx index e967d5126..04e7e8043 100644 --- a/src/content/ko/installation/server-configuration-requirements/server-configuration-requirements-summary.mdx +++ b/src/content/ko/installation/server-configuration-requirements/server-configuration-requirements-summary.mdx @@ -1,9 +1,9 @@ --- -title: '서버구성 요구사항 요약표' +title: '서버 구성 요구사항 요약표' confluenceUrl: 'https://querypie.atlassian.net/wiki/spaces/QM/pages/1692303361' --- -# 서버구성 요구사항 요약표 +# 서버 구성 요구사항 요약표 QueryPie 서버의 하드웨어 처리 용량 요구사항에 대한 가이드를 간단하게 정리한 요약표입니다. diff --git a/src/content/ko/installation/system-architecture-and-network-access-control.mdx b/src/content/ko/installation/system-architecture-and-network-access-control.mdx index fce5ad22b..63081ffb5 100644 --- a/src/content/ko/installation/system-architecture-and-network-access-control.mdx +++ b/src/content/ko/installation/system-architecture-and-network-access-control.mdx @@ -153,4 +153,3 @@ QueryPie 제품의 기능에 따라, 공통, DAC, SAC, KAC, WAC 로 구분합니 | Network Load Balancer
(L4) | TCP / 6443 | querypie:6443 | http://querypie:80/readyz | default | QueryPie Agent (KAC) | | Network Load Balancer
(L4) | TCP / 7447 | querypie:7447 | http://querypie:80/readyz | default | QueryPie Agent (WAC) | -