Skip to content

defenseunicorns/uds-package-gitlab

Repository files navigation

🏭 UDS GitLab Zarf Package

Made for UDS Latest Release Build Status OpenSSF Scorecard

This package is designed for use as part of a UDS Software Factory bundle deployed on UDS Core.

GitLab is a comprehensive DevOps platform that streamlines the entire software development lifecycle, from planning and source code management to testing, security, and deployment. It offers a unified interface for teams to collaborate effectively and deliver high-quality software efficiently.

Important

The arm64 package includes amd64 images due to lack of availability of arm64 images from upstream projects at this time. This means you can deploy the arm64 package on an arm64 kubernetes cluster, but some of the images contained in the package will require emulation (e.g., qemu or rosetta) to run properly.

Pre-requisites

The GitLab Package expects to be deployed on top of UDS Core with a configured Redis/Valkey instance, Postgres database and S3 compatible object storage. To learn more about configuring GitLab see the configuration documentation.

Important

NOTE: Some GitLab features (such as GitLab pages) will also require a GitLab runner along with additional configuration such as an additional certificate SAN for *.pages.<your-domain>.

Releases

The released packages can be found in ghcr.

UDS Tasks (for local dev and CI)

*For local dev, this requires you install uds-cli

Tip

To get a list of tasks to run you can use uds run --list!

Contributing

Please see the CONTRIBUTING.md

Development

When developing this package it is ideal to utilize the json schemas for UDS Bundles, Zarf Packages and Maru Tasks. This involves configuring your IDE to provide schema validation for the respective files used by each application. For guidance on how to set up this schema validation, please refer to the guide in uds-common.