Makefile

using Makefile

use -n flag for dry-run, -s or '--silent' flag to suppress echoing

make release/* make deploy/* are manually invoked.

Targets

• default VERSION is git tag

• default TYPE is service

proto

codegen from proto

make proto
make proto TARGET=account
make proto-account
## generate for protos in shared package
# make proto TARGET=shared TYPE=.
make proto_shared

test

# unit tests
make test-unit TARGET=account
make test-unit TARGET=emailer
make test-unit TARGET=account TYPE=api
make test-unit TARGET=config TYPE=shared
make test-unit TARGET=demo TYPE=cmd
make test-unit

# integration tests
make test-inte TARGET=account
make test-inte TARGET=emailer
make test-inte TARGET=emailer TIMEOUT=30s
make test-inte

# end-to-end tests
make test-e2e TARGET=account
make test-e2e TARGET=emailer
make test-e2e
# e2e tests in CI envelopment with micro gRPC proxy
MICRO_PROXY_ADDRESS="localhost:8081" make test-e2e

# generate code coverage
make test-cover
# benchmark testing
make test-bench
make test-race

e2e tests on CI

trigger e2e tests on GitHub Actions

make deploy/e2e GITHUB_TOKEN=123...

run

make run-account
make run TARGET=emailer
make run-emailer
make run-greeter ARGS="--server_address=127.0.0.1:8080"
make run-micro-cmd ARGS="--api_address=0.0.0.0:8088 api"
make run-demo-cmd

lint

# lint all
make lint
# lint account service
make lint-account
make lint-account-service
# goup checks if there are any updates for imports in your module.
# the main purpose is using it as a linter in continuous integration or in development process.
make gomod_lint

Packager

make pkger TARGET=greeter
make pkger-greeter
make pkger
# other pkger commands
pkger list -include /config/config.yaml -include /config/config.prod.yaml -include /config/certs
pkger info github.com/xmlking/micro-starter-kit

build

# use git tag as VERSION
make build VERSION=v0.1.1
make build TARGET=account VERSION=v0.1.1
make build TARGET=account TYPE=service VERSION=v0.1.1
make build TARGET=emailer TYPE=service VERSION=v0.1.1
make build TARGET=account TYPE=api VERSION=v0.1.1
make build-account VERSION=v0.1.1
make build-account-api VERSION=v0.1.1

release

push tag to git

make release VERSION=v0.1.1 GITHUB_TOKEN=123...

docker

Optionally set export DOCKER_BUILDKIT=1 to use moby

make docker-account VERSION=v0.1.1
make docker-account-service VERSION=v0.1.1
make docker TARGET=account VERSION=v0.1.1
make docker TARGET=account TYPE=service VERSION=v0.1.1
make docker TARGET=account DOCKER_REGISTRY=us.gcr.io DOCKER_CONTEXT_PATH=<MY_PROJECT_ID>/micro-starter-kit
make docker TARGET=account DOCKER_REGISTRY=us.gcr.io DOCKER_CONTEXT_PATH=<MY_PROJECT_ID>/micro-starter-kit GO_MICRO_VERSION=v1.17.1
# short hand for TARGET and TYPE args
make docker-emailer-service

# build all docker images for docker-compose
make docker
make docker DOCKER_REGISTRY=us.gcr.io
make docker VERSION=v0.3.2 GO_MICRO_VERSION=v2.3.0
make docker DOCKER_REGISTRY=docker.pkg.github.com DOCKER_CONTEXT_PATH=xmlking/micro-starter-kit
make docker DOCKER_REGISTRY=docker.pkg.github.com DOCKER_CONTEXT_PATH=xmlking/micro-starter-kit VERSION=v0.2.9
make docker DOCKER_REGISTRY=docker.pkg.github.com DOCKER_CONTEXT_PATH=xmlking/micro-starter-kit VERSION=v0.2.9 GO_MICRO_VERSION=v1.17.1

# publish all microservices images
make docker_push

# remove all previous microservices images and any dangling images
make docker_clean

kustomize

generate build/kubernetes.yaml for given overlay and namespace using kustomize

make kustomize OVERLAY=production NS=default VERSION=v1.0.1
make kustomize OVERLAY=production NS=default
make kustomize OVERLAY=production
make kustomize NS=default
# defaults: ENV=local,  NS=default, VERSION=git tag
make kustomize
# build yaml files for local, prod overlays into ./build
make build/kustomize VERSION=v0.2.5

Release

make release/draft VERSION=v0.1.1

At this point, you should inspect the release in the Github web UI. If it looks reasonable, proceed:

make release/publish GITHUB_TOKEN=123...

Deploy

make deploy/e2e GITHUB_TOKEN=123...
make deploy/prod GITHUB_TOKEN=123...

Reference

1. A Makefile for your Go project