インストール

GitLabはほとんどのGNU/Linuxディストリビューションや多くのクラウドプロバイダーにインストールすることができます。 GitLabから最高の体験を得るためには、パフォーマンス、信頼性、管理のしやすさ(バックアップ、アップグレード、トラブルシューティング)、ホスティングのコストのバランスをとる必要があります。

GitLabのインストール方法はプラットフォームによって様々です:

  1. OmnibusGitLab: PostgreSQL、Redis、Sidekiqなど、GitLabとそれに依存する様々なコンポーネントをバンドルした公式deb/rpmパッケージ。
  2. GitLab Helm chart: GitLabとそのすべてのコンポーネントをKubernetesにインストールするためのクラウドネイティブのHelm chartです。
  3. Docker: Omnibus GitLabパッケージのdocker化。
  4. ソース:GitLabとそのコンポーネントをゼロからインストールします。
OmnibusGitLabパッケージは成熟しており、スケーラブルで、現在GitLab.comで使用されています。 Kubernetesに慣れている方にはOmnibusチャートがおすすめです。

要件

GitLabをインストールする前に、システム要件をレビューすることが非常に重要です。 システム要件には、GitLabをサポートするための最小限のハードウェア、ソフトウェア、データベース、その他の要件の詳細が含まれています。

Omnibus GitLab パッケージは公式の deb/rpm リポジトリを使用します。 ほとんどのユーザーにはこれが推奨されます。

さらなる柔軟性と回復力が必要な場合は、リファレンスアーキテクチャのドキュメントに記載されているようにGitLabをデプロイすることをお勧めします。

> Omnibus GitLabパッケージを使ってGitLabをインストールします。

GitLab HelmチャートによるKubernetesへのGitLabインストール

Kubernetesの経験が必要:GitLabをプロダクションにデプロイするためにKubernetesを使用する前に、Kubernetesに精通していることをお勧めします。 管理の方法、観測可能性、いくつかの概念は、従来のデプロイとは異なります。

KubernetesにGitLabをインストールする際には、いくつかのトレードオフに注意する必要があります:

  • 管理およびトラブルシューティングにはKubernetesの知識が必要です。
  • デフォルトのインストールでは、ほとんどのサービスが冗長構成でデプロイされるため、シングルノードのOmnibusデプロイよりも多くのリソースが必要になります。
  • 注意すべき機能制限がいくつかあります。

> GitLab Helmチャートを使ってKubernetesにGitLabをインストールします。

Dockerを使ったGitLabのインストール

GitLabはOmnibus GitLabパッケージをベースにした公式Dockerイメージのセットを維持しています。

> 公式のGitLab Dockerイメージを使ってGitLabをインストールします。

ソースからの GitLab のインストール

OmnibusのGitLabパッケージがディストリビューションにない場合は、ソースからGitLabをインストールすることができます。 ディレクトリ構造の概要については、構造ドキュメントをお読みください。

> GitLab をソースからインストールします。

クラウドプロバイダーへのGitLabインストール

GitLabは、クラウドプロバイダーが対応していれば、上記のいずれかの方法で様々なクラウドプロバイダーにインストールすることができます。

  • AWSへのインストール:GitLabが提供するコミュニティAMIを使用して、AWS上にOmnibus GitLabをインストールします。
  • Google Cloud PlatformにGitLabをインストール:GCPのVMにOmnibus GitLabをインストールします。
  • AzureにGitLabをインストール:Azure MarketplaceからOmnibus GitLabをインストールします。
  • OpenShiftにGitLabをインストール:GitLabのHelmチャートを使ってOpenShiftにGitLabをインストールします。
  • DC/OSにGitLabをインストール:GitLab-Mesosphereインテグレーションを介してMesosphere DC/OSにGitLabをインストールします。
  • GitLabをDigitalOceanにインストール: Omnibus GitLabをDigitalOceanにインストールします。
  • テストのみ! DigitalOceanとDocker Machine: Docker Machineを使用して、DigitalOcean上でGitLabの任意のバージョンを素早くテストできます。

GitLabインストールのセキュリティ

インストールが完了したら、GitLabインスタンスをセキュリティで保護するための推奨プラクティスをご確認ください。