웹사이트
관리형 애드온: Postgres 및 Redis
The Addons tab lets you attach a managed PostgreSQL database or a managed Redis instance to a site without building or maintaining a server for it. Kapsule provisions it, gives you a connection…
Addons 탭을 사용하면 서버를 구축하거나 유지 관리할 필요 없이 관리형 PostgreSQL 데이터베이스 또는 관리형 Redis 인스턴스를 사이트에 연결할 수 있습니다. Kapsule이 프로비저닝하고 연결 문자열을 제공한 후 제거할 때 깔끔하게 정리합니다.
Addons의 위치
Websites를 열고 사이트를 클릭한 후 사이트 탭 스트립에서 Settings 메뉴를 열고 Addons를 선택합니다. 페이지 제목은 Managed addons입니다.
카탈로그에는 두 가지 옵션이 있습니다:
| Addon | 일반적인 용도 |
|---|---|
| PostgreSQL | MySQL이 아닌 애플리케이션의 기본 데이터 저장소 |
| Redis | 캐싱, 세션 저장소 및 백그라운드 작업 큐 |
이는 표준 호스팅 사이트와 함께 제공되는 MySQL 데이터베이스와는 별개입니다. 해당 데이터베이스는 Files, Database 탭에 있으며 프로비저닝이 필요 없습니다: Connecting To Your Database Over an SSH Tunnel을 참조하세요.
Addon 요청하기
- Add a managed database 섹션에서 addon을 찾습니다.
- Add to site를 클릭합니다.
요청이 즉시 기록되고 addon은 Your addons에 PENDING 배지와 Waiting for provisioner 메모와 함께 나타납니다. 페이지는 15초마다 새로 고쳐지므로 열어두고 있을 수 있습니다.
백그라운드 작업이 몇 분마다 보류 중인 요청을 처리하고 전용 데이터베이스와 사이트의 전용 사용자를 생성한 후 암호화된 연결 문자열을 다시 작성합니다. 그러면 상태가 ACTIVE로 이동합니다.
addon을 요청하거나 제거하려면 sites:write 권한이 필요합니다. 읽기 전용 팀 멤버는 어떤 addon이 있는지와 상태를 볼 수 있지만 버튼은 숨겨집니다.
사이트당 하나씩
사이트는 하나의 PostgreSQL addon과 하나의 Redis addon을 보유할 수 있습니다. 같은 유형의 두 번째를 요청하면 이미 프로비저닝되었다는 메시지와 함께 거부되며 설치되면 카탈로그에서 옵션을 숨깁니다. 둘 다 설치되면 카탈로그 섹션에는 All available addons are installed라고 표시됩니다.
상태 읽기
| 상태 | 의미 |
|---|---|
| PENDING | 요청됨, 프로비저너 대기열에 있음 |
| PROVISIONING | 현재 생성 중 |
| ACTIVE | 사용 준비 완료 |
| FAILED | 프로비저닝이 완료되지 않음, 이유는 행에 표시됨 |
| DELETED | 제거됨, 더 이상 나열되지 않음 |
FAILED 행은 일반적인 메시지 대신 실제 오류 텍스트를 아래에 표시합니다. 이유가 조치할 수 없는 것이라면 지원 티켓에서 그대로 인용하세요: Opening a Support Ticket을 참조하세요.
연결 문자열 얻기
addon이 ACTIVE가 되면 해당 행에 마스크된 연결 문자열이 표시되며 암호는 점으로 바뀌므로 자격 증명을 노출하지 않고 한 눈에 호스트와 데이터베이스 이름을 확인할 수 있습니다.
Copy connection을 클릭하여 전체 연결 문자열을 클립보드에 넣습니다. 해당 요청을 위해 서버 측에서 해독되며 페이지에 출력되지 않으므로 화면 공유 및 스크린샷으로 누출되지 않습니다. 모든 공개는 사이트의 감사 추적에 기록되고 Site Activity Log에 표시됩니다.
문자열은 각 엔진에 대한 일반적인 URL 형식으로, 이 사이트에 대해 생성된 호스트, 포트, 사용자, 암호 및 데이터베이스 이름을 전달합니다.
애플리케이션에서 사용하기
연결 문자열을 애플리케이션이 설정을 읽는 위치에 붙여넣습니다. Node.js 사이트에서 올바른 위치는 Secrets 탭이며 DATABASE_URL 또는 REDIS_URL과 같은 키 아래의 production 환경에서입니다.
연결 문자열을 커밋하는 파일에 하드코딩하지 마세요. 여기에는 실시간 암호가 포함되어 있습니다. 원격 git에 도달하면 누출된 것으로 취급해야 하며 유일한 실제 해결 방법은 addon을 삭제하고 새 것을 요청하는 것입니다. 왜냐하면 자격 증명을 패널에서 제자리에 회전할 수 없기 때문입니다.
Addon 제거하기
행의 Delete를 클릭합니다. KPanel에서 확인을 요청하고 어떤 일이 일어날지 명확하게 설명합니다: 이는 관리형 데이터베이스를 제거하고 데이터는 복구할 수 없습니다.
행은 즉시 삭제 표시되고 프로비저너가 다음 패스에서 기본 데이터베이스와 사용자를 정리합니다. 기존 연결은 정리 중에 종료됩니다.
관리형 addon 삭제 시 백업이 없으며 실행 취소도 없습니다. addon에서 보관하고 싶은 것이 있다면 pg_dump 또는 redis-cli --rdb로 먼저 덤프하세요. addon이 여전히 활성화되어 있고 연결 문자열이 여전히 작동하는 동안입니다.
옵션 선택하기
PostgreSQL 사용: 애플리케이션이 관계형 데이터베이스가 필요하고 Postgres를 대상으로 작성된 경우: 강력한 제약 조건, 트랜잭션, JSON 열, 그리고 그렇지 않으면 별도로 추가해야 할 전체 텍스트 검색입니다.
Redis 사용: 사라져도 되는 것들: 캐시된 조각, 비율 제한 카운터, 세션 저장소 및 작업 큐. 기록 시스템이 아니라 빠르고 휘발성인 것으로 취급합니다.
기본 제공 MySQL 데이터베이스 사용: WordPress 및 이미 MySQL을 대상으로 작성된 모든 것입니다. WordPress 사이트에 Postgres addon을 추가하면 WordPress가 이를 사용할 수 없으므로 아무 소용이 없습니다.
문제 해결
addon이 오랫동안 PENDING 상태로 있습니다. 프로비저너는 즉시가 아닌 일정에 따라 실행됩니다. 페이지를 열어두십시오. 자동 새로 고침이 되므로 다시 확인해 주세요. 몇 번의 패스 후에도 이동하지 않으면 사이트 도메인 및 addon 유형과 함께 지원 티켓을 엽니다.
프로비저닝이 FAILED되었습니다. 행의 오류를 읽습니다. 실패한 addon을 삭제하고 다시 요청합니다. 이는 안전합니다: 실패한 행 뒤에는 라이브 데이터베이스가 없었습니다.
Copy connection이 아무것도 하지 않습니다. 일부 브라우저는 탭이 포커스되지 않으면 클립보드 쓰기를 차단합니다. 먼저 페이지를 클릭한 후 버튼을 다시 클릭합니다.
애플리케이션이 연결할 수 없습니다. 순서대로 세 가지를 확인하세요: addon 상태가 ACTIVE인지 확인, 다시 입력하지 말고 문자열을 복사했는지 확인, 애플리케이션이 실제로 설정한 값이 이전 배포의 오래된 값이 아닌지 확인합니다. 새 구성을 선택하기 전에 보통 재시작이 필요합니다.
재배포 후 연결이 거부됩니다. 구성의 연결 문자열이 이 페이지의 문자열과 일치하는지 확인합니다. addon을 삭제하고 다시 요청하면 새 사용자와 새 암호가 생성되므로 이전 문자열이 작동하지 않습니다.
다음으로 이동할 위치
- Storing App Secrets For a Site, 연결 문자열을 보관할 수 있는 올바른 위치입니다.
- Connecting To Your Database Over an SSH Tunnel 기본 제공 MySQL 데이터베이스용입니다.
- Site Settings 나머지 사이트 수준 설정용입니다.