docs: added basic readme file

This commit is contained in:
Felipe M 2022-08-15 20:55:53 +02:00
parent 166c4089ef
commit c127235880
Signed by: fmartingr
GPG Key ID: 716BC147715E716F
1 changed files with 32 additions and 0 deletions

View File

@ -1 +1,33 @@
# golang-app-template
Golang application template for GitHub.
Contains:
- Basic running Go code (just a `cmd` so everything else works)
- A `Makefile` with some Quality of Life for contributing and executing common tasks.
- A `Containerfile` with a boilerplate container with no dependencies.
- [Goreleaser](https://goreleaser.com) configuration and CI.
- A basic Helm chart
- Github actions to build, test and release binaries and container images to the Github container registry.
## Using the template
1. Press the **Use this template** button at the top of this repository.
2. Find and replace `golang-app-template` everywhere you need
3. Rename `cmd/golang-app-template`
4. `make quick-run`
## Makefile
```
$ make help
build: builds the project for the setup os/arch combinations
clean: clean test cache, build files
format: Executes the formatting pipeline on the project
help: this screen. Keep it first target to be default
lint: Check the project for errors
quick-run: Executes the project using golang
run: Executes the project build locally
test: Runs the test suite
```