/sigstore-local-deployment

sigstore local deployment scripts

Primary LanguageShellApache License 2.0Apache-2.0

sigstore-local-deployment

This automates, and enhances the manual approach to running local Sigstore outlined in Sigstore the local way.

The sigstore-local-deployment provides:

  • Container image signing
  • Signing action with cosign
  • Image uploaded to local OCI registry
  • Rekor transparency log to provide a second immutable source of truth to the system

See make help for details of make targets.

Installation of requirements

Linux packages

Currently only RHEL/Fedora is fully supported. MacOS support is in progress.

The following packages are required:

  • mariadb-server
  • git
  • golang
  • softhsm
  • opensc

To install these run:

sudo make install-packages-linux or make install-packages-mac

Go packages

The following are provided are go packages (see make help for target details):

  • Simple OCI registry
  • cosign
  • trillian_log_server
  • trillian_log_signer
  • createtree
  • ko

These can be installed by running:

  • make install-registry
  • make install-cosign
  • make install-trillian
  • make install-ko

Starting Cosign and dependancies

The easiest way to create a Cosign environment is by running:

make quickstart

Once this has been completed run the following to test the installation:

make post-deploy-tests

Logging

All backgrounds processes (Registry, cosign, Trillian etc) are logged via systemd journal, so use journalctl to view these.