cli

README

Command Line Interface (CLI)

This Command Line Interface (CLI) is a local client that's used for two purposes:

a) Operator Management Tasks

• operate on the control plane
• upload/download artifacts to the artifact proxy.

b) Attestation Crafting Process

• Perform the attestation process inside a CI/CD system.

The project is a Go CLI that leverages Cobra for CLI scaffolding, Viper for configuration handling, gRPC to communicate with both the control plane and the Artifact CAS APIs, and the cosign, in-toto, DSEE and SLSA projects for the attestation process.

Runbook

We use make for most development tasks. Run make -C app/cli to see a list of the available tasks.

Run the project in development

Refer to development guide for more information but in a nutshell.

go run app/cli/main.go --insecure

NOTE: In development a --insecure flag must be provided to talk to the local APIs

Configure the CLI to point to the local control plane and CAS services.

If you want to use this CLI pointing to a local or custom instance of Chainloop, you need to perform a config override this way.

go run app/cli/main.go config save --insecure --control-plane localhost:9000 --artifact-cas localhost:9001

Run tests

make test

Build binary

make build

Generate API code from protocol buffer defintions (*.proto)

We leverage buf.io to lint and generate proto files. Make sure you install buf first. Once done, generating the API code is as easy as executing

make api

Contribution guidelines

Please make sure to review the Contribution guidelines and feel free to reach out if you have any questions!

Welcome!