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.
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!
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'.
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
pachctlpoint 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
Create a test repo:
pachctl create repo testSystem response
pachctl 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.
You have successfully deployed and configured a Pachyderm workspace in Hub.
Next: Beginner Tutorial