Beginner Tutorial

First-Time Setup

Connect to Existing Instance

Language Clients

Target Audience

Intro to Data Versioning

Intro to Pipelines

Developer Workflow

CI/CD Integration

Create a Machine Learning Workflow

The Push Images Flag

Working with Pipelines

High-Level Architecture Diagram

Azure Deployment

Set Up AWS Secret Manager

Pachctl Auto-completion

Unified Deployment

Authentication & IdP Connectors

Authorization (RBAC)

Access Control (RBAC) Roles & Permissions

Manage RBAC via Console

Add Roles to User via PachCTL

Add Roles to Group via PachCTL

Environment Variables

Kubernetes RBAC

Import a Kubernetes Context

Log Aggregation (Loki)

Non-Default Namespaces

Enterprise Edition

👉 Activate Enterprise via Helm

Activate Enterprise via PachCTL

Features Overview

Enterprise Server (ES)

Activate ES for Multi-Cluster

Activate ES for Single-Cluster

Register a Cluster via Helm

Register a Cluster via PachCTL

Server Management

TLS (SSL, HTTPS)

Tracing (Jaeger)

Blob/Object Storage

Defer Processing via Staging Branch

Skip Failed Datums

Time-Windowed Data

Build Pipelines & DAGs

Create a Pipeline

Delete a Pipeline

Draw a Pipeline

Inspect a Pipeline

Jsonnet Pipeline Specifications

Update a Pipeline

View Pipeline Jobs & Runtimes

Create a Project

Set a Project as Current

Add a Project Resource

Grant Project Access

Delete a Project

Process Specific Commits

Set Branch Triggers

Set Output Branch

List Global Commits & Jobs

List Global ID Sub Commits

Track Downstream

Delete Branch Head

Squash Non-Head Commits

Delete File From History

Standard ML Pipeline

AutoML Pipeline

Multi-Pipeline DAG

Data Parallelism Pipeline

Task Parallelism Pipeline

Docker Image + User Code

Egress To An SQL Database

Export via Egress

Export via PachCTL

Mount a Repo Locally

S3 Gateway Operations

Create S3 Bucket

Delete an S3 Object

Delete Empty S3 Bucket

Get an S3 Object

List S3 Buckets

List S3 Objects

Write an S3 Object

Google BigQuery

Docker Installation Guide

Run in Determined

Local Installation Guide

Troubleshooting

VS Code Auto-Completion

Weights and Biases

pachctl auth activate

pachctl auth check

pachctl auth check project

pachctl auth check repo

pachctl auth deactivate

pachctl auth get

pachctl auth get cluster

pachctl auth get enterprise

pachctl auth get project

pachctl auth get repo

pachctl auth get-config

pachctl auth get-groups

pachctl auth get-robot-token

pachctl auth login

pachctl auth logout

pachctl auth revoke

pachctl auth roles-for-permission

pachctl auth rotate-root-token

pachctl auth set

pachctl auth set cluster

pachctl auth set enterprise

pachctl auth set project

pachctl auth set repo

pachctl auth set-config

pachctl auth use-auth-token

pachctl auth whoami

pachctl buildinfo

pachctl check status

pachctl completion

pachctl completion bash

pachctl completion zsh

pachctl config delete

pachctl config delete context

pachctl config get

pachctl config get active-context

pachctl config get active-enterprise-context

pachctl config get context

pachctl config get metrics

pachctl config import-kube

pachctl config list

pachctl config list context

pachctl config set

pachctl config set active-context

pachctl config set active-enterprise-context

pachctl config set context

pachctl config set metrics

pachctl config update

pachctl config update context

pachctl connect

pachctl copy file

pachctl create branch

pachctl create defaults

pachctl create pipeline

pachctl create project

pachctl create repo

pachctl create secret

pachctl debug analyze

pachctl debug binary

pachctl debug dump

pachctl debug local

pachctl debug log-level

pachctl debug profile

pachctl debug template

pachctl delete all

pachctl delete branch

pachctl delete commit

pachctl delete commitV2

pachctl delete defaults

pachctl delete file

pachctl delete job

pachctl delete pipeline

pachctl delete project

pachctl delete repo

pachctl delete secret

pachctl delete transaction

pachctl diff file

pachctl draw pipeline

pachctl edit pipeline

pachctl enterprise

pachctl enterprise deactivate

pachctl enterprise get-state

pachctl enterprise heartbeat

pachctl enterprise pause

pachctl enterprise pause-status

pachctl enterprise register

pachctl enterprise sync-contexts

pachctl enterprise unpause

pachctl find commit

pachctl finish commit

pachctl finish transaction

pachctl get file

pachctl glob file

pachctl idp create-client

pachctl idp create-connector

pachctl idp delete-client

pachctl idp delete-connector

pachctl idp get-client

pachctl idp get-config

pachctl idp get-connector

pachctl idp list-client

pachctl idp list-connector

pachctl idp set-config

pachctl idp update-client

pachctl idp update-connector

pachctl inspect

pachctl inspect branch

pachctl inspect cluster

pachctl inspect commit

pachctl inspect datum

pachctl inspect defaults

pachctl inspect file

pachctl inspect job

pachctl inspect pipeline

pachctl inspect project

pachctl inspect repo

pachctl inspect secret

pachctl inspect transaction

pachctl kube-events

pachctl license

pachctl license activate

pachctl license add-cluster

pachctl license delete-all

pachctl license delete-cluster

pachctl license get-state

pachctl license list-clusters

pachctl license update-cluster

pachctl list branch

pachctl list commit

pachctl list datum

pachctl list file

pachctl list job

pachctl list pipeline

pachctl list project

pachctl list repo

pachctl list secret

pachctl list transaction

pachctl port-forward

pachctl put file

pachctl rerun pipeline

pachctl restart

pachctl restart datum

pachctl resume transaction

pachctl run cron

pachctl run pfs-load-test

pachctl run pps-load-test

pachctl squash commit

pachctl squash commitV2

pachctl start commit

pachctl start pipeline

pachctl start transaction

pachctl stop job

pachctl stop pipeline

pachctl stop transaction

pachctl subscribe

pachctl subscribe commit

pachctl unmount

pachctl update defaults

pachctl update pipeline

pachctl update project

pachctl update repo

pachctl validate

pachctl validate pipeline

pachctl version

pachctl wait commit

pachctl wait job

Debug Pipelines

Troubleshooting Deployments

View Audit Logs

View Kubernetes Logs

Client Initialization (Start Here)

Breast Cancer Detection

Distributed Image Processing

Spout Pipelines

Coding Conventions

Contributor Setup

Developing on Windows with VSCode

Documentation Style Guide

Activate Enterprise via Helm

Learn how to deploy the Enterprise edition using Helm.

Before You Start #

You must have a Pachyderm Enterprise License Key.
You must have pachctl and Pachyderm installed.
You must have the Pachyderm Helm repo downloaded.

How to Activate Enterprise Pachyderm via Helm #

Activation Method:

Open your Helm values.yml file.
Find the the pachd.enterpriseLicenseKey attribute.
Input your enterprise key.
Upgrade your cluster by running the following command:

helm upgrade pachyderm pachyderm/pachyderm -f values.yml

Once deployed, Pachyderm stores your provided Enterprise license as the platform secret pachyderm-license in the key enterprise-license-key.

Create a secret for your Enterprise license.

kubectl create secret generic pachyderm-enterprise-key \
--from-literal=enterprise-license-key='<replace-with-key>' \
--dry-run=client -o json | jq 'del(.metadata.resourceVersion)' > pachyderm-enterprise-key.json

Or

{
  "kind": "Secret",
  "apiVersion": "v1",
  "metadata": {
    "name": "pachyderm-enterprise-key",
    "creationTimestamp": null
  },
  "data": {
    "enterprise-license-key": "<replace-with-key>"
  }
}

Upload the secret to your cluster.

pachctl create secret -f pachyderm-enterprise-key.json

Obtain your current user-input helm values:
```
helm get values pachyderm > values.yaml
```
Find the the pachd.enterpriseLicenseKeySecretName attribute.

Input your license’s secret name found in meta.name of pachyderm-enterprise-key.json (e.g., pachyderm-enterprise-key-secret).

deployTarget: LOCAL
proxy:
  enabled: true
  host: localhost
  service:
    type: LoadBalancer
pachd:
  enterpriseLicenseKeySecretName: "pachyderm-enterprise-key"

Upgrade your cluster by running the following command:

helm upgrade pachyderm pachyderm/pachyderm -f values.yml

Enterprise automatically enables authentication. You can log in using the following command:

pachctl auth login

username: admin
password: password

However, to use Console, you must set up an IdP.

Activate Enterprise via PachCTL 👉