--- metadata: - name: generator content: Diplodoc Platform v5.57.3 alternate: - https://sourcecraft.dev/portal/docs/en/sourcecraft/operations/tracker-integration.md - https://sourcecraft.dev/portal/docs/ru/sourcecraft/operations/tracker-integration.md - href: en/sourcecraft/operations/tracker-integration.md type: text/markdown title: Markdown version - href: ../../llms.txt type: text/markdown title: llms.txt title: Setting up SourceCraft integration with Yandex Tracker description: Follow this guide to set up SourceCraft integration with Yandex Tracker, link a pull request with an issue, and test the integration. --- > **Documentation Index:** Fetch the complete configuration index at https://sourcecraft.dev/portal/docs/en/llms.txt # Setting up SourceCraft integration with Yandex Tracker [Yandex Tracker](https://yandex.ru/support/tracker/ru) 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](https://sourcecraft.dev/portal/docs/en/sourcecraft/concepts/index.md#pr) and SourceCraft [tasks](https://sourcecraft.dev/portal/docs/en/sourcecraft/concepts/index.md#issues) 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](https://sourcecraft.dev/portal/docs/en/sourcecraft/concepts/tracker-integration.md). To set up integration: 1. [Get ready to work](#before-you-begin). 1. [Configure an integration](#connect). 1. [Test the integration](#test). ## Getting started {#before-you-begin} To set up an integration, you need at least the `Organization admin` [role](https://sourcecraft.dev/portal/docs/en/sourcecraft/security/index.md#organization-manager-admin) in the [SourceCraft organization](https://sourcecraft.dev/portal/docs/en/sourcecraft/concepts/index.md#org). 1. If you have no organization in Tracker yet, create one using one of these methods: * [In Yandex Cloud](https://yandex.cloud/en/docs/organization/operations/enable-org) * [In Yandex 360](https://yandex.ru/support/yandex-360/business/admin/ru/organization/overview) {% note tip %} We recommend you to use the same Yandex Cloud organization for Tracker that you work from in SourceCraft. {% endnote %} If you are using Yandex Cloud [SAML-compatible identity federations](https://yandex.cloud/en/docs/organization/concepts/add-federation) 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. 1. [Perform](https://yandex.ru/support/tracker/ruenable-tracker) the initial Tracker setup and [create](https://yandex.ru/support/tracker/rumanager/create-queue) an issue queue. ## Configure an integration {#connect} 1. Open the SourceCraft [home page](https://sourcecraft.dev). 1. Navigate to the ![image](../../_assets/console-icons/briefcase.svg) **Organizations** tab. 1. Select the SourceCraft organization you want to set up integration with Tracker for. 1. On the organization page, under ![image](../../_assets/console-icons/gear.svg) **Settings**, go to the ![image](../../_assets/console-icons/arrows-opposite-to-dots.svg) **Integrations** section. 1. Under **Tracker**, select an organization Tracker is active in. {% note info %} You can connect to SourceCraft only organizations of which you are the administrator and in which Tracker has been paid. {% endnote %} 1. 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`. {% note tip %} To connect another one of the Tracker organizations, click **Disconnect** and confirm disconnecting the current integration. Now you can connect a new organization. The already created links of pull requests and SourceCraft tasks with Tracker issues will not be deleted. {% endnote %} ## Test the integration {#test} ### View the list of Tracker issues {#ticket-list} 1. Open the SourceCraft [home page](https://sourcecraft.dev). 1. On the ![image](../../_assets/console-icons/house.svg) **Home** tab, under ![image](../../_assets/console-icons/layout-tabs.svg) **Your craftspace**, navigate to ![image](../../_assets/console-icons/archive.svg) **Repositories**. 1. Select a repository. 1. Under ![image](../../_assets/console-icons/calendar.svg) **Plan**, navigate to ![image](../../_assets/console-icons/list-check.svg) **External issues**. You will see the list of Tracker issues with their current statuses and assignees. {% note tip %} You can search for tasks by title and description, filter by [queue](https://yandex.ru/support/tracker/ruqueue-intro), and sort by key. {% endnote %} 1. Click an issue to open it in the Tracker interface. {% note 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. {% endnote %} ### Link a pull request to an issue in Tracker {#pr-ticket} 1. Open the SourceCraft [home page](https://sourcecraft.dev). 1. On the ![image](../../_assets/console-icons/house.svg) **Home** tab, under ![image](../../_assets/console-icons/layout-tabs.svg) **Your craftspace**, navigate to ![image](../../_assets/console-icons/archive.svg) **Repositories**. 1. Select a repository. 1. Under ![image](../../_assets/console-icons/code.svg) **Code** on the repository page, go to ![image](../../_assets/console-icons/code-pull-request.svg) **Pull requests**. 1. Select an existing pull request or [create](https://sourcecraft.dev/portal/docs/en/sourcecraft/operations/pr-create.md) a new one. 1. Under the pull request description in the **Related issues** section, click ![image](../../_assets/console-icons/link.svg) **Add issue**. 1. In the ![image](../../_assets/console-icons/file-text.svg) **External** tab, click the search bar and start entering the key of your Tracker issue. In the pop-up list, select a relevant issue. 1. Open the issue in the [Tracker interface](https://tracker.yandex.com/). 1. 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](https://sourcecraft.dev/portal/docs/en/sourcecraft/concepts/index.md#issues) to a Tracker issue. {% note tip %} If you add a link to a Tracker issue, e.g., `https://tracker.yandex.com/TEST-123`, to the description or comment of a SourceCraft pull request or issue, it will be converted to a hyperlink in [TEST-123](https://tracker.yandex.com/TEST-123) format. You can navigate to the issue directly from the SourceCraft UI without copying the link manually. Note that mentioning a Tracker issue in the description or comment of a SourceCraft pull request or issue does not create a relation between them. {% endnote %} ### Useful links {#see-also} * [Integrating SourceCraft with Yandex Tracker](https://sourcecraft.dev/portal/docs/en/sourcecraft/concepts/tracker-integration.md) * [Webhooks in SourceCraft](https://sourcecraft.dev/portal/docs/en/sourcecraft/concepts/webhooks.md) * [Configuring a webhook in a SourceCraft repository](https://sourcecraft.dev/portal/docs/en/sourcecraft/operations/webhooks.md) * [Yandex Tracker guides](https://yandex.ru/support/tracker/ru)