Skip to main content

External release tags in Prophecy

If you use external CI-CD tools to merge and release your projects, you can use release tags from those tools within Prophecy for deployment and dependencies.

Once you've deployed an external tag in Prophecy, you can add that release as a dependency in a Project.

View external release tags​

Any externally created release tag that you pull into Prophecy is visible on the Releases & Deployments tab of your Project metadata.

External_tags_list

Tags that are created externally are labeled with an (1) External tag. If your latest tags aren't showing, click on the (2) Refresh button to refresh the list of tags.

Deploy an external release tag​

To deploy an existing tag, follow these steps:

  1. From ... in the top right corner, select (1) Deploy. This opens the Deploy dialog.

    Deploy_button

  2. Select a release version you wish to deploy by using the (1) Choose a release dropdown. Once you select a version, the table below shows the Jobs that are going to be modified (there might not be any Jobs). Click (2) Deploy to start the deployment.

    Deploy_start

    note

    If you have enabled Selective Job Deployment, then you can pick the Jobs you wish to deploy. Additionally, you have the option to override the Fabrics for these Jobs. Job selection is not required to deploy the release.

This deploys a new release. You can access deployment logs from the Deployment History tab.

Use the release as a dependency​

Once you've deployed a tag, you can use the release as a dependency in a Project.

First, navigate to the (1) Dependencies tab of the relevant Project and click (2) + Add Dependency.

Add_dependency

Next, in the Create Dependency dialog:

  1. For Type, select Package Hub Dependency.
  2. For Name, choose the Project that contains the external release tag.
  3. For Version, select the option that matches your external release tag.
  4. Click Create Dependency.

Add_dependency_2

You can also edit a dependency and update its version to an externally released version.

FAQ​

How does Prophecy support tags from a repo that is linked to multiple Prophecy Projects?

A Git tag is a pointer to a specific commit in the repo. It's not linked to a subfolder in the repo. So in this case, if you create a tag, it would be available for all Projects linked to the repo.

Do the tags have to follow a certain pattern to be recognized?

No. Prophecy supports all tag patterns supported in Git. Prophecy automatically recognizes external tags after you visit the Release and Deployment page or refresh the page.