gitlab-org--gitlab-foss/doc/user/project/integrations/asana.md

1.4 KiB

stage group info
Create Ecosystem 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

Asana service (FREE)

This service adds commit messages as comments to Asana tasks. Once enabled, commit messages are checked for Asana task URLs (for example, https://app.asana.com/0/123456/987654) or task IDs starting with # (for example, #987654). Every task ID found gets the commit comment added to it.

You can also close a task with a message containing: fix #123456. You can use either of these words:

  • fix
  • fixed
  • fixes
  • fixing
  • close
  • closes
  • closed
  • closing

See also the Asana service API documentation.

Setup

In Asana, create a Personal Access Token. Learn about Personal Access Tokens in Asana.

Complete these steps in GitLab:

  1. Go to the project you want to configure.
  2. Go to the Integrations page.
  3. Select Asana.
  4. Ensure that the Active toggle is enabled.
  5. Paste the token you generated in Asana.
  6. (Optional) To restrict this setting to specific branches, list them in the Restrict to branch field, separated with commas.
  7. Select Save changes or optionally select Test settings.