QueryPie 커뮤니티 버전 설치 가이드
🧭 시작하기 전에 QueryPie ACP Community 버전은 QueryPie Enterprise에서 제공하는 핵심 기능을 체험해 볼 수 있는 버전입니다. - Database Access Controller - System Access Controller - Kubernetes Access Controller - Web Access Controller
단, Community 버전은 최대 5명의 사용자 계정이 활성화 가능합니다.
(5명 이상 사용자 등록이 필요하다면, Enterprise 플랜으로 확장해보세요.)
QueryPie ACP는 일반적인 Web Application 방식으로 작동하며, Proxy 기반의 Network Server 기능도 포함되어 있습니다.
🖥️ 서버 권장 사양
QueryPie ACP 커뮤니티 버전을 원활하게 설치하고 운영하기 위해 아래 환경을 권장합니다.
| 구분 | 사양 |
| --- | --- |
| 기본 사양 | - Hardware : AMD64 Architecture, CPU 4 vCPUs, Memory 16 GiB, Disk 100 GiB+ - AWS EC2 : m6i.xlarge, m7i.xlarge - GCP Compute Engine : c4-standard-4, n4-standard-4 (or AMD64 architecture -standard-4 models) |
| 시험 사용 | - Hardware: ARM64 Architecture, 4 vCPUs, Memory 16 GiB, Disk 30 GiB+ - AWS EC2 : t4g.xlarge, m7g.xlarge - OS: Linux or macOS with Docker |
| 다수 이용자 운영환경의 권장 사양 | - Hardware: AMD64 Architecture, 8 vCPUs, Memory 32 GiB, Disk 100 GiB+ - AWS EC2 : m6i.2xlarge, m7i.2xlarge - GCP Compute Engine : c4-standard-8, n4-standard-8 (or AMD64 architecture -standard-8 models) |
| OS | Linux with Docker or Podman |
ARM64 Architecture CPU 환경 또는 macOS 환경은 개발자를 위한 시험사용, 테스트 용도로 권장합니다.
자세한 요구사항은 아래 문서를 참고해주세요:
📄 Prerequisites for Installation - Single Machine (Korean)
🐳 설치 방법 설치는 Docker Image 기반이며, 한 줄 명령어로 자동 설치가 가능합니다.
1. 터미널에서 명령 실행하기
Linux 서버의 터미널에 접속한 뒤, 홈 디렉토리에서 아래 명령을 입력하세요:
```code
bash <(curl https://dl.querypie.com/setup.v2.sh)
```
⏱️ 설치에는 약 7~10분 정도 소요됩니다.
2. 설치되는 동안 라이선스 발급 받기
QueryPie ACP Community Edition은 라이선스 등록이 필요합니다.
설치 되는 동안 라이선스 발급 신청서를 통해 신청하면, 입력한 이메일로 .crt 형식의 텍스트 파일이 발송됩니다.
3. 설치 후 접속하기
설치가 완료되면 브라우저에서 다음 주소로 접속합니다:
``code
http://<서버 IP 주소>
또는
https://<서버 IP 주소>
``
설치한 리눅스 서버의 IP 주소는 이용자의 PC 에서 접근 가능한 IP 주소를 사용하여야 합니다.
4. 라이선스 등록하기 이메일로 받은 .crt 파일을 업로드하거나 PEM 형식 텍스트 내용을 복사/붙여넣기 하세요.
5. 로그인하기
아래 기본 계정으로 로그인을 합니다.
최초 로그인 시, 자동으로 비밀번호 변경 절차가 시작되니 안전하게 새 비밀번호를 설정하고 사용을 시작하세요.
- ID: qp-admin
- Password: querypie
6. 설치 완료 🎉 축하합니다! 설치가 완료되었습니다. 이제 관리자 매뉴얼을 참고해 환경 설정을 진행하시면 됩니다.
