2018-04-19 02:07:10 -07: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-10-23 03:55:53 -07:00
# Create the main Makefile in the root project directory.
2018-04-19 02:07:10 -07:00
# include Makefile.common
# customTarget:
2018-04-20 09:35:42 -07:00
# @echo ">> Running customTarget"
2018-04-19 02:07:10 -07:00
#
# 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-10-23 03:55:53 -07:00
GOOPTS ?=
2018-12-19 02:28:26 -08:00
GOHOSTOS ?= $( shell $( GO) env GOHOSTOS)
GOHOSTARCH ?= $( shell $( GO) env GOHOSTARCH)
2018-11-09 02:55:04 -08: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])\.' )
2019-02-07 08:22:04 -08:00
GOVENDOR :=
GO111MODULE :=
2018-11-09 02:55:04 -08:00
i f e q ( , $( PRE_GO_ 111) )
2018-10-29 03:29:16 -07:00
ifneq ( ,$( wildcard go.mod) )
# Enforce Go modules support just in case the directory is inside GOPATH (and for Travis CI).
GO111MODULE := on
ifneq ( ,$( wildcard vendor) )
# Always use the local vendor/ directory to satisfy the dependencies.
GOOPTS := $( GOOPTS) -mod= vendor
endif
endif
2018-10-29 02:14:22 -07:00
e l s e
2018-10-29 03:29:16 -07:00
ifneq ( ,$( wildcard go.mod) )
ifneq ( ,$( wildcard vendor) )
2018-10-23 03:55:53 -07:00
$( warning This repository requires Go >= 1.11 because of Go modules )
2018-11-09 02:55:04 -08:00
$( warning Some recipes may not work as expected as the current Go runtime is '$ ( GO_VERSION_NUMBER ) ')
2018-10-29 03:29:16 -07:00
endif
else
# This repository isn't using Go modules (yet).
GOVENDOR := $( FIRST_GOPATH) /bin/govendor
endif
2018-10-23 03:55:53 -07:00
e n d i f
2018-04-19 02:07:10 -07:00
PROMU := $( FIRST_GOPATH) /bin/promu
2018-04-19 03:38:01 -07:00
pkgs = ./...
2018-04-19 02:07:10 -07:00
2018-12-18 07:20:43 -08: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-10 07:28:59 -08:00
2020-02-24 02:50:05 -08:00
GOTEST := $( GO) test
GOTEST_DIR :=
i f n e q ( $( CIRCLE_JOB ) , )
i f n e q ( $( shell which gotestsum ) , )
GOTEST_DIR := test-results
GOTEST := gotestsum --junitfile $( GOTEST_DIR) /unit-tests.xml --
e n d i f
e n d i f
2020-09-02 09:03:52 -07:00
PROMU_VERSION ?= 0.6.0
2018-11-10 07:28:59 -08:00
PROMU_URL := https://github.com/prometheus/promu/releases/download/v$( PROMU_VERSION) /promu-$( PROMU_VERSION) .$( GO_BUILD_PLATFORM) .tar.gz
2019-03-14 01:47:36 -07:00
2019-04-24 05:18:40 -07:00
GOLANGCI_LINT :=
2019-05-03 06:11:28 -07:00
GOLANGCI_LINT_OPTS ?=
2019-09-10 08:40:08 -07:00
GOLANGCI_LINT_VERSION ?= v1.18.0
2019-04-24 05:18:40 -07:00
# golangci-lint only supports linux, darwin and windows platforms on i386/amd64.
2019-03-14 01:47:36 -07:00
# windows isn't included here because of the path separator being different.
2019-04-24 05:18:40 -07:00
i f e q ( $( GOHOSTOS ) , $( filter $ ( GOHOSTOS ) ,linux darwin ) )
2019-03-14 01:47:36 -07:00
ifeq ( $( GOHOSTARCH) ,$( filter $( GOHOSTARCH) ,amd64 i386) )
2019-04-24 05:18:40 -07:00
GOLANGCI_LINT := $( FIRST_GOPATH) /bin/golangci-lint
2019-03-14 01:47:36 -07:00
endif
e n d i f
2018-11-10 07:28:59 -08:00
2018-04-19 02:07:10 -07:00
PREFIX ?= $( shell pwd )
BIN_DIR ?= $( shell pwd )
DOCKER_IMAGE_TAG ?= $( subst /,-,$( shell git rev-parse --abbrev-ref HEAD) )
2019-06-22 01:59:46 -07:00
DOCKERFILE_PATH ?= ./Dockerfile
DOCKERBUILD_CONTEXT ?= ./
2018-07-04 02:27:10 -07:00
DOCKER_REPO ?= prom
2018-04-19 02:07:10 -07:00
2019-04-15 05:27:00 -07: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) )
2018-12-19 02:28:26 -08: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-07-12 14:53:34 -07: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-02-19 03:25:10 -08:00
.PHONY : common -all
2019-04-24 05:18:40 -07:00
common-all : precheck style check_license lint unused build test
2019-02-19 03:25:10 -08:00
2018-07-12 14:53:34 -07:00
.PHONY : common -style
common-style :
2018-04-19 02:07:10 -07:00
@echo ">> checking code style"
2018-08-07 03:19:19 -07:00
@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
2018-04-19 02:07:10 -07:00
2018-07-12 14:53:34 -07:00
.PHONY : common -check_license
common-check_license :
2018-04-19 02:07:10 -07:00
@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 00:58:11 -07:00
.PHONY : common -deps
common-deps :
@echo ">> getting dependencies"
i f d e f G O 1 1 1 M O D U L E
GO111MODULE = $( GO111MODULE) $( GO) mod download
e l s e
$( GO) get $( GOOPTS) -t ./...
e n d i f
2020-05-18 02:43:45 -07: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 \
$( GO) get $$ m; \
done
GO111MODULE = $( GO111MODULE) $( GO) mod tidy
i f n e q ( , $( wildcard vendor ) )
GO111MODULE = $( GO111MODULE) $( GO) mod vendor
e n d i f
2018-07-12 14:53:34 -07:00
.PHONY : common -test -short
2020-02-24 02:50:05 -08:00
common-test-short : $( GOTEST_DIR )
2018-04-19 02:07:10 -07:00
@echo ">> running short tests"
2020-02-24 02:50:05 -08:00
GO111MODULE = $( GO111MODULE) $( GOTEST) -short $( GOOPTS) $( pkgs)
2018-04-19 02:07:10 -07:00
2018-07-12 14:53:34 -07:00
.PHONY : common -test
2020-02-24 02:50:05 -08:00
common-test : $( GOTEST_DIR )
2018-04-19 02:07:10 -07:00
@echo ">> running all tests"
2020-02-24 02:50:05 -08:00
GO111MODULE = $( GO111MODULE) $( GOTEST) $( test-flags) $( GOOPTS) $( pkgs)
$(GOTEST_DIR) :
@mkdir -p $@
2018-04-19 02:07:10 -07:00
2018-07-12 14:53:34 -07:00
.PHONY : common -format
common-format :
2018-04-19 02:07:10 -07:00
@echo ">> formatting code"
2018-12-06 03:49:47 -08:00
GO111MODULE = $( GO111MODULE) $( GO) fmt $( pkgs)
2018-04-19 02:07:10 -07:00
2018-07-12 14:53:34 -07:00
.PHONY : common -vet
common-vet :
2018-04-19 02:07:10 -07:00
@echo ">> vetting code"
2018-10-23 03:55:53 -07:00
GO111MODULE = $( GO111MODULE) $( GO) vet $( GOOPTS) $( pkgs)
2018-04-19 02:07:10 -07:00
2019-04-24 05:18:40 -07: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"
2018-10-29 04:22:01 -07:00
i f d e f G O 1 1 1 M O D U L E
2019-01-04 05:47:38 -08: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.
GO111MODULE = $( GO111MODULE) $( GO) list -e -compiled -test= true -export= false -deps= true -find= false -tags= -- ./... > /dev/null
2019-05-03 06:11:28 -07:00
GO111MODULE = $( GO111MODULE) $( GOLANGCI_LINT) run $( GOLANGCI_LINT_OPTS) $( pkgs)
2018-10-25 07:40:05 -07:00
e l s e
2019-04-24 05:18:40 -07:00
$( GOLANGCI_LINT) run $( pkgs)
2018-10-25 07:40:05 -07:00
e n d i f
2019-03-14 01:47:36 -07:00
e n d i f
2018-04-19 02:07:10 -07:00
2019-04-24 05:18:40 -07:00
# For backward-compatibility.
.PHONY : common -staticcheck
common-staticcheck : lint
2018-07-12 14:53:34 -07:00
.PHONY : common -unused
common-unused : $( GOVENDOR )
2018-10-29 03:29:16 -07:00
i f d e f G O V E N D O R
2018-04-19 02:07:10 -07:00
@echo ">> running check for unused packages"
2018-04-19 05:07:55 -07:00
@$( GOVENDOR) list +unused | grep . && exit 1 || echo 'No unused packages'
2018-10-23 03:55:53 -07:00
e l s e
2018-10-29 03:29:16 -07:00
i f d e f G O 1 1 1 M O D U L E
2018-10-23 03:55:53 -07:00
@echo ">> running check for unused/missing packages in go.mod"
GO111MODULE = $( GO111MODULE) $( GO) mod tidy
2018-12-04 06:01:12 -08:00
i f e q ( , $( wildcard vendor ) )
2018-10-26 00:55:52 -07:00
@git diff --exit-code -- go.sum go.mod
2018-12-04 06:01:12 -08:00
e l s e
2018-10-23 03:55:53 -07:00
@echo ">> running check for unused packages in vendor/"
GO111MODULE = $( GO111MODULE) $( GO) mod vendor
2018-10-26 00:55:52 -07:00
@git diff --exit-code -- go.sum go.mod vendor/
2018-10-23 03:55:53 -07:00
e n d i f
2018-10-29 02:14:22 -07:00
e n d i f
2018-10-29 03:29:16 -07:00
e n d i f
2018-04-19 02:07:10 -07:00
2018-07-12 14:53:34 -07:00
.PHONY : common -build
common-build : promu
2018-04-19 02:07:10 -07:00
@echo ">> building binaries"
2019-08-29 03:11:49 -07:00
GO111MODULE = $( GO111MODULE) $( PROMU) build --prefix $( PREFIX) $( PROMU_BINARIES)
2018-04-19 02:07:10 -07:00
2018-07-12 14:53:34 -07:00
.PHONY : common -tarball
common-tarball : promu
2018-04-19 02:07:10 -07:00
@echo ">> building release tarball"
$( PROMU) tarball --prefix $( PREFIX) $( BIN_DIR)
2019-04-15 05:27:00 -07:00
.PHONY : common -docker $( BUILD_DOCKER_ARCHS )
common-docker : $( BUILD_DOCKER_ARCHS )
$(BUILD_DOCKER_ARCHS) : common -docker -%:
docker build -t " $( DOCKER_REPO) / $( DOCKER_IMAGE_NAME) -linux- $* : $( DOCKER_IMAGE_TAG) " \
2019-06-22 01:59:46 -07:00
-f $( DOCKERFILE_PATH) \
2019-04-15 05:27:00 -07:00
--build-arg ARCH = " $* " \
--build-arg OS = "linux" \
2019-06-22 01:59:46 -07:00
$( DOCKERBUILD_CONTEXT)
2019-04-15 05:27:00 -07:00
.PHONY : common -docker -publish $( PUBLISH_DOCKER_ARCHS )
common-docker-publish : $( PUBLISH_DOCKER_ARCHS )
$(PUBLISH_DOCKER_ARCHS) : common -docker -publish -%:
docker push " $( DOCKER_REPO) / $( DOCKER_IMAGE_NAME) -linux- $* : $( DOCKER_IMAGE_TAG) "
2020-10-22 08:19:44 -07:00
DOCKER_MAJOR_VERSION_TAG = $( firstword $( subst ., ,$( shell cat VERSION) ) )
2019-04-15 05:27:00 -07:00
.PHONY : common -docker -tag -latest $( TAG_DOCKER_ARCHS )
common-docker-tag-latest : $( TAG_DOCKER_ARCHS )
$(TAG_DOCKER_ARCHS) : common -docker -tag -latest -%:
docker tag " $( DOCKER_REPO) / $( DOCKER_IMAGE_NAME) -linux- $* : $( DOCKER_IMAGE_TAG) " " $( DOCKER_REPO) / $( DOCKER_IMAGE_NAME) -linux- $* :latest "
2020-10-22 08:19:44 -07:00
docker tag " $( DOCKER_REPO) / $( DOCKER_IMAGE_NAME) -linux- $* : $( DOCKER_IMAGE_TAG) " " $( DOCKER_REPO) / $( DOCKER_IMAGE_NAME) -linux- $* :v $( DOCKER_MAJOR_VERSION_TAG) "
2019-04-15 05:27:00 -07:00
.PHONY : common -docker -manifest
common-docker-manifest :
DOCKER_CLI_EXPERIMENTAL = enabled docker manifest create -a " $( DOCKER_REPO) / $( DOCKER_IMAGE_NAME) : $( DOCKER_IMAGE_TAG) " $( foreach ARCH,$( DOCKER_ARCHS) ,$( DOCKER_REPO) /$( DOCKER_IMAGE_NAME) -linux-$( ARCH) :$( DOCKER_IMAGE_TAG) )
DOCKER_CLI_EXPERIMENTAL = enabled docker manifest push " $( DOCKER_REPO) / $( DOCKER_IMAGE_NAME) : $( DOCKER_IMAGE_TAG) "
2018-04-19 02:07:10 -07:00
2018-06-11 08:51:28 -07:00
.PHONY : promu
2018-11-10 07:28:59 -08:00
promu : $( PROMU )
$(PROMU) :
2018-11-30 07:20:50 -08: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-04-19 02:07:10 -07:00
2018-09-05 12:04:44 -07:00
.PHONY : proto
proto :
@echo ">> generating code from proto files"
@./scripts/genproto.sh
2019-04-24 05:18:40 -07:00
i f d e f G O L A N G C I _ L I N T
$(GOLANGCI_LINT) :
2019-01-04 05:47:38 -08:00
mkdir -p $( FIRST_GOPATH) /bin
2019-06-13 01:56:30 -07: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-03-14 01:47:36 -07:00
e n d i f
2018-04-19 02:07:10 -07:00
2018-10-29 03:29:16 -07:00
i f d e f G O V E N D O R
2018-06-11 08:51:28 -07:00
.PHONY : $( GOVENDOR )
$(GOVENDOR) :
2018-04-19 02:07:10 -07:00
GOOS = GOARCH = $( GO) get -u github.com/kardianos/govendor
2018-10-23 03:55:53 -07:00
e n d i f
2018-11-09 06:04:13 -08: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 01:17:48 -08:00
.PHONY : $( 1) _precheck
2018-11-09 06:04:13 -08:00
$(1)_precheck :
@if ! $$ ( PRECHECK_COMMAND_$( 1) ) 1>/dev/null 2>& 1; then \
echo " Execution of ' $$ (PRECHECK_COMMAND_ $( 1) )' command failed. Is $( 1) installed? " ; \
exit 1; \
fi
e n d e f