A snapshot is initially associated with the workspace or stream
from which it was created. You can establish a relationship between the snapshot
and another stream by promoting the snapshot. You can also delete a snapshot,
which removes the association between a snapshot and a stream but preserves
the snapshot in the repository.
Promoting or deleting a snapshot creates or breaks an association
between the snapshot and another repository object such as a stream or workspace.
In a typical use case, a snapshot created by a build is promoted to a distinguished
stream, such as an integration stream or one that will become the basis for
a release.
- To promote a snapshot:
- In the Team Artifacts view, navigate to
the stream that includes the snapshot.
- Right-click the stream and click Show Snapshots.
- In the Search Results view, right click
the snapshot that you want to promote and click Promote.
- In the Select a Stream or Workspace window,
choose the stream or workspace to which you want to promote the snapshot. If the stream or workspace is not displayed, you can enter a text string
that will be used to search for a stream or workspace whose name matches all
or part of the text string. If you are not sure of the name of the stream
or workspace but know the name of its owner, you can enter the owner's name
to see a list of streams or workspaces associated with that owner.
- Click OK to promote the snapshot to the
selected stream or workspace.
- To delete a snapshot:
- In the Team Artifacts view, navigate to
the stream that includes the snapshot.
- Right-click the stream and click Show Snapshots.
- In the Search Results view, right click
the snapshot that you want to delete and click Delete.
- Click OK to confirm the deletion. The association between the stream and the snapshot is broken, but the
snapshot remains in the repository. You can search for it using Jazz™ source control search. For more information, see Searching for repository objects.
Note: You can use the same procedures to promote or delete a snapshot
associated with a workspace. Search for snapshots associated with workspaces
in the Pending Changes view.