Gearset's Linear issue tracking integration lets you link Linear issues to feature branches and pull requests in Gearset Pipelines, giving your team greater visibility into your work as it moves through your Pipeline.
Note: Available with the Deployment Teams or Deployment Enterprise licences.
Setting up the connection
Make sure you're logged in to your Linear workspace.
In Gearset, go to Source control and services and click Connect to Linear.
Review and authorise the connection on the Linear authorisation screen.
Linear is now connected and ready to use in your pipelines.
Enabling Linear issue tracking in Pipelines
Once the Linear connection has been authorised, enable issue tracking in your Pipeline:
In the pipeline, click Edit pipeline details.
Go to the Linear Integration section and toggle Enable Linear Integration. This allows linking of Linear issues to features and pull requests in Gearset. Then click save:
Linking Linear issues to new features
Once the integration has been switched on in your pipeline settings, Linear issues can be linked to new features upon creation.
On a developer sandbox, click New Feature.
Select a Linear issue to link, optionally filtering or searching to limit your options.
Continue creating your feature by committing the necessary changes. Once done, the linked issue is shown on your feature branch.
Once a pull request is created, the linked Linear issue is shown in the pull request details.
Linking Linear issues directly to pull requests
Linear issues can also be linked to existing pull requests.
On the pull request details on the right, click Add Issue under the Linear section.
Select a Linear issue to link.
The linked Linear issue is now shown in the pull request details.
User Owned Pipeline - You need a Personal Linear Connection to select an issue when creating a feature branch from your Developer Sandbox or to manually attach it to a PR. This will also allow Gearset to attach a Linear Issue to the PR if the Issue is in the PR Description.
Team Shared Pipeline - You need a Team Shared Linear Connection to allow Gearset to read the PR description and attach a identify Linear Issues.