웹사이트
사이트에 앱 설치하기
The Apps install wizard takes three steps: configure the admin account and site settings, review what is about to happen, then watch the install run and collect your login details.
사이트에 앱 설치하기
시작하기 전에
필요한 것은 하나입니다: 계정에 활성 웹사이트가 있어야 합니다. 마법사는 이미 있는 사이트에 설치되며, 새로운 사이트를 만들지는 않습니다. 없으면 마법사가 알려주고 새로 만들 수 있는 링크를 제공합니다. 첫 웹사이트 만들기를 참조하세요.
또한 apps:write 권한이 필요하며, 이는 계정 소유자와 관리자가 보유합니다.
콘텐츠가 이미 있는 사이트에 설치하기 전에 백업을 받으세요. 마법사는 이미 앱을 보유한 사이트에 대한 안전 장치가 있으며, 아래에서 설명하지만, 의도적으로 만든 수동 복원 지점이 자동으로 만든 것보다 항상 더 가치가 있습니다. 백업 받기를 참조하세요.
마법사로 이동하기
- KPanel 사이드바에서 앱을 클릭합니다.
- 원하는 앱을 클릭합니다.
- 오른쪽 패널에서 [앱] 설치를 클릭합니다.
직접 주소는 /apps/<app-slug>/install입니다.
1단계: 구성
마법사는 앱을 표시한 후 네 개의 필드 그룹을 보여줍니다. 앱이 현재 계획보다 높은 계획 수준을 제안하면 맨 위에 계획 업그레이드 권장 알림이 나타납니다: 이는 조언이며 설치는 계속 진행됩니다.
위치
사이트에 설치합니다. 활성 사이트에서 선택합니다. 앱이 있을 위치입니다.
관리자 계정
- 관리자 사용자 이름. 기본값은
admin입니다. 이것은 로그인할 때 사용할 사용자 이름이며, 나중에 더 많은 사용자를 추가할 수 있습니다. - 관리자 비밀번호. 페이지가 로드되는 순간 16자의 강력한 비밀번호가 생성됩니다. 표시는 이를 표시하고 생성은 새 비밀번호를 만듭니다. 직접 입력할 수도 있으며, 최소 8자 이상이어야 합니다.
- 관리자 이메일. 선택사항입니다. 로그인 및 비밀번호 재설정에 사용됩니다. 비워두면 계정 이메일이 사용됩니다.
마법사를 떠나기 전에 관리자 비밀번호를 저장하세요. 검토 화면과 성공 화면에 표시되고, 그 후에는 사라집니다. Kapsule은 나중에 검색할 수 있는 복사본을 저장하지 않으므로, 비밀번호를 잃으면 앱 자체를 통해 비밀번호를 재설정해야 합니다.
사이트 설정
- 사이트 이름, 앱이 요청하는 경우.
- 언어. 앱이 설정된 언어로, 영어 (US), 영어 (UK), Te Reo Māori 및 주요 유럽 및 아시아 언어를 포함한 16가지 옵션 중에서 선택합니다. 이는 KPanel이 아닌 앱 자체의 콘텐츠 언어를 설정합니다.
데이터베이스
필요한 앱에만 표시됩니다. 마법사는 도메인에서 파생된 데이터베이스 이름을 제안합니다. 문자와 숫자만 사용하며, 언더스코어나 하이픈은 사용하지 않습니다: 필드는 입력하면서 이를 적용합니다. 원하면 변경할 수 있습니다.
데이터베이스가 필요한 앱은 설치의 일부로 자동으로 프로비저닝됩니다.
일부 앱은 아래에 앱 자체에서 정의한 추가 필드를 추가하며, 해당하는 경우 도움말 텍스트가 있습니다. 필수 필드는 별표로 표시되며, 모든 필드가 채워질 때까지 계속은 비활성 상태입니다.
맨 아래 마법사는 이 앱의 리소스 요약을 보여줍니다: 예상 설치 시간, 최소 RAM 및 데이터베이스 추가 여부입니다.
계속을 클릭합니다.
2단계: 검토 및 확인
검토 화면은 한 목록에서 결정 사항을 다시 표시합니다: 앱, 웹사이트, 사이트 이름, 관리자 사용자 이름, 관리자 비밀번호 (표시 또는 숨기기 토글 포함), 관리자 이메일, 언어 및 데이터베이스 이름입니다. 부제목은 이를 명확하게 말합니다: 확인할 때까지 설치되지 않습니다.
- 편집은 뒤로 돌아가서 무언가를 변경합니다.
- 확인 및 설치는 작업을 시작합니다.
검토 화면을 가장 중요한 한 가지 확인에 사용하세요: 웹사이트 행입니다. 잘못된 사이트에 설치하는 것은 가장 흔한 설치 실수이며, 아래의 덮어쓰기 보호가 있는 이유입니다.
3단계: 설치
마법사는 진행률 보기로 전환됩니다. 순서대로 다음을 확인할 것입니다:
- 대기 중: 작업자 대기 중. 작업이 대기열에 있으며 곧 시작됩니다.
- [앱] 설치 중, 경과 시간(일반적인 설치 시간 기준) 및 진행률 표시줄과 함께.
페이지를 열린 상태로 유지하세요. 다른 곳으로 이동하면 설치가 백그라운드에서 계속되지만, 라이브 보기와 끝의 자격 증명 요약을 잃게 됩니다.
설치가 문제를 만나면 자동으로 재시도하며, 설치 재시도 및 시도 번호를 표시합니다. 예상 시간을 훨씬 넘어 실행되면 계속 대기하거나 취소하도록 제안하는 메모가 나타납니다.
취소
설치 취소는 작업을 중지합니다. 결과 화면이 이를 확인합니다: 설치가 중지되었습니다. 사이트에서 변경된 것이 없습니다.
사이트에 이미 앱이 있을 때
대상 사이트의 디렉토리에 이미 사이트가 있으면 설치가 경고와 함께 중지되며, 발견한 것의 이름을 지정합니다:
이 디렉토리는 이미 [앱]를 포함하고 있습니다. [새 앱]을 설치하면 덮어쓰게 되며 실행 취소할 수 없습니다. 복원할 수 있도록 현재 사이트의 전체 백업이 먼저 수행됩니다.
두 가지 선택: 취소하거나 백업 및 덮어쓰기. 동의하면 작업은 아무것도 쓰기 전에 기존 사이트의 전체 백업을 수행하므로 복원 지점이 있습니다.
이것은 마법사의 복귀 불가 지점입니다. 덮어쓰기는 기존 사이트의 파일을 교체합니다. 자동 백업은 클릭으로 되돌릴 수 있다는 의미가 아니라 복구 가능하다는 의미입니다. 사이트가 삭제 가능한지 확실하지 않으면 취소하고 대신 다른 사이트에 설치하세요.
팀에서 수동으로 설치하는 앱
일부 앱은 입증된 자동 설치 프로그램이 없습니다. 이런 경우 마법사는 진행률 표시줄을 완전히 건너뛰고 따뜻한 확인을 대신 표시합니다:
[앱]을 설정 중입니다. 이 앱은 직접 설정이 필요하므로 주문 후 팀에서 사이트에 설치합니다. 라이브가 되는 순간 이메일을 보내드리며, 더 이상 할 일이 없습니다.
실패한 것도 없고 대기 중인 것도 없습니다. 앱은 무료이므로 어느 쪽이든 청구되지 않습니다.
4단계: 이제 라이브입니다
성공하면 마법사는 [앱]이 라이브, 도메인 링크 및 자격 증명 요약을 표시합니다:
- 관리자 사용자 이름
- 관리자 비밀번호, 표시 또는 숨기기
- 관리자 이메일
- 사이트 제목
또한 각 단계가 성공, 실패 또는 건너뜀으로 표시되는 줄별 설치 로그를 표시합니다. 깨끗한 설치에서도 그 로그를 한번 보는 것이 좋습니다: 정확히 무엇이 구성되었는지 알려줍니다.
두 개의 버튼으로 흐름을 마칩니다: [앱] 열기는 앱으로 직접 이동하고, 앱으로 돌아가기는 카탈로그 페이지로 돌아갑니다.
실패하면 어떻게 하나요
설치 실패. 결과 화면은 무엇이 일어났는지 보여주고 중요한 부분을 명시합니다: 모든 부분적 변경이 롤백되었습니다. 사이트가 깨끗합니다. 다시 시도 및 지원팀에 문의의 두 가지 작업이 제공됩니다.
일반적인 원인 및 해결 방법:
- 리소스 제한. 앱의 최소 RAM이 계획에서 제공하는 것보다 높으면 설치가 중간에 실패할 수 있습니다. 앱 페이지에서 최소 RAM 수치를 확인하세요. 계획 업그레이드하기를 참조하세요.
- 거부된 필드. 마법사는 작업이 대기열에 들어가기 전에 셸 안전하지 않은 문자가 포함된 입력을 거부하고 필드의 이름을 지정합니다. 값을 단순화하세요: 일반 사용자 이름, 생성된 비밀번호, 문자 및 숫자 데이터베이스 이름.
- 사이트가 활성 상태가 아닙니다. 사이트 드롭다운에는 활성 상태인 사이트만 나타납니다. 아직 프로비저닝 중인 사이트는 나열되지 않습니다.
설치가 성공했지만 사이트에 오류가 표시됩니다. 설치 로그에서 실패한 단계를 확인한 후 설치 후 설정에 대해 앱 자체의 설명서를 확인하세요. 특히 커뮤니티 앱은 브라우저에서 최종 설정 마법사를 실행해야 합니다. 웹사이트가 로드되지 않음을 참조하세요.
관리자 비밀번호를 잃어버렸습니다. 설정한 관리자 이메일로 앱 자체의 비밀번호 재설정을 사용하세요. WordPress의 경우 WordPress 비밀번호 재설정을 참조하세요.
설치가 대기 중에서 진행되지 않습니다. 작업 대기열이 바쁩니다. 시작될 것입니다. 예상 설치 시간을 훨씬 넘어 아직 대기 중이면 취소하고 다시 시도한 후, 반복되면 지원 티켓을 엽니다.