Develop Internals
This guide gives information how to start develop internals of Carbonaut. Carbonauts source code is developed in Go and located in the pkg/
directory of the project. After this guide you are able to make changes, verify if made changes work and how to push these changes and get towards merging it to the main Carbonaut project.
Setup
- Read the contributors guide here and fork the carbonaut repository.
- Setup your dev environment. Follow this guide.
- Test building the project locally
make build
- Run Carbonaut in test-run mode
./main --test-run
. Carbonaut will load a test config and shut down after a couple of seconds automatically.
Make changes to the codebase
Open up any edit and make changes to the code base. You can run unit tests and linting with make verify
. During that process a coverage.html
will be generated which can be used to explore test coverage.
Verify changes made
- Run
make verify
.- INFO: Some steps run commands like
go mod tidy
which may changego.mod
(depending on your edits) ifgo.mod
was changed duringmake verify
, the check will fail but its safe to rerun it.
- INFO: Some steps run commands like
- Optionally you can run e2e checks see this guide