앱 카탈로그는 이미 KapsuleHost에서 호스팅 중인 사이트에 설치할 수 있는 웹 애플리케이션을 둘러볼 수 있는 라이브러리로, WordPress와 WooCommerce부터 위키, 분석 도구, 파일 동기화, 자동화 도구까지 다양합니다.
카탈로그란 무엇인가
앱은 호스팅 위에서 실행되는 소프트웨어이지, 별도로 구독하는 추가 상품이 아닙니다. 이미 사이트 비용을 지불하고 계시며, 앱은 그 위에서 실행하기로 선택하는 것일 뿐입니다.
카탈로그가 존재하는 이유는 여러분이 직접 소프트웨어를 조사하고, 다운로드하고, 압축을 풀고, 설정할 필요가 없도록 하기 위해서입니다. 대부분의 항목에는 검증된 설치 프로그램이 포함되어 있어, 지정한 사이트에 앱을 설치하고, 데이터베이스를 생성하고, 관리자 계정을 만들어 로그인 정보를 전달해 줍니다.
앱은 KPanel 사이드바의 최상위 항목으로, Main 그룹 내 웹사이트와 이메일 사이에 있습니다. 직접 접속 주소는 /apps입니다.
앱 비용
없습니다. 앱은 이미 비용을 지불하고 있는 사이트에 설치되므로, 앱 자체에 대한 요금도 없고 환불할 것도 없습니다. 여러분이 비용을 지불하는 대상은 그 아래에 있는 호스팅입니다.
여기에는 계획해 둘 만한 현실적인 결과가 하나 있습니다. 더 무거운 앱은 플랜의 리소스를 더 많이 사용한다는 점입니다. 다섯 명이 쓰는 위키와 바쁜 쇼핑몰은 같은 플랜에서도 전혀 다른 부하를 만들어 냅니다.
둘러보기와 검색
카탈로그 페이지를 열면 현재 카탈로그에 몇 개의 앱이 있는지 보여 주는 개수 표시 알약(pill), 검색창, 그리고 카테고리 칩 행이 나타납니다.
- 검색은 앱 이름, 슬러그, 태그라인을 기준으로 일치시킵니다. 입력하면 전체 카탈로그가 하나의 평면 그리드로 필터링되어 결과가 표시됩니다.
- 카테고리 칩은 유형별로 필터링합니다. 다중 선택이 가능해, 여러 개를 클릭해 필터 범위를 넓히거나 All을 클릭해 초기화할 수 있습니다.
검색어가 없고 칩도 선택되지 않은 상태에서는, 넓은 히어로 카드에 추천 앱 하나가 표시된 뒤, 나머지는 카테고리별 레이블이 붙은 섹션으로 그룹화되어 큰 카탈로그도 쉽게 둘러볼 수 있습니다.
카테고리는 다음과 같습니다: CMS, eCommerce, Analytics, Files, Wiki, Forums, Email, Automation, Headless CMS, Project Mgmt, CRM, DevOps, Education, Static Sites, Tools.
원하는 것이 대략 어떤 것인지는 알지만 이름을 모른다면, 검색 대신 카테고리 칩을 사용하세요. "Wiki"와 "Headless CMS"는 대부분의 사람들이 이름으로 검색할 생각조차 하지 못할 옵션들을 드러내 줍니다.
타일 읽는 법
갤러리의 모든 타일에는 앱 아이콘, 이름, 한 줄짜리 태그라인, 그리고 한두 개의 알약(pill)이 표시됩니다:
- 런타임 알약:
PHP,NODEJS,STATIC또는PYTHON. 이는 앱이 무엇으로 만들어졌는지를 나타내며, 어떤 종류의 호스팅 환경이 필요한지 알려 줍니다. - Community 알약: 설치 프로그램이 커뮤니티에서 기여된 앱에 표시됩니다. 설치 스크립트는 포함되어 있지만 설정을 마치려면 몇 가지 수동 단계가 필요할 수 있습니다.
앱 페이지 읽는 법
아무 앱이나 클릭하면 상세 페이지가 열립니다. 페이지는 두 개의 영역으로 나뉩니다.
왼쪽 열은 전반적인 설명을 담고 있습니다:
- 앱 아이콘, 이름, 태그라인과 함께 런타임, 카테고리, 데이터베이스가 필요한지 여부, Community 여부, Featured 여부를 나타내는 알약들.
- About [app]: 소프트웨어가 실제로 무엇을 하는지에 대한 설명.
- 한눈에 보기: 리소스 관련 사실들과 함께, 프로젝트 자체 문서 및 홈페이지로 연결되는 외부 링크.
한눈에 보기 카드에는 다음이 포함될 수 있습니다:
| 항목 | 알려 주는 내용 |
|---|---|
| 설치 시간 | 설치에 걸리는 대략적인 시간 |
| 최소 RAM | 앱 실행에 필요한 메모리 |
| 최소 디스크 | 필요한 디스크 공간 |
| Database | 데이터베이스가 자동으로 프로비저닝되는지 여부 |
오른쪽 열은 고정된(sticky) 설치 패널로, Install [app] 버튼과 해당 앱에 적용되는 안내 사항이 표시됩니다.
설치 가능한 앱과 저희가 직접 설정해 드리는 앱
카탈로그에 있는 모든 앱은 주문 가능합니다. "출시 예정"이라는 막다른 길은 없습니다. 다른 점은 설치되는 방식입니다:
- 검증된 설치 프로그램이 있는 앱은 자동으로 프로비저닝됩니다. 설정하고, 확인하고, 진행률 표시줄을 지켜보기만 하면 됩니다.
- 검증된 설치 프로그램이 없는 앱은 저희 팀이 직접 설치합니다. 앱 페이지에는 다음과 같이 명시되어 있습니다: 저희 팀이 직접 설정합니다: 주문 후 저희가 수동으로 이 앱을 설치하고, 준비가 완료되면 이메일로 안내해 드립니다. 동일한 버튼을 클릭하면 되며, 비용은 여전히 발생하지 않습니다.
이렇게 구분하는 데는 분명한 이유가 있습니다. 검증되지 않은 설치 스크립트를 고객의 운영 중인 사이트에 실행하는 것은 사이트를 망가뜨리기 좋은 방법이기 때문입니다. 스크립트를 보장할 수 없는 경우에는 사람이 직접 작업합니다.
커뮤니티 앱
Community로 표시된 앱은 사내에서 유지 관리되는 것이 아니라 커뮤니티에서 기여한 설치 스크립트를 사용합니다. 앱 페이지에는 설치 스크립트가 포함되어 있지만 설정을 마치려면 몇 가지 수동 단계가 필요할 수 있다고 명시되어 있습니다.
커뮤니티 앱은 "설치는 되었지만 설정은 되지 않은" 상태로 여기세요. 소프트웨어는 사이트에 설치되어 접속 가능하겠지만, 마지막 설정 마법사는 직접 진행해야 할 것으로 예상하시고, 설치 프로그램이 처리하지 못한 부분은 해당 프로젝트의 자체 문서를 확인하세요. 시작하기 전에 백업을 받아 두세요. 백업하기를 참고하세요.
권장 플랜 등급
일부 앱은 페이지에 권장 최소 플랜 등급을 명시하고 있으며, 현재 플랜이 그 기준보다 낮으면 설치 마법사에 플랜 업그레이드 권장 알림이 표시됩니다.
이 알림은 조언일 뿐 차단이 아닙니다. 어느 쪽이든 설치는 진행됩니다. 다만 경고하는 내용 자체는 실제입니다. 플랜이 넉넉하게 제공하는 것보다 더 많은 메모리를 필요로 하는 앱은 설치 중에 실패하거나, 이후 제대로 작동하지 않을 수 있습니다. 무시하기 전에 앱 페이지의 최소 RAM 수치를 플랜이 제공하는 값과 비교해 보세요.
누가 설치할 수 있는가
설치하려면 계정 소유자(Owner)와 관리자(Admin)가 보유한 apps:write 권한이 필요합니다. 다른 역할은 전체 카탈로그를 둘러보고 모든 앱 페이지를 읽을 수 있지만, 설치 버튼은 어떤 역할이 작업할 수 있는지에 대한 안내와 함께 잠겨 있습니다.
문제가 발생하면
카탈로그가 로드되지 않습니다. 페이지에 Try again 버튼이 있는 오류 카드가 표시됩니다. 이는 로드 실패이며, 카탈로그가 비어 있는 것이 아닙니다.
"No apps match your search."(검색 결과와 일치하는 앱이 없습니다.) 검색창을 지우거나 All 칩을 클릭해 카테고리 필터를 초기화하세요. 다중 선택 칩은 실수로 켜진 채로 남아 있기 쉽습니다.
원하는 앱이 보이지 않습니다. 카탈로그는 선별되어 있습니다. 필요한 것이 빠져 있다면 지원 티켓을 열어 문의해 주세요. 카탈로그에 앱을 추가하는 것은 특이한 요청이 아니라 일반적인 요청입니다.
앱 페이지에 오류가 표시됩니다. 모든 앱으로 돌아가 타일에서 다시 시도해 보세요. 특정 앱 하나에서 계속 발생한다면 티켓에 해당 앱의 슬러그를 적어 보고해 주세요.
다음 단계
앱을 선택하셨다면, 사이트에 앱 설치하기에서 설치 대상 사이트가 비어 있지 않을 때 일어나는 일을 포함해 마법사 전체 과정을 처음부터 끝까지 안내합니다.