- Python 3.8+
- Docker (optional, used by
sameproject from PyPI¶
For example, with
pip3 install --upgrade sameproject
Validate successful installation by running
same version. Output should look similar to below
Connecting to a Workflow Engine¶
To run SAME, you will need a workflow engine to connect to. We support Kubeflow Pipelines.
Option A: Test Drive¶
Use a test drive Kubernetes cluster with Kubeflow Pipelines preinstalled.
This test drive cluster will expire 1 hour after starting it.
You can run
testctl get again to get a new one at any time.
Register for a Testfaster account.
Copy and run the
testctlinstall instructions at Access Token. Make sure to include the
Clone this Kubeflow Combinator repo and get a cluster:
git clone https://github.com/combinator-ml/terraform-k8s-stack-kubeflow-mlflow cd terraform-k8s-stack-kubeflow-mlflow cd examples/testfaster
testctl get(If you use a non-
bashshell, you may need to spell the command to set an environment variable differently.)
- To launch the Kubeflow Pipelines UI, from the
terraform-k8s-kubeflow/testfasterdirectory, run:And copy the final URL into your browser. Log in with
12341234. Go to
Defaultin the Kubeflow UI.
- Now in the same shell you ran the
exportcommand, you can run
same run(see next section) and it will be able to find and deploy to Kubeflow pipelines in the configured cluster.
Option B: Use Existing Kubeflow Pipelines Install¶
Ensure your active
kubectl context is pointing to the Kubernetes cluster with Kubeflow Pipelines installed:
kubectl config current-context
If so, you are ready to run
same run (see next page for example).
same run, look in
Default in the Kubeflow UI.
Option C: Install Kubeflow Pipelines on Kubernetes¶
Follow the Kubeflow installation instructions, and then follow the existing Kubeflow Pipelines section.
Or, try the Test Drive if this is too much hard work.
You're done setting up SAME and are now ready to execute!
The default execution uses Kubeflow (either locally or in the cloud). Use the
-t flag to set another target.
To try out an example, check out the roadsigns example from Example Notebook.