IBM CloudのGitリポジトリを使ってみる

# はじめに
IBM Cloudでは、IBM Cloud上での開発をスムーズに行えるように、GitLab Community EditionをベースとしたGitリポジトリ・Issueトラッキングの機能を提供しています(2020年8月時点：GitLab Community Edition 12.9が使用されている模様）。

このサービスは、IBM Cloudの他のサービス・サーバを利用せずとも単独で利用することができ、ユーザ認証もIBMidを利用することができるため、少人数・小規模の開発であればお手軽に使うことができます。

また、IBM CloudのToolchainに組み込み、ビルド・デプロイを自動化するといったことも可能になります。

ここでは、IBM Cloud上でのGitリポジトリの作成・利用についてご紹介します。

# Gitリポジトリ作成の手順

IBM Cloudにログインし、画面上部の「カタログ」をクリックします。

次に画面左側に表示された「サービス」をクリックし、「Developer Tools」にチェックを入れます。
<img width="200" alt="image.png" src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/386149/35df28ef-560e-967a-5f6e-5e0ad807a73e.png">

絞られた内容から、以下の「Toolchain」を探し、クリックします。
<img width="300" alt="image.png" src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/386149/c65ca955-0bcc-f2ef-e318-5ec5c5cc42a6.png">

「ツールチェーンの作成」の画面で、一番下の「Build your ownツールチェーン」をクリックします。
<img width="300" alt="image.png" src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/386149/ce2d2736-3c97-2268-92ca-341a2fcf600d.png">


「ツールチェーン名」が自動で設定されるので少し待ちます。
もし「リージョンの選択」が「東京」になっていなければ、「東京」を選択し、「作成」ボタンをクリックします。
<img width="300" alt="image.png" src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/386149/208ea87a-94fc-c0ca-6b34-598fa03088d1.png">

画面右側の「ツールの追加」ボタンをクリックします。
<img width="" alt="image.png" src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/386149/4cbba27f-2672-7d71-9e35-f9f7cb7bfe16.png">

「GitリポジトリーおよびIssueトラッキング」をクリックします。
<img width="300" alt="image.png" src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/386149/135d905b-1bd7-72e4-6322-a4cad8a01440.png">

「リポジトリー名」にリポジトリの名前を入力し、「リポジトリー・タイプ」が「新規」であることを確認し、「統合の作成」ボタンをクリックします。
<img width="" alt="image.png" src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/386149/e252bc93-6015-f59d-9bac-213feae18bb1.png">

以下の画面で、「Git」（赤枠部分）をクリックします。
<img width="" alt="image.png" src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/386149/7aaced14-d851-e8fe-c075-eb47ef0fd97b.png">

すると、以下のようなGitLabのWeb画面に遷移し、あとはGitLabとして利用できるようになります。
<img width="600" alt="image.png" src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/386149/a0e2d415-b64b-bd99-2716-9c2a25b68b38.png">

このWeb画面のURLはブラウザのアドレスバーで確認ください。以降はそのURLに直アクセスでGitLabを利用できるようになります。


# Gitリポジトリの利用手順

作成したリポジトリをgit cloneして利用する際、GitLabのWeb画面でPersonal Access Tokenを作成しておく必要があります。

GitLabの画面の右上のアイコンをクリックし、「Settings」をクリックします。
<img width="300" alt="image.png" src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/386149/43a183b9-26e1-31b7-5a4f-9a36e1863daf.png">

「Access Tokens」をクリックし、「Name」に任意の名前を入力し、「read_repository」、「write_repository」にチェックを入れ、「Create personal access token」ボタンをクリックします。
<img width="600" alt="image.png" src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/386149/528455ac-9421-316b-b0b4-188c37e0ba9d.png">

これでPersonal Access Tokenが作成されますのでメモします。以降、トークンを参照することはできませんのでご注意ください。
あとは、git cloneなどを実行する際のパスワードとして作成したトークンを入力すれば、リポジトリをクローンすることができます。


# 複数メンバーで利用する場合

他の人にリポジトリへのアクセスを許可する場合、GitLabのWeb画面でメンバーの追加を実施してください(GitLabのWeb画面のトップ -> 画面左側メニューのSettings -> Members から追加する）。

GitLabのWeb画面の認証はIBMid、および、IBMidのパスワードで実施されます。そのため、追加対象者はIBMidを持っている必要があります。ただし、Toolchainサービスの属する（IBM Cloudの）アカウントに対象者を追加する必要はありません。
（git cloneなどのGitコマンドの実行時の認証は、前述の通り、パスワードとしてPersonal Access Tokenを使用します）