Skip to main content
Version: 0.4.3

Quickstart

Skipping past most of the documentation? Here's an easy to follow Quick Start Guide:

Quick Installation​

# install latest release
curl -sfL https://get.hauler.dev | bash

Example Use of Hauler​

Add Content to the Hauler Store​

Using the Command Line:​

# add a image: neuvector/scanner:latest
hauler store add image neuvector/scanner:latest --platform linux/amd64

# add a image with supply chain artifacts
hauler store add image rgcrprod.azurecr.us/longhornio/longhorn-ui:v1.5.2 --key carbide-key.pub --platform linux/amd64

# add a chart: rancher-stable/rancher (v2.8.1)
hauler store add chart rancher --repo https://releases.rancher.com/server-charts/stable --version 2.8.1

# add a file: rke2-install.sh
hauler store add file https://get.rke2.io --name install.sh

Using a Hauler Manifest:​

hauler store sync --files hauler-manfiest.yaml
hauler-manfiest.yaml
apiVersion: content.hauler.cattle.io/v1alpha1
kind: Images
metadata:
  name: hauler-content-images-example
spec:
  images:
    - name: neuvector/scanner:latest
    - name: rgcrprod.azurecr.us/longhornio/longhorn-ui:v1.5.1
      key: carbide-key.pub
      platform: linux/amd64
---
apiVersion: content.hauler.cattle.io/v1alpha1
kind: Charts
metadata:
  name: hauler-content-charts-example
spec:
  charts:
    - name: rancher
      repoURL: https://releases.rancher.com/server-charts/stable
      version: 2.8.1
---
apiVersion: content.hauler.cattle.io/v1alpha1
kind: Files
metadata:
  name: hauler-content-files-example
spec:
  files:
    - path: https://get.rke2.io
      name: install.sh

View the Hauler Store​

# view and verify the content in the local hauler store
hauler store info

Save the Hauler Store​

# save and export the content in the local hauler store
hauler store save --filename haul.tar.zst

airgap the haul.tar.zst to the disconnected environment

Load the Airgapped Hauler Store​

# load and import the airgapped content to the new local hauler store
hauler store load haul.tar.zst

Serve the Hauler Store​

# serve the content as a registry from the hauler store
hauler store serve registry

# serve the file content as a fileserver from the hauler store
hauler store serve fileserver

Copy the Hauler Store to a Registry​

# copy the content to a registry from the hauler store
hauler store copy registry://harbor.example.com

Copy the Hauler Store to a Directory​

# copy the content to a directory from the hauler store
hauler store copy dir://hauler-files