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¶
Before you start¶
Log in with your GitHub or Google account to start using hub.pachyderm.com.
1- Create a Workspace¶
Click the Create a 4-hr Workspace button and fill out the form.
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.
3-4 Configure your Pachyderm context and login to your workspace by using a one-time authentication token¶
-
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:
The system should return the name of your workspace.pachctl config get active-context
jolly-caribou
-
Create a test repo:
pachctl create repo test
System responsepachctl list repo
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