> For the complete documentation index, see [llms.txt](https://manual.dxable.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://manual.dxable.com/clickup/integrations-and-clickup-api/integrations/gitlab-integration.md).
# GitLabインテグレーション
[GitLab の](https://about.gitlab.com/)コミット、ブランチ、マージ リクエストをClickUpタスクと統合します。 これにより、次のことが可能になります。
* ClickUpのタスクに関連するすべての GitLab アクティビティを表示します。
* オプションで、新しい GitLab アクティビティ項目がタスクに追加されたときに[ClickUp通知](https://help.clickup.com/hc/en-us/articles/6326004036887-Notifications-overview)を受信します。
* [ClickUpタスク](https://help.clickup.com/hc/en-us/articles/6309944875671-Task-Overview)に自動または手動で添付します。
* 次の形式を使用してコミットに[ClickUpタスク ID](https://help.clickup.com/hc/en-us/articles/6309890818071-Task-IDs-overview)を追加することで、GitLab アクションで[ステータス](https://help.clickup.com/hc/en-us/articles/6309452618647-Create-and-manage-custom-statuses)を自動的に変更します: **#{taskID}\[status]** 。
* 例： **#1abc2de\[closed]**
### **必要条件**
* GitLab 統合は[すべてのClickUpプラン](https://clickup.com/pricing)で利用できます。
* 統合を設定できるのは、ワークスペースの[オーナーと管理者のみ](https://help.clickup.com/hc/en-us/articles/6310033667223-User-Roles)です。
* [Guests](https://help.clickup.com/hc/en-us/articles/6310022323991-Guests-overview)はGitLab 統合を使用できません。
* GitLab 統合は、オンプレミス バージョンとセルフホスト バージョンの両方の GitLab で機能します。
### **ステップ1 ： GitLabを承認する**
ClickUpからGitLabに接続して認証します。
1. 右上隅にある[Quick Actionメニュー](https://help.clickup.com/hc/en-us/articles/8746698620567-Quick-Action-menu)をクリックします。
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**](http://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/**](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**](https://gitlab.clickup.com/).
### **ステップ2 ： ClickUpに個人リポジトリを追加する**
ワークスペース内で複数のユーザーが GitLab を承認できます。 ワークスペースと共有するリポジトリをカスタマイズできるため、すべてのリポジトリを添付せずに個人アカウントを承認できます。
リポジトリをアタッチしても、ユーザーにリポジトリのコードベースへのアクセス権が付与されるわけではありません。 これにより、ユーザーは指定した[スペース](https://help.clickup.com/hc/en-us/articles/6309466958103-Spaces-overview)にそのリポジトリの履歴項目を添付できるようになります。
ClickUpにリポジトリを追加するには：
1. [App Center](https://help.clickup.com/hc/en-us/articles/12580135233559-App-Center-overview)から**\[GitLab]**を選択します。
2. **\[Manage]**をクリックします。
3. リポジトリは**\[My repositories from Gitlab]**セクションにリストされます。
4. 追加したいリポジトリの右側にある**\[+ Add ClickUp]**をクリックします。
### **ステップ3 ：リポジトリに添付するスペースを選択する**
追加されたリポジトリは、右下の**\[Gitlab repositories added to ClickUp]**に表示されます。
ClickUpスペースにリポジトリを添付するには、リポジトリ名の右側にあるドロップダウンをクリックし、1 つ以上のスペースを選択します。
注
GitLab アイテムをタスクに添付する前に、リポジトリをスペースに添付する必要があります。
### **ClickUpでGitLabアクティビティを自動的に関連付ける**
ClickUp は、新しい GitLab アクティビティをタスクに自動的に関連付けることができます。
これを行うには、マージ リクエストのタイトル、ブランチ名、またはコミット メッセージの任意の部分に、次のいずれかの形式でClickUp[タスク ID](https://help.clickup.com/hc/en-us/articles/6309890818071-Task-IDs-overview)を追加します。
**#{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. コミットを添付してください。
### **GitLabブランチを手動で関連付ける**
GitLab ブランチを手動で関連付けるには：
1. タスクを開き、 **\[GitLab]**アイコンをクリックします。
2. **\[Branches]**タブをクリックします。
3. **\[New Merge Request ]**の横にあるドロップダウン メニューを使用して、リポジトリを選択します。
4. ブランチを添付するには、**\[Select Branch]**ドロップダウンを使用します。
### **GitLabからタスクのステータスを自動的に変更する**
コミット、問題、またはマージリクエストからタスクの[ステータス](https://help.clickup.com/hc/en-us/articles/6309452618647-Create-and-manage-custom-statuses)を変更できます。
1. ClickUp[タスク IDを追加し](https://help.clickup.com/hc/en-us/articles/6309890818071-Task-IDs-overview)、必要なステータスを角括弧で囲みます。
* 例： **#u7hu\[staged]**
{% hint style="info" %}
ヒント\
この記事の「ClickUpで GitLab アクティビティを自動的に関連付ける」セクションにリストされているすべての形式を使用できます。 適切なフォーマットを確保するために、タスク ID とステータス情報の間にスペースを追加しないでください。
{% endhint %}
1. タスクのステータスが変更されます。
### **ClickUpから新しいブランチを作成する**
ClickUpのクイックアクションを使用して新しいブランチを作成します。
1. タスクを開き、**\[GitLab]**アイコンをクリックします。
2. 左側には、自動生成されたクイックコピーのオプションがいくつかあります。 GitLab で直接新しいブランチを作成する場合は、モーダルの左下隅にある**\[Create Branch]**をクリックします。
### **自動生成されたブランチ名をカスタマイズする**
クイックアクションで使用される自動生成されたブランチ名のフォーマットをカスタマイズできます。
1. [App Center](https://help.clickup.com/hc/en-us/articles/12580135233559-App-Center-overview)から**\[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 のマージ リクエストに自動的に追加されます。
マージ リクエストがリンクされると、リンクされたClickUpタスク内から、それを開いたユーザー、レビュー担当者、CI/CD ステータス、マージ リクエスト ステータスを確認できます。
### **GitLab統合をRemove**
ワークスペースの所有者と管理者だけが GitLab 統合を削除できます。
GitLab 統合を削除するには：
1. App Centerから**\[GitLab]**を選択します。
2. 右下にある**\[GitlabをRemove]**をクリックします。
### **統合のトラブルシューティング**
GitLab の[トラブルシューティング記事](https://help.clickup.com/hc/en-us/articles/6327975641495-Troubleshooting-GitLab)をお読みいただくか、[こちら](https://about.gitlab.com/contact/)からGitLab カスタマー サポートにお問い合わせください。
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://manual.dxable.com/clickup/integrations-and-clickup-api/integrations/gitlab-integration.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.