2018-08-24 13:10:16 +03:00
# Copyright 2018 The Prometheus Authors
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
# http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.
# A common Makefile that includes rules to be reused in different prometheus projects.
# !!! Open PRs only against the prometheus/prometheus/Makefile.common repository!
# Example usage :
2018-11-15 19:51:14 +03:00
# Create the main Makefile in the root project directory.
2018-08-24 13:10:16 +03:00
# include Makefile.common
# customTarget:
# @echo ">> Running customTarget"
#
# Ensure GOBIN is not set during build so that promu is installed to the correct path
u n export GOBIN
GO ?= go
GOFMT ?= $( GO) fmt
FIRST_GOPATH := $( firstword $( subst :, ,$( shell $( GO) env GOPATH) ) )
2018-11-15 19:51:14 +03:00
GOOPTS ?=
2019-01-05 23:56:06 +03:00
GOHOSTOS ?= $( shell $( GO) env GOHOSTOS)
GOHOSTARCH ?= $( shell $( GO) env GOHOSTARCH)
2018-11-15 19:51:14 +03:00
GO_VERSION ?= $( shell $( GO) version)
GO_VERSION_NUMBER ?= $( word 3, $( GO_VERSION) )
PRE_GO_111 ?= $( shell echo $( GO_VERSION_NUMBER) | grep -E 'go1\.(10|[0-9])\.' )
2018-08-24 13:10:16 +03:00
PROMU := $( FIRST_GOPATH) /bin/promu
pkgs = ./...
2019-01-05 23:56:06 +03:00
i f e q ( a r m , $( GOHOSTARCH ) )
GOHOSTARM ?= $( shell GOARM = $( GO) env GOARM)
GO_BUILD_PLATFORM ?= $( GOHOSTOS) -$( GOHOSTARCH) v$( GOHOSTARM)
e l s e
GO_BUILD_PLATFORM ?= $( GOHOSTOS) -$( GOHOSTARCH)
e n d i f
2018-11-15 19:51:14 +03:00
2020-02-25 03:08:30 +03:00
GOTEST := $( GO) test
GOTEST_DIR :=
i f n e q ( $( CIRCLE_JOB ) , )
2023-06-19 11:12:39 +03:00
i f n e q ( $( shell command -v gotestsum > /dev /null ) , )
2020-02-25 03:08:30 +03:00
GOTEST_DIR := test-results
GOTEST := gotestsum --junitfile $( GOTEST_DIR) /unit-tests.xml --
e n d i f
e n d i f
2023-08-15 10:39:13 +03:00
PROMU_VERSION ?= 0.15.0
2018-11-15 19:51:14 +03:00
PROMU_URL := https://github.com/prometheus/promu/releases/download/v$( PROMU_VERSION) /promu-$( PROMU_VERSION) .$( GO_BUILD_PLATFORM) .tar.gz
2019-04-12 03:00:36 +03:00
2023-02-01 14:06:38 +03:00
SKIP_GOLANGCI_LINT :=
2019-04-25 03:00:38 +03:00
GOLANGCI_LINT :=
2019-05-04 03:00:58 +03:00
GOLANGCI_LINT_OPTS ?=
2023-09-03 20:34:10 +03:00
GOLANGCI_LINT_VERSION ?= v1.54.2
2019-04-25 03:00:38 +03:00
# golangci-lint only supports linux, darwin and windows platforms on i386/amd64.
2019-04-12 03:00:36 +03:00
# windows isn't included here because of the path separator being different.
2019-04-25 03:00:38 +03:00
i f e q ( $( GOHOSTOS ) , $( filter $ ( GOHOSTOS ) ,linux darwin ) )
2019-04-12 03:00:36 +03:00
ifeq ( $( GOHOSTARCH) ,$( filter $( GOHOSTARCH) ,amd64 i386) )
2021-09-16 03:01:42 +03:00
# If we're in CI and there is an Actions file, that means the linter
# is being run in Actions, so we don't need to run it here.
2023-02-01 14:06:38 +03:00
ifneq ( ,$( SKIP_GOLANGCI_LINT) )
GOLANGCI_LINT :=
else ifeq ( ,$( CIRCLE_JOB) )
2021-09-16 03:01:42 +03:00
GOLANGCI_LINT := $( FIRST_GOPATH) /bin/golangci-lint
else ifeq ( ,$( wildcard .github/workflows/golangci-lint.yml) )
GOLANGCI_LINT := $( FIRST_GOPATH) /bin/golangci-lint
endif
2019-04-12 03:00:36 +03:00
endif
e n d i f
2018-11-15 19:51:14 +03:00
2018-08-24 13:10:16 +03:00
PREFIX ?= $( shell pwd )
BIN_DIR ?= $( shell pwd )
DOCKER_IMAGE_TAG ?= $( subst /,-,$( shell git rev-parse --abbrev-ref HEAD) )
2019-06-23 03:00:52 +03:00
DOCKERFILE_PATH ?= ./Dockerfile
DOCKERBUILD_CONTEXT ?= ./
2018-08-24 13:10:16 +03:00
DOCKER_REPO ?= prom
2019-04-16 03:00:39 +03:00
DOCKER_ARCHS ?= amd64
BUILD_DOCKER_ARCHS = $( addprefix common-docker-,$( DOCKER_ARCHS) )
PUBLISH_DOCKER_ARCHS = $( addprefix common-docker-publish-,$( DOCKER_ARCHS) )
TAG_DOCKER_ARCHS = $( addprefix common-docker-tag-latest-,$( DOCKER_ARCHS) )
2023-03-22 11:46:56 +03:00
SANITIZED_DOCKER_IMAGE_TAG := $( subst +,-,$( DOCKER_IMAGE_TAG) )
2019-01-05 23:56:06 +03:00
i f e q ( $( GOHOSTARCH ) , a m d 6 4 )
ifeq ( $( GOHOSTOS) ,$( filter $( GOHOSTOS) ,linux freebsd darwin windows) )
# Only supported on amd64
test-flags := -race
endif
e n d i f
2018-08-24 13:10:16 +03:00
# This rule is used to forward a target like "build" to "common-build". This
# allows a new "build" target to be defined in a Makefile which includes this
# one and override "common-build" without override warnings.
% : common -% ;
2019-03-04 16:17:23 +03:00
.PHONY : common -all
2021-06-25 03:01:28 +03:00
common-all : precheck style check_license lint yamllint unused build test
2019-03-04 16:17:23 +03:00
2018-08-24 13:10:16 +03:00
.PHONY : common -style
common-style :
@echo ">> checking code style"
@fmtRes= $$ ( $( GOFMT) -d $$ ( find . -path ./vendor -prune -o -name '*.go' -print) ) ; \
if [ -n " $$ {fmtRes} " ] ; then \
echo "gofmt checking failed!" ; echo " $$ {fmtRes} " ; echo; \
echo " Please ensure you are using $$ ( $( GO) version) for formatting code. " ; \
exit 1; \
fi
.PHONY : common -check_license
common-check_license :
@echo ">> checking license header"
@licRes= $$ ( for file in $$ ( find . -type f -iname '*.go' ! -path './vendor/*' ) ; do \
awk 'NR<=3' $$ file | grep -Eq "(Copyright|generated|GENERATED)" || echo $$ file; \
done ) ; \
if [ -n " $$ {licRes} " ] ; then \
echo "license header checking failed:" ; echo " $$ {licRes} " ; \
exit 1; \
fi
2019-03-13 11:14:47 +03:00
.PHONY : common -deps
common-deps :
@echo ">> getting dependencies"
2022-06-14 01:19:38 +03:00
$( GO) mod download
2019-03-13 11:14:47 +03:00
2020-05-19 03:08:43 +03:00
.PHONY : update -go -deps
update-go-deps :
@echo ">> updating Go dependencies"
@for m in $$ ( $( GO) list -mod= readonly -m -f '{{ if and (not .Indirect) (not .Main)}}{{.Path}}{{end}}' all) ; do \
2021-10-23 03:01:35 +03:00
$( GO) get -d $$ m; \
2020-05-19 03:08:43 +03:00
done
2022-06-14 01:19:38 +03:00
$( GO) mod tidy
2020-05-19 03:08:43 +03:00
2018-08-24 13:10:16 +03:00
.PHONY : common -test -short
2020-02-25 03:08:30 +03:00
common-test-short : $( GOTEST_DIR )
2018-08-24 13:10:16 +03:00
@echo ">> running short tests"
2022-06-14 01:19:38 +03:00
$( GOTEST) -short $( GOOPTS) $( pkgs)
2018-08-24 13:10:16 +03:00
.PHONY : common -test
2020-02-25 03:08:30 +03:00
common-test : $( GOTEST_DIR )
2018-08-24 13:10:16 +03:00
@echo ">> running all tests"
2022-06-14 01:19:38 +03:00
$( GOTEST) $( test-flags) $( GOOPTS) $( pkgs)
2020-02-25 03:08:30 +03:00
$(GOTEST_DIR) :
@mkdir -p $@
2018-08-24 13:10:16 +03:00
.PHONY : common -format
common-format :
@echo ">> formatting code"
2022-06-14 01:19:38 +03:00
$( GO) fmt $( pkgs)
2018-08-24 13:10:16 +03:00
.PHONY : common -vet
common-vet :
@echo ">> vetting code"
2022-06-14 01:19:38 +03:00
$( GO) vet $( GOOPTS) $( pkgs)
2018-08-24 13:10:16 +03:00
2019-04-25 03:00:38 +03:00
.PHONY : common -lint
common-lint : $( GOLANGCI_LINT )
i f d e f G O L A N G C I _ L I N T
@echo ">> running golangci-lint"
2019-01-05 23:56:06 +03:00
# 'go list' needs to be executed before staticcheck to prepopulate the modules cache.
# Otherwise staticcheck might fail randomly for some reason not yet explained.
2022-06-14 01:19:38 +03:00
$( GO) list -e -compiled -test= true -export= false -deps= true -find= false -tags= -- ./... > /dev/null
$( GOLANGCI_LINT) run $( GOLANGCI_LINT_OPTS) $( pkgs)
2019-04-12 03:00:36 +03:00
e n d i f
2018-08-24 13:10:16 +03:00
2021-06-25 03:01:28 +03:00
.PHONY : common -yamllint
common-yamllint :
@echo ">> running yamllint on all YAML files in the repository"
2023-06-19 11:12:39 +03:00
i f e q ( , $( shell command -v yamllint > /dev /null ) )
2021-07-24 12:31:05 +03:00
@echo "yamllint not installed so skipping"
e l s e
2021-06-25 03:01:28 +03:00
yamllint .
2021-07-24 12:31:05 +03:00
e n d i f
2021-06-25 03:01:28 +03:00
2019-04-25 03:00:38 +03:00
# For backward-compatibility.
.PHONY : common -staticcheck
common-staticcheck : lint
2018-08-24 13:10:16 +03:00
.PHONY : common -unused
2022-06-14 01:19:38 +03:00
common-unused :
2018-11-15 19:51:14 +03:00
@echo ">> running check for unused/missing packages in go.mod"
2022-06-14 01:19:38 +03:00
$( GO) mod tidy
2018-11-15 19:51:14 +03:00
@git diff --exit-code -- go.sum go.mod
2018-08-24 13:10:16 +03:00
.PHONY : common -build
common-build : promu
@echo ">> building binaries"
2022-06-14 01:19:38 +03:00
$( PROMU) build --prefix $( PREFIX) $( PROMU_BINARIES)
2018-08-24 13:10:16 +03:00
.PHONY : common -tarball
common-tarball : promu
@echo ">> building release tarball"
$( PROMU) tarball --prefix $( PREFIX) $( BIN_DIR)
2019-04-16 03:00:39 +03:00
.PHONY : common -docker $( BUILD_DOCKER_ARCHS )
common-docker : $( BUILD_DOCKER_ARCHS )
$(BUILD_DOCKER_ARCHS) : common -docker -%:
2023-03-22 11:46:56 +03:00
docker build -t " $( DOCKER_REPO) / $( DOCKER_IMAGE_NAME) -linux- $* : $( SANITIZED_DOCKER_IMAGE_TAG) " \
2019-06-23 03:00:52 +03:00
-f $( DOCKERFILE_PATH) \
2019-04-16 03:00:39 +03:00
--build-arg ARCH = " $* " \
--build-arg OS = "linux" \
2019-06-23 03:00:52 +03:00
$( DOCKERBUILD_CONTEXT)
2019-04-16 03:00:39 +03:00
.PHONY : common -docker -publish $( PUBLISH_DOCKER_ARCHS )
common-docker-publish : $( PUBLISH_DOCKER_ARCHS )
$(PUBLISH_DOCKER_ARCHS) : common -docker -publish -%:
2023-03-22 11:46:56 +03:00
docker push " $( DOCKER_REPO) / $( DOCKER_IMAGE_NAME) -linux- $* : $( SANITIZED_DOCKER_IMAGE_TAG) "
2019-04-16 03:00:39 +03:00
2020-10-23 03:08:36 +03:00
DOCKER_MAJOR_VERSION_TAG = $( firstword $( subst ., ,$( shell cat VERSION) ) )
2019-04-16 03:00:39 +03:00
.PHONY : common -docker -tag -latest $( TAG_DOCKER_ARCHS )
common-docker-tag-latest : $( TAG_DOCKER_ARCHS )
$(TAG_DOCKER_ARCHS) : common -docker -tag -latest -%:
2023-03-22 11:46:56 +03:00
docker tag " $( DOCKER_REPO) / $( DOCKER_IMAGE_NAME) -linux- $* : $( SANITIZED_DOCKER_IMAGE_TAG) " " $( DOCKER_REPO) / $( DOCKER_IMAGE_NAME) -linux- $* :latest "
docker tag " $( DOCKER_REPO) / $( DOCKER_IMAGE_NAME) -linux- $* : $( SANITIZED_DOCKER_IMAGE_TAG) " " $( DOCKER_REPO) / $( DOCKER_IMAGE_NAME) -linux- $* :v $( DOCKER_MAJOR_VERSION_TAG) "
2019-04-16 03:00:39 +03:00
.PHONY : common -docker -manifest
common-docker-manifest :
2023-03-22 11:46:56 +03:00
DOCKER_CLI_EXPERIMENTAL = enabled docker manifest create -a " $( DOCKER_REPO) / $( DOCKER_IMAGE_NAME) : $( SANITIZED_DOCKER_IMAGE_TAG) " $( foreach ARCH,$( DOCKER_ARCHS) ,$( DOCKER_REPO) /$( DOCKER_IMAGE_NAME) -linux-$( ARCH) :$( SANITIZED_DOCKER_IMAGE_TAG) )
DOCKER_CLI_EXPERIMENTAL = enabled docker manifest push " $( DOCKER_REPO) / $( DOCKER_IMAGE_NAME) : $( SANITIZED_DOCKER_IMAGE_TAG) "
2018-08-24 13:10:16 +03:00
.PHONY : promu
2018-11-15 19:51:14 +03:00
promu : $( PROMU )
$(PROMU) :
2019-01-05 23:56:06 +03:00
$( eval PROMU_TMP := $( shell mktemp -d) )
curl -s -L $( PROMU_URL) | tar -xvzf - -C $( PROMU_TMP)
mkdir -p $( FIRST_GOPATH) /bin
cp $( PROMU_TMP) /promu-$( PROMU_VERSION) .$( GO_BUILD_PLATFORM) /promu $( FIRST_GOPATH) /bin/promu
rm -r $( PROMU_TMP)
2018-11-15 19:51:14 +03:00
.PHONY : proto
proto :
@echo ">> generating code from proto files"
@./scripts/genproto.sh
2018-08-24 13:10:16 +03:00
2019-04-25 03:00:38 +03:00
i f d e f G O L A N G C I _ L I N T
$(GOLANGCI_LINT) :
2019-01-05 23:56:06 +03:00
mkdir -p $( FIRST_GOPATH) /bin
2019-06-14 03:01:17 +03:00
curl -sfL https://raw.githubusercontent.com/golangci/golangci-lint/$( GOLANGCI_LINT_VERSION) /install.sh \
| sed -e '/install -d/d' \
| sh -s -- -b $( FIRST_GOPATH) /bin $( GOLANGCI_LINT_VERSION)
2019-04-12 03:00:36 +03:00
e n d i f
2018-11-15 19:51:14 +03:00
.PHONY : precheck
precheck ::
d e f i n e PRECHECK_COMMAND_template =
precheck :: $( 1) _precheck
PRECHECK_COMMAND_$(1) ?= $( 1) $$ ( strip $$ ( PRECHECK_OPTIONS_$( 1) ) )
2018-11-20 21:39:44 +03:00
.PHONY : $( 1) _precheck
2018-11-15 19:51:14 +03:00
$(1)_precheck :