GitLab

GitLabは、GitLab社が開発したDevOpsツールです。GitLabサーバーからプロジェクトをクローンし、Gitを使用してローカルおよびリモートリポジトリを管理することができます。

GitLab を使用するには、GitLab サーバーへの接続を作成し、作業したいプロジェクトをクローンします。以前にクローンしたプロジェクトをプロジェクト設定で GitLab にリンクすると、「バージョン管理」ビューでイベント通知を受け取ることができます。

GitLabサーバーへの接続

GitLabサーバーに接続するには、サーバーのホスト名とポート番号、およびGitLabでQt Creator 用に作成したアクセストークンを指定します。トークンの権限スコープは、少なくともread_api またはapi である必要があります。

GitLab サーバーへの接続を指定するには、Preferences >Version Control >GitLab に移動します：

GitLab サーバーを追加するには：

1. 「Add 」を選択して、「Add Server 」ダイアログを開きます。

   

2. 「Host 」に、GitLabサーバーのホスト名を入力します。
3. 「Description 」で、リンクされたプロジェクトのGitLab設定に表示される自由形式のテキストを入力します。
4. 「Access token 」で、GitLab サーバーの「Preferences 」>「Access Tokens 」でQt Creator 用に作成したアクセストークンを入力します。
5. Port に、ポート番号を入力します。
6. HTTPS のチェックを外すと、セキュア接続の代わりにHTTP接続が使用されます。
7. 「Add 」を選択して接続を作成します。

[GitLab ] タブで、[curl ] には、HTTP 接続に使用されるcurl ツールへのパスが表示されます。Qt Creator が検出したものとは別のツールのインスタンスを使用するには、別のパスを指定してください。

選択した接続を編集するには、[Edit] を選択します。

選択した接続を削除するには、[Remove] を選択します。

プロジェクトのクローン作成

接続済みのGitLabサーバーからプロジェクトをクローンできます。Qt Creator はアクセストークンからユーザー名とIDを読み取り、各サーバーで利用可能なプロジェクトを表示します。特定のプロジェクトを検索したり、リストからプロジェクトを閲覧したりできます。

GitLab からプロジェクトをクローンするには：

1. Tools > [GitLab ] に移動し、接続済みの GitLab サーバーの一覧と、各サーバーで利用可能なプロジェクトを表示します。

   

2. Remote で、GitLabサーバーを選択します。
3. 「Projects 」で、クローンするプロジェクトを選択します。
4. 「Clone 」を選択して、「Clone Repository 」ダイアログを開きます。

   

5. 「Repository 」で、リポジトリの URL を指定します。
6. 「Path 」で、リポジトリをクローンする先となるパスを指定します。
7. 「Directory 」で、クローンしたリポジトリのディレクトリ名を指定します。
8. リポジトリのサブモジュールもクローンするには、[Recursive ] を選択します。
9. Clone を選択すると、プロジェクトが指定されたディレクトリにクローンされます。

Qt Creator プロジェクトが自動的に開きます。クローンされたプロジェクトに複数のプロジェクトファイル（CMakeList.txt 、.pro 、.qbs など）がある場合、Qt Creator が開くファイルを選択するよう促します。Qt Creator で開くことのできるプロジェクトファイルがない場合は、File >New Project >Import Project >Import Existing Project に移動し、プロジェクトを汎用プロジェクトとしてインポートしてください。