正式なドキュメントは英語版であり、この日本語訳はAI支援翻訳により作成された参考用のものです。日本語訳の一部の内容は人間によるレビューがまだ行われていないため、翻訳のタイミングにより英語版との間に差異が生じることがあります。最新かつ正確な情報については、英語版をご参照ください。

UbuntuにLinuxパッケージをインストールする

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

サポートされているディストリビューションとアーキテクチャの完全なリストについては、サポートされているプラットフォームを参照してください。

前提要件

  • OS要件:
    • Ubuntu 20.04
    • Ubuntu 22.04
    • Ubuntu 24.04
  • 最小ハードウェア要件については、インストール要件を参照してください。
  • 開始する前に、DNSを設定していることを確認してください。以下のコマンドのhttps://gitlab.example.comを、お好みのGitLab URLに置き換えてください。GitLabは、そのアドレスで自動的に構成され、起動されます。
  • https:// URLの場合、GitLabは自動的にLet’s Encryptで証明書をリクエストしますが、これには受信HTTPアクセスと有効なホスト名が必要です。独自の証明書を使用することも、暗号化されていないURLの場合はhttp://（sなし）を使用することもできます。

SSHを有効にして、ファイアウォールポートを開きます

必要なファイアウォールポート（80、443、22）を開き、GitLabにアクセスできるようにするには:

  1. OpenSSHサーバーデーモンを有効にして起動します:

    sudo systemctl enable --now ssh

  2. ufwがインストールされている状態で、ファイアウォールポートを開きます:

    sudo ufw allow 22/tcp
sudo ufw allow 80/tcp
sudo ufw allow 443/tcp
sudo ufw enable

GitLabパッケージリポジトリを追加します

GitLabをインストールするには、まずGitLabパッケージリポジトリを追加します。

  1. 必要なパッケージをインストールします:

    sudo apt install -y curl

  2. 次のスクリプトを使用してGitLabリポジトリを追加します（スクリプトのURLをブラウザに貼り付けて、bashにパイプする前に何をするかを確認できます）:

    curl "https://packages.gitlab.com/install/repositories/gitlab/gitlab-ee/script.deb.sh" | sudo bash
    curl "https://packages.gitlab.com/install/repositories/gitlab/gitlab-ce/script.deb.sh" | sudo bash

パッケージをインストールします

システムのパッケージマネージャーを使用して、GitLabをインストールします。

EXTERNAL_URLの設定は必須ではありませんが、推奨されています。インストール時に設定しなかった場合は、後で設定できます。

sudo EXTERNAL_URL="https://gitlab.example.com" apt install gitlab-ee
sudo EXTERNAL_URL="https://gitlab.example.com" apt install gitlab-ce

GitLabは、/etc/gitlab/initial_root_passwordに格納されているルート管理者アカウントのランダムなパスワードとメールアドレスを24時間生成します。24時間後、セキュリティ上の理由から、このファイルは自動的に削除されます。

最初のサインイン

GitLabをインストールしたら、設定したURLにアクセスし、次の認証情報を使用してサインインします:

  • ユーザー名: root
  • パスワード: /etc/gitlab/initial_root_passwordを参照してください

サインイン後、パスワードとメールアドレスを変更してください。

高度な設定

インストール前に次のオプションの環境変数を設定することで、GitLabのインストールをカスタマイズできます。これらの変数は、最初のインストール中にのみ機能します。また、後続の再構成の実行には影響しません。既存のインストールでは、/etc/gitlab/initial_root_passwordのパスワードを使用するか、ルートパスワードをリセットします。

変数目的必須例
EXTERNAL_URLGitLabインスタンスの外部URLを設定します推奨EXTERNAL_URL="https://gitlab.example.com"
GITLAB_ROOT_EMAILルート管理者アカウントのカスタムメールオプションGITLAB_ROOT_EMAIL="admin@example.com"
GITLAB_ROOT_PASSWORDルート管理者アカウントのカスタムパスワード（最小8文字）オプションGITLAB_ROOT_PASSWORD="strongpassword"

GitLabがインストール時に有効なホスト名を検出できない場合、再構成は自動的に実行されません。この場合は、必要な環境変数を最初のgitlab-ctl reconfigureコマンドに渡します。

gitlab_rails['initial_root_password']を設定して、/etc/gitlab/gitlab.rbに初期パスワードを設定することもできますが、推奨されません。パスワードがクリアテキストであるため、セキュリティ上のリスクがあります。これが構成されている場合は、インストール後に必ず削除してください。

GitLabエディションを選択し、上記の環境変数でカスタマイズします:

sudo GITLAB_ROOT_EMAIL="admin@example.com" GITLAB_ROOT_PASSWORD="strongpassword" EXTERNAL_URL="https://gitlab.example.com" apt install gitlab-ee
sudo GITLAB_ROOT_EMAIL="admin@example.com" GITLAB_ROOT_PASSWORD="strongpassword" EXTERNAL_URL="https://gitlab.example.com" apt install gitlab-ce

コミュニケーション設定を行います

コミュニケーションをいつ取るかをお知らせいただくために、メール購読設定センターにアクセスしてください。明示的なメールオプトインポリシーがあるため、メールの送信内容と頻度を完全に制御できます。

月に2回、新機能、インテグレーション、ドキュメント、開発チームからの舞台裏ストーリーなど、知っておく必要のあるGitLabニュースをお届けします。バグやシステムパフォーマンスに関連する重要なセキュリティアップデートについては、専用のセキュリティニュースレターにサインアップしてください。

セキュリティニュースレターにオプトインしない場合、セキュリティアラートは届きません。

インストールが完了したら、推奨される次のステップ（認証オプションやサインアップ制限など）を検討してください。