Creating and Using Release Capsules

1. Releasing a Compute Capsule

2. Finding a Release Capsule

3. Working with a Release Capsule

A release capsule is a permanently reproducible, run-only version of your capsule that is separate from the original. This enables your team to use a fully functioning version while you continue to develop your capsule.

Release capsules will inherit the sharing permissions of the original capsule. Once it has been created, the sharing permissions of the release capsule can be changed independently of the original. See Sharing Compute Capsules for more information.

Internal Releases are Release Capsules that have been shared with everyone in your organization. There is a dedicated dashboard for Internal Releases. See the next section for more information.

Releasing a Compute Capsule

1. Click Release with in the top right corner of your capsule to begin the release process.
2. Complete the mandatory pre-release steps:

   2.1 Fill out the required metadata.*

   2.2 Perform a reproducible run that includes all the latest changes.

   2.3 Ensure all files in your capsule are either tracked in Git or intentionally excluded from Git by adding them to the .gitignore file.

3. Once you meet all the criteria, the capsule can be released. This creates a separate run-only version of your capsule that is available to anyone with access to the original. You can access the release version from the capsule Timeline.
4. If you continue to develop the original capsule and would like changes to be reflected in the release version, you can update the release capsule by clicking Release a new version in the original capsule. All versions will be available in the release capsule’s Timeline as well as through a dropdown menu above the Timeline. From any release version, users can easily toggle to others.

*Capsules that are used as RShiny or Streamlit apps have an additional field to complete in the metadata page; the type of no-code app must be selected. This will ensure the appropriate Cloud Workstation is available in the release capsule. Shiny or Streamlit will be available in the Release as no-code App dropdown menu of the metadata page when that Cloud Workstation has been used in the capsule.

Only Owners of the capsule can release the capsule.

Find a Release Capsule

Navigate to the My Capsules dashboard () in the left sidebar. Select the Released tab to view any release capsule you have access to.

Working with a Release Capsule

From the original capsule, navigate to the release capsule by clicking Go To Release Capsule in the Timeline. The capsule's release status is indicated by a blue Release label to the left of the capsule's title.

In the release capsule you can explore any files the author made available, execute reproducible runs, create data assets from results, and duplicate the release version.

In the release capsule, click Reproducible Run to execute a run. A pop-up message appears to indicate the estimated re-run time. Click Proceed to continue.

Any user with access to the release capsule can do a Reproducible Run, but in the Timeline each user will only see the Release Results and results from runs they started.

To edit a released version, you must duplicate it first.

1. Click Capsule in the menu.

2. Click Duplicate.

You are redirected to the newly duplicated capsule. The capsule name becomes Copy of + the original capsule name.