Skip to content

defenseunicorns/uds-cli

Folders and files

NameName
Last commit message
Last commit date

Latest commit

bc4f2e7 · Apr 21, 2025
Apr 21, 2025
Nov 7, 2024
Apr 21, 2025
Apr 21, 2025
Apr 21, 2025
Apr 21, 2025
Apr 15, 2025
Apr 21, 2025
Apr 21, 2025
Apr 8, 2025
Apr 21, 2025
Apr 21, 2025
Apr 15, 2025
Apr 15, 2025
Nov 7, 2024
Oct 17, 2024
Apr 15, 2025
Oct 18, 2024
Oct 17, 2024
Apr 21, 2025
Apr 21, 2025
Oct 17, 2024
Apr 2, 2025
Feb 7, 2025
Feb 12, 2025
Sep 4, 2024
Dec 16, 2024

Repository files navigation

UDS-CLI

Latest Release Go version Build Status OpenSSF Scorecard

Install

Recommended installation method is with Brew:

brew tap defenseunicorns/tap && brew install uds

UDS CLI binaries are also included with each Github Release

Official Documentation

Official documentation is located at uds.defenseunicorns.com/reference/cli/overview/

Quickstart

UDS-CLI provides a mechanism to bundle and deploy multiple, independent Zarf packages. To create a UDSBundle of Zarf packages, create a uds-bundle.yaml file like so:

kind: UDSBundle
metadata:
  name: example
  description: an example UDS bundle
  version: 0.0.1

packages:
  - name: init
    repository: ghcr.io/defenseunicorns/packages/init
    ref: v0.33.0
    optionalComponents:
      - git-server
  - name: podinfo
    repository: ghcr.io/defenseunicorns/uds-cli/podinfo
    ref: 0.0.1

Running uds create in the same directory as the above uds-bundle.yaml will create a bundle tarball containing both the Zarf init package and podinfo. The bundle can be deployed with uds deploy.

Contributing

Build instructions and contributing docs are located in CONTRIBUTING.md.