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

このガイドでは、Google Cloud Platform(GCP)インスタンスに GitLab をインストールする方法を説明します。

別のインストール方法:Googleは、すべての手順と外部リソースの設定を含む、Google Kubernetes Engine上で本番環境対応のGitLabをデプロイするためのホワイトペーパーを提供しています。 これらはGCP VMを使用する代わりに、クラウドネイティブのGitLab Helmチャートを使用します。

前提条件

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. GoogleコンソールのSSHボタンをクリックすると、新しいウィンドウが表示されます。

    SSH button

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

  2. お好みのテキストエディタでOmnibus GitLabの設定ファイルを編集します:

    sudo vim /etc/gitlab/gitlab.rb
    
  3. external_url の値を、GitLab にhttpsなしで持たせたいドメイン名に設定します:

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

    HTTPSの設定は次のステップで行いますので、今は不要です。

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

    sudo gitlab-ctl reconfigure
    
  5. これで、ドメイン名を使って GitLab にアクセスできるようになりました。

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

必要ではありませんが、GitLabをTLS証明書でセキュリティすることを強く推奨します。 Omnibusドキュメントの手順に従ってください。

電子メールのSMTP設定

メールのSMTP設定を正しくしないと、GitLabはコメントやパスワード変更などの通知メールを送信できません。 Omnibusのドキュメントを確認してください。

さらに読む

GitLabは他のOAuthプロバイダ、LDAP、SAML、Kerberosなどで認証するように設定することができます。以下は興味のあるドキュメントです: