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

Amazon Linux 2にLinuxパッケージをインストール

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

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

前提要件

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

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 yum 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" yum install gitlab-ee
sudo EXTERNAL_URL="https://gitlab.example.com" yum install gitlab-ce

GitLabは、管理者アカウントのランダムな認証情報とメールアドレスを生成し、24時間/etc/gitlab/initial_root_passwordに保存します。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" yum install gitlab-ee
sudo GITLAB_ROOT_EMAIL="admin@example.com" GITLAB_ROOT_PASSWORD="strongpassword" EXTERNAL_URL="https://gitlab.example.com" yum install gitlab-ce

コミュニケーション設定を行う

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

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

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

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