Ethsim2
8월 23, 2025, 10:53오전
1
새로운 Discourse 클론을 설정할 때, 저장소에는 standalone.yml 파일이 함께 제공됩니다.
문서화된 워크플로우는 다음과 같습니다:
git clone https://github.com/discourse/discourse_docker.git /var/discourse
cd /var/discourse
./discourse-setup # app.yml 생성
하지만 누군가가 ./discourse-setup을 건너뛰고 대신 다음을 실행한다면
./launcher bootstrap app
# 또는
./launcher rebuild app
app.yml 파일이 존재하지 않는 상태에서 실행할 때, app.yml이 없기 때문에 혼란스러운 오류가 발생합니다. standalone.yml은 자동으로 시작점으로 인식되지 않습니다.
이것은 standalone.yml 파일이 이미 사용 가능한 유효한 파일이라고 가정하는 신규 관리자들에게 흔한 장애물입니다.
launcher bootstrap 또는 launcher rebuild가 호출되었을 때 containers/app.yml 파일이 존재하지 않으면, CLI는 다음과 같은 명확한 경고를 출력해야 합니다:
No containers/app.yml found.
Did you mean to run ./discourse-setup first?
Note: app.yml is generated from the sample standalone.yml file.
이렇게 하면 신규 사용자가 막다른 길에 부딪혀 Meta에서 답변을 검색해야 하는 상황을 방지할 수 있습니다.
이것이 launcher에 합리적인 추가 사항이 될까요?
2개의 좋아요
Ethsim2
8월 23, 2025, 11:02오전
2
네, 현재
./launcher bootstrap app
을 실행하기 전에 app.yml을 먼저 생성하지 않으면 다음과 같은 메시지만 표시됩니다:
ERROR: containers/app.yml does not exist or is not readable.
이 메시지는 정확하지만, 특히 다음 두 가지 일반적인 상황에서 매우 도움이 되지 않습니다:
새로운 프로덕션 설치 standalone.yml에서 app.yml을 생성하기 위해 ./discourse-setup을 실행해야 합니다.
외부 이메일 없이 빠른 테스트 포럼 설정
./launcher bootstrap app
./launcher start app
./launcher enter app
rake admin:create
이렇게 하면 이메일 없이 관리자 계정을 생성할 수 있습니다.
제안 사항:
1개의 좋아요
Ethsim2
8월 23, 2025, 11:14오전
3
공식 백업/복원 가이드 에서는 launcher를 실행하기 전에 새 VPS에 app.yml을 복사해 두는 것을 권장한다는 점을 덧붙이고 싶습니다.
따라서 에러 메시지에 이 시나리오도 포함될 수 있을 것 같습니다. 현재 가이드를 따르지만 app.yml을 먼저 복사하는 것을 잊은 사용자는 동일한 막다른 골목에 부딪히게 됩니다.
다음과 같은 메시지가 어떨까요:
ERROR: containers/app.yml 파일이 존재하지 않거나 읽을 수 없습니다.
첫 설치인 경우, ./discourse-setup을 실행하여 app.yml을 생성하세요.
(샘플 standalone.yml에서 생성됩니다.)
새 서버로 복원하는 경우, 기존 서버의 app.yml을 /var/discourse/containers 경로로 복사했는지 확인하세요.
이렇게 하면 세 가지 유형의 사용자에게 모두 올바른 방향을 제시할 수 있습니다:
신규 관리자
포럼을 복원하는 사용자
SMTP 설정을 원하지 않는 테스트 사용자