相対URLでGitLabをインストール

プラン: Free、Premium、Ultimate
提供形態: GitLab Self-Managed

GitLabは専用の（サブ）ドメインにインストールする必要がありますが、さまざまな理由により、それが不可能な場合があります。その場合、GitLabは相対URL（例: https://example.com/gitlab）でインストールすることもできます。

このドキュメントでは、ソースからインストールする場合の、相対URLでGitLabを実行する方法について説明します。公式のLinuxパッケージを使用している場合は、手順が異なります。GitLabを初めてインストールする場合は、このガイドをインストールガイドと併せて使用してください。

相対URLのネストされた深さに制限はありません。たとえば、問題なく/foo/bar/gitlab/gitでGitLabを提供できます。

既存のGitLabインストールでURLを変更すると、すべてのリモートURLが変更されるため、GitLabインスタンスを指すローカルリポジトリで手動で編集する必要があります。

相対URLからGitLabを提供するために変更する必要がある設定ファイルのリストは次のとおりです:

/home/git/gitlab/config/initializers/relative_url.rb
/home/git/gitlab/config/gitlab.yml
/home/git/gitlab/config/puma.rb
/home/git/gitlab-shell/config.yml
/etc/default/gitlab

すべての変更後、アセットを再コンパイルし、GitLabを再起動する必要があります。

相対URLの要件

相対URLでGitLabを設定すると、アセット（JavaScript、CSS、フォント、画像など）を再コンパイルする必要があり、CPUとメモリのリソースを大量に消費する可能性があります。メモリ不足エラーを回避するには、コンピューターで少なくとも2 GBのRAMを使用できるようにする必要があります。4 GBのRAMと、4つまたは8つのCPUコアをお勧めします。

詳細については、ドキュメントの要件を参照してください。

GitLabで相対URLを有効にする

相対URLに関するWebサーバーの設定ファイルは変更しないでください。相対URLのサポートは、GitLab Workhorseによって実装されています。

このプロセスは以下を想定しています:

GitLabは/gitlabで提供されます
GitLabがインストールされているディレクトリは/home/git/です

GitLabで相対URLを有効にするには:

オプション。リソースが不足している場合は、次のコマンドを使用してGitLabサービスをシャットダウンすることにより、一時的にメモリを解放できます:
```
sudo service gitlab stop
```

/home/git/gitlab/config/initializers/relative_url.rbを作成します

cp /home/git/gitlab/config/initializers/relative_url.rb.sample \
   /home/git/gitlab/config/initializers/relative_url.rb

そして、次の行を変更します:

config.relative_url_root = "/gitlab"

/home/git/gitlab/config/gitlab.ymlを編集し、次の行のコメントを解除するか、変更します:
```
relative_url_root: /gitlab
```
/home/git/gitlab/config/puma.rbを編集し、次の行のコメントを解除するか、変更します:
```
ENV['RAILS_RELATIVE_URL_ROOT'] = "/gitlab"
```
/home/git/gitlab-shell/config.ymlを編集し、次の行に相対パスを追加します:
```
gitlab_url: http://127.0.0.1/gitlab
```
インストールガイドに記載されているように、提供されたsystemdサービス、またはinitスクリプトとデフォルトファイルをコピーしたことを確認してください。次に、/etc/default/gitlabを編集し、gitlab_workhorse_optionsで、次のように読み取るように-authBackend設定を設定します:
```
-authBackend http://127.0.0.1:8080/gitlab
```
カスタムinitスクリプトを使用している場合は、必要に応じて上記のGitLab Workhorse設定を編集してください。
変更を反映させるため、GitLabを再起動します。

GitLabで相対URLを無効にする

相対URLを無効にするには:

/home/git/gitlab/config/initializers/relative_url.rbを削除します
手順2から始まる上記の手順に従い、相対パスを含まないGitLab URLをセットアップします。