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

公式のLinuxパッケージを使って、Google Cloud Platform(GCP)にGitLabをインストールできます。必要に応じてカスタマイズしてください。

note
本番環境で使えるGitLabをGoogle Kubernetes Engine上にデプロイするには、Google Cloud PlatformのClick to Deploy ステップに従ってください。 これはGCP VMを使う代わりに、](https://github.com/GoogleCloudPlatform/click-to-deploy/blob/master/k8s/gitlab/README.md)クラウドネイティブのGitLab Helm](https://github.com/GoogleCloudPlatform/click-to-deploy/blob/master/k8s/gitlab/README.md)チャートを使います。

前提条件

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

  1. Googleアカウントを持っていること。
  2. GCPプログラムに登録する必要があります。初めてご利用になる場合、Googleは$300のクレジットを60日間にわたって無料で提供します。

この2つのステップを実行した後、VMを作成することができます。

VMの作成

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

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

  2. 作成」を選択します。

    Search for GitLab

  3. 次のページでは、VMのタイプと見積もりコストを選択できます。インスタンス名、希望するデータセンター、マシンタイプを入力します。ユーザーベースのサイズ別のハードウェア要件に注意してください。

    Launch on Compute Engine

  4. サイズ、タイプ、および希望するオペレーション・システムを選択するには、Boot disk の下にあるChangeを選択します。 完了したらSelectを選択します。

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

GitLabのインストール

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

Deploy settings

  1. インスタンスの外部 IP アドレスを控えておきましょう。後のステップで必要になるからです。
  2. インスタンスに接続するために、接続欄でSSHを選択します。

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

    GitLab first sign in

  4. 次に、選択したオペレーティングシステム用に GitLab をインストールするための手順https://about.gitlab.com/install/ に従います。ホスト名には、先ほど説明した外部 IP アドレスを使います。

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

    GitLab first sign in

次のステップ

GitLabを初めてインストールした後に取るべき最も重要な次のステップです。

固定IPの割り当て

デフォルトでは、GoogleはインスタンスにエフェメラルIPを割り当てます。GitLabをプロダクションで使用していて、以下のようにドメイン名を使用している場合は、静的IPを割り当てることを強くお勧めします。

エフェメラルIPアドレスを昇格させる方法についてはGoogleのドキュメントをお読みください。

ドメイン名の使用

ドメイン名を持っていて、前のステップで設定した固定IPを指すようにDNSを正しく設定したと仮定して、GitLabが変更を認識するように設定する方法を説明します：

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

    SSH button

    将来的には、SSHキーで接続するように設定すると良いでしょう。

  2. Linux パッケージの設定ファイルをお好みのテキストエディタで編集してください：

    sudo vim /etc/gitlab/gitlab.rb

  3. external_url の値を、httpsなしでGitLab に持たせたいドメイン名に設定します：

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

    次のステップで HTTPS を設定するので、今は設定する必要はありません。

  4. 変更を有効にするために GitLab を再設定します：

    sudo gitlab-ctl reconfigure

  5. ドメイン名を使って GitLab にアクセスできるようになりました。

ドメイン名を使ったHTTPSの設定

必須ではありませんが、GitLabをTLS証明書でセキュリティすることを強く推奨します。

メールのSMTP設定

電子メールのSMTP設定を正しく行わないと、GitLabはコメントやパスワード変更などの通知メールを送信できません。Linux パッケージのドキュメントを参照してください。

さらに読む

GitLabは、LDAP、SAML、Kerberosのような他のOAuthプロバイダで認証するように設定することができます。興味のあるドキュメントをいくつか紹介します：