このガイドでは、プライベートなGitHubリポジトリからDiscourseのテーマまたはテーマコンポーネントをインストールする方法を説明します。
必要なユーザーレベル：管理者
概要
このドキュメントでは、プライベートなGitHubリポジトリからDiscourseのテーマまたはテーマコンポーネントをインストールする手順について説明します。安全なアクセスを確保するためのSSHキーの生成と使用手順が含まれます。DiscourseインスタンスとインストールするGitHubリポジトリの両方で管理者アクセス権限が必要になります。これにより、フォーラムで独自のプライベートテーマとテーマコンポーネントを使用する方法がわかります。
前提条件
始める前に、以下が揃っていることを確認してください。
- Discourseインスタンスへの管理者アクセス
- テーマまたはコンポーネントを含むプライベートGitリポジトリ
- Gitリポジトリにデプロイキーを追加するためのアクセス権（管理者/オーナーレベル）
ステップバイステップガイド
- プライベートなGitHubリポジトリに移動し、「Clone SSH」タブからSSHアドレスをコピーします。
2. Discourseの管理パネルに移動します。
3. 管理サイドバーで、「
Appearance > Themes and components」に移動し、「Themes」または「Components」タブを選択します（インストールするものによって異なります）。 4. 「
Install」をクリックし、次に「From a git repository」を選択します。
5. ステップ1でコピーしたSSHアドレスを貼り付けます。形式は「
git@github.com:USERNAME/REPO-NAME.git」である必要があります。
SSHでクローンするリンクを使用するようにしてください。
httpsで始まるリンクは使用しないでください。
6. SSHキーが自動的に生成され、新しいテキストボックスに表示されます。
7. そのボックスの右上隅にあるコピーアイコンをクリックして、新しいSSHキーをコピーします。この時点ではインストールボタンをクリックしたり、このモーダルを閉じたりしないでください。
8. 次に、プライベートなGitHubリポジトリの設定に移動します（例：GitHubの場合、「
Settings > Deploy keys」に移動します）。
9. 新しいデプロイキーを追加します。適切なタイトルを付ける必要があります。DiscourseからコピーしたSSHキーをデプロイキーフィールドに貼り付けます。
10. 「
Add key」をクリックして、Gitリポジトリ設定にデプロイキーを保存します。
11. Discourseのテーマインストールモーダルに戻り、「
Install」ボタンをクリックします。これで、新しいテーマまたはコンポーネントの設定ページが表示されるはずです。
ベストプラクティス
- リポジトリには、常にSSH URLを使用し、HTTPS URLは使用しないでください。
- デプロイキーは安全に保管し、公開しないでください。
- 最新の機能とセキュリティアップデートを入手するために、テーマやコンポーネントは定期的に更新してください。
よくある質問
Q: この方法はGitHub以外のGitプロバイダーでも使用できますか？
A: はい、この方法はデプロイキーまたはSSH認証をサポートする任意のGitプロバイダーで機能するはずです。
Q: Discourseは将来のアップデートのためにSSHキーを記憶しますか？
A: はい、Discourseは生成された秘密鍵を保存し、将来のGitリポジトリへのアクセスに使用します。
Q: 後でプライベートリポジトリを変更できますか？
A: はい、必要に応じてテーマ設定でリポジトリURLを更新できます。
追加リソース
このトピックで使用されているSSHキーは、このドキュメントのために生成されたもののみです