🇨🇳 Ubuntu에 Discourse 개발 환경 설치하기

[honeymoose]

본 가이드는 Discourse 개발 환경 설정에만 해당됩니다. 프로덕션 환경에 Discourse를 설치하려면 다음 페이지의 내용을 참조하세요: Install Discourse in production with the official supported instructions

개발 환경 설정의 영문 원본은 다음 페이지의 내용을 참조하세요: Set up a local Discourse Development Environment?

---

본 문서는 Ubuntu 환경에서의 개발 설정에만 해당됩니다. Discourse는 Ruby 기반으로 개발되었기 때문에 Ruby 개발 환경 설정이 Ubuntu에서 가장 간단합니다. 또한 Discourse 프로덕션 환경 실행도 공식적으로 Ubuntu 사용을 권장합니다. 물론 저희 커뮤니티는 Docker 컨테이너를 사용하여 REHL 환경에서도 문제없이 운영되고 있지만, Discourse 개발을 원하신다면 Ubuntu 환경을 사용하는 것이 좋습니다.

Windows 시스템을 사용 중이시라면 WSL 환경을 설치해야 합니다. WSL은 Windows에서 제공하는 Ubuntu 기반 환경으로, Windows에서 Linux 애플리케이션 개발 문제를 해결하는 데 주로 사용됩니다.

본 글은 Ubuntu 환경에 Ruby/Rails/Postgres/Redis 환경이 아직 설치되어 있지 않다고 가정하고 개발 환경 설정을 시작합니다!

이 개발 가이드는 Ubuntu 개발 환경을 사용하는 것을 전제로 하지만, Debian 기반의 모든 Linux 배포판에서도 사용할 수 있습니다.

본 개발 가이드는 Ubuntu 18에서 추가 단계 없이 개발 환경 설정을 완료할 수 있음을 검증했습니다.

Ubuntu/Debian 개발 환경 사용에 따라 차이가 있을 수 있으므로, Ubuntu/Debian에서 개발할 때 아래 정보를 참고하시기 바랍니다:

Ubuntu 20.04 및 이후 버전에서 Discourse 테스트 환경 설치 관련 정보

기본적인 Ubuntu 20.04 및 이후 버전에는 OpenSSL 3.0.2가 기본적으로 설치됩니다. 이전 OpenSSL 버전에서 컴파일하여 위 버전을 대체할 필요가 있을 수 있습니다(공식 권장 버전은 OpenSSL-1.1.1n). 또한 설치된 Ruby 버전을 확인해야 하며, ruby --version 명령어를 사용하여 Ruby 버전을 확인할 수 있습니다. 현재 Discourse는 여전히 Ruby 2 버전을 사용하므로, Ruby 3.x 또는 그 이후 버전을 사용 중이라면 Ruby 버전을 다운그레이드해야 합니다. 공식적으로는 Ruby 버전 관리 도구를 사용하여 버전을 낮추는 것을 권장합니다. 현재 Discourse 실행 환경에 대해 공식적으로 가장 적합한 Ruby 버전은 2.7.6으로 판단됩니다. 더 많은 정보는 다음 페이지의 내용을 참조하세요: Notes about Installing Discourse on Ubuntu 20.04 - #2 by SaraDev

Ubuntu 20.04 이전 버전에서 Discourse 테스트 환경 설치 관련 정보

아래 부분은 @pfaffman이 22.05.16에 추가한 내용으로, 이 오류가 발생할 수 있지만 사용자에 따라 발생하지 않을 수도 있습니다.

참고: 관련 정보는 다음 페이지의 내용을 참조하세요: Failed to build ruby 2.7.5 on ubuntu 22.04 · rbenv/ruby-build · Discussion #1940 · GitHub

@pfaffman 추가 내용 끝.

우리의 테스트 경험에 따르면, Ubuntu 22 버전에서는 컴파일 실패 또는 패키지를 찾을 수 없는 상황이 발생할 수 있습니다. 현재까지 우리는 20.04에서만 로컬 개발 환경 설정을 완료했습니다.

Discourse 의존성 설치

일반 사용자는 콘솔에서 다음 명령을 실행할 수 있습니다: this script. 위 명령은 로컬 개발 환경에서 Rails를 빠르게 설정하는 데 도움이 됩니다.

실행할 명령은 다음과 같습니다:

bash <(wget -qO- https://raw.githubusercontent.com/discourse/install-rails/master/linux)

위 명령은 로컬 시스템에 다음 패키지를 설치합니다:

• Git
• rbenv
• ruby-build
• Ruby (stable)
• Rails
• PostgreSQL
• SQLite
• Redis
• Bundler
• MailHog
• ImageMagick

로컬 운영체제에 일부 소프트웨어가 이미 설치되어 있거나 모든 소프트웨어를 설치하지 않으려면 script의 내용을 참조하여 현재 설치하지 않으려는 소프트웨어를 선택하세요. 위 설치 스크립트는 Discourse 실행에 필요한 모든 소프트웨어를 설치하며, 이 소프트웨어들은 Discourse 실행을 지원합니다.

모든 Discourse 의존성 설치가 완료되면 이제 Discourse를 설치할 수 있습니다.

위 그림은 Ubuntu에서 소프트웨어를 설치하는 화면을 보여줍니다. 소프트웨어 설치 과정은 시간이 좀 걸리며, 사용 중인 시스템에 따라 5분 이상 소요될 수 있습니다.

Discourse 클론(clone)

Discourse를 ~/discourse 폴더에 클론합니다.

git clone https://github.com/discourse/discourse.git ~/discourse

~는 현재 홈 폴더를 의미하며, 이는 Discourse 프로그램이 홈 폴더 아래에 복사됨을 의미합니다.

우리는 WSL 서브시스템을 사용하므로, 실제로는 파일을 D 드라이브에 클론했습니다.

데이터베이스 설정(Setup)

Ubuntu 시스템 사용자명과 동일한 이름의 사용자를 생성합니다:

sudo -u postgres createuser -s "$USER"

위 명령을 실행할 때 오류가 발생하면:

createuser: error: could not connect to database template1: could not connect to server: No such file or directory

다음 페이지의 내용을 참조하세요: iSharkFly - 飞鲨

Discourse 시작

Discourse 클론 디렉터리로 이동합니다:

cd ~/discourse

필요한 gems를 설치합니다.

source ~/.bashrc
bundle install

동시에 필요한 JS 의존성도 설치합니다.

yarn install

이 단계까지 도달하면 필요한 모든 gems와 의존성이 설치되었으므로, 다음 명령을 실행해 보세요:

bundle exec rake db:create 
bundle exec rake db:migrate
RAILS_ENV=test bundle exec rake db:create db:migrate

실행 중 오류가 발생하면 다음 저장소의 내용을 참조하세요: iSharkFly - 飞鲨

다음 명령을 실행해 보세요:

bundle exec rake autospec

프로젝트는 모든 테스트를 통과해야 합니다.

이 테스트는 매우 시간이 오래 걸리며, 수행하지 않아도 됩니다. 그렇지 않으면 몇 시간이 소요될 수 있습니다.

서버를 시작하려면 다음 명령을 실행합니다:

bundle exec rails server

위 설치 단계를 완료하면 http://localhost:3000을 통해 로컬에 설치된 Discourse에 액세스할 수 있어야 합니다.

Discourse 2.5+부터 로컬 개발 환경에서 EmberCLI가 필수 옵션이 되었습니다:

3000 포트를 통해 직접 인터페이스에 액세스하면 다음 프롬프트 화면이 표시됩니다:

콘솔 터미널에서 (cd ~/discourse) 폴더로 이동한 다음 다음을 실행합니다:

bin/ember-cli

http://localhost:4200 주소를 통해 로컬 Discourse 설치를 확인할 수 있어야 합니다.

이 두 서버는 모두 동시에 시작되어야 한다는 점에 유의하세요. ember-cli는 3000 포트로의 액세스를 위해 리버스 프록시를 사용합니다.

새로운 관리자 계정 생성

개발 환경에 로그인하기 전에 관리자 계정을 생성해야 합니다. 다음 명령을 실행하여 생성합니다:

RAILS_ENV=development bundle exec rake admin:create

명령 프롬프트의 지시에 따라 관리자 계정을 생성하세요.

입력해야 하는 정보는 이메일 주소와 비밀번호입니다.

이메일 구성

MailHog를 실행합니다:

mailhog

---

위 모든 단계를 완료하면 Discourse 로컬 개발 환경 설정이 완료됩니다. 이제 관리자 계정으로 Discourse에 로그인할 수 있습니다.

Discourse 플러그인 개발을 원하신다면 다음 페이지의 가이드를 참조하세요: Developing Discourse Plugins - Part 1 - Create a basic plugin

---

[wayway_way]

@honeymoose

ubuntu 시스템의 사용자 이름과 동일한 사용자를 생성하세요

안녕하세요, ubuntu 시스템의 사용자 이름이 어떤 사용자를 가리키는 건지 궁금합니다.

[Lhc_fl (Linca)]

@wayway_way

안녕하세요, ubuntu 시스템에서 사용자 이름이 어떤 사용자를 가리키는지 궁금합니다.

직접 찾으실 필요는 없습니다. 이 명령어는 환경 변수 $USER를 사용자 이름으로 설정하는 것을 의미합니다. 그대로 실행하시면 됩니다. 그 문장은 이 명령어가 무엇을 하는지 설명하는 것입니다.

@honeymoose

sudo -u postgres createuser -s "$USER"

[honeymoose]

@Lhc_fl

직접 찾으실 필요 없어요. 이 명령어는 환경 변수 $USER를 사용자 이름으로 설정하는 뜻입니다. 그대로 실행하시면 됩니다. 그 문장은 이 명령어가 무엇을 하는지 설명하는 거예요.

네, 감사합니다.

그 뜻이 맞습니다.

[wayway_way]

네, 인내심 있는 답변에 감사합니다.

[scavin]

중문을 번역해 주셨네요. 정말 마음에 들어서 특별히 칭찬해 드립니다.