Publish Bucket

This section will guide you through publishing a bucket from a Rok cluster to a Rok Registry.

What You’ll Need

  • A working Rok and Rok Registry deployment.
  • A Rok bucket that you want to publish.

Procedure

  1. Log in to Rok using your credentials.

    ../../_images/login.png
  2. Select Snapshots from the left-side menu.

    ../../_images/snapshot.png
  3. Find the bucket you want to publish in your bucket list and click on the Publish button (upward pointing arrow).

    ../../_images/arrow.png
  4. Fill in the URL of your registry followed by the user and the bucket name under Rok registry link. Choose whether you want your bucket to be private or public. Then click Publish.

    ../../_images/publish.png

    Important

    • The URL must have the format https://<REGISTRY>/<USER>/<BUCKET-NAME>.
    • The user name is displayed in the Rok Registry UI when you login.
    • The bucket name can contain only letters, numbers, dashes and underscores. The first character must be a letter.
    • The bucket will be created, if it doesn’t exist.
  5. If your Rok cluster is not authorized to create that bucket in the registry, you need to follow these extra steps:

    1. Authorize it by clicking OK.

      ../../_images/authorization.png
    2. In the pop-up window choose whether you want to allow access to one or more buckets and for how long, then click Allow.

      ../../_images/permissions.png
  6. Ensure that you published the bucket. A green upward arrow will appear under the bucket name and the Publish button will be replaced by the Unpublish button.

    ../../_images/published.png

Verify

  1. Click on your bucket, go to Bucket info and verify that your bucket is Published and it is syncing.

    ../../_images/info.png
  2. Log in to your Rok registry and verify that you can see the bucket you just published.

    ../../_images/registry.png

Summary

You have successfully published a bucket to a Rok Registry.

What’s Next

The next step is to subscribe to a bucket.