teleport/build.assets/Makefile
Ev Kontsevoy 51ab559872 Documentation improvements
- Faster docs build time due to parallel builds
- Added "agentless" entry to Q&A
- Documented -o flag support for `tsh ssh`. Closes #2330
2019-02-12 16:39:21 -08:00

151 lines
3.3 KiB
Makefile

#
# This Makefile is used for producing official Teleport releases
#
BBOX=teleport-buildbox:latest
DOCSBOX=teleport-docsbox:latest
DOCSHOST=teleport-docs
DOCSDIR=/teleport
HOSTNAME=buildbox
SRCDIR=/gopath/src/github.com/gravitational/teleport
DOCKERFLAGS := --rm=true -v "$$(pwd)/../":$(SRCDIR) -v /tmp:/tmp -w $(SRCDIR) -h $(HOSTNAME)
ADDFLAGS=-ldflags -w
NOROOT=-u $$(id -u):$$(id -g)
KUBECONFIG ?=
TEST_KUBE ?=
OS ?= linux
ARCH ?= amd64
RUNTIME ?= go1.11.5
ifneq ("$(KUBECONFIG)","")
DOCKERFLAGS := $(DOCKERFLAGS) -v $(KUBECONFIG):/mnt/kube/config -e KUBECONFIG=/mnt/kube/config -e TEST_KUBE=$(TEST_KUBE)
endif
export
#
# Build 'teleport' release inside a docker container
#
.PHONY:build
build: bbox
docker run $(DOCKERFLAGS) $(NOROOT) $(BBOX) \
make -C $(SRCDIR) ADDFLAGS='$(ADDFLAGS)' release
#
# Build 'teleport' release inside a docker container
#
.PHONY:build-binaries
build-binaries: bbox
docker run $(DOCKERFLAGS) $(NOROOT) $(BBOX) \
make -C $(SRCDIR) ADDFLAGS='$(ADDFLAGS)' all
#
# Builds a Docker container which is used for building official Teleport
# binaries and docs
#
.PHONY:bbox
bbox:
docker build \
--build-arg UID=$$(id -u) \
--build-arg GID=$$(id -g) \
--build-arg RUNTIME=$(RUNTIME) \
--tag $(BBOX) .
#
# Builds a Docker container for building mkdocs documentation
#
.PHONY:
docsbox:
docker build --build-arg UID=$$(id -u) \
--build-arg GID=$$(id -g) \
--build-arg USER=jenkins \
--build-arg WORKDIR=$(DOCSDIR) \
--tag $(DOCSBOX) -f docs.dockerfile .
#
# Removes the docker image
#
.PHONY:clean
clean:
docker image rm --force $(BBOX)
docker image rm --force $(DOCSBOX)
#
# Runs tests inside a build container
#
.PHONY:test
test: bbox
docker run $(DOCKERFLAGS) $(NOROOT) -t $(BBOX) \
/bin/bash -c \
"examples/etcd/start-etcd.sh & sleep 1; \
ssh-agent > external.agent.tmp && source external.agent.tmp; \
cd $(SRCDIR) && make TELEPORT_DEBUG=0 FLAGS='-cover -race' clean test"
.PHONY:integration
integration: bbox
docker run $(DOCKERFLAGS) $(NOROOT) -t $(BBOX) \
/bin/bash -c "make -C $(SRCDIR) FLAGS='-cover' integration"
#
# Builds docs
#
.PHONY:docs
docs: docsbox
docker run --rm=true -ti $(NOROOT) \
-v $$(pwd)/..:$(DOCSDIR) \
-v /tmp:/tmp \
-w $(DOCSDIR) \
-h $(DOCSHOST) $(DOCSBOX) \
./docs/build.sh
#
# allows to enter into bash shell of docs container
#
.PHONY:
enter-docs: docsbox
docker run --rm=true $(NOROOT) \
-v $$(pwd)/..:$(DOCSDIR) \
-v /tmp:/tmp \
-w $(DOCSDIR) \
-h $(DOCSHOST) \
-ti $(DOCSBOX) /bin/bash
#
# Runs docs website on localhost
#
.PHONY:run-docs
run-docs: docsbox
docker run -ti $(NOROOT) \
-v $$(pwd)/..:$(DOCSDIR) \
-v /tmp:/tmp \
-e HOME=$(SRCDIR)/build.assets \
-p 6600:6600 \
-w $(DOCSDIR) \
$(DOCSBOX) docs/run.sh
#
# Starts shell inside the build container
#
.PHONY:enter
enter: bbox
docker run $(DOCKERFLAGS) -ti $(NOROOT) \
-e HOME=$(SRCDIR)/build.assets -w $(SRCDIR) $(BBOX) /bin/bash
#
# Create a Teleport package using the build container.
#
.PHONY:release
release: bbox
docker run $(DOCKERFLAGS) -i $(NOROOT) $(BBOX) \
/usr/bin/make release -e ADDFLAGS="$(ADDFLAGS)" OS=$(OS) ARCH=$(ARCH) RUNTIME=$(RUNTIME)
#
# Create a Windows Teleport package using the build container.
#
.PHONY:release-windows
release-windows: bbox
docker run $(DOCKERFLAGS) -i $(NOROOT) $(BBOX) \
/usr/bin/make release -e ADDFLAGS="$(ADDFLAGS)" OS=windows