02d16a0b40
Merge in DNS/adguard-home from 2243-better-docs to master Closes #2243. Squashed commit of the following: commit 26c655a0e4339528870633c2cdf39c3b5c486b1d Author: Ainar Garipov <A.Garipov@AdGuard.COM> Date: Thu Nov 5 12:51:43 2020 +0300 * openapi: improve more commit dc0ab9857787d14eb0686814a4f3c8f917698bee Author: Ainar Garipov <A.Garipov@AdGuard.COM> Date: Tue Nov 3 20:40:32 2020 +0300 * home, openapi: improve docs and responses
349 lines
12 KiB
Makefile
349 lines
12 KiB
Makefile
#
|
|
# Available targets
|
|
#
|
|
# * build -- builds AdGuardHome for the current platform
|
|
# * client -- builds client-side code of AdGuard Home
|
|
# * client-watch -- builds client-side code of AdGuard Home and watches for changes there
|
|
# * docker -- builds a docker image for the current platform
|
|
# * clean -- clean everything created by previous builds
|
|
# * lint -- run all linters
|
|
# * test -- run all unit-tests
|
|
# * dependencies -- installs dependencies (go and npm modules)
|
|
# * ci -- installs dependencies, runs linters and tests, intended to be used by CI/CD
|
|
#
|
|
# Building releases:
|
|
#
|
|
# * release -- builds AdGuard Home distros. CHANNEL must be specified (edge, release or beta).
|
|
# * release_and_sign -- builds AdGuard Home distros and signs the binary files.
|
|
# CHANNEL must be specified (edge, release or beta).
|
|
# * sign -- Repacks all release archive files and signs the binary files inside them.
|
|
# For signing to work, the public+private key pair for $(GPG_KEY) must be imported:
|
|
# gpg --import public.txt
|
|
# gpg --import private.txt
|
|
# GPG_KEY_PASSPHRASE must contain the GPG key passphrase
|
|
# * docker-multi-arch -- builds a multi-arch image. If you want it to be pushed to docker hub,
|
|
# you must specify:
|
|
# * DOCKER_IMAGE_NAME - adguard/adguard-home
|
|
# * DOCKER_OUTPUT - type=image,name=adguard/adguard-home,push=true
|
|
|
|
GOPATH := $(shell go env GOPATH)
|
|
PWD := $(shell pwd)
|
|
TARGET=AdGuardHome
|
|
BASE_URL="https://static.adguard.com/adguardhome/$(CHANNEL)"
|
|
GPG_KEY := devteam@adguard.com
|
|
GPG_KEY_PASSPHRASE :=
|
|
GPG_CMD := gpg --detach-sig --default-key $(GPG_KEY) --pinentry-mode loopback --passphrase $(GPG_KEY_PASSPHRASE)
|
|
|
|
# See release target
|
|
DIST_DIR=dist
|
|
|
|
# Update channel. Can be release, beta or edge. Uses edge by default.
|
|
CHANNEL ?= edge
|
|
|
|
# Validate channel
|
|
ifneq ($(CHANNEL),release)
|
|
ifneq ($(CHANNEL),beta)
|
|
ifneq ($(CHANNEL),edge)
|
|
$(error CHANNEL value is not valid. Valid values are release,beta or edge)
|
|
endif
|
|
endif
|
|
endif
|
|
|
|
# Version history URL (see
|
|
VERSION_HISTORY_URL="https://github.com/AdguardTeam/AdGuardHome/releases"
|
|
ifeq ($(CHANNEL),edge)
|
|
VERSION_HISTORY_URL="https://github.com/AdguardTeam/AdGuardHome/commits/master"
|
|
endif
|
|
|
|
# goreleaser command depends on the $CHANNEL
|
|
GORELEASER_COMMAND=goreleaser release --rm-dist --skip-publish --snapshot --parallelism 1
|
|
ifneq ($(CHANNEL),edge)
|
|
# If this is not an "edge" build, use normal release command
|
|
GORELEASER_COMMAND=goreleaser release --rm-dist --skip-publish --parallelism 1
|
|
endif
|
|
|
|
# Version properties
|
|
COMMIT=$(shell git rev-parse --short HEAD)
|
|
TAG_NAME=$(shell git describe --abbrev=0)
|
|
RELEASE_VERSION=$(TAG_NAME)
|
|
SNAPSHOT_VERSION=$(RELEASE_VERSION)-SNAPSHOT-$(COMMIT)
|
|
|
|
# Set proper version
|
|
VERSION=
|
|
ifeq ($(TAG_NAME),$(shell git describe --abbrev=4))
|
|
ifeq ($(CHANNEL),edge)
|
|
VERSION=$(SNAPSHOT_VERSION)
|
|
else
|
|
VERSION=$(RELEASE_VERSION)
|
|
endif
|
|
else
|
|
VERSION=$(SNAPSHOT_VERSION)
|
|
endif
|
|
|
|
# Docker target parameters
|
|
DOCKER_IMAGE_NAME ?= adguardhome-dev
|
|
DOCKER_IMAGE_FULL_NAME = $(DOCKER_IMAGE_NAME):$(VERSION)
|
|
DOCKER_PLATFORMS=linux/amd64,linux/arm/v6,linux/arm/v7,linux/arm64,linux/386,linux/ppc64le
|
|
DOCKER_OUTPUT ?= type=image,name=$(DOCKER_IMAGE_NAME),push=false
|
|
BUILD_DATE=$(shell date -u +'%Y-%m-%dT%H:%M:%SZ')
|
|
|
|
# Docker tags (can be redefined)
|
|
DOCKER_TAGS ?=
|
|
ifndef DOCKER_TAGS
|
|
ifeq ($(CHANNEL),release)
|
|
DOCKER_TAGS := --tag $(DOCKER_IMAGE_NAME):latest
|
|
endif
|
|
ifeq ($(CHANNEL),beta)
|
|
DOCKER_TAGS := --tag $(DOCKER_IMAGE_NAME):beta
|
|
endif
|
|
ifeq ($(CHANNEL),edge)
|
|
# Don't set the version tag when pushing to "edge"
|
|
DOCKER_IMAGE_FULL_NAME := $(DOCKER_IMAGE_NAME):edge
|
|
# DOCKER_TAGS := --tag $(DOCKER_IMAGE_NAME):edge
|
|
endif
|
|
endif
|
|
|
|
# Validate docker build arguments
|
|
ifndef DOCKER_IMAGE_NAME
|
|
$(error DOCKER_IMAGE_NAME value is not set)
|
|
endif
|
|
|
|
# OS-specific flags
|
|
TEST_FLAGS := --race -v
|
|
ifeq ($(OS),Windows_NT)
|
|
TEST_FLAGS :=
|
|
endif
|
|
|
|
.PHONY: all build client client-watch docker lint lint-js lint-go test dependencies clean release docker-multi-arch
|
|
all: build
|
|
|
|
init:
|
|
git config core.hooksPath .githooks
|
|
|
|
build: client_with_deps
|
|
go mod download
|
|
PATH=$(GOPATH)/bin:$(PATH) go generate ./...
|
|
CGO_ENABLED=0 go build -ldflags="-s -w -X main.version=$(VERSION) -X main.channel=$(CHANNEL) -X main.goarm=$(GOARM)"
|
|
PATH=$(GOPATH)/bin:$(PATH) packr clean
|
|
|
|
client:
|
|
npm --prefix client run build-prod
|
|
|
|
client_with_deps:
|
|
npm --prefix client ci
|
|
npm --prefix client run build-prod
|
|
|
|
client-watch:
|
|
npm --prefix client run watch
|
|
|
|
docker:
|
|
DOCKER_CLI_EXPERIMENTAL=enabled \
|
|
docker buildx build \
|
|
--build-arg VERSION=$(VERSION) \
|
|
--build-arg CHANNEL=$(CHANNEL) \
|
|
--build-arg VCS_REF=$(COMMIT) \
|
|
--build-arg BUILD_DATE=$(BUILD_DATE) \
|
|
$(DOCKER_TAGS) \
|
|
--load \
|
|
-t "$(DOCKER_IMAGE_NAME)" -f ./Dockerfile .
|
|
|
|
@echo Now you can run the docker image:
|
|
@echo docker run --name "adguard-home" -p 53:53/tcp -p 53:53/udp -p 80:80/tcp -p 443:443/tcp -p 853:853/tcp -p 3000:3000/tcp $(DOCKER_IMAGE_NAME)
|
|
|
|
lint: lint-js lint-go
|
|
|
|
lint-js: dependencies
|
|
@echo Running js linter
|
|
npm --prefix client run lint
|
|
|
|
lint-go:
|
|
@echo Running go linter
|
|
golangci-lint run
|
|
|
|
test: test-js test-go
|
|
|
|
test-js:
|
|
npm run test --prefix client
|
|
|
|
test-go:
|
|
go test $(TEST_FLAGS) --coverprofile coverage.txt ./...
|
|
|
|
ci: client_with_deps
|
|
go mod download
|
|
$(MAKE) test
|
|
|
|
dependencies:
|
|
npm --prefix client ci
|
|
go mod download
|
|
|
|
clean:
|
|
# make build output
|
|
rm -f AdGuardHome
|
|
rm -f AdGuardHome.exe
|
|
# tests output
|
|
rm -rf data
|
|
rm -f coverage.txt
|
|
# static build output
|
|
rm -rf build
|
|
# dist folder
|
|
rm -rf $(DIST_DIR)
|
|
# client deps
|
|
rm -rf client/node_modules
|
|
# packr-generated files
|
|
PATH=$(GOPATH)/bin:$(PATH) packr clean || true
|
|
|
|
docker-multi-arch:
|
|
DOCKER_CLI_EXPERIMENTAL=enabled \
|
|
docker buildx build \
|
|
--platform $(DOCKER_PLATFORMS) \
|
|
--build-arg VERSION=$(VERSION) \
|
|
--build-arg CHANNEL=$(CHANNEL) \
|
|
--build-arg VCS_REF=$(COMMIT) \
|
|
--build-arg BUILD_DATE=$(BUILD_DATE) \
|
|
$(DOCKER_TAGS) \
|
|
--output "$(DOCKER_OUTPUT)" \
|
|
-t "$(DOCKER_IMAGE_FULL_NAME)" -f ./Dockerfile .
|
|
|
|
@echo If the image was pushed to the registry, you can now run it:
|
|
@echo docker run --name "adguard-home" -p 53:53/tcp -p 53:53/udp -p 80:80/tcp -p 443:443/tcp -p 853:853/tcp -p 3000:3000/tcp $(DOCKER_IMAGE_NAME)
|
|
|
|
release: client_with_deps
|
|
go mod download
|
|
@echo Starting release build: version $(VERSION), channel $(CHANNEL)
|
|
CHANNEL=$(CHANNEL) $(GORELEASER_COMMAND)
|
|
$(call write_version_file,$(VERSION))
|
|
PATH=$(GOPATH)/bin:$(PATH) packr clean
|
|
|
|
release_and_sign: client_with_deps
|
|
$(MAKE) release
|
|
$(call repack_dist)
|
|
|
|
sign:
|
|
$(call repack_dist)
|
|
|
|
define write_version_file
|
|
$(eval version := $(1))
|
|
|
|
@echo Writing version file: $(version)
|
|
|
|
# Variables for CI
|
|
rm -f $(DIST_DIR)/version.txt
|
|
echo "version=$(version)" > $(DIST_DIR)/version.txt
|
|
|
|
# Prepare the version.json file
|
|
rm -f $(DIST_DIR)/version.json
|
|
echo "{" >> $(DIST_DIR)/version.json
|
|
echo " \"version\": \"$(version)\"," >> $(DIST_DIR)/version.json
|
|
echo " \"announcement\": \"AdGuard Home $(version) is now available!\"," >> $(DIST_DIR)/version.json
|
|
echo " \"announcement_url\": \"$(VERSION_HISTORY_URL)\"," >> $(DIST_DIR)/version.json
|
|
echo " \"selfupdate_min_version\": \"0.0\"," >> $(DIST_DIR)/version.json
|
|
|
|
# Windows builds
|
|
echo " \"download_windows_amd64\": \"$(BASE_URL)/AdGuardHome_windows_amd64.zip\"," >> $(DIST_DIR)/version.json
|
|
echo " \"download_windows_386\": \"$(BASE_URL)/AdGuardHome_windows_386.zip\"," >> $(DIST_DIR)/version.json
|
|
|
|
# MacOS builds
|
|
echo " \"download_darwin_amd64\": \"$(BASE_URL)/AdGuardHome_darwin_amd64.zip\"," >> $(DIST_DIR)/version.json
|
|
echo " \"download_darwin_386\": \"$(BASE_URL)/AdGuardHome_darwin_386.zip\"," >> $(DIST_DIR)/version.json
|
|
|
|
# Linux
|
|
echo " \"download_linux_amd64\": \"$(BASE_URL)/AdGuardHome_linux_amd64.tar.gz\"," >> $(DIST_DIR)/version.json
|
|
echo " \"download_linux_386\": \"$(BASE_URL)/AdGuardHome_linux_386.tar.gz\"," >> $(DIST_DIR)/version.json
|
|
|
|
# Linux, all kinds of ARM
|
|
echo " \"download_linux_arm\": \"$(BASE_URL)/AdGuardHome_linux_armv6.tar.gz\"," >> $(DIST_DIR)/version.json
|
|
echo " \"download_linux_armv5\": \"$(BASE_URL)/AdGuardHome_linux_armv5.tar.gz\"," >> $(DIST_DIR)/version.json
|
|
echo " \"download_linux_armv6\": \"$(BASE_URL)/AdGuardHome_linux_armv6.tar.gz\"," >> $(DIST_DIR)/version.json
|
|
echo " \"download_linux_armv7\": \"$(BASE_URL)/AdGuardHome_linux_armv7.tar.gz\"," >> $(DIST_DIR)/version.json
|
|
echo " \"download_linux_arm64\": \"$(BASE_URL)/AdGuardHome_linux_arm64.tar.gz\"," >> $(DIST_DIR)/version.json
|
|
|
|
# Linux, MIPS
|
|
echo " \"download_linux_mips\": \"$(BASE_URL)/AdGuardHome_linux_mips_softfloat.tar.gz\"," >> $(DIST_DIR)/version.json
|
|
echo " \"download_linux_mipsle\": \"$(BASE_URL)/AdGuardHome_linux_mipsle_softfloat.tar.gz\"," >> $(DIST_DIR)/version.json
|
|
echo " \"download_linux_mips64\": \"$(BASE_URL)/AdGuardHome_linux_mips64_softfloat.tar.gz\"," >> $(DIST_DIR)/version.json
|
|
echo " \"download_linux_mips64le\": \"$(BASE_URL)/AdGuardHome_linux_mips64le_softfloat.tar.gz\"," >> $(DIST_DIR)/version.json
|
|
|
|
# FreeBSD
|
|
echo " \"download_freebsd_386\": \"$(BASE_URL)/AdGuardHome_freebsd_386.tar.gz\"," >> $(DIST_DIR)/version.json
|
|
echo " \"download_freebsd_amd64\": \"$(BASE_URL)/AdGuardHome_freebsd_amd64.tar.gz\"," >> $(DIST_DIR)/version.json
|
|
|
|
# FreeBSD, all kinds of ARM
|
|
echo " \"download_freebsd_arm\": \"$(BASE_URL)/AdGuardHome_freebsd_armv6.tar.gz\"," >> $(DIST_DIR)/version.json
|
|
echo " \"download_freebsd_armv5\": \"$(BASE_URL)/AdGuardHome_freebsd_armv5.tar.gz\"," >> $(DIST_DIR)/version.json
|
|
echo " \"download_freebsd_armv6\": \"$(BASE_URL)/AdGuardHome_freebsd_armv6.tar.gz\"," >> $(DIST_DIR)/version.json
|
|
echo " \"download_freebsd_armv7\": \"$(BASE_URL)/AdGuardHome_freebsd_armv7.tar.gz\"," >> $(DIST_DIR)/version.json
|
|
echo " \"download_freebsd_arm64\": \"$(BASE_URL)/AdGuardHome_freebsd_arm64.tar.gz\"" >> $(DIST_DIR)/version.json
|
|
|
|
# Finish
|
|
echo "}" >> $(DIST_DIR)/version.json
|
|
endef
|
|
|
|
define repack_dist
|
|
# Repack archive files
|
|
# A temporary solution for our auto-update code to be able to unpack these archive files
|
|
# The problem is that goreleaser doesn't add directory AdGuardHome/ to the archive file
|
|
# and we can't create it
|
|
rm -rf $(DIST_DIR)/AdGuardHome
|
|
|
|
# Windows builds
|
|
$(call zip_repack_windows,AdGuardHome_windows_amd64.zip)
|
|
$(call zip_repack_windows,AdGuardHome_windows_386.zip)
|
|
|
|
# MacOS builds
|
|
$(call zip_repack,AdGuardHome_darwin_amd64.zip)
|
|
$(call zip_repack,AdGuardHome_darwin_386.zip)
|
|
|
|
# Linux
|
|
$(call tar_repack,AdGuardHome_linux_amd64.tar.gz)
|
|
$(call tar_repack,AdGuardHome_linux_386.tar.gz)
|
|
|
|
# Linux, all kinds of ARM
|
|
$(call tar_repack,AdGuardHome_linux_armv5.tar.gz)
|
|
$(call tar_repack,AdGuardHome_linux_armv6.tar.gz)
|
|
$(call tar_repack,AdGuardHome_linux_armv7.tar.gz)
|
|
$(call tar_repack,AdGuardHome_linux_arm64.tar.gz)
|
|
|
|
# Linux, MIPS
|
|
$(call tar_repack,AdGuardHome_linux_mips_softfloat.tar.gz)
|
|
$(call tar_repack,AdGuardHome_linux_mipsle_softfloat.tar.gz)
|
|
$(call tar_repack,AdGuardHome_linux_mips64_softfloat.tar.gz)
|
|
$(call tar_repack,AdGuardHome_linux_mips64le_softfloat.tar.gz)
|
|
|
|
# FreeBSD
|
|
$(call tar_repack,AdGuardHome_freebsd_386.tar.gz)
|
|
$(call tar_repack,AdGuardHome_freebsd_amd64.tar.gz)
|
|
|
|
# FreeBSD, all kinds of ARM
|
|
$(call tar_repack,AdGuardHome_freebsd_armv5.tar.gz)
|
|
$(call tar_repack,AdGuardHome_freebsd_armv6.tar.gz)
|
|
$(call tar_repack,AdGuardHome_freebsd_armv7.tar.gz)
|
|
$(call tar_repack,AdGuardHome_freebsd_arm64.tar.gz)
|
|
endef
|
|
|
|
define zip_repack_windows
|
|
$(eval ARC := $(1))
|
|
cd $(DIST_DIR) && \
|
|
unzip $(ARC) && \
|
|
$(GPG_CMD) AdGuardHome/AdGuardHome.exe && \
|
|
zip -r $(ARC) AdGuardHome/ && \
|
|
rm -rf AdGuardHome
|
|
endef
|
|
|
|
define zip_repack
|
|
$(eval ARC := $(1))
|
|
cd $(DIST_DIR) && \
|
|
unzip $(ARC) && \
|
|
$(GPG_CMD) AdGuardHome/AdGuardHome && \
|
|
zip -r $(ARC) AdGuardHome/ && \
|
|
rm -rf AdGuardHome
|
|
endef
|
|
|
|
define tar_repack
|
|
$(eval ARC := $(1))
|
|
cd $(DIST_DIR) && \
|
|
tar xzf $(ARC) && \
|
|
$(GPG_CMD) AdGuardHome/AdGuardHome && \
|
|
tar czf $(ARC) AdGuardHome/ && \
|
|
rm -rf AdGuardHome
|
|
endef
|