LinuxパッケージでGitLabをインストールします。

前提条件

  • インストール要件。
  • mygitlabinstance.com のようにドメイン名を使ってGitLabインスタンスにアクセスしたい場合は、ドメインがGitLabをインストールしているサーバーのIPを正しく指していることを確認してください。host mygitlabinstance.com というコマンドで確認できます。
  • GitLabインスタンスでHTTPSを使いたい場合は、ドメインのSSL証明書を用意してください。(コンテナレジストリのように、独自のサブドメインを持つことができる特定のコンポーネントでは、それらのサブドメイン用の証明書も必要になることに注意してください)。
  • 通知メールを送信したい場合は、SendmailやPostfixのようなメールサーバ(MTA) をインストールして設定してください。あるいは、他のサードパーティのSMTPサーバを使用することもできます。

インストールと設定

これらの設定は、Linuxパッケージのインストールを構成する際に一般的に使用されます。設定の完全なリストについては、READMEファイルを参照してください。

初期パスワードの設定

GitLab 14.0 で導入されました。

デフォルトでは、Linuxパッケージのインストールは自動的に初期管理者ユーザーアカウントのパスワードを生成し(root)、少なくとも24時間/etc/gitlab/initial_root_password に保存します。セキュリティ上の理由から、24時間が経過すると、このファイルは最初のgitlab-ctl reconfigure によって自動的に削除されます。

note
インストール中にGitLabがサーバーの有効なホスト名を検出できなかった場合、再設定は実行されません。

カスタムの初期rootパスワードを設定するには、2つのオプションがあります：

  • GITLAB_ROOT_PASSWORD 環境変数をインストールコマンドに渡す(サーバのホスト名が正しく設定されている場合)：

     sudo GITLAB_ROOT_PASSWORD="<strongpassword>" EXTERNAL_URL="http://gitlab.example.com" apt install gitlab-ee

    インストール中に GitLab が自動的に再設定を行わない場合、最初のgitlab-ctl reconfigure 実行時にGITLAB_ROOT_PASSWORD 変数を渡す必要があります。

  • 最初のリコンフィギュアの前に、/etc/gitlab/gitlab.rb を編集して（存在しない場合は作成して）設定してください：

     gitlab_rails['initial_root_password'] = '<my_strong_password>'

これらの方法はどちらも、最初のリコンフィギュアで行われる最初のデータベース・シード時にのみ適用されます。それ以降のリコンフィギュアの実行では、前述の方法はいずれも効果がありません。その場合は、/etc/gitlab/initial_root_password のランダムパスワードを使用してログインするか、root パスワードをリセットしてください。

Dockerイメージの使用

GitLabが提供するDockerイメージを使ってGitLabインスタンスをインストール・設定することもできます。詳しくはドキュメントをご覧ください。

Linuxパッケージ（Omnibus）のアンインストール

Linux パッケージをアンインストールするには、データ (リポジトリ、データベース、設定) を保持するか、すべてを削除するかを選択できます：

  1. オプション。Linux パッケージによって作成されたすべてのユーザーとグループを削除してからパッケージを削除するには (apt またはyum を使用)：

    sudo gitlab-ctl stop && sudo gitlab-ctl remove-accounts
    note
    アカウントやグループの削除に問題がある場合は、userdel またはgroupdel を手動で実行して削除してください。また、/home/に残っているユーザーのホームディレクトリを手動で削除することもできます。

  2. データを残すか、すべて削除するかを選択してください：

    • データ（リポジトリ、データベース、設定）を保持するには、GitLabを停止し、監視プロセスを削除します：

       sudo systemctl stop gitlab-runsvdir
 sudo systemctl disable gitlab-runsvdir
 sudo rm /usr/lib/systemd/system/gitlab-runsvdir.service
 sudo systemctl daemon-reload
 sudo systemctl reset-failed
 sudo gitlab-ctl uninstall

    • 全てのデータを削除するには

       sudo gitlab-ctl cleanse && sudo rm -r /opt/gitlab

  3. パッケージをアンインストールしてください（GitLab FOSSをインストールしている場合は、gitlab-ce に置き換えてください）：

    # Debian/Ubuntu
sudo apt remove gitlab-ee
   
# RedHat/CentOS
sudo yum remove gitlab-ee