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

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

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

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

前提要件

  • OS要件:
    • Amazon Linux 2023
  • 最小ハードウェア要件については、インストール要件を参照してください。
  • 開始する前に、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 dnf install -y 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" dnf install gitlab-ee
sudo EXTERNAL_URL="https://gitlab.example.com" dnf install gitlab-ce

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

最初のサインイン

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

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

サインイン後、パスワードとメールアドレスを変更します。

高度な設定

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

変数目的必須例
EXTERNAL_URLGitLabインスタンスの外部URLを設定します推奨EXTERNAL_URL="https://gitlab.example.com"
GITLAB_ROOT_EMAILroot管理者アカウントのカスタムメールオプションGITLAB_ROOT_EMAIL="admin@example.com"
GITLAB_ROOT_PASSWORDroot管理者アカウントのカスタムパスワード（最小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" dnf install gitlab-ee
sudo GITLAB_ROOT_EMAIL="admin@example.com" GITLAB_ROOT_PASSWORD="strongpassword" EXTERNAL_URL="https://gitlab.example.com" dnf install gitlab-ce

コミュニケーションの設定

メールサブスクリプション設定センターにアクセスして、連絡が必要な時期をお知らせください。メールの明示的なオプトインポリシーがあるため、メールの送信内容と頻度を完全に制御できます。

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

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

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