Getting Started with Hub¶

Hub is a SaaS platform that gives you access to all of Pachyderm's functionalities without the burden of deploying and maintaining it locally or in a third-party cloud platform.

This section walks you through the steps of creating a workspace in Hub so that you do not need to worry about the underlying infrastructure and can get started right away.

Note

Let us know how to improve Hub. Join our Slack channel.

Get started in 4 simple steps¶

Hub Steps

Before you start¶

Log in with your GitHub or Google account to start using hub.pachyderm.com. Hub Login

1- Create a Workspace¶

Click the Create a 4-hr Workspace button and fill out the form. Hub workspace

You just provisioned a one-node cluster that you can now use for a limited time for free!

Note

While Pachyderm maintains a few clusters that are instantly available, none may be available during periods of high traffic. If you see your workspace is in a starting state, you might have to wait a few minutes for it to be ready.

2- Install pachctl¶

Hub enables you to access your workspace through Pachyderm CLI pachctl and the web interface called the Dashboard. Although you can perform most simple actions directly in the Dashboard, pachctl provides full functionality. Most likely, you will use pachctl for any operation beyond the most basic workflow. We recommend that you use pachctl for all data operations and the Dashboard to view your data and graphical representation of your pipelines.

After your workspace creation, open a terminal window and install 'pachctl'.

Warning

kubectl commands are not supported for the workspaces deployed on Hub.

To configure a Pachyderm context and log in to your workspace (i.e. have your pachctl point to your new workspace), click the Connect link on your workspace name in the Hub UI.

In your terminal window, copy, paste, and run the commands 1,2,3 listed in the instructions.

Note Your token has a limited lifetime. The following error means that your authentication token has expired. Close the pop-up window and re-connect.
```
   error authenticating with Pachyderm cluster: otp is invalid or has expired
```
Verify that you have set the correct context:
```
pachctl config get active-context
```
The system should return the name of your workspace.
```
jolly-caribou
```

Create a test repo:

pachctl create repo test

pachctl list repo

System response

NAME CREATED       SIZE (MASTER) ACCESS LEVEL
test 5 seconds ago 0B            OWNER

Check the repo in your dashboard:

In the Hub UI, click the Details button next to your workspace name, then Dash. Your dashboard opens in a new window.

Next Step¶

You have successfully deployed and configured a Pachyderm workspace in Hub.

Next: Beginner Tutorial

Last update: April 5, 2021

Does this page need fixing?