Version: 2021.1
Unity CCD Command-line interface (CLI)
Using CCD via the command-line interface

Unity CCD Develop Dashboard

Important: The Unity Cloud Content Delivery documentation has moved to docs.unity.com. Please visit the new site for the most up to date information about Unity CCD.

You can use Cloud Content Delivery (CCD) in the Develop Dashboard to create and maintain buckets, badges and releases. However, you must use the command-line interface (CLI) to upload, delete and sync files and folders before you manage them in the Develop Dashboard.

As an example scenario, you could use the Develop Dashboard to interactively manage an application’s assets using a more visual user interface than the CLI provides.

To access CCD in the Develop Dashboard:

  1. If you are using Unity services for the first time:
    1. Create a Unity ID account (if you don’t already have one).
    2. Log into the Develop Dashboard from the Develop tab.
    3. Click Create New Project. In the Create New Project windowA window that shows the contents of your Assets folder (Project tab) More info
      See in Glossary
      , fill in the details.
  2. Select the project name, or click View.
  3. In the Overview page for this project, in the left-side navigation bar, select Content Delivery > Buckets.

Buckets

In the Cloud Content Delivery page for your project, you need to create buckets to host your content.

To add a bucket:

  1. Click Create Bucket.
  2. In the Create Bucket window, give the bucket a name and an optional description.

In the bucket list view, each bucket has a details row that contains the following information:

  • The bucket name
  • A description of the bucket
  • A snapshot of the current state:
    • The release number of the current release, or notification of unreleased changes.
    • The date at which the last change was made to the bucket.
    • The user name of the person who made the latest changes, or the name of the source for automated changes.

You can edit or delete a bucket via the More Items menu (⋮) at the end of a bucket’s row.

To see more information about a bucket, click its name in the list view. In the bucket details screen, there are following tabs:

  • Latest: Shows the current state of the bucket, and the latest versions of all its content. From here, you can create a release. The asset list is paginated, searchable, and contains a filter. If your bucket does not have any unreleased changes, you can promote a release from this tab.
  • Releases: Displays all the releases you have created for this project.
  • Badges: Lists all the badges available for this release.

Releases

You can manage the releases you have created for your project on the Releases tab. If your bucket has any unreleased content, you see the Create Release button in your release’s details row.

To create a release:

  1. Select a bucket from the Content Delivery Buckets page that contains unreleased changes.
  2. In the bucket’s page, select the Latest tab.
  3. Select the Create Release button.
  4. In the Create Release dialog box, enter optional release notes and click Next.
  5. On the next page, choose the badges that you want to assign to this release (removing them from their current releases), and select Next.
  6. Review your changes, then select Submit to finalize, or Back to continue editing. The Unreleased Changes notification changes to reflect the new status.

After you create a release, it appears in the list in the Releases tab, with its creation date and any associated badges. You can assign a badge to a release via the More Items menu (⋮) at the end of a release’s row.

When you click on the Release # of a release in the list, you see a page that contains the release’s details, and a list of assets and bundles associated with that release.

Some situations in your project’s release pipeline might require you to move a release from one bucket to another, which is a process called promotion. If your bucket does not have any unreleased changes, you see the Promote Release button in your release’s details row.

To promote a release:

  1. Click the Release # of the release you want to promote in the Releases tab.
  2. In the release summary, click Promote Release.
  3. In the Promote Release window, select the bucket to which you want to promote the release in the Target Bucket drop-down.
  4. Add any optional release notes, and select Next.
  5. On the next page, choose the badges that you want to assign to this release (removing them from their current releases), and select Next.
  6. Review your changes, then select Promote Release to finalize, or Back to continue editing.

Badges

Attaching a badge to a release allows your application to load content from whichever release the badge is assigned to.

To create a badge:

  1. Select a bucket from the Content Delivery Buckets page.
  2. Select the Badges tab.
  3. Select Add New.
  4. In the Add New Badge window, give the badge a unique name, and select its release from the drop-down list.
  5. Select Submit.

The badge now appears in the badge list in the Badges tab. You can edit a badge’s associated release, or delete the badge via the More Items menu (⋮) at the end of a badge’s row.

Unity CCD Command-line interface (CLI)
Using CCD via the command-line interface