Managing Releases in Oracle Developer Cloud Service

A release in Oracle Developer Cloud Service is a collection of specific tags or branches of Git repositories, specific binary artifacts of project Maven repository, and specific binaries that are available for non-members to download.

About the Releases Page

The Releases page enables you to create a Release, edit a Release, view details, clone a Release, or delete a Release.

About Releases

See Managing Releases in Oracle Developer Cloud Service.

When a project non-member opens a shared project, the user can choose to download sources snapshot of specified branch or tag of the project Git repository, binary artifacts of the project Maven repository, specified binaries, and archived build artifacts. This way you can manage and choose releases of your software that are available to download.

Project owners and members can always create or edit a release. Non-members can not edit or create a release. Remember that if the project is not shared, it will be not be available to non-members.

What You Can Do from the Releases Page

See Actions you can perform on the Releases page and a Release to know more about you can do on the Releases page.

For frequently asked questions, see Questions about the Releases Page and Configuring Releases of a project.

What You See on the Releases Page

No Releases

If no release exist in the project, click + New Release to create release. See Creating a Release.

Populated with Releases

The following table highlights the elements of the Release page.

Element Description

New Release

Create a Release. See Creating a Release.

Release List

Lists all releases along with their descriptions and tags.

Click a Release to view its details on the right.

Release Title and tag

For the selected release, the name, description, date-time stamp when the release was created or modified, and tag is displayed.

Click the Actions icon on the right to choose any of the following actions:

  • Edit

  • Clone

  • Delete

Binaries

Lists all binary files of the Release. The file names and their sizes are displayed.

In the File table, click the file name link to download the file individually.

Builds

Lists all specified jobs, builds of jobs, build status, and a link to a zip file to download the artifacts of the specified build.

Maven Artifacts

Lists all artifact files of the Release. The artifacts, groups, and versions are displayed.

In the artifact table, click the Artifact name link to open the artifact in the Browse view of the Maven page.

Repositories

Lists all repositories of the Release. The repository name, tag, and the zip, tar.gz download links are displayed.

In the repositories table, click the Git repository name link to open the repository in the Code page, of the Maven page. Click the zip or tar.gz link to download zip or tar.gz archive file of the listed Tag.

Notes

View notes made for the Release.

Creating a Release

You can create a Release from the Releases page.

To create a Release:
  1. In the navigation bar, click Releases.
  2. In the Releases page, click + New Release.
  3. In the New Release page, enter the details:
    Element Description

    Name

    Enter the release name.

    Status

    Select the release status tag as Draft, Pre-Release, or Public. See see About Release States.

    Description

    Enter the release description.

    Builds

    In the Builds section, specify all build jobs and their builds whose artifacts you want to add to the release.

    In Job, select or enter the job name. In Build, select or enter the build number of the specified job. Select Last Build to specify the last build of the job. Click Add to Release when you are done. All artifacts of the specified job and build will be available for download.

    If you specified Last Build as the Build of a job, when you change the status of the release to Public, the last build of the job will be used. Make sure that the last build is successful and has generated desired artifacts.

    To remove a job, click Delete at the right.

    Maven Artifacts

    In the Maven Artifacts section, specify all Maven artifacts of the release.

    To add an artifact, select or enter the artifact’s group ID in GroupId, artifact ID in ArtifactId, and version in Version. You can select the ID from the list or start typing and then select the ID from the list of suggestions. The auto-suggest list is based on the Maven indexes. If no index data is available, the auto-suggest list will not appear.

    Click Add to Release when you are done.

    To remove an artifact, click Cancel at the right side.

    Repositories

    In the Repositories section, view all Git repositories branch/tag attached to the release.

    To add a Git repository to the release, enter or select the Git repository in Repository, tag name in Tag, and branch in Branch. Click Add to Release when you are done.

    If you enter an existing tag name, it will be used when the release’s status is marked as Public. If you enter a tag name that does not exist, the Git repository tag will be created when the release is marked as Public.

    To remove a repository, click Cancel at the right side of the added Git repository.

    Notes

    Enter the release notes in the Page Text tab. Preview the notes in the Preview tab.

    You can also use the project’s wiki markup language to format the notes.

  4. Scroll to the top of the page and click Save.

About Release States

A release can be in one of the following states: Draft, Pre-Release, and Public.

Draft

Set the release’s status to Draft when you and your team is working on the features of the release.

When you create a release, you specify the Maven artifacts and the Git repository tags that will be available for download.

While adding a Git repository to a release, you will want to specify a branch that has the stable code at the time of release. Usually, it is the master branch, but you can specify any branch name. You will also want to specify the Git repository tag that indicates the stable state of the branch. Usually, the tag is created before the release when the code in the branch is stable. While creating a release, if you specify a tag name that has not been created, it will be automatically created when you change the status of the release to Public. If you specify an existing tag name, it will be used.

Pre-Release

Set the release’s status to Pre-Release when you and your team has completed all feature, staged the software, and are waiting for approvals to release the software.

This indicates that the release is stable, but might have some issues that might need fixing before the release is Public.

You might want to edit the release and update the Maven artifacts, Git repositories, tags, or branch names if they have changed while the release was in the Draft state. See Editing or Cloning a Release.

Public

Set the release’s status to Public when you and your team is ready to release the software, or has already released the software.

While creating a release, if you specify a tag name that has not been created, it will be automatically created for the specified branch when the release is set to Public. If you have specified an existing tag name, it will be used. This might be useful when you create a release which is already public.

You might want to edit the release and update the Maven artifacts, Git repositories, tags, or branch names if they have changed while the release was in the Pre-Release or the Draft state. See Editing or Cloning a Release.

Editing or Cloning a Release

You can edit a Release’s name and description, tag name, and other details from the Edit Release page. When you clone a release, you can change all fields of the page.

To edit or clone a release:
  1. In the navigation bar, click Releases.
  2. In the Releases page, select the release that you want to edit or clone.
  3. Click the Actions icon on the right of the details page and choose Edit or Clone.
  4. In the page, enter or edit the details:
    Element Description

    Name

    Enter or edit the release name.

    Status

    Select the release status tag as Draft, Pre-Release, or Public. See see About Release States.

    Description

    Enter or edit the release description.

    Binaries

    In the Binaries section, view all added binaries of the release.

    To add binary files, in the Drop section, drag and drop the binary files that you want to include in the release. Select the Choose Files link, browse, and then select files manually. Click Attach Files to add files.

    To remove an attached binary file, click Remove at the right side of the binary file size.

    You cannot add a binary file when you create a release.

    Builds

    In the Builds section, specify build jobs and their builds whose artifacts you want to add to the release.

    In Job, select or enter the job name. In Build, select or enter the build number of the specified job. Select Last Build to specify the last build of the job. Click Add to Release when you are done. All artifacts of the specified job and build will be available for download.

    If you specified Last Build as the Build of a job, when you change the status of the release to Public, the last build of the job will be used. Make sure that the last build is successful and has generated desired artifacts.

    To remove a job, click Delete at the right.

    Maven Artifacts

    In the Maven Artifacts section, view all artifacts of the release.

    To add an artifact, enter the artifacts group ID in GroupId, artifact ID in ArtifactId, and version in Version. Click Add to Release when you are done.

    To remove a job, click Cancel at the right side.

    Repositories

    In the Repositories section, view all Git repositories branch/tag attached to the release.

    To add a repository, enter or select the Git repository in Repository,tag name in Tag, and branch in Branch. Click Add to Release when you are done.

    To remove a repository, click Cancel at the right side.

    Notes

    Enter or edit the release notes in the Page Text tab. Preview the notes in the Preview tab.

    You can also use the project’s wiki markup language to format the notes.

  5. Scroll to the top of the page, and click Save.

Changing a Release’s Status

You can change the status of a release from the Edit Release page.

To change the status of a release:
  1. In the navigation bar, click Releases.
  2. In the Release list, select the release whose status you want to change.
  3. Click the Actions icon on the right and select Edit.
  4. In the Edit Release page, change the selected option in Status option buttons to the desired option.
    The name of the release at the top of the page shows the selected release state. To know more about release states, see About Release States.
  5. Click Save.
A notification about the change in the state of the release is displayed in the Activity Feed of the Project page.

Downloading Artifacts of a Release

You can download the artifacts of a release individually from the Releases page.

The following artifacts can be downloaded for a Release:

  • Binary files from the Binaries section

  • Build artifacts of successful builds from the Builds section

  • Maven artifacts from the Maven Artifacts section

  • An archive of a tag of a Git repository in the Repositories section

Downloading Binary Files

  1. In the navigation bar, click Releases.

  2. In the Release list, select the release whose artifacts you want to download.

  3. Expand the Binaries section, if required.

  4. For each file you want to download, click the file name link in the File column.

    Save the file at the desired location on your computer.

Downloading Build Artifacts

  1. In the navigation bar, click Releases.

  2. In the Release list, select the release whose artifacts you want to download.

  3. Expand the Builds section, if required.

  4. For each artifact you want to download, click the zip link in the Artifact column. You can download artifacts of successful builds only.

    Save the file at the desired location on your computer.

Downloading Maven Artifacts

  1. In the navigation bar, click Releases.

  2. In the Release list, select the release whose artifacts you want to download.

  3. Expand the Maven Artifacts section, if required.

  4. For each artifact you want to download, click the name link in the Artifact column.

    Save the file at the desired location on your computer.

Downloading Git Repository Archives of Tags

  1. In the navigation bar, click Releases.

  2. In the Release list, select the release whose artifacts you want to download.

  3. Expand the Repositories section, if required.

  4. For a tag’s archive file you want to download, click the zip or the tar.gz link in the Download column.

    Save the file at the desired location on your computer.

Deleting a Release

You can delete a release from the Release page.

To delete a release:
  1. In the navigation bar, click Releases.
  2. In the Releases page, select the release that you want to delete.
  3. Click the Actions icon on the right of the details page and choose Delete.
  4. In the Delete Release dialog box, select the Are you sure you want to delete <release_name> release? check box.
  5. Click Delete.