blob: 3ac29c636c6b85418945a08f49b2d92233390b5b [file] [log] [blame]
khenaidooab1f7bd2019-11-14 14:00:27 -05001# Copyright 2018 The Prometheus Authors
2# Licensed under the Apache License, Version 2.0 (the "License");
3# you may not use this file except in compliance with the License.
4# You may obtain a copy of the License at
5#
6# http://www.apache.org/licenses/LICENSE-2.0
7#
8# Unless required by applicable law or agreed to in writing, software
9# distributed under the License is distributed on an "AS IS" BASIS,
10# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
11# See the License for the specific language governing permissions and
12# limitations under the License.
13
14
15# A common Makefile that includes rules to be reused in different prometheus projects.
16# !!! Open PRs only against the prometheus/prometheus/Makefile.common repository!
17
18# Example usage :
19# Create the main Makefile in the root project directory.
20# include Makefile.common
21# customTarget:
22# @echo ">> Running customTarget"
23#
24
25# Ensure GOBIN is not set during build so that promu is installed to the correct path
26unexport GOBIN
27
28GO ?= go
29GOFMT ?= $(GO)fmt
30FIRST_GOPATH := $(firstword $(subst :, ,$(shell $(GO) env GOPATH)))
31GOOPTS ?=
32GOHOSTOS ?= $(shell $(GO) env GOHOSTOS)
33GOHOSTARCH ?= $(shell $(GO) env GOHOSTARCH)
34
35GO_VERSION ?= $(shell $(GO) version)
36GO_VERSION_NUMBER ?= $(word 3, $(GO_VERSION))
37PRE_GO_111 ?= $(shell echo $(GO_VERSION_NUMBER) | grep -E 'go1\.(10|[0-9])\.')
38
39GOVENDOR :=
40GO111MODULE :=
41ifeq (, $(PRE_GO_111))
42 ifneq (,$(wildcard go.mod))
43 # Enforce Go modules support just in case the directory is inside GOPATH (and for Travis CI).
44 GO111MODULE := on
45
46 ifneq (,$(wildcard vendor))
47 # Always use the local vendor/ directory to satisfy the dependencies.
48 GOOPTS := $(GOOPTS) -mod=vendor
49 endif
50 endif
51else
52 ifneq (,$(wildcard go.mod))
53 ifneq (,$(wildcard vendor))
54$(warning This repository requires Go >= 1.11 because of Go modules)
55$(warning Some recipes may not work as expected as the current Go runtime is '$(GO_VERSION_NUMBER)')
56 endif
57 else
58 # This repository isn't using Go modules (yet).
59 GOVENDOR := $(FIRST_GOPATH)/bin/govendor
60 endif
61endif
62PROMU := $(FIRST_GOPATH)/bin/promu
63pkgs = ./...
64
65ifeq (arm, $(GOHOSTARCH))
66 GOHOSTARM ?= $(shell GOARM= $(GO) env GOARM)
67 GO_BUILD_PLATFORM ?= $(GOHOSTOS)-$(GOHOSTARCH)v$(GOHOSTARM)
68else
69 GO_BUILD_PLATFORM ?= $(GOHOSTOS)-$(GOHOSTARCH)
70endif
71
khenaidood948f772021-08-11 17:49:24 -040072GOTEST := $(GO) test
73GOTEST_DIR :=
74ifneq ($(CIRCLE_JOB),)
75ifneq ($(shell which gotestsum),)
76 GOTEST_DIR := test-results
77 GOTEST := gotestsum --junitfile $(GOTEST_DIR)/unit-tests.xml --
78endif
79endif
80
81PROMU_VERSION ?= 0.7.0
khenaidooab1f7bd2019-11-14 14:00:27 -050082PROMU_URL := https://github.com/prometheus/promu/releases/download/v$(PROMU_VERSION)/promu-$(PROMU_VERSION).$(GO_BUILD_PLATFORM).tar.gz
83
84GOLANGCI_LINT :=
85GOLANGCI_LINT_OPTS ?=
khenaidood948f772021-08-11 17:49:24 -040086GOLANGCI_LINT_VERSION ?= v1.18.0
khenaidooab1f7bd2019-11-14 14:00:27 -050087# golangci-lint only supports linux, darwin and windows platforms on i386/amd64.
88# windows isn't included here because of the path separator being different.
89ifeq ($(GOHOSTOS),$(filter $(GOHOSTOS),linux darwin))
90 ifeq ($(GOHOSTARCH),$(filter $(GOHOSTARCH),amd64 i386))
91 GOLANGCI_LINT := $(FIRST_GOPATH)/bin/golangci-lint
92 endif
93endif
94
95PREFIX ?= $(shell pwd)
96BIN_DIR ?= $(shell pwd)
97DOCKER_IMAGE_TAG ?= $(subst /,-,$(shell git rev-parse --abbrev-ref HEAD))
khenaidood948f772021-08-11 17:49:24 -040098DOCKERFILE_PATH ?= ./Dockerfile
99DOCKERBUILD_CONTEXT ?= ./
khenaidooab1f7bd2019-11-14 14:00:27 -0500100DOCKER_REPO ?= prom
101
102DOCKER_ARCHS ?= amd64
103
104BUILD_DOCKER_ARCHS = $(addprefix common-docker-,$(DOCKER_ARCHS))
105PUBLISH_DOCKER_ARCHS = $(addprefix common-docker-publish-,$(DOCKER_ARCHS))
106TAG_DOCKER_ARCHS = $(addprefix common-docker-tag-latest-,$(DOCKER_ARCHS))
107
108ifeq ($(GOHOSTARCH),amd64)
109 ifeq ($(GOHOSTOS),$(filter $(GOHOSTOS),linux freebsd darwin windows))
110 # Only supported on amd64
111 test-flags := -race
112 endif
113endif
114
115# This rule is used to forward a target like "build" to "common-build". This
116# allows a new "build" target to be defined in a Makefile which includes this
117# one and override "common-build" without override warnings.
118%: common-% ;
119
120.PHONY: common-all
121common-all: precheck style check_license lint unused build test
122
123.PHONY: common-style
124common-style:
125 @echo ">> checking code style"
126 @fmtRes=$$($(GOFMT) -d $$(find . -path ./vendor -prune -o -name '*.go' -print)); \
127 if [ -n "$${fmtRes}" ]; then \
128 echo "gofmt checking failed!"; echo "$${fmtRes}"; echo; \
129 echo "Please ensure you are using $$($(GO) version) for formatting code."; \
130 exit 1; \
131 fi
132
133.PHONY: common-check_license
134common-check_license:
135 @echo ">> checking license header"
136 @licRes=$$(for file in $$(find . -type f -iname '*.go' ! -path './vendor/*') ; do \
137 awk 'NR<=3' $$file | grep -Eq "(Copyright|generated|GENERATED)" || echo $$file; \
138 done); \
139 if [ -n "$${licRes}" ]; then \
140 echo "license header checking failed:"; echo "$${licRes}"; \
141 exit 1; \
142 fi
143
144.PHONY: common-deps
145common-deps:
146 @echo ">> getting dependencies"
147ifdef GO111MODULE
148 GO111MODULE=$(GO111MODULE) $(GO) mod download
149else
150 $(GO) get $(GOOPTS) -t ./...
151endif
152
khenaidood948f772021-08-11 17:49:24 -0400153.PHONY: update-go-deps
154update-go-deps:
155 @echo ">> updating Go dependencies"
156 @for m in $$($(GO) list -mod=readonly -m -f '{{ if and (not .Indirect) (not .Main)}}{{.Path}}{{end}}' all); do \
157 $(GO) get $$m; \
158 done
159 GO111MODULE=$(GO111MODULE) $(GO) mod tidy
160ifneq (,$(wildcard vendor))
161 GO111MODULE=$(GO111MODULE) $(GO) mod vendor
162endif
163
khenaidooab1f7bd2019-11-14 14:00:27 -0500164.PHONY: common-test-short
khenaidood948f772021-08-11 17:49:24 -0400165common-test-short: $(GOTEST_DIR)
khenaidooab1f7bd2019-11-14 14:00:27 -0500166 @echo ">> running short tests"
khenaidood948f772021-08-11 17:49:24 -0400167 GO111MODULE=$(GO111MODULE) $(GOTEST) -short $(GOOPTS) $(pkgs)
khenaidooab1f7bd2019-11-14 14:00:27 -0500168
169.PHONY: common-test
khenaidood948f772021-08-11 17:49:24 -0400170common-test: $(GOTEST_DIR)
khenaidooab1f7bd2019-11-14 14:00:27 -0500171 @echo ">> running all tests"
khenaidood948f772021-08-11 17:49:24 -0400172 GO111MODULE=$(GO111MODULE) $(GOTEST) $(test-flags) $(GOOPTS) $(pkgs)
173
174$(GOTEST_DIR):
175 @mkdir -p $@
khenaidooab1f7bd2019-11-14 14:00:27 -0500176
177.PHONY: common-format
178common-format:
179 @echo ">> formatting code"
180 GO111MODULE=$(GO111MODULE) $(GO) fmt $(pkgs)
181
182.PHONY: common-vet
183common-vet:
184 @echo ">> vetting code"
185 GO111MODULE=$(GO111MODULE) $(GO) vet $(GOOPTS) $(pkgs)
186
187.PHONY: common-lint
188common-lint: $(GOLANGCI_LINT)
189ifdef GOLANGCI_LINT
190 @echo ">> running golangci-lint"
191ifdef GO111MODULE
192# 'go list' needs to be executed before staticcheck to prepopulate the modules cache.
193# Otherwise staticcheck might fail randomly for some reason not yet explained.
194 GO111MODULE=$(GO111MODULE) $(GO) list -e -compiled -test=true -export=false -deps=true -find=false -tags= -- ./... > /dev/null
195 GO111MODULE=$(GO111MODULE) $(GOLANGCI_LINT) run $(GOLANGCI_LINT_OPTS) $(pkgs)
196else
197 $(GOLANGCI_LINT) run $(pkgs)
198endif
199endif
200
201# For backward-compatibility.
202.PHONY: common-staticcheck
203common-staticcheck: lint
204
205.PHONY: common-unused
206common-unused: $(GOVENDOR)
207ifdef GOVENDOR
208 @echo ">> running check for unused packages"
209 @$(GOVENDOR) list +unused | grep . && exit 1 || echo 'No unused packages'
210else
211ifdef GO111MODULE
212 @echo ">> running check for unused/missing packages in go.mod"
213 GO111MODULE=$(GO111MODULE) $(GO) mod tidy
214ifeq (,$(wildcard vendor))
215 @git diff --exit-code -- go.sum go.mod
216else
217 @echo ">> running check for unused packages in vendor/"
218 GO111MODULE=$(GO111MODULE) $(GO) mod vendor
219 @git diff --exit-code -- go.sum go.mod vendor/
220endif
221endif
222endif
223
224.PHONY: common-build
225common-build: promu
226 @echo ">> building binaries"
khenaidood948f772021-08-11 17:49:24 -0400227 GO111MODULE=$(GO111MODULE) $(PROMU) build --prefix $(PREFIX) $(PROMU_BINARIES)
khenaidooab1f7bd2019-11-14 14:00:27 -0500228
229.PHONY: common-tarball
230common-tarball: promu
231 @echo ">> building release tarball"
232 $(PROMU) tarball --prefix $(PREFIX) $(BIN_DIR)
233
234.PHONY: common-docker $(BUILD_DOCKER_ARCHS)
235common-docker: $(BUILD_DOCKER_ARCHS)
236$(BUILD_DOCKER_ARCHS): common-docker-%:
237 docker build -t "$(DOCKER_REPO)/$(DOCKER_IMAGE_NAME)-linux-$*:$(DOCKER_IMAGE_TAG)" \
khenaidood948f772021-08-11 17:49:24 -0400238 -f $(DOCKERFILE_PATH) \
khenaidooab1f7bd2019-11-14 14:00:27 -0500239 --build-arg ARCH="$*" \
240 --build-arg OS="linux" \
khenaidood948f772021-08-11 17:49:24 -0400241 $(DOCKERBUILD_CONTEXT)
khenaidooab1f7bd2019-11-14 14:00:27 -0500242
243.PHONY: common-docker-publish $(PUBLISH_DOCKER_ARCHS)
244common-docker-publish: $(PUBLISH_DOCKER_ARCHS)
245$(PUBLISH_DOCKER_ARCHS): common-docker-publish-%:
246 docker push "$(DOCKER_REPO)/$(DOCKER_IMAGE_NAME)-linux-$*:$(DOCKER_IMAGE_TAG)"
247
khenaidood948f772021-08-11 17:49:24 -0400248DOCKER_MAJOR_VERSION_TAG = $(firstword $(subst ., ,$(shell cat VERSION)))
khenaidooab1f7bd2019-11-14 14:00:27 -0500249.PHONY: common-docker-tag-latest $(TAG_DOCKER_ARCHS)
250common-docker-tag-latest: $(TAG_DOCKER_ARCHS)
251$(TAG_DOCKER_ARCHS): common-docker-tag-latest-%:
252 docker tag "$(DOCKER_REPO)/$(DOCKER_IMAGE_NAME)-linux-$*:$(DOCKER_IMAGE_TAG)" "$(DOCKER_REPO)/$(DOCKER_IMAGE_NAME)-linux-$*:latest"
khenaidood948f772021-08-11 17:49:24 -0400253 docker tag "$(DOCKER_REPO)/$(DOCKER_IMAGE_NAME)-linux-$*:$(DOCKER_IMAGE_TAG)" "$(DOCKER_REPO)/$(DOCKER_IMAGE_NAME)-linux-$*:v$(DOCKER_MAJOR_VERSION_TAG)"
khenaidooab1f7bd2019-11-14 14:00:27 -0500254
255.PHONY: common-docker-manifest
256common-docker-manifest:
257 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))
258 DOCKER_CLI_EXPERIMENTAL=enabled docker manifest push "$(DOCKER_REPO)/$(DOCKER_IMAGE_NAME):$(DOCKER_IMAGE_TAG)"
259
260.PHONY: promu
261promu: $(PROMU)
262
263$(PROMU):
264 $(eval PROMU_TMP := $(shell mktemp -d))
265 curl -s -L $(PROMU_URL) | tar -xvzf - -C $(PROMU_TMP)
266 mkdir -p $(FIRST_GOPATH)/bin
267 cp $(PROMU_TMP)/promu-$(PROMU_VERSION).$(GO_BUILD_PLATFORM)/promu $(FIRST_GOPATH)/bin/promu
268 rm -r $(PROMU_TMP)
269
270.PHONY: proto
271proto:
272 @echo ">> generating code from proto files"
273 @./scripts/genproto.sh
274
275ifdef GOLANGCI_LINT
276$(GOLANGCI_LINT):
277 mkdir -p $(FIRST_GOPATH)/bin
khenaidood948f772021-08-11 17:49:24 -0400278 curl -sfL https://raw.githubusercontent.com/golangci/golangci-lint/$(GOLANGCI_LINT_VERSION)/install.sh \
279 | sed -e '/install -d/d' \
280 | sh -s -- -b $(FIRST_GOPATH)/bin $(GOLANGCI_LINT_VERSION)
khenaidooab1f7bd2019-11-14 14:00:27 -0500281endif
282
283ifdef GOVENDOR
284.PHONY: $(GOVENDOR)
285$(GOVENDOR):
286 GOOS= GOARCH= $(GO) get -u github.com/kardianos/govendor
287endif
288
289.PHONY: precheck
290precheck::
291
292define PRECHECK_COMMAND_template =
293precheck:: $(1)_precheck
294
295PRECHECK_COMMAND_$(1) ?= $(1) $$(strip $$(PRECHECK_OPTIONS_$(1)))
296.PHONY: $(1)_precheck
297$(1)_precheck:
298 @if ! $$(PRECHECK_COMMAND_$(1)) 1>/dev/null 2>&1; then \
299 echo "Execution of '$$(PRECHECK_COMMAND_$(1))' command failed. Is $(1) installed?"; \
300 exit 1; \
301 fi
302endef