Skip to content

defenseunicorns/uds-package-dubbd

Repository files navigation

Important

DUBBD will be maintained until summer of 2024, when it will be deprecated in favor of uds-core

Defense Unicorns Big Bang Distro (DUBBD)

Pre-built Zarf Package of DoD-Platform-One/big-bang configured for production use by Defense Unicorns.

Prerequisites

  • Zarf is installed locally with a minimum version of v0.32.1
  • Optional: A working Kubernetes cluster on v1.27+ -- e.g k3d, k3s, RKE2, etc (Zarf can be used to deploy a built-in k3s distribution)
  • Working kube context (kubectl get nodes <-- this command works)

For additional information see here.

Quickstart Deploy

k3d

Assumes you've followed the prerequisites and have a k3d cluster running.

zarf init --components=git-server --confirm
zarf package deploy oci://ghcr.io/defenseunicorns/packages/dubbd-k3d:<VERSION> # search tags at https://github.com/defenseunicorns/uds-package-dubbd/pkgs/container/packages%2Fdubbd-k3d

Confirm Deployment

zarf tools kubectl get pods -A

For deploying other flavors of DUBBD:

DUBBD repo details

  • aws - DUBBD for aws (EKS)
    • dubbd-aws - DUBBD package for aws (imports DUBBD base)
    • k8s-manifests - k8s manifest files for aws
    • values - values file overrides for aws
  • defense-unicorns-distro - base DUBBD package definition
    • manifests - k8s manifests
      • alerts - k8s manifests for alerting
    • scripts - scripts for zarf package
  • k3d - DUBBD for k3d (local development)
    • values - values file overrides for k3d
  • rke2 - DUBBD for rke2
    • values - values file overrides for rke2
  • values - shared values files

Releases

When to expect new releases

New DUBBD versions can be expected (at a minimum) shortly after each Big Bang release is available.

Following semantic versioning for releases, a new release version is created upon implementing changes that are categorized as fixes or features.

Creating releases

See DUBBD Releases for more information.

Contributing

Please see the CONTRIBUTING.md.