Released Capsules

This guide introduces Released Capsules and Internal Releases, as well as how to create and use a Released Capsule.

A released capsule is an end-to-end reproducible version of your capsule that is separate from the original. This enables your team to use a fully functioning version while you develop your capsule.

Released capsules can only be used by people with access to the original version. Before releasing a capsule you’ll need to share it with your team members. See Sharing Compute Capsules for more information.

Internal Releases are Released Capsules that have been shared with you organization. There is a dedicated dashboard for Internal Releases. See below for additional information .

Releasing a Compute Capsule

1. Click Release in the top tight corner of you capsuleto release the capsule.
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 then to the .gitignore file.

3. Once you meet all the criteria, the capsule is 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 released version from the capsule Timeline.
4. If you continue to develop the original capsule and would like changes to be reflected in the released version, you can update the released capsule by clicking Release new version in the original capsule. All versions will be available in the released capsule’s Timeline. From any released version, users can easily toggle to others..

You can only release a capsule from the compute capsule IDE.

Only the Owner of the capsule can release the capsule.

Internal Releases

Released capsules that have been shared with your entire organization will appear in the Internal Releases Dashboard. Navigate to this dashboard by clicking the Release icon on the left side bar from anywhere in Code Ocean.

The following steps indicate how to make your released capsule available in the Internal Releases Dashboard:

1. From the released capsule, click Share to set the permissions for the capsule.
2. Check Share with everyone.
3. Click Save.

Now this released capsule will be accessible to your entire organization through the Internal Releases Dashboard.

Find a Released Capsule

Navigate to the Capsules page () in the left sidebar. Select the Released tab to view the released capsules.

Internal releases are available on the Internal Releases Dashboard. A capsule shared with the entire organization will appear under both the Released tab and the Internal Releases Dashboard.

Working with a Released Capsule

From the Timeline, click Go To Released Capsule. The released status is indicated by a blue Released label in front of the capsule name. You can view any file of the released capsule and execute reproducible runs.

Execute a Reproducible Run in a Released Capsule

In the released capsule view, click Reproducible Run, at the top of the Timeline, to execute a run. A pop-up message appears to indicate the estimated re-run time. Click Proceed to continue.

If the released Capsule has the App Panel feature in use, click the App Panel tab to modify the parameters, then click Run with parameters. A pop-up message appears and indicates the estimated re-run time. Click Proceed to continue.

If the App Panel feature is in use, you can select the functionality that will be available in the released capsule. Refer to Metadata to see additional information about the Functionality Status.

Duplicate a Released Capsule

To edit a released capsule, 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.