Setting up SourceCraft integration with Yandex Tracker

Yandex Tracker is a task management and team collaboration service: you can manage tasks, projects, goals, and portfolios, set up processes, and collect your team's performance analytics.

SourceCraft offers integration with Tracker. It allows you to link pull requests and SourceCraft tasks with Tracker issues, follow the status and activity of linked pull requests and SourceCraft tasks in a Tracker issue, and find linked Tracker issues directly in the repository interface. The integration helps you sync the actions of SourceCraft developers with task management processes in Tracker, thus eliminating the need to switch between the services.

For more information, see Integrating SourceCraft with Yandex Tracker.

To set up integration:

1. Get ready to work.
2. Configure an integration.
3. Test the integration.

Getting started

To set up an integration, you need at least the Organization admin role in the SourceCraft organization.

1. If you have no organization in Tracker yet, create one using one of these methods:

   • In Yandex Cloud
   • In Yandex 360

   Tip

   We recommend you to use the same Yandex Cloud organization for Tracker that you work from in SourceCraft.

   If you are using Yandex Cloud SAML-compatible identity federations to authorize corporate accounts in SourceCraft, you can only configure integration with Tracker in the Yandex Cloud organization you are using to work with SourceCraft.

2. Perform the initial Tracker setup and create an issue queue.

Configure an integration

1. Open the SourceCraft home page.

2. Navigate to the  Organizations tab.

3. Select the SourceCraft organization you want to set up integration with Tracker for.

4. On the organization page, under  Settings, go to the  Integrations section.

5. Under Tracker, select an organization Tracker is active in.

   Note

   You can connect to SourceCraft only organizations of which you are the administrator and in which Tracker has been paid.

6. Click Create integration.

   Wait for a message that your integration was successfully created. Under Tracker, you will now see the Status field set to enabled.

Test the integration

View the list of Tracker issues

1. Open the SourceCraft home page.

2. On the Home tab, under Your craftspace, navigate to Repositories.

3. Select a repository.

4. Under Plan, navigate to External issues.

   You will see the list of Tracker issues with their current statuses and assignees.

   Tip

   You can search for tasks by title and description, filter by queue, and sort by key.

5. Click an issue to open it in the Tracker interface.

   Warning

   The Tracker interface will open in the same organization you use to work in SourceCraft. If Tracker is configured for a different organization, authenticate to it.

Link a pull request to an issue in Tracker

1. Open the SourceCraft home page.
2. On the Home tab, under Your craftspace, navigate to Repositories.
3. Select a repository.
4. Under  Code on the repository page, go to  Pull requests.
5. Select an existing pull request or create a new one.
6. Under the pull request description in the Related issues section, click Add issue.
7. In the External tab, click the search bar and start entering the key of your Tracker issue. In the pop-up list, select a relevant issue.
8. Open the issue in the Tracker interface.
9. Make sure your issue now has the Links to external applications section with a link to the pull request from SourceCraft.

Similarly, you can link a SourceCraft issue to a Tracker issue.

Useful links

• Integrating SourceCraft with Yandex Tracker
• Webhooks in SourceCraft
• Configuring a webhook in a SourceCraft repository
• Yandex Tracker guides