debian-mirror-gitlab/doc/integration/trello_power_up.md

50 lines
1.8 KiB
Markdown
Raw Normal View History

2021-01-29 00:20:46 +05:30
---
2021-02-22 17:27:13 +05:30
stage: Create
group: Ecosystem
info: To determine the technical writer assigned to the Stage/Group associated with this page, see https://about.gitlab.com/handbook/engineering/ux/technical-writing/#assignments
2021-01-29 00:20:46 +05:30
---
2017-09-10 17:25:29 +05:30
# Trello Power-Up
2021-02-22 17:27:13 +05:30
The GitLab Trello Power-Up enables you to seamlessly attach
2017-09-10 17:25:29 +05:30
GitLab **merge requests** to Trello cards.
![GitLab Trello PowerUp - Trello card](img/trello_card_with_gitlab_powerup.png)
## Configuring the Power-Up
2021-02-22 17:27:13 +05:30
In order to get started, you must configure your Power-Up.
2017-09-10 17:25:29 +05:30
In Trello:
1. Go to your Trello board
1. Select `Power-Ups` to see a listing of all the available Power-Ups
1. Look for a row that says `GitLab` and select the `Enable` button
1. Select the `Settings` (gear) icon
1. In the popup menu, select `Authorize Account`
2021-02-22 17:27:13 +05:30
In this popup, fill in your `API URL` and `Personal Access Token`. After that, you can attach any merge request to any Trello card on your selected Trello board.
2017-09-10 17:25:29 +05:30
## What is my API URL?
Your API URL should be your GitLab instance URL with `/api/v4` appended in the end of the URL.
For example, if your GitLab instance URL is `https://gitlab.com`, your API URL would be `https://gitlab.com/api/v4`.
2021-02-22 17:27:13 +05:30
If your instance's URL is `https://example.com`, your API URL is `https://example.com/api/v4`.
2017-09-10 17:25:29 +05:30
![configure GitLab Trello PowerUp in Trello](img/enable_trello_powerup.png)
## What is my Personal Access Token?
2021-02-22 17:27:13 +05:30
Your GitLab personal access token enables your GitLab account to be accessed
2017-09-10 17:25:29 +05:30
from Trello.
2021-03-11 19:13:27 +05:30
To find it in GitLab:
1. In the top-right corner, select your avatar.
1. Select **Edit profile**.
1. In the left sidebar, select **Access Tokens**.
2017-09-10 17:25:29 +05:30
Learn more about generating a personal access token in the
2020-04-22 19:07:51 +05:30
[Personal Access Token Documentation](../user/profile/personal_access_tokens.md).
2017-09-10 17:25:29 +05:30
Don't forget to check the API scope checkbox!