diff options
author | Marcia Ramos <virtua.creative@gmail.com> | 2017-07-21 03:06:27 +0300 |
---|---|---|
committer | Marcia Ramos <virtua.creative@gmail.com> | 2017-07-21 03:06:27 +0300 |
commit | eaceee0fb9e23982571c9c2a878d662ba241240e (patch) | |
tree | 657a108fdc5230e9bfd03db38c91bb69f0188ecf /doc | |
parent | bbf57237747ef15fe7a757d6e5b09c59bfb1c280 (diff) | |
parent | e97d10560fe96909411e1b255e9eb51d013a110d (diff) |
Merge branch 'docs-trello-power-up' into 'master'
Add GitLab Trello Power-Up Documentation
See merge request !12997
Diffstat (limited to 'doc')
-rw-r--r-- | doc/README.md | 1 | ||||
-rw-r--r-- | doc/integration/img/enable_trello_powerup.png | bin | 0 -> 17905 bytes | |||
-rw-r--r-- | doc/integration/img/trello_card_with_gitlab_powerup.png | bin | 0 -> 18667 bytes | |||
-rw-r--r-- | doc/integration/trello_power_up.md | 42 |
4 files changed, 43 insertions, 0 deletions
diff --git a/doc/README.md b/doc/README.md index 1a7638b3d7e..2b3b0998fcc 100644 --- a/doc/README.md +++ b/doc/README.md @@ -115,6 +115,7 @@ Manage files and branches from the UI (user interface): - [Project Services](user/project/integrations/project_services.md): Integrate a project with external services, such as CI and chat. - [GitLab Integration](integration/README.md): Integrate with multiple third-party services with GitLab to allow external issue trackers and external authentication. +- [Trello Power-Up](integration/trello_power_up.md): Integrate with GitLab's Trello Power-Up ---- diff --git a/doc/integration/img/enable_trello_powerup.png b/doc/integration/img/enable_trello_powerup.png Binary files differnew file mode 100644 index 00000000000..65d01f1c38c --- /dev/null +++ b/doc/integration/img/enable_trello_powerup.png diff --git a/doc/integration/img/trello_card_with_gitlab_powerup.png b/doc/integration/img/trello_card_with_gitlab_powerup.png Binary files differnew file mode 100644 index 00000000000..2965dc35855 --- /dev/null +++ b/doc/integration/img/trello_card_with_gitlab_powerup.png diff --git a/doc/integration/trello_power_up.md b/doc/integration/trello_power_up.md new file mode 100644 index 00000000000..d264486a872 --- /dev/null +++ b/doc/integration/trello_power_up.md @@ -0,0 +1,42 @@ +# Trello Power-Up + +GitLab's Trello Power-Up enables you to seamlessly attach +GitLab **merge requests** to Trello cards. + +![GitLab Trello PowerUp - Trello card](img/trello_card_with_gitlab_powerup.png) + +## Configuring the Power-Up + +In order to get started, you will need to configure your Power-Up. + +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` + +In this popup, fill in your `API URL` and `Personal Access Token`. After that, you will be able to attach any merge request to any Trello card on your selected Trello board. + +## 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`. +If your instance's URL is `https://example.com`, your API URL will be `https://example.com/api/v4`. + +![configure GitLab Trello PowerUp in Trello](img/enable_trello_powerup.png) + +## What is my Personal Access Token? + +Your GitLab's personal access token will enable your GitLab account to be accessed +from Trello. + +> Find it in GitLab by clicking on your avatar (upright corner), from which you access +your user **Settings** > **Access Tokens**. + +Learn more about generating a personal access token in the +[Personal Access Token Documentation][personal-access-token-documentation]. +Don't forget to check the API scope checkbox! + +[personal-access-token-documentation]: ../user/profile/personal_access_tokens.html |