GitLab のコミット、ブランチ、マージ リクエストをClickUpタスクと統合します。 これにより、次のことが可能になります。

• ClickUpのタスクに関連するすべての GitLab アクティビティを表示します。
• オプションで、新しい GitLab アクティビティ項目がタスクに追加されたときにClickUp通知を受信します。
• ClickUpタスクに自動または手動で添付します。
• 次の形式を使用してコミットにClickUpタスク IDを追加することで、GitLab アクションでステータスを自動的に変更します: #{taskID}[status] 。
  • 例： #1abc2de[closed]

必要条件

• GitLab 統合はすべてのClickUpプランで利用できます。
• 統合を設定できるのは、ワークスペースのオーナーと管理者のみです。
• GuestsはGitLab 統合を使用できません。
• GitLab 統合は、オンプレミス バージョンとセルフホスト バージョンの両方の GitLab で機能します。

ステップ1 ： GitLabを承認する

ClickUpからGitLabに接続して認証します。

1. 右上隅にあるQuick Actionメニューをクリックします。
2. [App Center]をクリックします。
3. App Centerサイドバーから、 [Development] を選択します。
4. [GitLab]をクリックします。
5. [Connect]を選択します。
6. GitLab アカウントにサインインします。

gitlab.comまたはセルフホスト型GitLabで認証する

GitLab アカウントを接続したら、gitlab.com またはセルフホスト型 GitLab を使用して承認することを選択できます。 

gitlab.com の使用：

1. GitLab App Centerページで、[Manage]をクリックします。
2. [+ Add Gitlab]をクリックします。
3. 「No, I use gitlab.com]を選択します。
4. [Link Gitlab]をクリックします。
5. [Authorize]をクリックします。 GitLab アクティビティをClickUpタスクに関連付けるには、 ClickUp を許可する必要があります。

セルフホスト型 GitLab の使用：

1. GitLab App Centerページで、[Manage]をクリックします。
2. [+ Add Gitlab]をクリックします。
3. [Yes, I use a hosted version of Gitlab]を選択します。
4. GitLab URL を[Host url]テキスト ボックスに貼り付けます。
   • URLの例： ：https://gitlab.mydomain.com/
5. 指示に従って個人アクセス トークンを見つけてコピーし、 [Access token]テキスト ボックスに貼り付けます。

注 

チームがファイアウォールの背後にある場合は、統合する前に、ファイアウォールの許可リストに静的 IP アドレスを含めます。 このステップでは静的 IP アドレスが表示されます。

1. [Link Gitlab]をクリックします。
2. [Authorize]をクリックします。 GitLab アクティビティをClickUpタスクに関連付けるには、 ClickUp を許可する必要があります。

注 

セキュリティ上の理由から、セルフホスト型 GitLab インスタンスを使用するすべての GitLab 統合にはトップレベルドメイン (TLD) が必要です。 URL にポート番号を追加することはできません。 トップレベルドメインとして認識されない IP アドレスまたはドメインは許可されません。 有効な URL の例はhttps://gitlab.clickup.com.

ステップ2 ： ClickUpに個人リポジトリを追加する

ワークスペース内で複数のユーザーが GitLab を承認できます。 ワークスペースと共有するリポジトリをカスタマイズできるため、すべてのリポジトリを添付せずに個人アカウントを承認できます。 

リポジトリをアタッチしても、ユーザーにリポジトリのコードベースへのアクセス権が付与されるわけではありません。 これにより、ユーザーは指定したスペースにそのリポジトリの履歴項目を添付できるようになります。 

ClickUpにリポジトリを追加するには：

1. App Centerから[GitLab]を選択します。
2. [Manage]をクリックします。
3. リポジトリは[My repositories from Gitlab]セクションにリストされます。
4. 追加したいリポジトリの右側にある[+ Add ClickUp]をクリックします。

   

   Screenshot of someone adding a repository to ClickUp.

ステップ3 ：リポジトリに添付するスペースを選択する

追加されたリポジトリは、右下の[Gitlab repositories added to ClickUp]に表示されます。 

ClickUpスペースにリポジトリを添付するには、リポジトリ名の右側にあるドロップダウンをクリックし、1 つ以上のスペースを選択します。 

注 

GitLab アイテムをタスクに添付する前に、リポジトリをスペースに添付する必要があります。 

Screenshot of someone selecting ClickUp Spaces for a repository.

ClickUpでGitLabアクティビティを自動的に関連付ける

ClickUp は、新しい GitLab アクティビティをタスクに自動的に関連付けることができます。 

これを行うには、マージ リクエストのタイトル、ブランチ名、またはコミット メッセージの任意の部分に、次のいずれかの形式でClickUpタスク IDを追加します。 

#{task_id} 

CU-{task_id} 

{custom_task_id} 

#{custom_task_id} 

例えば： 

#1abc2de 

CU-1abc2de 

prefix-1

#prefix-1

GitLabコミットを手動で関連付ける

GitLab コミットをClickUpタスクに手動で関連付けるには：

1. タスクを開き、[GitLab]アイコンをクリックします。
2. [Commits]タブをクリックします。
3. [New Merge Request]の横にあるドロップダウン メニューを使用して、リポジトリを選択します。
4. [Select Branch]ドロップダウンを使用してブランチを選択します。
5. コミットを添付してください。

   

   Screenshot of someone manually associating a GitLab commit with a ClickUp task.

GitLabブランチを手動で関連付ける

GitLab ブランチを手動で関連付けるには：

1. タスクを開き、 [GitLab]アイコンをクリックします。
2. [Branches]タブをクリックします。
3. [New Merge Request ]の横にあるドロップダウン メニューを使用して、リポジトリを選択します。
4. ブランチを添付するには、[Select Branch]ドロップダウンを使用します。

   

Screenshot of someone attaching a branch.

GitLabからタスクのステータスを自動的に変更する

コミット、問題、またはマージリクエストからタスクのステータスを変更できます。

1. ClickUpタスク IDを追加し、必要なステータスを角括弧で囲みます。
   • 例： #u7hu[staged]

1. タスクのステータスが変更されます。

ClickUpから新しいブランチを作成する

ClickUpのクイックアクションを使用して新しいブランチを作成します。

1. タスクを開き、[GitLab]アイコンをクリックします。
2. 左側には、自動生成されたクイックコピーのオプションがいくつかあります。 GitLab で直接新しいブランチを作成する場合は、モーダルの左下隅にある[Create Branch]をクリックします。

   

Screenshot of someone creating a new branch from ClickUp.

自動生成されたブランチ名をカスタマイズする

クイックアクションで使用される自動生成されたブランチ名のフォーマットをカスタマイズできます。

1. App Centerから[GitLab]を選択します。
2. [Auto-generated branch names format]で編集を行います。
   
3. 右下にある[Save]をクリックします。

ClickUpからマージリクエストを作成する

ClickUpからマージリクエストを作成またはリンクします。 新しいマージリクエストを作成するには：

1. タスクを開き、[GitLab]アイコンをクリックします。
2. モーダルの左下にある[New Merge Request]をクリックします。
3. あらかじめ作成されたマージ リクエストのタイトルを使用するか、独自のタイトルを作成します。
4. リポジトリ、ソース ブランチ、ターゲット ブランチを選択します。
5. 説明を入力。
6. [New Merge Request]をクリックしてマージリクエストを作成します。

ClickUpでリクエストを作成またはマージすると、関連するClickUpタスクへのリンクが GitLab のマージ リクエストに自動的に追加されます。 

Screenshot of someone creating a marge request from ClickUp. 

マージ リクエストがリンクされると、リンクされたClickUpタスク内から、それを開いたユーザー、レビュー担当者、CI/CD ステータス、マージ リクエスト ステータスを確認できます。

GitLab統合をRemove

ワークスペースの所有者と管理者だけが GitLab 統合を削除できます。 

GitLab 統合を削除するには：

1. App Centerから[GitLab]を選択します。
2. 右下にある[GitlabをRemove]をクリックします。

統合のトラブルシューティング

GitLab のトラブルシューティング記事をお読みいただくか、こちらからGitLab カスタマー サポートにお問い合わせください。