Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

feat!: full transition to uds-core #28

Merged
merged 1 commit into from
Feb 26, 2024
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
21 changes: 15 additions & 6 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,20 +8,29 @@ The full list of packages and dependencies installed by the bundle (and an assum
[DEVELOPMENT_MAINTENANCE.md](docs/DEVELOPMENT_MAINTENANCE.md)

## Installation ("quickstart")
Once the below [Prerequisites](#prerequisites) are met, these are the steps to deploy.
1) Gather your files in your working directory. Bundle tarball can be referenced via OCI or downloaded for local use.
- uds-config.yaml [Instructions on creating this file](#Configuration)
- our-keycloak-values.yaml [Needed at deploy time](our-keycloak-values.yaml)
- uds-bundle-software-factory-nutanix-amd64-0.x.x.tar.zst [Instructions on OCI reference usage](#deployment). [Instructions on local reference](#(optional)-local-deployment-reference)
2) Deploy the bundle with the above files in your working directory by [following these instructions](#deployment)

### Prerequisites
**Tools**:
* [zarf](https://github.com/defenseunicorns/zarf)
* [uds](https://github.com/defenseunicorns/uds-cli)
* [zarf version v0.32.1](https://github.com/defenseunicorns/zarf/tree/v0.32.1)
- `sudo curl -sL https://github.com/defenseunicorns/zarf/releases/download/v0.32.1/zarf_v0.32.1_Linux_amd64`
* [uds version v0.7.0](https://github.com/defenseunicorns/uds-cli/tree/v0.7.0)
- `sudo curl -sL https://github.com/defenseunicorns/uds-cli/releases/download/v0.7.0/uds-cli_v0.7.0_Linux_amd64`
* (OPTIONAL) [kubectl](https://kubernetes.io/docs/tasks/tools/#kubectl)
* (OPTIONAL) [helm](https://github.com/helm/helm)

> NOTE: Zarf must be accessible on the user's PATH

**Infrastructure**:
* Kubernetes cluster
* Access to the cluster with enough privilage to deploy
* Access to the cluster with enough privilege to deploy
* A valid domain
> NOTE: `*.bigbang.dev` may be used for demomonstration and test deployments.
> NOTE: `*.bigbang.dev` may be used for demonstration and test deployments.
* Wildcard certificates to cover your domain (alternatively, expand for full SAN list)
<details>
<summary>Individual SAN list </summary>
Expand Down Expand Up @@ -89,7 +98,7 @@ The full list of packages and dependencies installed by the bundle (and an assum
Deployment configuration is managed via a `uds-config.yaml` file in the deployment directory. Some values in the configuration will be sensitive, **we do not recommend checking this into source control in its entierty**. Best practice would involve either storing the configuration in an external secrets manager (like Vault), or managing deployments via CD and generating the config file dynamically at deploy time using CD managed secrets.

For demonstration purposes, you can setup a local configfile as follows:
* Copy an example configuration from `uds-config/test-cluster` to your working directory
* Copy an example configuration from [uds-config/uds-core-swf/dev-cluster/uds-config.yaml](uds-config/uds-core-swf/dev-cluster/uds-config.yaml) to your working directory
* Update the config according to your environment taking care to set:
* domain variables
* certificate values
Expand All @@ -116,7 +125,7 @@ uds deploy uds-bundle-software-factory-nutanix-amd64-0.1.4.tar.zst --confirm
```

## Additional Notes
You can use the uds tasks in this project to build and deploy.
You can reference the uds tasks in this project to learn how to build and deploy.

```bash
# List the available tasks to run
Expand Down
200 changes: 0 additions & 200 deletions bundles/dubbd-swf/uds-bundle.yaml

This file was deleted.

6 changes: 4 additions & 2 deletions bundles/uds-core-swf/uds-bundle.yaml
Original file line number Diff line number Diff line change
@@ -1,9 +1,11 @@
# yaml-language-server: $schema=https://raw.githubusercontent.com/defenseunicorns/uds-cli/v0.5.1/uds.schema.json
kind: UDSBundle
metadata:
name: uds-core-swf
name: software-factory-nutanix
description: A UDS bundle for deploying a software factory to an RKE2 cluster
version: "0.0.1"
# x-release-please-start-version
version: "0.1.5"
# x-release-please-end
architecture: amd64

packages:
Expand Down
72 changes: 0 additions & 72 deletions docs/packages-and-dependencies-uds-core.md

This file was deleted.

Loading