Files
matchbox/Documentation/dev/develop.md
Dalton Hubble a0b24a9596 Remove rkt tutorials, docs, and scripts
* rkt achieved its mission creating the OCI standard,
pluggable runtimes, and prevented Docker world
domination. We can now proceed with disarmament
* Few, if any, developers still use rkt locally
2019-10-06 22:28:39 -07:00

1.2 KiB

Development

To develop matchbox locally, compile the binary and build the container image.

Static binary

Build the static binary.

$ make build

Test with vendored dependencies.

$ make test

Container image

Build a container image coreos/matchbox:latest.

$ make docker-image

Version

$ ./bin/matchbox -version
$ sudo docker run coreos/matchbox:latest -version

Run

Run the binary.

$ ./bin/matchbox -address=0.0.0.0:8080 -log-level=debug -data-path examples -assets-path examples/assets

Run the Docker image on docker0.

$ sudo docker run -p 8080:8080 --rm -v $PWD/examples:/var/lib/matchbox:Z -v $PWD/examples/groups/etcd:/var/lib/matchbox/groups:Z coreos/matchbox:latest -address=0.0.0.0:8080 -log-level=debug

bootcmd

Run bootcmd against the gRPC API of the service.

$ ./bin/bootcmd profile list --endpoints 172.18.0.2:8081 --cacert examples/etc/matchbox/ca.crt

Vendor

Add or update dependencies in go.mod and vendor.

make update
make vendor

Codegen

Generate code from proto definitions using protoc and the protoc-gen-go plugin.

$ make codegen