GitLab コードホスティングプラットフォームをデプロイする

• ECS インスタンスで Alibaba Cloud Linux 3 が実行されている場合、インストールパッケージを使用して JiHu GitLab のみをインスタンスにインストールできます。Alibaba Cloud Linux 3 に GitLab Community Edition をインストールするには、Docker イメージを使用します。

• JiHu GitLab でサポートされているオペレーティングシステムについては、「サポートされているオペレーティングシステム」を参照してください。

1. GitLab をインストールする ECS インスタンスに接続します。

   詳細については、「Workbench を使用して SSH 経由で Linux インスタンスに接続する」をご参照ください。

2. Docker をインストールします。詳細については、「Docker をインストールする」をご参照ください。

3. GitLab の構成、ログ、データファイルなど、GitLab データを格納するディレクトリを作成します。

   sudo mkdir -p /srv/gitlab 

4. $GITLAB_HOME 環境変数を構成します。

   export GITLAB_HOME=/srv/gitlab

5. GitLab コンテナイメージをインストールします。

   GitLab Community Edition

   JiHu GitLab

   sudo docker run --detach \
     --hostname gitlab.example.com \
     --publish 443:443 --publish 80:80 --publish 2222:22 \
     --name gitlab \
     --restart always \
     --volume $GITLAB_HOME/config:/etc/gitlab \
     --volume $GITLAB_HOME/logs:/var/log/gitlab \
     --volume $GITLAB_HOME/data:/var/opt/gitlab \
     --shm-size 256m \
     gitlab/gitlab-ce:latest

   コンテナパラメータ	ホストパラメータの説明
   hostname	ホスト名。このパラメータには、ECS インスタンスのパブリック IP アドレスを指定することをお勧めします。
   publish 443:443	ホストのポート 443 をコンテナのポート 443 にマップして、HTTPS アクセスを許可します。ホストポートがすでに使用されていることを示すエラーメッセージが表示された場合は、ホストのポート 443 を、publish 8443:443 のポート 8443 などの非標準ポートに置き換えます。 説明 ホストのポート 443 をポート 8443 などの非標準ポートに置き換える場合は、ECS インスタンスのセキュリティグループにインバウンドルールを追加して、非標準ポートを開く必要があります。詳細については、「セキュリティグループルールを追加する」をご参照ください。
   publish 80:80	ホストのポート 80 をコンテナのポート 80 にマップして、HTTP アクセスを許可します。ホストポートがすでに使用されていることを示すエラーメッセージが表示された場合は、ホストのポート 80 を、publish 8080:80 のポート 8080 などの非標準ポートに置き換えます。 説明 ホストのポート 80 をポート 8080 などの非標準ポートに置き換える場合は、ECS インスタンスのセキュリティグループにインバウンドルールを追加して、非標準ポートを開く必要があります。詳細については、「セキュリティグループルールを追加する」をご参照ください。
   publish 2222:22	ホストのポート 2222 をコンテナのポート 22 にマップして、SSH を許可します。コードのクローン、プッシュ、プルなどの Git 操作を実行する場合は、SSH を使用する必要があります。 説明 ECS インスタンスの SSH のデフォルトポートはポート 22 です。 デフォルトの SSH ポートをポート 2222 などの非標準ポートに置き換えた後、ECS インスタンスのセキュリティグループにインバウンドルールを追加して非標準ポートを開き、gitlab.rb ファイルの SSH ポート番号を変更する必要があります。

   次の表に、ECS インスタンスとコンテナ間のパスマッピングを示します。

   ECS インスタンスパス	コンテナパス	説明
   $GITLAB_HOME/data	/var/opt/gitlab	アプリケーションデータを格納します。
   $GITLAB_HOME/logs	/var/log/gitlab	GitLab ログファイルを格納します。
   $GITLAB_HOME/config	/etc/gitlab	GitLab 構成ファイルを格納します。

   sudo docker run --detach \
     --hostname gitlab.example.com \
     --publish 443:443 --publish 80:80 --publish 2222:22 \
     --name gitlab \
     --restart always \
     --volume $GITLAB_HOME/config:/etc/gitlab \
     --volume $GITLAB_HOME/logs:/var/log/gitlab \
     --volume $GITLAB_HOME/data:/var/opt/gitlab \
     --shm-size 256m \
     registry.gitlab.cn/omnibus/gitlab-jh:latest

   コンテナパラメータ	ホストパラメータの説明
   hostname	ホスト名。このパラメータには、ECS インスタンスのパブリック IP アドレスを指定することをお勧めします。
   publish 443:443	ホストのポート 443 をコンテナのポート 443 にマップして、HTTPS アクセスを許可します。ホストポートがすでに使用されていることを示すエラーメッセージが表示された場合は、ホストのポート 443 を、publish 8443:443 のポート 8443 などの非標準ポートに置き換えます。 説明 ホストのポート 443 をポート 8443 などの非標準ポートに置き換える場合は、ECS インスタンスのセキュリティグループにインバウンドルールを追加して、非標準ポートを開く必要があります。詳細については、「セキュリティグループルールを追加する」をご参照ください。
   publish 80:80	ホストのポート 80 をコンテナのポート 80 にマップして、HTTP アクセスを許可します。ホストポートがすでに使用されていることを示すエラーメッセージが表示された場合は、ホストのポート 80 を、publish 8080:80 のポート 8080 などの非標準ポートに置き換えます。 説明 ホストのポート 80 をポート 8080 などの非標準ポートに置き換える場合は、ECS インスタンスのセキュリティグループにインバウンドルールを追加して、非標準ポートを開く必要があります。詳細については、「セキュリティグループルールを追加する」をご参照ください。
   publish 2222:22	ホストのポート 2222 をコンテナのポート 22 にマップして、SSH を許可します。コードのクローン、プッシュ、プルなどの Git 操作を実行する場合は、SSH を使用する必要があります。 説明 ECS インスタンスの SSH のデフォルトポートはポート 22 です。 デフォルトの SSH ポートをポート 2222 などの非標準ポートに置き換えた後、ECS インスタンスのセキュリティグループにインバウンドルールを追加して非標準ポートを開き、gitlab.rb ファイルの SSH ポート番号を変更する必要があります。

   次の表に、ECS インスタンスとコンテナ間のパスマッピングを示します。

   ECS インスタンスパス	コンテナパス	説明
   $GITLAB_HOME/data	/var/opt/gitlab	アプリケーションデータを格納します。
   $GITLAB_HOME/logs	/var/log/gitlab	GitLab ログファイルを格納します。
   $GITLAB_HOME/config	/etc/gitlab	GitLab 構成ファイルを格納します。

6. コンテナのステータスを表示します。

   sudo docker ps -a

   コンテナが正常な状態であれば、GitLab コンテナが起動しています。

   

GitLab は、プロジェクトの更新やパスワードのリセットに関する通知など、メール通知を送信するためにメール転送エージェントを必要とします。ほとんどの場合、簡易メール転送プロトコル（SMTP）サービスは、ECS インスタンスのポート 25 を使用してメールを送信します。デフォルトでは、セキュリティを確保するために、ECS インスタンスのポート 25 はブロックされています。メールを送信するには、SSL 暗号化ポート（ほとんどの場合ポート 465）を使用することをお勧めします。共通ポートについては、「共通ポート」をご参照ください。SMTP を構成するには、次の手順を実行します。

1. 外部 SMTP サーバーを構成する。

2. SMTP 構成を確認します。

   1. gitlab-rails console コマンドを実行して、Rails コンソールにログインします。

   2. 次のコマンドを実行して、テストメールを送信します。

      Notify.test_email('destination_email@address.com', 'メッセージの件名', 'メッセージ本文').deliver_now

   3. 宛先メールボックスでテストメールが受信されているかどうかを確認するか、ECS インスタンスで sudo tail -f /var/log/mail.log コマンドを実行してメールログを表示します。

• ECS インスタンスに GitLab をインストールした後、各プロジェクトリポジトリのデータはインスタンスの /var/opt/gitlab/git-data ディレクトリに格納され、リポジトリは repositories サブフォルダに格納されます。

• 次のバックアップ方法のいずれかを使用できます。

  • プロジェクトリポジトリ内のデータのみを保存する場合は、ECS インスタンスに接続されているディスクのスナップショットを作成します。詳細については、「スナップショットを作成する」および「ECS ディザスタリカバリソリューション」トピックの「スナップショットを使用してデータをバックアップおよび復元する」セクションをご参照ください。

  • プロジェクトリポジトリデータ、GitLab 構成、インストールされているソフトウェアなど、完全なデータをバックアップする場合は、ECS インスタンスからイメージを作成します。詳細については、「インスタンスからカスタムイメージを作成する」および「ECS ディザスタリカバリソリューション」トピックの「イメージを使用してデータをバックアップおよび復元する」セクションをご参照ください。

  • 複数の ECS インスタンスに GitLab サーバーをデプロイする場合は、次の手順を実行します。

    1. NAS ファイルシステム（NAS）を作成する GitLab データを格納します。

    2. 複数の ECS インスタンスに NAS ファイルシステムを同時にマウントする インスタンスが GitLab データを共有できるようにします。

    3. プロジェクトリポジトリのデータストレージパスとして、NAS ファイルシステムのマウントパスを指定します。詳細については、「Git データを別のディレクトリに格納する」を参照してください。

ユーザーが ECS インスタンスのパブリック IP アドレスを使用して GitLab Web サイトにアクセスできるようにすると、インスタンスのセキュリティが危険にさらされます。ドメイン名を持っている場合、または GitLab Web サイトのドメイン名を登録する場合は、次の手順を実行します。

1. ドメイン名を登録します。

   詳細については、「Alibaba Cloud でドメイン名を登録する」をご参照ください。

2. ドメイン名のインターネットコンテンツプロバイダ（ICP）ファイリングを申請します。

   ドメイン名の Web サイトが中国本土リージョンにある ECS インスタンスでホストされている場合は、ICP ファイリングを申請します。

3. 登録済みドメイン名を解決します。ドメイン名解決設定を構成すると、外部ユーザーはドメイン名を使用して GitLab Web サイトにアクセスできます。

   ドメイン名を使用して GitLab Web サイトにアクセスする場合は、ドメイン名解決が前提条件です。詳細については、「初心者向けガイド」をご参照ください。

4. HTTPS 暗号化アクセスを有効にします。Let's Encrypt for free automatic HTTPS などの無料サービス、または SSL Certificates Service などの有料サービスを使用します。

5. セキュリティグループルールを追加する。ECS インスタンスのセキュリティグループにインバウンドルールを追加します。セキュリティ上の理由から、許可された IP アドレスのみが特定のポートにアクセスできるようにすることをお勧めします。

   • パッケージのインストール：ポート 443（HTTPS）

   • Docker イメージのインストール：docker run コマンドで指定されたホスト HTTPS ポート

6. gitlab.rb ファイルの external_url パラメータを変更します。次の図は、構成結果を示しています。

   • パッケージのインストール：「GitLab の外部 URL を構成する」を参照してください。

   • Docker イメージのインストール：「構成ファイルを編集する」を参照してください。

     

• 4 vCPU と 8 GiB のメモリ未満のインスタンスタイプを使用して GitLab をインストールすると、インストールプロセスが [インストール中] 状態のまま長時間続いたり、失敗したりする可能性があります。この場合は、GitLab をインストールする前に、インスタンスタイプをスペックアップしてください。インスタンスタイプをスペックアップする方法については、「インスタンス構成の変更の概要」をご参照ください。

• SSH 経由で ECS インスタンスに接続できない場合は、Virtual Network Computing（VNC）を使用してインスタンスに接続し、スワップスペースを構成してから、Sidekiq を最適化できます。詳細については、「メモリ制約のある環境での GitLab の実行」を参照してください。

• ECS インスタンスの vCPU 使用率、ネットワークトラフィック、およびディスク I/O 操作を監視します。詳細については、「ECS インスタンスの監視情報を表示する」をご参照ください。

デフォルトでは、ECS インスタンスは SSH にポート 22 を使用します。Docker イメージを使用して GitLab をインストールする場合は、ホストのポート 22 を別のポートに置き換え、gitlab_rails['gitlab_shell_ssh_port'] パラメータを変更する必要があります。次の手順を実行します。

1. Docker を起動するときに、ポート 2222 などの非標準ポートを指定します。例：publish 2222:22。

2. GitLab 構成ファイルを変更します。

   1. sudo docker exec -it gitlab /bin/bash コマンドを実行して、セッションを開始します。

   2. /etc/gitlab/gitlab.rb ファイルを編集します。

   3. gitlab_rails['gitlab_shell_ssh_port'] パラメータを 2222 に設定します。

   4. gitlab-ctl reconfigure コマンドを実行して、GitLab を再構成します。

3. プロジェクトページを開き、構成を確認します。