Craft allows you to set up two-way synchronization with GitLab. This will allow your development team to keep using GitLab for Sprint execution while using Craft for Ideation, Definition, Prioritization, Planning and Workflow management. Craft will then be used by you to manage your none-dev resources such as UX, Content, Research and other teams.
Through the two-way connection, you have the ability to synchronize the following items. Note the mapping between GitLab and Craft:
There are two steps required to integrate between Craft and GitLab. Follow them carefully so that the integration succeeds.
Important - In order to connect to GitLab, you are required to have the login credentials with Owner permissions to GitLab projects, and your product in Craft must have at least one Epic and one User Story.
To Sync Craft to GitLab
- Press the 9 dots menu, located on the Craft toolbar, and select Sync.
2. Press Connect on the GitLab tab.
3. Enter your GitLab Private Token and Enterprise URL and press Next.
Note: To generate your GitLab Access Token go to: User Settings/Access Tokens and create personal access token with scope: 'api'
4. Select the GitLab project to sync with Craft, and press Next.
5. Define the GitLab settings according to the following, and press Save.
- Choose Craft teams to Sync with - This allows you to select the team or teams that you want to sync with GitLab. Note that only Tasks, Bugs and Improvements for the selected team/teams will be synced with GitLab. Stories and Requirements will be synced as GitLab issues, regardless of the selected teams.
- Synchronize your Workflow - allows you to select the team to synchronize workflow with. GitLab statuses will be created in columns in Craft. Note: Make sure Status names are the same in GitLab board and Craft Build.
- Choose Craft teams to sync GitLab milestones - You can select whether to sync GitLab milestones or not, sync Craft Versions or sync Craft Sprints.
6. To finalize the Synchronization with GitLab, press Sync Data to GitLab.
If you prefer to push the data to GitLab at a later stage, press Do it later.
To Sync GitHub to Craft
In order to sync changes made in GitLab back to Craft, see the following:
7. Select the parts of Craft you want to push to GitLab.
All Product - will sync the entire Craft product to GitLab
Versions - allows you to select one or more Craft versions to be pushed to GitLab
Sprint Backlog - allows you to select one or more Craft sprint backlogs to be pushed to GitLab.
Once you have completed your selection, press Sync with GitLab.
Note: Pushing your project, or part of it, may take a long time to complete. Please wait until data has been transferred.
To view the synchronization status of an item.
- Double click an item and click the Gitlab icon from the right menu.
- The status of the item is displayed on the right.
3. Click Sync Item to sync changes made to the individual item.
4. Click the GitLab issue number to open GitLab issue.