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

Google Cloud PlatformへのGitLabのインストール

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

公式のLinuxパッケージを使用すると、Google Cloud Platform（GCP）にGitLabをインストールできます。必要に応じてカスタマイズする必要があります。ニーズに合わせてカスタマイズしてください。

本番環境対応のGitLabをGoogle Kubernetes Engineにデプロイするには、Google Cloud PlatformのClick to Deploy手順に従ってください。これは、GCP VMを使用する代わりの方法であり、Cloud native GitLab Helmチャートを使用します。

前提要件

GCPにGitLabをインストールするには、2つの前提条件があります:

  1. Googleアカウントを持っている必要があります。
  2. GCPプログラムにサインアップする必要があります。初めての場合は、Googleから60日間で使用できる300ドルのクレジットが無料で提供されます。

これらの2つの手順を実行したら、VMを作成できます。

VMの作成

GCPにGitLabをデプロイするには、仮想マシンを作成する必要があります:

  1. https://console.cloud.google.com/compute/instancesにアクセスし、Google認証情報でサインインします。

  2. 作成を選択します。

    「インスタンスを作成」を選択してインスタンスを作成します。

  3. 次のページでは、VMのタイプと予想コストを選択できます。インスタンスの名前、希望するデータセンター、およびマシンタイプを入力します。さまざまなユーザーベース規模に対するハードウェア要件に注意してください。

    インスタンスを構成します。

  4. サイズ、種類、および必要なオペレーティングシステムを選択するには、Boot diskの下の変更を選択します。完了したら選択を選択します。

  5. 最後の手順として、HTTPおよびHTTPSトラフィックを許可し、作成を選択します。プロセスは数秒で完了します。

GitLabのインストール

数秒後、インスタンスが作成され、サインインできるようになります。次のステップでは、GitLabをインスタンスにインストールします。

インスタンスが正常に作成されました。

  1. 後の手順で必要になるため、インスタンスの外部IPアドレスをメモしてください。

  2. connect列のSSHを選択して、インスタンスに接続します。

  3. 新しいウィンドウが表示され、インスタンスにログインします。

    インスタンスのコマンドラインインターフェース

  4. 次に、https://about.gitlab.com/install/で、選択したオペレーティングシステム用のGitLabをインストールする手順に従います。前にメモした外部IPアドレスをホスト名として使用できます。

  5. おつかれさまでした。GitLabがインストールされ、ブラウザからアクセスできるようになりました。インストールを完了するには、ブラウザーでURLを開き、最初の管理者パスワードを入力します。このアカウントのユーザー名はrootです。

    インストール後のGitLabの最初のサインイン。

次の手順

これらは、GitLabを初めてインストールした後に実行する最も重要な次のステップです。

静的IPの割り当て

デフォルトでは、Googleは一時的なIPをインスタンスに割り当てます。ドメイン名を持つ本番環境でGitLabを使用する場合は、静的IPを割り当てる必要があります。

詳細については、一時的な外部IPアドレスのプロモートを参照してください。

ドメイン名の使用

ドメイン名を所有していて、前の手順で構成した静的IPを指すようにDNSが正しく設定されていると仮定すると、変更を認識するようにGitLabを構成する方法は次のとおりです:

  1. VMにSSH接続します。GoogleコンソールでSSHを選択すると、新しいウィンドウがポップアップ表示されます。

    SSHボタンを使用してログインするインスタンスの詳細。

    将来的には、代わりにSSHキーで接続を設定することをお勧めします。

  2. お気に入りのエディタを使用して、Linuxパッケージの設定ファイルを編集します:

    sudo vim /etc/gitlab/gitlab.rb

  3. external_url値を、GitLabで使用するドメイン名にhttpswithout（なし）で設定します:

    external_url 'http://gitlab.example.com'

    次の手順でHTTPSを設定するため、今すぐ行う必要はありません。

  4. 変更を有効にするには、GitLabを再構成します:

    sudo gitlab-ctl reconfigure

  5. これで、ドメイン名を使用してGitLabにアクセスできます。

ドメイン名を使用したHTTPSの構成

必須ではありませんが、TLS証明書を使用してGitLabを保護することを強くお勧めします。

メールSMTP設定の構成

メールSMTP設定を正しく構成する必要があります。そうしないと、GitLabはコメントやパスワードの変更などの通知メールを送信できません。その方法については、Linuxパッケージドキュメントを確認してください。

さらに詳しく

GitLabは、LDAP、SAML、Kerberosなどの他のOAuthプロバイダーで認証するように構成できます。興味のあるドキュメントを次に示します: