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

OpenSUSEとSLESにLinuxパッケージをインストールする

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

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

前提要件

  • OS要件:
    • openSUSE Leap 15.6
    • SLES 12
    • SLES 15 SP6
  • 最小ハードウェア要件については、インストール要件を参照してください。
  • 開始する前に、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 sshd

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

    sudo firewall-cmd --permanent --add-service=http
sudo firewall-cmd --permanent --add-service=https
sudo firewall-cmd --permanent --add-service=ssh
sudo systemctl reload firewalld

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

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

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

    sudo zypper install curl

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

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

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

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

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

sudo EXTERNAL_URL="https://gitlab.example.com" zypper install gitlab-ee
sudo EXTERNAL_URL="https://gitlab.example.com" zypper 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" zypper install gitlab-ee
sudo GITLAB_ROOT_EMAIL="admin@example.com" GITLAB_ROOT_PASSWORD="strongpassword" EXTERNAL_URL="https://gitlab.example.com" zypper install gitlab-ce

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

メールサブスクリプション設定センターにアクセスして、ご連絡が必要な場合をお知らせください。当社では明示的なメールオプトインポリシーを採用しているため、当社から送信するメールの内容と頻度を完全に管理できます。

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

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

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