序章


GitLabは、集中型サーバー上のgitリポジトリを管理するための優れた方法です。 GitHubのようなソリューションは多くのプロジェクトに最適なオプションですが、すべてのチームのニーズに適合するわけではありません。 GitLabを使用すると、リポジトリを完全に制御でき、リポジトリをパブリックにするかプライベートにするかを無料で決定できます。

DigitalOceanにはGitLabワンクリックインストールイメージがあり、VPSインスタンスにGitLabサーバーを簡単にデプロイできます。 ここでDigitalOceanにGitLabをセットアップできます。

このガイドでは、環境を構成し、プロジェクトをアップロードし、ユーザーを招待して管理できるように、GitLabインターフェースについて説明します。 インストール手順を完了し、GitLabインスタンスにログインできることを前提としています。

ユーザープロファイルを構成する方法


GitLabを使用してプロジェクトを処理する前に、プロファイルを正しく設定することをお勧めします。 これは、チームメートがあなたを識別するのに役立つだけでなく、インターフェイスやプロジェクトへの接続方法を管理できる場所でもあります。

右上隅にある[プロファイル設定]ボタンをクリックすることから始めます。

DigitalOcean GitLab profile settings button

第一画面では、アカウントに関連付けられている名前とメールアドレスを変更できます。 ソーシャルメディアアカウントをリンクしたり、短い経歴を書いたり、好きな写真をアップロードしたりすることもできます。

ユーザー名も変更したい場合は、上部の「アカウント」タブをクリックしてください。 ここで、リポジトリが保存されるユーザー名を調整できます。 アクセストークンにもアクセスできます。

DigitalOcean GitLab account settings

間違いなく調べたいもう1つの項目は、「SSHキー」タブです。 このタブで、「SSHキーの追加」ボタンをクリックします。

ここで、gitを介してサーバーと通信するために使用するSSHキーを追加できます。 ユーザーごとに複数のキーを追加できます。 SSHキーを追加し、[キーの追加]をクリックします。

DigitalOcean GitLab add SSH key

必要に応じて、これはアプリケーションとコードプレビューのテーマを変更する良い機会でもあります。 「デザイン」タブをクリックします。 5つのアプリケーションテーマと4つの人気のあるコードプレビューテーマから選択できます。

DigitalOcean GitLab design tab

ユーザーとグループを管理する方法


GitLabは、プロジェクト、ユーザー、グループを1つの画面から管理するためのツールを提供します。 右上隅にある[管理エリア]ボタンをクリックしてアクセスします。

DigitalOcean GitLab admin area button

インターフェイスは、プロジェクト、最新のプロジェクト、ユーザー、最新のユーザー、グループ、統計の6つのセクションに分かれています。 私たちが使用する主な連絡先は、プロジェクト、ユーザー、およびグループです。

新しいユーザーを作成する


現在、ユーザーは1人だけで、グループのプロジェクトはありません。 後で使用できるデモンストレーションユーザーを作成することから始めましょう。 中央の列にある[新しいユーザー]ボタンをクリックします。

DigitalOcean GitLab new user button

通常の連絡先を記入する必要があります。 完了したら、下部にある[ユーザーの作成]ボタンをクリックします。

DigitalOcean GitLab create user

新しいユーザーのアカウントページに移動します。 アカウントのメールアドレスに初期パスワードが記載されたメールアドレスが送信されます。

新しいグループを作成する


今すぐ新しいグループを追加しましょう。 右上隅にある[管理エリア]ボタンをもう一度クリックします。 右の列にある[新しいグループ]ボタンをクリックします。

DigitalOcean GitLab new group button

グループを作成するために必要なのは、名前と説明を入力することだけです。 「グループの作成」ボタンをクリックします。

DigitalOcean GitLab create group screen

グループが作成され、所有者としてグループに自動的に追加されます。 このグループにもデモアカウントを追加しましょう。

「グループにユーザーを追加:」というタイトルのボックスで2番目のユーザー名を検索します。 ユーザーのアクセスレベルも選択する必要があります。 GitLabで利用できるさまざまなアクセス許可レベルの説明については、次を参照してください。

your_domain.com / help / permits

これは、「プロジェクトの権限について詳しくはこちら」の下のボックスにあるリンクとしても利用できます。

今のところ、どのレベルを選択してもかまいません。 「ユーザーをグループに追加」をクリックして、アクセスを追加します。

DigitalOcean GitLab add users to group

ユーザーの権限レベルを変更する場合は、新しい権限でユーザーを再度追加できます。 それに応じて更新されます。

プロジェクトを初期化する


これで、プロジェクトを初期化できます。 前と同じように「管理領域」ボタンをクリックして、管理ダッシュボードに戻ります。 左側の「新規プロジェクト」ボタンをクリックします。

DigitalOcean GitLab new project button

上部のナビゲーションバーにある[新しいプロジェクト]ボタンをクリックして、この領域にアクセスすることもできます。

DigitalOcean GitLab top new project button

名前と名前空間を選択します。 名前空間は、プロジェクトの所有者です。 作成したグループにプロジェクトの所有権を付与します。 また、説明を入力して、リポジトリを公開するかどうかを選択する必要があります。

別のサイトからリポジトリをインポートすることもできます。 「既存のリポジトリのインポート」リンクをクリックして、この機能にアクセスできます。

DigitalOcean GitLab create project

プロジェクトをローカルコンピューターに複製する方法、またはローカルプロジェクトをGitLabの新しいリポジトリにプッシュする方法を示すページが表示されます。

リポジトリのクローンを作成し、グループメンバー(または公開されている場合は他の人)と共有するために使用できるリポジトリリンクが提供されます。

DigitalOcean GitLab initial project

指示に従うと、最初のコミットをGitLabリポジトリにプッシュできるはずです。

GitLabでプロジェクトを管理する


サンプルプロジェクトをGitLabリポジトリに追加して、プロジェクトに履歴があり、多くのコミットがある場合に利用できる機能の一部を確認できるようにします。

手順を実行して、新しいプロジェクトを作成します。 それを「レール」と呼びます。 今回は「既存リポジトリのインポート」リンクをクリックします。 MichaelHartlのRubyonRailsチュートリアルサンプルアプリケーションを使用します。

[既存のリポジトリのインポート]フィールドに、次のように入力します。

https://github.com/mhartl/sample_app.git

「プロジェクトの作成」をクリックします。

プロジェクトコードを表示


プロジェクトのランディングページに移動する必要があります。 「ファイル」タブをクリックして、実際のリポジトリファイルを表示します。

DigitalOcean GitLab repo files

「Gemfile」ファイルをクリックします。 ご覧のとおり、認識されている言語には、優れた構文の強調表示が含まれています。

DigitalOcean GitLab gemfile

プロジェクトに複数のブランチがある場合は、マスタードロップダウンをクリックしてブランチビューを変更し、別のブランチに切り替えることができます。

DigitalOcean GitLab switch branch

レビューコミット


「コミット」タブをクリックして、現在のブランチのコミットのリストを表示します。

DigitalOcean GitLab commit history

任意のコミットをクリックすると、コミットによって生成された差分を確認できます。 プロジェクト全体を任意のコミットポイントで表示する場合は、そのコミットに関連付けられている[コードの参照]リンクをクリックします。

DigitalOcean GitLab browse code

2つのコミットの違いを確認するには、上部の[比較]タブをクリックします。 左側のボックスにコミットの1つの名前を入力すると(この場合はe3c055dffを使用します)、2つの間の完全な差分を取得できます。

DigitalOcean GitLab commit diff

プロジェクトのグラフィック表現


プロジェクトは、2つの異なる方法でグラフィカルに表示できます。

まず、「ネットワーク」タブをクリックすると、プロジェクトのコミットツリーが表示されます。 これにより、ブランチ、マージ、およびコミットを確認できます。 簡単に識別できるように、各コミットの横にもユーザーの写真が使用されます。

DigitalOcean GitLab commit tree

プロジェクトのグラフィック画像を取得するもう1つの方法は、[グラフ]タブを使用することです。 プロジェクトのコミット数と時間の関係を示す大きなグラフが表示されます。 その下には、各寄稿者の一致するグラフがあります。

DigitalOcean GitLab commit graph

プロジェクトグラフの一部を選択すると、それに応じてユーザーのグラフが調整されます。 ドロップダウンメニューから、コミットの代わりに追加または削除を表示するように選択することもできます。

結論


GitLabには、チームで使用する予定がある場合に確認する必要のある他のツールが含まれています。 これには、各プロジェクトの埋め込みWiki、問題追跡システム、およびマージリクエストが含まれます。 特定のプロジェクトの外部で小さなコードを共有するために、GitLabはスニペットもサポートしています。

ほとんどのチームにとって、適切に構成されたGitLabは、プロジェクトを処理するのに十分すぎるほどです。 シンプルなユーザーコントロールと簡単なプロジェクトの作成と共有を提供します。 インターフェースを調べて、プロジェクトにとって簡単な解決策になるかどうかを確認してください。

ジャスティン・エリングウッド