이 가이드는 macOS 개발 환경의 설치 방법을 다룹니다. 프로덕션 환경 설치 가이드는 다음을 참고하세요: Install Discourse in production with the official supported instructions
macOS에서 Discourse를 설정하여 개발과 해킹(수정/실험)을 해보고 싶으신가요?
여러분의 Mac에 Ruby/Rails/Postgres/Redis가 설치되어 있지 않다고 가정합니다. 시작해 보겠습니다
!
Discourse 의존성 설치
시스템에 다음 패키지가 필요합니다:
- Git
- rbenv 또는 asdf
- ruby-build
- Ruby (최신 안정 버전)
- Rails
- PostgreSQL
- SQLite
- Redis
- Node.js
- pnpm
- libvips
- MailHog**
- ImageMagick**
** 선택 사항
터미널을 재시작하세요
이제 Discourse 의존성이 설치되었으므로, Discourse 자체를 설치하는 단계로 넘어가겠습니다.
터미널 재시작
셸을 종료하고 다시 시작하면 설치된 패키지의 경로가 터미널에 의해 올바르게 인식됩니다.
Discourse 클론
Discourse 저장소를 ~/discourse 폴더에 클론하세요:
git clone https://github.com/discourse/discourse.git ~/discourse
~는 홈 폴더를 나타내므로, Discourse 소스 코드는 홈 폴더에서 사용할 수 있게 됩니다.
Discourse 부트스트랩
Discourse 폴더로 이동하세요:
cd ~/discourse
필요한 gems를 설치합니다
bundle install
JS 의존성을 설치합니다
pnpm install
다음으로, 로컬 Discourse 인스턴스를 설정하려면 다음 명령을 실행하세요:
bundle exec rake db:create
bundle exec rake db:migrate
RAILS_ENV=test bundle exec rake db:create db:migrate
Rails + Ember 서버를 시작합니다. 여기에는 두 가지 옵션이 있습니다.
옵션 1: 두 개의 별도 터미널 탭/창을 사용하여 Rails와 프론트엔드 번들러를 각각 실행합니다
bundle exec rails server
그리고
bin/dev --only ember
옵션 2: 터미널 탭/창 하나만 사용:
bin/dev # Pitchfork와 프론트엔드 번들러를 함께 실행
이제 http://localhost:3000으로 이동하여 로컬 Discourse 설치를 볼 수 있어야 합니다. (서버 워밍업으로 인해 첫 번째 로딩에 최대 1분이 걸릴 수 있다는 점을 참고하세요.)
스펙(테스트)을 실행해 볼 수도 있습니다:
bundle exec rake autospec
모든(또는 거의 모든) 테스트가 통과해야 합니다.
새 관리자 생성
새 관리자를 생성하려면 다음 명령을 실행하세요:
RAILS_ENV=development bundle exec rake admin:create
프롬프트에 따라 관리자 계정을 생성하세요.
메일 구성
MailHog를 실행하세요:
mailhog
축하합니다! 이제 여러분은 자신의 Discourse 설치의 관리자가 되었습니다!
즐거운 개발 하세요! 그리고 시작하기 위해, Discourse 플러그인 생성 입문 가이드를 참고하세요.
이 문서는 버전 관리됩니다 - 변경 사항을 제안하려면 github에서 제안해 주세요.