Skip to content

loft-orbital/timoni-hub

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

38 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

timoni-hub

build license

K8s packages collection as timoni.sh modules.

Using a Module

If you're new to Timoni, we highly recommend visiting Timoni concepts first. This resource will help you understand the fundamental concepts of Timoni. Additionally, having some basic knowledge of CUE is necessary. This walktrough will get you started with using a module.

Modules

Modules are stored within the modules/ directory. Each module includes its own usage documentation. Before using a module, please ensure to review its documentation thoroughly.

Tip

Every module includes a set of examples located in the examples/ directory. These examples serve as a valuable starting point to comprehend the module configuration.

Module Package Description
gitlab-runner ghcr.io/loft-orbital/timoni/gitlab-runner CI runner for GitLab
postgresql ghcr.io/loft-orbital/timoni/postgresql Postgres SQL database

Verifying

All modules are signed with Cosign keyless during distribution. You can verify the integrity of the module by using the --certificate-identity-regexp ^https://github.com/loft-orbital/timoni-hub.*$ and --certificate-oidc-issuer https://token.actions.githubusercontent.com. Here's an example with the pull command:

timoni mod pull oci:https://ghcr.io/loft-orbital/timoni/<module-name> -v 1.0.0 \
  --output ./<module-name> \
  --verify=cosign \
  --certificate-identity-regexp="^https://github.com/loft-orbital/timoni-hub.*$` \
  --certificate-oidc-issuer-regexp=https://token.actions.githubusercontent.com

Contributing

We welcome contribution via GitHub pull requests. Please refer to the contributing guide for more informations.