cli

command
v0.97.1 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Oct 23, 2024 License: Apache-2.0 Imports: 12 Imported by: 0

README

Command Line Interface (CLI)

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

a) Operator Management Tasks

b) Attestation Crafting Process

cas

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
Updating default values

By default CLI uses the following values for the Control Plane and Artifacts CAS API endpoints:

  • Artifacts CAS: api.cas.chainloop.dev:443
  • Control Plane API: api.cp.chainloop.dev:443

If you want to change them to your custom endpoints, you can do that at build time. We will use ldflags and the following variables: defaultCASAPI and defaultCPAPI. We assume in this example that we have our instance of Chainloop running at the following locations: api.cas.acme.com:443 and api.cp.acme.com:443.

go build -ldflags "-X 'github.com/chainloop-dev/chainloop/app/cli/cmd.defaultCASAPI=api.cas.acme.com:443' -X 'github.com/chainloop-dev/chainloop/app/cli/cmd.defaultCPAPI=api.cp.acme.com:443'" app/cli/main.go

Contribution guidelines

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

Welcome!

Documentation

The Go Gopher

There is no documentation for this package.

Directories

Path Synopsis
cmd
internal

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL