제가 도움을 주어 세팅한 디스코urses 포럼 관리자를 위한 짧은 문서를 작성 중입니다. 빠진 부분이 있을까요?

여러 친구/협회용 Discourse 포럼을 설정해 둔 적이 있습니다. 그들이 관리에 대해 더 자율적이 되기를 원하며, 이렇게 하면 제가 직접 개입할 가능성이 줄어듭니다.

그들은 수개월에서 수년 동안 Discourse를 사용자 및 공동 관리자로 사용해 왔습니다. 그들은 "새로운 관리자"가 아니지만, 일상적인 Discourse 유지 관리(모더레이션 기본 사항 제외)에 대한 심층적인 지식과, 관리자로써 알아야 할 사항, 그리고 기술적 문제가 발생했을 때 대처하는 방법에 대해 부족한 점이 있습니다. 이는 항상 제가 그런 일을 처리해 주었기 때문입니다.

저는 앞으로도 도움을 줄 수 있지만, 목표는 그들이 가장 흔한 문제들을 스스로 추적하고 해결할 수 있도록 하는 것입니다.

지금까지 작성해 둔 내용은 다음과 같습니다 (제 원문이 프랑스어이므로 영어로 AI 번역을 했습니다. 일부 문장이 이상하게 느껴질 수 있으니 신경 쓰지 마세요):


업데이트

웹 인터페이스를 통한 업데이트

관리자 패널에 빨간색 불만 표정(중요한 업데이트가 적용되어야 함을 의미)이 표시될 때 업데이트를 실행하십시오.
업데이트는 다음 경로를 통해 수행됩니다:
https://tonforum.fr/admin/upgrade

때로는 두 단계로 수행됩니다: 나머지 부분을 업그레이드하기 전에 먼저 "Docker_Manager"를 업데이트해야 합니다:

명령줄을 통한 업데이트

가끔은 업데이트를 명령줄을 통해 수행해야 합니다 (필요한 경우 Discourse 관리자 페이지에서 명시적으로 알려줍니다).

  1. SSH를 통해 서버에 연결합니다
  2. 다음 명령을 사용하여 포럼을 재빌드합니다 (재빌드는 항상 Discourse를 업데이트합니다):
  3. /var/discourse/launcher rebuild app
    
  4. 포럼이 올바르게 작동하는지 확인한 후, 때로는 사용하지 않는 Docker 이미지(이전 업그레이드에서 남은 잔여물)를 삭제하여 디스크 공간을 확보하는 것이 유용할 수 있습니다:
    /var/discourse/launcher cleanup
    

서버 내 중요 파일 위치

app.yml

서버 구성과 설치된 플러그인 목록을 포함합니다. 포럼을 다른 서버로 마이그레이션하거나 특정 구성(예: 업로드 및 백업 파일을 다른 디스크로 이동)을 적용해야 할 때 매우 유용합니다. 위치는 다음과 같습니다:

/var/discourse/containers/app.yml

mail-receiver.yml

이메일로 답변을 받아 포럼에 게시할 수 있도록 하는 소프트웨어의 구성을 포함합니다. 위치는 다음과 같습니다:

/var/discourse/containers/mail-receiver.yml

백업

백업 파일은 여기에 저장됩니다:

/var/discourse/shared/standalone/backups/default

포럼 관리자에서 중요한 페이지

유용할 수 있는 몇 가지 페이지 :robot:

테마 및 컴포넌트

사용자 정의 CSS와 HTML을 포함합니다:

https://tonforum.fr/admin/config/customize/themes

로그

이메일

디버깅에 유용합니다:

https://tonforum.fr/admin/email-logs

스태프 활동

매우 유용합니다. (거의) 모든 사이트 설정 변경 사항과 모더레이터 및 관리자가 수행한 다른 작업의 기록을 유지합니다.

https://tonforum.fr/admin/logs/staff_action_logs

오류 로그

문제가 명확하지 않을 때 단서를 제공할 수 있습니다:

https://tonforum.fr/logs/

백업

백업 빈도와 최대 백업 수를 변경하거나, 백업을 확인하거나, 다운로드하려면:

https://tonforum.fr/admin/backups

리소스

https://meta.discourse.org
공식 지원입니다. 주저하지 말고 그곳에 게시하십시오; 커뮤니티 멤버와 개발자들은 보통 매우 친절하게 도와줍니다.


추가하거나 제거할 수 있는 부분이 있는지 보입니까? /logs/ 부분은 매우, 매우 드물게 유용하므로 제거할 수 있다고 생각합니다. 몇몇 인스턴스를 관리한 수년 동안 그 안에서 유용한 정보를 찾았는지조차 확신하지 못합니다.

10개의 좋아요

몇 가지 분명히 하고 싶은 점이 있습니다.

첫째, 웹 인터페이스를 통해 업데이트를 시도할 때 업데이트가 실패할 수 있으며 포럼이 중단될 수 있다는 점을 유념해 주세요. 이에 대비해 두시기 바랍니다.

둘째, 호스트에 접근할 수 없게 되거나 손상된 경우, 백업 파일과 yml 파일이 필요합니다. 이러한 파일은 이미 별도의 시스템에 안전하게 저장해 두어야 합니다.

이 두 가지를 종합하면, 업데이트를 시도하기 전에 항상 백업을 생성하고 백업 파일을 다운로드해 두어야 한다는 것입니다.

4개의 좋아요

에드님, 아주 타당한 지적입니다. 얼마 전 한 멤버가 다른 시스템으로 백업하는 스크립트를 작성한 적이 있었던 것 같습니다. 검색해서 확인해봐야겠네요.

여기 OP(질문자)의 게시글을 좀 가져왔습니다. Canapin 님이 Google Drive/Dropbox로 백업하는 방법에 대한 링크가 포함된 좋은 답변을 하셨습니다.

@Canapin 런처 리빌드 앱(launcher rebuild app)의 경우, 이렇게 실행해야 하지 않나요?

./launcher r build app

이것은 제가 이 사이트의 다른 문서들에서 사용하던 방식입니다. 하지만 배운 바에 따르면, 일을 처리하는 방법은 여러 가지가 있더군요. ㅋㅋ

편리한 잘 정리된 글 감사합니다.

1개의 좋아요

하지만 그 전에 cd /var/discourse를 실행하므로 ./는 해당 디렉토리를 가리키게 되며, 따라서 launcher의 경로는 사실상 /var/discourse/launcher가 되는 것이 아닌가요?

그걸 몰랐네요. 다른 discourse 튜토리얼처럼 그냥 사용하고 있었어요. 하지만 말이 되는 것 같습니다. 감사합니다.

에스컬레이션 팁을 추가하는 것이 가치가 있을지 궁금합니다. 이 문서를 읽는 사람이 호스트에 ssh로 접속하여 문제를 조사하거나 해결하는 방법을 모른다면, 누가 할 수 있을까요? 아마도 메타에서 질문을 하라는 팁, 그리고 ask를 사용하라는 팁도 포함할 수 있을 것 같습니다.

4개의 좋아요

좋은 정보네요. 포럼 자체에서 생성한 백업 파일을 다운로드하는 것만 알고 있었습니다.

1개의 좋아요

도와주셔서 감사합니다!

가이드의 시작 부분에 이 내용을 추가했습니다:

어떤 상황에든 대비하세요

포럼과 동일한 서버에 저장된 로컬 백업 외에도, 이러한 백업의 사본을 다른 서버나 클라우드에 보관하는 것을 강력히 권장합니다[1].

또한 /var/discourse/containers/app.yml 파일의 사본을 안전한 곳에 보관하는 것이 유용합니다[2]. 이 선택적 파일은 포럼 재설치 또는 다른 서버로의 마이그레이션 시 사용됩니다.

무언가에 대해 심각한 의문이 생기면 저에게 연락해 주세요 (canapin@gmail.com).

업데이트 섹션에 이 내용을 추가했습니다:

:information_source: 업데이트를 수행하기 전에 포럼의 최신 백업을 다운로드하는 것을 강력히 권장합니다.

이 내용을 추가했습니다:

포럼이 더 이상 작동하지 않을 때 무엇을 해야 하나요?

포럼을 재구성(Rebuild)하면 많은 문제가 해결되며, 커맨드 라인 업데이트와 동일한 명령어로 수행됩니다:

/var/discourse/launcher rebuild app

재구성 후에도 포럼이 작동하지 않는다면?

저에게 문의해 주세요 (canapin@gmail.com) 또는 공식 지원 포럼에 게시물을 작성해 주세요.

가이드의 끝부분에 ask.discourse.org에 대한 언급도 추가했습니다.

리소스

https://meta.discourse.org : 공식 지원입니다. 주저하지 말고 그곳에 게시물을 작성하세요 — 커뮤니티 멤버와 개발자들이 매우 도움을 줍니다
https://ask.discourse.com : Discourse 지원 데이터와 정보로 학습된 챗봇으로, 질문에 대한 답변을 제공하는 데 놀랍도록 효과적입니다 (네, 정말로요)

전문

어떤 상황에든 대비하세요

포럼과 동일한 서버에 저장된 로컬 백업 외에도, 이러한 백업의 사본을 다른 서버나 클라우드에 보관하는 것을 강력히 권장합니다[1:1].

또한 /var/discourse/containers/app.yml 파일의 사본을 안전한 곳에 보관하는 것이 유용합니다[2:1]. 이 선택적 파일은 포럼 재설치 또는 다른 서버로의 마이그레이션 시 사용됩니다.

무언가에 대해 심각한 의문이 생기면 저에게 연락해 주세요 (canapin@gmail.com).

업데이트

:information_source: 업데이트를 수행하기 전에 포럼의 최신 백업을 다운로드하는 것을 강력히 권장합니다.

인터페이스를 통한 업데이트

관리자 페이지에서 불행해 보이는 빨간색 이모지가 표시될 때 업데이트를 수행하세요(중요한 업데이트가 있음을 의미합니다).
업데이트는 https://yourforum.com/admin/upgrade를 통해 수행됩니다.

때로는 두 단계로 수행됩니다: 나머지 부분을 업그레이드하기 전에 먼저 “Docker_Manager”를 업데이트해야 합니다:

커맨드 라인을 통한 업데이트

때로는 업데이트를 커맨드 라인을 통해 수행해야 합니다(필요한 경우 Discourse 관리자 페이지에 표시됩니다).

  1. SSH를 통해 서버에 연결합니다
  2. 다음 명령어를 사용하여 포럼을 재구성합니다(재구성은 항상 Discourse를 업데이트합니다):
  3. /var/discourse/launcher rebuild app
    
  4. 포럼이 올바르게 작동하는지 확인한 후, 때로는 디스크 공간을 확보하기 위해 사용되지 않는 Docker 이미지(이전 업그레이드의 잔재)를 제거하는 것이 유용할 수 있습니다:
    /var/discourse/launcher cleanup
    

포럼이 더 이상 작동하지 않을 때 무엇을 해야 하나요?

포럼을 재구성(Rebuild)하면 많은 문제가 해결되며, 커맨드 라인 업데이트와 동일한 명령어로 수행됩니다:

/var/discourse/launcher rebuild app

지금은 꽤 괜찮아졌고 중요한 것을 놓치지 않았다고 생각합니다 :slight_smile:


  1. 제가 포럼을 설치해 드린 경우, 백업은 자동으로 제 Google Drive에 복사되지만, 이상적으로는 향후에는 사용자가 직접 관리하는 공간에 저장되어야 합니다. 언젠가 이 문제에 대해 이야기할 것입니다 :smile: ↩︎ ↩︎

  2. 메일 서버 사용자 이름과 비밀번호, 그리고 최고 관리자 이메일 주소(실제로는 제 이메일)가 포함되어 있습니다. ↩︎ ↩︎

3개의 좋아요

이것이 작동한다면, 이는 일반적인 2줄 버전(예전에는 3줄이었는데, 이 추세는 계속될 것 같습니다)보다 더 나은(더 간단한) 권장 사항이 될 것입니다.

두 방법 모두 작동합니다.

현재 디렉터리가 ./인 경우, 런처의 위치가 경로(path)에 포함되어 있지 않기 때문에 이 형식이 필요합니다.

Linux에서는 명령어가 경로에 없을 경우 해당 파일의 전체 경로를 지정해야 하며, 이렇게 해야 어떤 파일을 의미하는지 오해가 생기지 않습니다.

3개의 좋아요

네, 하지만 여러 작업을 동시에 수행해야 하는 경우가 많습니다. 예를 들어, 먼저 클린업을 실행하는 경우 등이 있죠. 이런 경우에는 먼저 cd 명령을 실행하는 것이 더 간결할 수 있습니다.

3개의 좋아요

동의합니다. 나중에 참고하기 위해 토픽을 북마크해 두었습니다. 감사합니다.

음, 자 그럼 전체 자동 번역된 가이드를 여기에 올립니다:

모든 상황에 대비하는 법

로컬 백업(포럼과 동일한 서버에 저장되는 백업) 외에도, 해당 백업의 사본을 다른 서버나 클라우드에 보관하는 것이 강력히 권장됩니다[1].

보안된 위치에 /var/discourse/containers/app.yml 파일의 사본을 보관하는 것도 유용합니다[2]. 이 선택적 파일은 포럼 재설치 또는 다른 서버로의 마이그레이션 시 유용합니다.

무엇에 대해 심각한 의문이 있다면 저에게 연락하세요.

업데이트

:information_source: 업데이트를 수행하기 전에 포럼의 최신 백업을 다운로드하는 것이 강력히 권장됩니다.

인터페이스를 통한 방법

관리자 페이지에 불행한 빨간 이모지가 표시될 때 업데이트를 수행하세요(중요한 업데이트가 필요하다는 의미입니다).
업데이트는 https://tonforum.fr/admin/upgrade를 통해 수행됩니다.

가끔 두 단계로 진행됩니다: 나머지 부분을 업그레이드할 수 있기 전에 먼저 “Docker_Manager”를 업데이트해야 합니다:

명령줄을 통한 방법

가끔은 명령줄을 통해 업데이트를 수행해야 합니다(필요한 경우 Discourse 관리자 페이지에 그렇게 표시됩니다).

  1. SSH를 통해 서버에 연결하세요
  2. 다음 명령을 사용하여 포럼을 다시 빌드하세요(다시 빌드는 항상 Discourse를 업데이트합니다):
  3. /var/discourse/launcher rebuild app
    
  4. 포럼이 올바르게 작동하는지 확인한 후, 때때로 사용하지 않는 Docker 이미지(이전 업그레이드에서 남은 것들)를 제거하여 디스크 공간을 확보하는 것이 유용할 수 있습니다:
    /var/discourse/launcher cleanup
    

포럼이 더 이상 작동하지 않을 때 해야 할 일?

포럼을 다시 빌드하면 많은 문제를 해결할 수 있으며, 명령줄을 통한 업데이트와 동일한 명령으로 수행됩니다:

/var/discourse/launcher rebuild app

다시 빌드한 후에도 포럼이 작동하지 않으면?

저에게 물어보거나 공식 지원 포럼에 게시하세요.

서버 내 중요 파일 위치

app.yml

서버 구성과 설치된 플러그인 목록을 포함합니다. 포럼을 다른 서버로 이동해야 하거나 특정 구성(업로드 및 백업을 다른 디스크로 이동하는 등)을 할 때 매우 유용합니다. 위치는 다음과 같습니다:

/var/discourse/containers/app.yml

mail-receiver.yml

이메일로 받은 답변을 포럼에 게시할 수 있도록 하는 소프트웨어의 구성을 포함합니다. 위치는 다음과 같습니다:

/var/discourse/containers/mail-receiver.yml

백업

백업 파일은 다음 위치에 있습니다:

/var/discourse/shared/standalone/backups/default

포럼 관리자 내 중요 페이지:

유용할 수 있는 페이지들 :technologist:

테마 및 컴포넌트

사용자 정의 CSS와 HTML 등을 포함합니다:

https://tonforum.fr/admin/config/customize/themes

로그

이메일

디버깅에 유용합니다:

https://tonforum.fr/admin/email-logs

스태프 작업

매우 유용합니다. (거의) 모든 사이트 설정 변경 사항 및 기타 모더레이터와 관리자 작업을 기록으로 유지합니다.

https://tonforum.fr/admin/logs/staff_action_logs

에러 로그

원인이 명확하지 않은 문제가 있을 때 단서를 제공할 수 있습니다.

https://tonforum.fr/logs/

백업

백업 빈도와 최대 수를 변경하거나, 확인하거나, 다운로드하려면:

https://tonforum.fr/admin/backups

리소스

https://meta.discourse.org : 공식 지원,那里에 게시하는 것을 주저하지 마세요. 멤버와 개발자들은 기꺼이 도움을 줄 것입니다
https://ask.discourse.com : Discourse 지원 및 데이터로 훈련된 챗봇으로, 질문에 답하는 데 놀라울 정도로 효과적입니다 (네, 진짜로요)


  1. 포럼을 제가 설치해 드렸다면, 백업은 자동으로 제 Google Drive에 복사됩니다. 하지만 이상적으로는 향후에는 여러분이 관리하는 공간에 저장되어야 합니다. 언젠가 이야기해 보죠 :smile: ↩︎

  2. 메일 서버의 식별자와 비밀번호, 그리고 관리자 이메일 (실제로는 제 이메일) 이 포함되어 있습니다. ↩︎

3개의 좋아요