In the example below we will create a project link with a project that has existing versions that we would like to keep:
Project: VCS - Source (team managed)
Versions: 1.0.0 & 2.0.0
Project: VCS - Target 1 (team managed)
Versions: 1.0.0 & 3.0.0
To share versions/components from the VCS - Source project, we will create a project link with project VCS - Target 1
Navigate to the Version & Component Sync page in the Source project.
Click on Create a project link
Select the project(s) you want to link to the Source project. Versions from VCS - Source will be propagated to selected project(s)
Click on Next: synchronisation
In this example we will use the Default schedulingTo ensure existing versions maintain in VCS - Target 1 we will uncheck the Delete trigger. All other triggers will remain checked.
Note |
---|
Keep in mind |
that unchecking the Delete trigger means that none of the |
Delete events will be synchronised. |
This means that:
|
|
|
|
|
|
Click on Next: filters
The app will now show an overview of the versions that will be synchronised from the source project to the target project
By creating filters you can control which versions are in-or excluded from synchronisation. In this example we will not use any filters
Click on Next: confirmation
The app will now show an overview of the project link(s) you are creating
Click on save, to save the project link(s)
Upon clicking on save, the app will:
Start synchronising
Shown an overview of the created project links and their current status
To edit or delete a existing project link first navigate to the Version & Component Sync page in the target project or click on the Linked project link on the Version & Component Sync page in the source project
Click on the Settings tab
Synchronisation
Upon creating a project link between Source & Target Project 1 the app checks whether there are versions present in Target Project 1
Version 1.0.0
The app recognises that version 1.0.0 in VCS - Source already exists in VCS - Target 1
The app links version 1.0.0 in VCS - Source to version 1.0.0 in VCS - Target 1
This links ensures that any and all version changes to version 1.0.0 in VCS - Source are synchronised to version 1.0.0 in VCS - Target 1
Version 2.0.0
The app recognises that version 2.0.0 does not exist in VCS - Target 1
The app creates version 2.0.0 in VCS - Target 1
Jira does not allow you to link a single version to multiple projects. Therefore the app needs to create ‘new’ versions in VCS - Target 1
The app makes sure that upon creation of the ‘new’ version 2.0.0 in VCS - Target 1 it is linked to version 2.0.0. in VCS - Source
This links ensures that any and all version changes to version 2.0.0 in VCS - Source are synchronised to version 2.0.0 in VCS - Target 1
Version 3.0.0
The app recognises that version 3.0.0 in VCS - Target 1 does not exist in VCS - Source
Due to unchecking the delete trigger the app will not delete version 3.0.0 in VCS - Target 1
Project: VCS - Source (team managed)
Versions: 1.0.0 & 2.0.0
Project: VCS - Target 1 (team managed)
Versions: 1.0.0, 2.0.0 & 3.0.0
Edit project link
To edit or delete a existing project link:
Navigate to the Version & Component Sync page in the target project or click on the Linked project link on the Version & Component Sync page in the source project.
Navigate to the Settings tab
Here you can change the apps synchronisation method, log level or delete the project link all together