🇨🇳 Discourse 公式インストールガイド | Discourse クラウドプラットフォームインストール

[honeymoose]

このドキュメントは、discourse/docs/INSTALL-cloud.md at main · discourse/discourse · GitHub ページの内容を翻訳したものです。

翻訳元の原文は以下の場所で公開されています：https://www.isharkfly.com/t/discourse/13590。議論への参加を歓迎します。

クラウドプラットフォームへのインストール

クラウドプラットフォームでの Discourse インストールは通常 30 分以内で完了します。Rails や Linux シェルの知識が全くなくても、スムーズにインストールできます。以下では、DigitalOcean サービスプロバイダーを使用してインストールテストを行っていますが、すべてのインストール手順は Docker に準拠したすべてのクラウドコンピューティングプラットフォームで実行可能であり、ローカルサーバーでのインストールも可能です。

30 分も時間がない場合は？Discourse コミュニティにインストールを依頼することもできます。Discourse コミュニティでは、一回限りの 150 ドルの手数料を徴収します。こちらのリンクからサービスを購入してください。

事前準備

ドメイン名

Discourse は IP アドレスでは動作しません。インストールにはドメイン名またはサブドメイン（例：example.com）が必要です。

• ドメイン名をすでに所有している場合は、任意のサブドメイン（例：discourse.example.com、talk.example.com、forum.example.com）を選択して Discourse インスタンスをインストールできます。
• ドメイン名を持っていない場合は、NameCheap ウェブサイトでお好みのドメインを検索するか、Google で great domain name registrars を検索して、お好みのドメイン登録事業者を選択してください。
• ドメイン名を購入した後、DNS 設定にアクセスして DNS を設定できる必要があります。インストールする Discourse ウェブサイトについては、DNS を介して A レコード を作成する必要があります。この A レコードは、インストールするドメイン名を特定の IP アドレス（通常は 1 段階目で購入したサーバーの IP アドレス）に指し示すように設定します。

メール

メールシステムは、Discourse でのユーザー作成プロセスにおいて非常に重要です。 インストール前にメール SMTP サーバーを設定していない場合、インストールされた Discourse にはアクセスできず、ログインもできません（サイトが破損した状態になります）！

• すでに独自の SMTP メールサーバーを持っている場合は、既存のメールサーバー設定情報をそのまま使用できます。
• メールサーバーを持っていない場合は、Discourse が推奨するメールサーバー を参照してください。
• メールが正常に配信されるようにするには、DNS に有効な SPF および DKIM レコード を追加する必要があります。設定方法については、メールサービスプロバイダーのドキュメントを参照してください。

実際の使用経験に基づくと、Discourse のインストールには必須として使用可能なドメイン名とメールサーバーの構成が必要です。中国国内の場合、アリババクラウドやテンセントクラウドが提供する企業メールを使用できます。通常、AWS SES や MailGun などの海外のメールサーバーを使用することをお勧めします。認証には国際クレジットカードが必要になる場合があります。ただし、このステップは必須であり、これを省略すると Discourse のインストールは完了しません。

どうしても中国国内で適切な SMTP サーバーが見つからず、急いでインストールしたい場合は、間違った設定で一度インストールを完了させ、その後 Discourse のインストールディレクトリでコンソールから手動で管理者アカウントを作成してください。

./launcher enter app
rails admin:create

インストール

新しいクラウドサーバーの作成

新しいクラウドサーバーを作成します。例：DigitalOcean ですが、他のプラットフォームが提供するサーバーを使用することも可能です。

中国本土内のサーバーを選択した場合、ネットワークの問題に遭遇する可能性が高いです。この翻訳版では、ネットワーク問題の解決策に関するセクションを追加しています。

• デフォルト設定では、現在の LTS Ubuntu オペレーティングシステムが正常に動作します。最低限、64 ビット Linux オペレーティングシステムが必要であり、カーネルは最新バージョンに更新されている必要があります。
• デフォルト設定では、1 GB のメモリで小規模な Discourse コミュニティを十分に動作させることができます。ただし、大規模なコミュニティには 2 GB のメモリを推奨します。
• デフォルト設定では、ニューヨークのデータセンターが北米およびヨーロッパにとって地理的に優れた選択肢です。Discourse ユーザーが他の地理的な位置にいることが多ければ、より近いデータセンターを選択できます。
• DigitalOcean で Droplet（Droplet は DigitalOcean におけるサーバー名の定義）を作成するために、ドメイン名 discourse.example.com を入力してください。もちろん、独自のドメイン名を購入して使用することもできます。通常、Discourse のインストールには実際のドメイン名が必要であり、IP アドレスではインストールできないため、まずドメイン名を購入するか、既存のドメイン名のサブドメインを使用することをお勧めします。

新しい Droplet を作成するプロセスは、DigitalOcean 上でサーバーを作成することと同等であり、他のプラットフォームで VPS やサーバーを作成することにも相当します。作成が完了すると、Root ユーザーのパスワードが記載された電子メールが届きます。ただし、サーバーへのアクセスセキュリティを強化するために、SSH キーの設定 を行うことをお勧めします。

クラウドサーバーへのアクセス

IP アドレスを使用して SSH で接続し、作成したサーバーにアクセスするか、Windows プラットフォームの場合は Putty をインストールして以下のコマンドを実行して接続します。

ssh root@192.168.1.1

SSH キーを設定していない場合は、DigitalOcean から送信された電子メールに記載されたパスワードを使用してログインするか、ローカルの SSH キーを使用して接続します。

Docker / Git のインストール（オプション）

sudo apt install docker.io
sudo apt install git

独自の Docker バージョンを使用したい場合は、新規設定したサーバーで現在インストールできます。サーバーにデフォルトで Docker がインストールされていない場合、discourse-setup が自動的に get.docker.com からダウンロードしてインストールします。

このステップでネットワーク問題に遭遇しましたか？Ubuntu ミラーサイト利用ガイド | 清華大学オープンソースミラーサイト | Tsinghua Open Source Mirror をお試しください。

Discourse のインストール

公式 Discourse Docker インストール リポジトリからコードをローカルコンピューターの /var/discourse ディレクトリにクローンします。

sudo -s
git clone https://github.com/discourse/discourse_docker.git /var/discourse
cd /var/discourse

このステップでネットワーク問題に遭遇しましたか？以下のコマンドをお試しください：

git config --global url."https://mirror.ghproxy.com/https://github.com/".insteadOf "https://github.com/"

上記のコマンドを実行するだけで、Discourse インストール中に root 権限が必要です。

Docker イメージの追加（中国本土のサーバーのみ）

サーバーが中国本土にある場合、以下の手順で Docker のステップで停止する可能性が高いです。Docker イメージの追加を試みてください。

テンセントクラウドを例に挙げると、お好みのエディターで Linux の /etc/docker/daemon.json を編集し、以下の内容を追加してください。https://mirror.ccs.tencentyun.com をクラウドサーバープロバイダーが提供する Docker イメージの URL に変更してみてください。

{
   "registry-mirrors": [
   "https://mirror.ccs.tencentyun.com"
  ]
}

Docker イメージを追加した後、sudo systemctl restart docker を実行して Docker アプリケーションの変更を再起動します。

Discourse 設定の編集

以下のコマンドで設定ツールを実行します。

./discourse-setup

以下のプロンプトに従ってすべてのパラメータを設定してください。

Hostname for your Discourse? [discourse.example.com]: 
Email address for admin account(s)? [me@example.com,you@example.com]: 
SMTP server address? [smtp.example.com]: 
SMTP port? [587]: 
SMTP user name? [user@example.com]: 
SMTP password? [pa$word]: 
Let's Encrypt account email? (ENTER to skip) [me@example.com]: 

上記の入力データは、Discourse インスタンス用の app.yml ファイルを作成し、インストール後に Discourse インスタンスを設定します。インストールの起動プロセスには、Discourse の設定に 2〜8 分 程度かかる場合があります。インストール中にエラーが発生した場合、またはインストール後に設定を変更する必要がある場合は、./discourse-setup コマンドを再度実行してください（このコマンドは既存の app.yml ファイルを再読み込みします）。あるいは、/containers/app.yml ファイルの内容を手動で直接編集し、その後 ./launcher rebuild app を再度実行してください。そうしないと、変更は反映されません。

中国のネットワーク環境の最適化

クラウドサーバーが中国本土にある場合、./discourse-setup または ./launcher rebuild app を実行する際にネットワーク問題に遭遇する可能性が高いです。Docker 以外のイメージサービスは Discourse によって既に用意されていますので、containers/app.yml の以下の部分に 1 行を追加するだけで済みます。

templates:
  - "templates/postgres.template.yml"
  - "templates/redis.template.yml"
  - "templates/web.template.yml"
  - "templates/web.china.template.yml" # この行を追加して、npm、rubygems などのパッケージマネージャーのミラーを設定

これで解決します。

Discourse の起動

初期インストール設定が完了すると、Discourse インスタンスは設定したドメイン名 discourse.example.com を介してブラウザからアクセスできるようになります。

中国本土のサーバーの場合、クラウドサーバープロバイダーの指示に従って ICP 登録（備案）を完了させてから次のステップに進む必要がある場合があります。

新しい管理者アカウントの登録

起動設定プロセスで入力したメールアドレスを使用して、管理者アカウントを登録します。

（管理者アカウント（Admin）を登録できない場合は、パス /var/discourse/shared/standalone/log/rails/production.log のログを確認するか、メール問題のトラブルシューティングチェックリスト を参照してください。）

管理者アカウントの登録が完了すると、セットアップウィザードが起動し、Discourse インスタンスの設定方法について案内されます。

すべてのセットアップウィザードが完了すると、Staff topics（スタッフトピック）と READ ME FIRST: Admin Quick Start Guide が表示されます。この設定ウィザードには、以降の設定に関する提案や、Discourse インスタンスのカスタマイズ方法が含まれています。

インストール後のメンテナンス

• オペレーティングシステムのセキュリティ自動更新を有効にすることを強くお勧めします。Ubuntu では dpkg-reconfigure -plow unattended-upgrades コマンドを使用します。CentOS/RHEL では yum-cron パッケージを使用します。
• SSH キーではなくパスワードでオペレーティングシステムにログインしている場合は、強力なパスワードを使用していることを確認してください。Ubuntu では apt-get install libpam-cracklib パッケージを使用します。fail2ban の使用を推奨します。これは、3 回ログインに失敗した IP アドレスを 10 分間ログイン禁止にするものです。
• Ubuntu: apt-get install fail2ban
• CentOS/RHEL: sudo yum install fail2ban（EPEL が必要です）
• デフォルトでファイアウォールをインストールしたい場合は、Ubuntu の場合は ufw を有効化 し、CentOS/RHEL 7 以降の場合は firewalld を使用してください。

Discourse に新しいバージョンの更新がある場合、メールアドレスに更新通知が届きます。すべてのセキュリティ問題が修正されるよう、Discourse インスタンスを常に最新バージョンに更新してください。You will get email reminders as new versions of Discourse are released. Please stay current to get the latest features and security fixes. Discourse を最新バージョンに更新するには、ブラウザから /admin/upgrade にアクセスし、更新ボタンをクリックしてください。

/var/discourse ディレクトリ内の launcher コマンドは、システムレベルのメンテナンスに使用されます。

Usage: launcher COMMAND CONFIG [--skip-prereqs] [--docker-args STRING]
Commands:
    start:      Start/initialize a container（コンテナの起動/初期化）
    stop:       Stop a running container（実行中のコンテナの停止）
    restart:    Restart a container（コンテナの再起動）
    destroy:    Stop and remove a container（コンテナの停止と削除）
    enter:      Use nsenter to get a shell into a container（nsenter を使用してコンテナ内のシェルにアクセス）
    logs:       View the Docker logs for a container（コンテナの Docker ログの表示）
    bootstrap:  Bootstrap a container for the config based on a template（テンプレートに基づいてコンテナの設定を初期化し起動）
    rebuild:    Rebuild a container (destroy old, bootstrap, start new)（コンテナの再構築：古いコンテナを削除し、初期化し、新しいコンテナを起動）
    cleanup:    Remove all containers that have stopped for > 24 hours（24 時間以上停止しているコンテナの削除）

Options:
    --skip-prereqs             Don't check launcher prerequisites（インストーラーの環境チェックをスキップ）
    --docker-args              Extra arguments to pass when running docker（コンテナ実行時に渡す追加引数）

[wjljack (王俊龙)]

翻訳もよくできていて、素晴らしいです。公式に多言語への入口があることを願っています。

[honeymoose]

ありがとうございます。

Discourse を利用している際も、日本語コンテンツが非常に少ないことに気づきましたが、Discourse というプラットフォーム自体は非常に優れています。

インストールには多少の難易度と前提条件があり、単一のマシンだけで完結するものではありません。

しかし、基本的にはそれらをうまく回避できるため、すでに社内から公開されている一部の内容を公式に提出することにしました。

公式側は非常に協力的でオープンですが、どのように配置すれば適切か迷い、少し散らかった印象を与えてしまっています。

時間とともに、すでに持っている記事も公式へ順次提出していく予定です。

[th21]

元々中国語フォーラムがあったのですが、年初に閉鎖されたようです。

[honeymoose]

これに会ったことを覚えています。インストールする際にも、彼らの記事をいくつか参考にしました。

おそらく元の管理者もメンテナンスする時間がなかったのでしょう。サイトを維持するには、相当な労力と経費がかかります。

Discourse については私たちも詳しくなく、長らく Discuz を使っていました。しかし、Discuz がテンセントに買収されてから数年間更新されず、問題が山積みで、アップグレードもできなくなってしまいました。

そこで代替品を探そうとしたところ、Discourse を発見し、インストールして使ってみたところ、非常に気に入りました。

そこで、自分たちの利用体験を自社のセクションにまとめました：iSharkFly - 飞鲨

次第に、中文の資料があまりにも少ないことに気づき、公式にも何かシェアしようと思いました。

サイトを継続して運営するのは本当に大変です。

Discourse を多くの人に使ってほしいです。利用者が増えれば盛り上がり、それだけ興味も湧いてくるはずです。

[th21]

@fantasticfears これはたぶん中国語版サイトの管理人ですよね……でも最終アクセスが2019年で、サーバーの更新を忘れたのか他の理由なのか、中国語版サイトが急に消えてしまいました。

[honeymoose]

時間がないのかもしれませんね。

まあ、没关系、公式フォーラムでぶらぶらしましょう。呵呵。

[neo (R.Zhang)]

中国ユーザーが中心の中文コミュニティにとって、Discourseのローカライゼーションはまだ不十分です。そもそもユーザーの利用習慣が異なるためです。

[honeymoose]

これは事実です。文字列マッピング方式で翻訳されているものはすべてこの問題を抱えています。

翻訳された文字列やソート順序が少し奇妙です。

しかし、Discourse は非常に優れています。特に添付ファイルのアップロードは驚くほど便利です。

コンテンツは Markdown 形式ですが、一般ユーザーにとっては学習コストが少し高いものの、十分に使えます。

最も重要なのは、データとストレージが分離されている点です。これには本当に称賛せざるを得ません。ほぼ無制限の添付ファイル容量、CDN の標準搭載、そして添付ファイルのバックアップが不要なため、スクリーンショットを多用する方にとってはまさに最高です。

[honeymoose]

@honeymoose

翻訳元記事は以下に公開されています：Discourse クラウド プラットフォームのインストール - Discourse - OSSEZ 、ディスカッションへの参加を歓迎します。

OSSEZ コミュニティはドメイン名を変更し、この記事は Discourse 云平台安装 - Discourse - iSharkFly に公開されました。

[Lhc_fl (Linca)]

中国のネットワーク環境の最適化という章を追加しました。