Closes #2576. Updates #2275. Updates #2419. Updates #2443. Squashed commit of the following: commit b1a4809ada298d675de12740051ba26fb9945957 Author: Ainar Garipov <A.Garipov@AdGuard.COM> Date: Fri May 21 14:01:40 2021 +0300 all: add --local-frontend, upd docker commit 619ee7c82f27e3405753003dbec556ffb056d025 Author: Ainar Garipov <A.Garipov@AdGuard.COM> Date: Thu May 20 15:02:33 2021 +0300 bamboo-specs: bump docker version commit 5c2b2fbce80afdcc81fd0cb83674dc3d64facbf1 Merge: 6536b32d |
||
---|---|---|
.. | ||
hooks | ||
make | ||
querylog | ||
snap | ||
translations | ||
whotracksme | ||
install.sh | ||
README.md |
AdGuard Home Scripts
hooks/
: Git Hooks
Usage
Run make init
from the project root.
querylog/
: Query Log Helpers
Usage
npm install
: install dependencies. Run this first.npm run anonymize <source> <dst>
: read the query log from the<source>
and write anonymized version to<dst>
.
make/
: Makefile Scripts
The release channels are: development
(the default), edge
, beta
, and
release
. If verbosity levels aren't documented here, there are only two: 0
,
don't print anything, and 1
, be verbose.
build-docker.sh
: Build A Multi-Architecture Docker Image
Required environment:
CHANNEL
: release channel, see above.COMMIT
: current Git revision.DIST_DIR
: the directory where a release has previously been built.VERSION
: release version.
Optional environment:
DOCKER_IMAGE_NAME
: the name of the resulting Docker container. By default it'sadguardhome-dev
.DOCKER_OUTPUT
: the--output
parameters. By default they aretype=image,name=${DOCKER_IMAGE_NAME},push=false
.SUDO
: allow users to usesudo
ordoas
withdocker
. By default none is used.
build-release.sh
: Build A Release For All Platforms
Required environment:
CHANNEL
: release channel, see above.GPG_KEY
andGPG_KEY_PASSPHRASE
: data forgpg
. Only required ifSIGN
is1
.
Optional environment:
ARCH
andOS
: space-separated list of architectures and operating systems for which to build a release. For example, to build only for 64-bit ARM and AMD on Linux and Darwin:
The default value ismake ARCH='amd64 arm64' OS='darwin linux' … build-release
''
, which means build everything.DIST_DIR
: the directory to build a release into. The default value isdist
.GO
: set an alternarive name for the Go compiler.SIGN
:0
to not sign the resulting packages,1
to sign. The default value is1
.SNAP
:0
to not build Snapcraft packages,1
to build. The default value is1
.VERBOSE
:1
to be verbose,2
to also print environment. This script callsgo-build.sh
with the verbosity level one level lower, so to get verbosity level2
ingo-build.sh
, set this to3
when callingbuild-release.sh
.VERSION
: release version. Will be set byversion.sh
if it is unset or if it has the defaultMakefile
value ofv0.0.0
.
clean.sh
: Cleanup
Optional environment:
GO
: set an alternarive name for the Go compiler.
Required environment:
DIST_DIR
: the directory where a release has previously been built.
go-build.sh
: Build The Backend
Optional environment:
BUILD_TIME
: If set, overrides the build time information. Useful for reproducible builds.GOARM
: ARM processor options for the Go compiler.GOMIPS
: ARM processor options for the Go compiler.GO
: set an alternarive name for the Go compiler.OUT
: output binary name.PARALLELISM
: set the maximum number of concurrently run build commands (that is, compiler, linker, etc.).VERBOSE
: verbosity level.1
shows every command that is run and every Go package that is processed.2
also shows subcommands and environment. The default value is0
, don't be verbose.
Required environment:
CHANNEL
: release channel, see above.VERSION
: release version.
go-deps.sh
: Install Backend Dependencies
Optional environment:
GO
: set an alternarive name for the Go compiler.VERBOSE
: verbosity level.1
shows every command that is run and every Go package that is processed.2
also shows subcommands and environment. The default value is0
, don't be verbose.
go-lint.sh
: Run Backend Static Analyzers
Don't forget to run make go-tools
once first!
Optional environment:
EXIT_ON_ERROR
: if set to0
, don't exit the script after the first encountered error. The default value is1
.GO
: set an alternarive name for the Go compiler.VERBOSE
: verbosity level.1
shows every command that is run.2
also shows subcommands. The default value is0
, don't be verbose.
go-test.sh
: Run Backend Tests
Optional environment:
GO
: set an alternarive name for the Go compiler.RACE
: set to0
to not use the Go race detector. The default value is1
, use the race detector.TIMEOUT_FLAGS
: set timeout flags for tests. The default value is--timeout 30s
.VERBOSE
: verbosity level.1
shows every command that is run and every Go package that is processed.2
also shows subcommands. The default value is0
, don't be verbose.
go-tools.sh
: Install Backend Tooling
Installs the Go static analysis and other tools into ${PWD}/bin
. Either add
${PWD}/bin
to your $PATH
before all other entries, or use the commands
directly, or use the commands through make
(for example, make go-lint
).
Optional environment:
GO
: set an alternarive name for the Go compiler.
version.sh
: Generate And Print The Current Version
Required environment:
CHANNEL
: release channel, see above.
snap/
: Snap GUI Files
App icons (see https://github.com/AdguardTeam/AdGuardHome/pull/1836), Snap manifest file templates, and helper scripts.
translations/
: Twosky Integration Script
Usage
npm install
: install dependencies. Run this first.npm run locales:download
: download and save all translations.npm run locales:upload
: upload the baseen
locale.npm run locales:summary
: show the current locales summary.npm run locales:unused
: show the list of unused strings.
After the download you'll find the output locales in the client/src/__locales/
directory.
whotracksme/
: Whotracks.me Database Converter
A simple script that converts the Ghostery/Cliqz trackers database to a json format.
Usage
yarn install
node index.js
You'll find the output in the whotracksmedb.json
file. Then, move it to
client/src/helpers/trackers
.