Testing and Deployment Customizations
Image Management
This document provides comprehensive guidelines for managing custom images within the UDS Core system, from creation and testing to deployment and transportation, particularly in restricted environments like air-gapped systems.
Building and Testing Custom Images
Build a new image
Build a custom development image for UDS Core using the following commands:
# create a dev image uds-core-config:keycloakuds run dev-build
# optionally, retag and publish to temporary registry for testingdocker tag uds-core-config:keycloak ttl.sh/uds-core-config:keycloakdocker push ttl.sh/uds-core-config:keycloak
Update UDS Core references
Update the custom image references in the uds-core
repository:
- Update zarf.yaml to include updated image.
- Specify configImage in Keycloak values.yaml.
- For truststore updates, see gateway configuration instructions.
Deploy UDS Core
Deploy UDS Core with the new custom image:
# build and deploy uds-coreuds run test-uds-core
See UDS Core for further details
Building New Image with Updates
For convenience, a Zarf package definition has been included to simplify custom image transport and install in air-gapped systems.
Use the included UDS task to build the custom image and package it with Zarf:
uds run build-zarf-pkg