Subscribe to Bucket

This section will guide you through subscribing to a bucket for a Rok Registry so you can start syncing its content in your Rok cluster.

What You’ll Need

Procedure

  1. Log in to your Rok Registry using your credentials.

    ../../_images/login-registry.png

  2. In the search bar, type the name of the bucket that you want to subscribe to and click on it.

    ../../_images/search.png

  3. Click on the Copy Link button to copy its link.

    ../../_images/copylink.png

  4. Log in to Kubeflow.

    ../../_images/login.png

  5. Select Snapshots from the left-side menu.

    ../../_images/snapshot.png

  6. Click on New Bucket from the top menu.

    ../../_images/newbucket.png

  7. Fill in a name for your bucket under Bucket name and choose Subscribed bucket type. Then click Next.

    ../../_images/subscribed.png

  8. Paste the link of the bucket you want to subscribe to under Rok registry link, then click Subscribe.

    ../../_images/subscribe.png

    Troubleshooting

    Add a new Rok registry

    If a registration form with the following message appears:

    This seems to be the first time you are trying to use this Rok registry. To proceed, you first need to register this Rok, by retrieving a registration code from this Rok registry.

    then your Rok cluster is not registered with this Rok Registry.

    In this case, you need to contact your admin to configure your Rok cluster for syncing.

  9. Your subscribed bucket will appear in your bucket list. A green downward arrow will appear under the bucket name along with the Unsubscribe button.

    ../../_images/subscribed-bucket.png

Verify

  1. Click on the bucket you subscribed to, go to Bucket info, and verify that your bucket is Subscribed and it is syncing.

    ../../_images/subscribed-info.png

    Troubleshooting

    Peer is stuck at Connecting state

    If the Bucket info shows more than one peers and the state of some remote peers is stuck at Connecting, it means that your Rok cluster is failing to connect to that remote peer to sync the bucket. This probably happens due to some misconfiguration on the peers.

    In this case, contact your admin and make sure they have properly configured the Rok clusters for syncing.

Summary

You have successfully subscribed to a bucket from a Rok Registry.

What’s Next

Check out the rest of our user guides.

PreviousNext