（旧式の）Discourse開発環境設定ガイド - GitHub Codespace

コミュニティWiki 開発者
1

GitHub Codespaces を使用した開発

GitHub Codespace は、優れた開発オプションです。クラウドでホストされているため、ここで開発するすべての人が同じ環境を確実に持つことができ、ローカルの Docker インストールに対処する必要がなく、ローカル開発インスタンスを簡単に公開でき、新しいテクノロジーを使用するのは楽しいです。

現在、開発を再学習しており、Discourse の開発を学ぶことに加えて GitHub Codespaces を習得することにしました。そのため、ローカル環境をセットアップする代わりに Discourse を GitHub Codespace で開発したい人のために、このガイドを作成しました。

このガイドは、GitHub Codespace でこれを機能させる際に多くの問題が発生した後に作成しました。

このガイドでは、何も前提とせず、最初から最後まで手順を省略しないようにします。コアリポジトリレベルで GitHub Codespace の構成を改善できる可能性がある、または少なくとも私の理解不足によるものだと推測しています。遠慮なく指摘してください。

Discourse リポジトリをフォークする

  1. https://github.com/discourse/discourse に移動します

    chrome_N3ATb2nEQr
    chrome_N3ATb2nEQr1920×1552 234 KB

  2. ページ右上にある Fork ボタンをクリックし、次のページで緑色の Create fork ボタンをクリックします。

    chrome_Lzf54D0tBO
    chrome_Lzf54D0tBO1920×1552 82.9 KB

  3. 少し待つと、discourse/discourse リポジトリの新しいフォークに移動します。

    chrome_yfJYprVK55
    chrome_yfJYprVK551920×1552 196 KB

GitHub Codespace をセットアップする

  1. 緑色の \u003c\u003e Code ボタンをクリックします

    chrome_rv8QTxhurC
    chrome_rv8QTxhurC1920×1552 198 KB

  2. Codespaces タブに切り替えて、緑色の Create codoespace on main ボタンをクリックします。

    chrome_wPl6kT08KX
    chrome_wPl6kT08KX1920×1552 204 KB

  3. 新しいウィンドウに移動し、GitHub が codespace を作成します。これには 1〜3 分かかります。
    chrome_LYoRTOWojo

  4. 数分後、GitHub Codespace (ブラウザ内の VS Code) が表示されます。

    chrome_lf9Kjh7c1w
    chrome_lf9Kjh7c1w1920×1552 103 KB

Codespace 環境をセットアップする

起動する前に、codespace 環境にいくつかの構成を行う必要があります。

  1. 新しい bash シェルを作成します。Windows/Linux では Ctrl + Shift + backtick、Mac では Cmd + Shift + backtick をクリックします。シェルは /var/www/discourse ディレクトリから開始されるはずです。

    chrome_CGfJzV8kQ3
    chrome_CGfJzV8kQ31405×514 7.63 KB

  2. discourse ディレクトリに移動します。

cd workspace/discourse

chrome_YzWw7aHvxM
chrome_YzWw7aHvxM1405×514 10.8 KB

  1. プロジェクトの Gemfile からすべてをインストールします。
bundle install --gemfile ./Gemfile

コマンドはかなり長いですが、次のようなものが表示されます。

chrome_IB7yqvARSB
chrome_IB7yqvARSB1404×1199 51.8 KB

  1. development.rb に新しい config.hosts を追加します。
    1. 現在のディレクトリ (/var/www/discourse/workspace/discourse) から config/environments/development.rb ファイルを開きます。
    2. config.hosts \u003c\u003c /\\A(([a-z0-9-]+)\\.)*localhost(\\:\\d+)?\\Z/ という行を見つけ、その下に次の行を作成してファイルを保存します。
config.hosts \u003c\u003c /^(.*)\\.app\\.github\\.dev$/

ファイルの末尾は、私のスクリーンショットの 102 行目のように見えるはずです。

chrome_gMmENBChWD
chrome_gMmENBChWD1537×614 42.4 KB

  1. ターミナルに戻り、bundle exec rake admin:create を実行して最初のアドミンアカウントを作成します。コマンドは、メールアドレスとパスワードを選択するように求めます (パスワードは 10 文字以上である必要があります)。
    chrome_0AgdDsZCih
    chrome_0AgdDsZCih963×420 29.3 KB

エンジンサーバーを起動する

サーバーのビルドと起動には 1〜2 分かかります。この時点で、アプリケーションを実行およびアクセスするために必要なすべてが揃っているはずです。

  1. 現在のターミナルで、次のコマンドを実行してサーバーを起動します。
bin/ember-cli -u

chrome_k13sEIlXL5
chrome_k13sEIlXL51378×819 72.6 KB

  1. コンソールで Terminal タブから PORTS タブに切り替えます。

    image
    image1537×298 14.3 KB

  2. Windows/Linux では Ctrl + click、Mac では Cmd + click を使用して、ポート 4200 の Forwarded Address をクリックすると、開発環境が表示されます。

    chrome_xK56iLoxN2
    chrome_xK56iLoxN21918×1464 46.7 KB

これが GitHub Codespaces の開始に役立つことを願っています！ :tada:

「いいね！」 11
2

素晴らしい、身軽に旅行するのに良い選択肢ですね。

「いいね！」 2
3

それか、私の場合は、WindowsとDockerで開発したくありませんが、自宅でUnix環境に切り替えたくもありません（職場では使用していますが）。

すべてがGitHubリポジトリにそのまま存在するという考えが気に入っています。

「いいね！」 3
4

このガイドは更新が必要だと思います。ステップ5を実行しても、データベースがまだ作成されていないため、機能しません。

「いいね！」 1
5

以下のコマンドを実行して動作させることができました。

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

次に

bin/rails db:create
bin/rails db:migrate
RAILS_ENV=test bin/rails db:create db:migrate

その後

bin/ember-cli -u

分割されたターミナルで

bin/rails admin:create
「いいね！」 1
6

@jordan-violet これは unsupported-install だと推測しますか？ app.yml が見つからないため、プラグインをインストールできません。

7

プラグインをインストールするには、Install plugins in your non-Docker development environment の手順に従ってください。

「いいね！」 3
8

プラグインコードのフォルダにプラグインフォルダからシンボリックリンクを作成します

「いいね！」 2
9

@jordan-violet、以前は必要だったすべての回避策を含むこのガイドを作成していただきありがとうございます :pray:

devcontainer/codespaces の構成に多くの変更をマージしたことをお知らせできることを嬉しく思います。これにより、フォークしたり手動で構成したりすることなく、物事を簡単に開始できるようになります。

公式ガイドはこちらです。

OP の上部に、公式ガイドへの誘導を追加します :writing_hand:

「いいね！」 6