Skip to content

Commit

Permalink
chore: improve the formatting on the README (#87)
Browse files Browse the repository at this point in the history
## Description

This improves the formatting of the deployment sections of the README.

## Related Issue

Fixes #N/A

## Type of change

- [ ] Bug fix (non-breaking change which fixes an issue)
- [ ] New feature (non-breaking change which adds functionality)
- [X] Other (security config, docs update, etc)

## Checklist before merging

- [X] Test, docs, adr added or updated as needed
- [X] [Contributor Guide
Steps](https://github.com/defenseunicorns/uds-software-factory/blob/main/CONTRIBUTING.md#developer-workflow)
followed
  • Loading branch information
Racer159 authored Jul 26, 2024
1 parent 5b77274 commit 64e9fcb
Showing 1 changed file with 25 additions and 18 deletions.
43 changes: 25 additions & 18 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -19,8 +19,8 @@ Also note that the Software Factory team helps to manage the following shared UD

## Bundles

> [!NOTE]
> These UDS Bundles are intended for dev and test environments and should not be used for production. They can however serve as examples to create custom bundles.
> [!CAUTION]
> These UDS Bundles are intended for dev, test and demo environments and should _not_ be used for production. They can however serve as examples to create custom bundles.
This repository publishes multiple bundles for dev, test and demo purposes. They are located in sub-directories under `bundles`.

Expand All @@ -47,7 +47,8 @@ If you have the resources for it locally (see above), you can deploy the full So
- [Docker Compatible Runtime](https://docs.docker.com/engine/) necessary for running `k3d`.
- [UDS CLI](https://github.com/defenseunicorns/uds-cli?tab=readme-ov-file#install) v0.10.4 or later

> [!NOTE]: Apple users follow these [instructions](./docs/development.md) to properly set up your environment to deploy this bundle.
> [!NOTE]
> Apple users follow these [instructions](./docs/development.md) to properly set up your environment to deploy this bundle.
#### Deployment

Expand All @@ -70,35 +71,41 @@ Alternatively, you can deploy the [uds-k3d-swf-dev bundle](./bundles/dev/README.
- [K3D](https://k3d.io/) for dev & test environments or any [CNCF Certified Kubernetes Cluster](https://www.cncf.io/training/certification/software-conformance/#logos) for production environments.
- [UDS CLI](https://github.com/defenseunicorns/uds-cli?tab=readme-ov-file#install) v0.10.4 or later

> [!NOTE]: Apple users follow these [instructions](./docs/development.md) to properly set up your environment to deploy this bundle.
> [!NOTE]
> Apple users follow these [instructions](./docs/development.md) to properly set up your environment to deploy this bundle.
#### Deployment

For `swf-dev` you have two options, build and deploy from source or deploy the artifacts from where they are hosted in the ghcr OCI registry.
For `swf-dev` you have two options, build and deploy from source or deploy the artifacts from where they are hosted in the `ghcr.io` OCI registry.

##### 1. Deploy from Source

To build and deploy from source you can utilize the UDS tasks in this repo by running:

```bash
uds run
uds run
```

Alternatively, you can deploy from OCI by running the following two commands:
##### 2. Deploy from Artifacts

1. Run the below command to deploy the `k3d-core-slim-dev` bundle:
_Alternatively_, you can deploy from OCI by running the following two commands:

> [!NOTE]: You can append `--set INSECURE_ADMIN_PASSWORD_GENERATION=true` to the below command to enable a default keycloak admin. This is useful for development and testing of the SWF stack and enables the ability to run `uds run setup:create-doug-user` to create a user to test with using the username `doug` and the password `unicorn123!@#UN`.
Run the below command to deploy the `k3d-core-slim-dev` bundle:

```bash
uds deploy k3d-core-slim-dev:0.24.1
```
> [!TIP]
> You can append `--set INSECURE_ADMIN_PASSWORD_GENERATION=true` to the below command to enable a default keycloak admin. This is useful for development and testing of the SWF stack and enables the ability to run `uds run setup:create-doug-user` to create a user to test with using the username `doug` and the password `unicorn123!@#UN`.
1. Run the below command to deploy the `swf-dev` bundle on top of the dev cluster:
```bash
uds deploy k3d-core-slim-dev:0.24.1
```

<!-- x-release-please-start-version -->
```bash
uds deploy swf-dev:0.2.3
```
<!-- x-release-please-end -->
Run the below command to deploy the `swf-dev` bundle on top of the dev cluster:

<!-- x-release-please-start-version -->
```bash
uds deploy swf-dev:0.2.3
```
<!-- x-release-please-end -->

## Development

Expand Down

0 comments on commit 64e9fcb

Please sign in to comment.