145 lines
7.0 KiB
Makefile
145 lines
7.0 KiB
Makefile
HUGO_VERSION = $(shell grep ^HUGO_VERSION netlify.toml | tail -n 1 | cut -d '=' -f 2 | tr -d " \"\n")
|
|
NODE_BIN = node_modules/.bin
|
|
NETLIFY_FUNC = $(NODE_BIN)/netlify-lambda
|
|
|
|
# The CONTAINER_ENGINE variable is used for specifying the container engine. By default 'docker' is used
|
|
# but this can be overridden when calling make, e.g.
|
|
# CONTAINER_ENGINE=podman make container-image
|
|
CONTAINER_ENGINE ?= docker
|
|
IMAGE_REGISTRY ?= gcr.io/k8s-staging-sig-docs
|
|
IMAGE_VERSION=$(shell scripts/hash-files.sh Dockerfile Makefile package.json package-lock.json | cut -c 1-12)
|
|
CONTAINER_IMAGE = $(IMAGE_REGISTRY)/k8s-website-hugo:v$(HUGO_VERSION)-$(IMAGE_VERSION)
|
|
# Mount read-only to allow use with tools like Podman in SELinux mode
|
|
# Container targets don't need to write into /src
|
|
CONTAINER_RUN = "$(CONTAINER_ENGINE)" run --rm --interactive --tty --volume "$(CURDIR):/src:ro,Z"
|
|
CONTAINER_RUN_TTY = "$(CONTAINER_ENGINE)" run --rm --interactive --tty
|
|
CONTAINER_HUGO_MOUNTS = \
|
|
--read-only \
|
|
--mount type=bind,source=$(CURDIR)/.git,target=/src/.git,readonly \
|
|
--mount type=bind,source=$(CURDIR)/archetypes,target=/src/archetypes,readonly \
|
|
--mount type=bind,source=$(CURDIR)/assets,target=/src/assets,readonly \
|
|
--mount type=bind,source=$(CURDIR)/content,target=/src/content,readonly \
|
|
--mount type=bind,source=$(CURDIR)/data,target=/src/data,readonly \
|
|
--mount type=bind,source=$(CURDIR)/i18n,target=/src/i18n,readonly \
|
|
--mount type=bind,source=$(CURDIR)/layouts,target=/src/layouts,readonly \
|
|
--mount type=bind,source=$(CURDIR)/static,target=/src/static,readonly \
|
|
--mount type=tmpfs,destination=/tmp,tmpfs-mode=01777 \
|
|
--mount type=bind,source=$(CURDIR)/hugo.toml,target=/src/hugo.toml,readonly
|
|
|
|
CCRED=\033[0;31m
|
|
CCEND=\033[0m
|
|
|
|
# Docker buildx related settings for multi-arch images
|
|
DOCKER_BUILDX ?= docker buildx
|
|
|
|
.PHONY: all build build-preview help serve
|
|
|
|
help: ## Show this help.
|
|
@awk 'BEGIN {FS = ":.*?## "} /^[a-zA-Z_-]+:.*?## / {sub("\\\\n",sprintf("\n%22c"," "), $$2);printf "\033[36m%-20s\033[0m %s\n", $$1, $$2}' $(MAKEFILE_LIST)
|
|
|
|
module-check: ## Check if all of the required submodules are correctly initialized.
|
|
@git submodule status --recursive | awk '/^[+-]/ {err = 1; printf "\033[31mWARNING\033[0m Submodule not initialized: \033[34m%s\033[0m\n",$$2} END { if (err != 0) print "You need to run \033[32mmake module-init\033[0m to initialize missing modules first"; exit err }' 1>&2
|
|
|
|
module-init: ## Initialize required submodules.
|
|
@echo "Initializing submodules..." 1>&2
|
|
@git submodule update --init --recursive --depth 1
|
|
|
|
all: build ## Build site with production settings and put deliverables in ./public
|
|
|
|
build: module-check ## Build site with non-production settings and put deliverables in ./public
|
|
hugo --cleanDestinationDir --minify --environment development
|
|
|
|
build-preview: module-check ## Build site with drafts and future posts enabled
|
|
hugo --cleanDestinationDir --buildDrafts --buildFuture --environment preview
|
|
|
|
deploy-preview: ## Deploy preview site via netlify
|
|
GOMAXPROCS=1 hugo --cleanDestinationDir --enableGitInfo --buildFuture --environment preview -b $(DEPLOY_PRIME_URL)
|
|
|
|
functions-build:
|
|
$(NETLIFY_FUNC) build functions-src
|
|
|
|
check-headers-file:
|
|
scripts/check-headers-file.sh
|
|
|
|
production-build: module-check ## Build the production site and ensure that noindex headers aren't added
|
|
GOMAXPROCS=1 hugo --cleanDestinationDir --minify --environment production
|
|
HUGO_ENV=production $(MAKE) check-headers-file
|
|
|
|
non-production-build: module-check ## Build the non-production site, which adds noindex headers to prevent indexing
|
|
GOMAXPROCS=1 hugo --cleanDestinationDir --enableGitInfo --environment nonprod
|
|
|
|
serve: module-check ## Boot the development server.
|
|
hugo server --buildDrafts --buildFuture --environment development
|
|
|
|
docker-image:
|
|
@echo -e "$(CCRED)**** The use of docker-image is deprecated. Use container-image instead. ****$(CCEND)"
|
|
$(MAKE) container-image
|
|
|
|
docker-build:
|
|
@echo -e "$(CCRED)**** The use of docker-build is deprecated. Use container-build instead. ****$(CCEND)"
|
|
$(MAKE) container-build
|
|
|
|
docker-serve:
|
|
@echo -e "$(CCRED)**** The use of docker-serve is deprecated. Use container-serve instead. ****$(CCEND)"
|
|
$(MAKE) container-serve
|
|
|
|
container-image: ## Build a container image for the preview of the website
|
|
$(CONTAINER_ENGINE) build . \
|
|
--network=host \
|
|
--tag $(CONTAINER_IMAGE) \
|
|
--build-arg HUGO_VERSION=$(HUGO_VERSION)
|
|
|
|
container-push: container-image ## Push container image for the preview of the website
|
|
$(CONTAINER_ENGINE) push $(CONTAINER_IMAGE)
|
|
|
|
PLATFORMS ?= linux/arm64,linux/amd64
|
|
docker-push: ## Build a multi-architecture image and push that into the registry
|
|
docker run --rm --privileged tonistiigi/binfmt:qemu-v8.1.5-43@sha256:46c5a036f13b8ad845d6703d38f8cce6dd7c0a1e4d42ac80792279cabaeff7fb --install all
|
|
docker version
|
|
$(DOCKER_BUILDX) version
|
|
$(DOCKER_BUILDX) inspect image-builder > /dev/null 2>&1 || $(DOCKER_BUILDX) create --name image-builder --use
|
|
# copy existing Dockerfile and insert --platform=${TARGETPLATFORM} into Dockerfile.cross, and preserve the original Dockerfile
|
|
sed -e 's/\(^FROM\)/FROM --platform=\$$\{TARGETPLATFORM\}/' Dockerfile > Dockerfile.cross
|
|
$(DOCKER_BUILDX) build \
|
|
--push \
|
|
--platform=$(PLATFORMS) \
|
|
--build-arg HUGO_VERSION=$(HUGO_VERSION) \
|
|
--tag $(CONTAINER_IMAGE) \
|
|
-f Dockerfile.cross .
|
|
$(DOCKER_BUILDX) stop image-builder
|
|
rm Dockerfile.cross
|
|
|
|
container-build: module-check
|
|
mkdir -p public
|
|
$(CONTAINER_RUN_TTY) $(CONTAINER_HUGO_MOUNTS) $(CONTAINER_IMAGE) \
|
|
hugo --destination /tmp/public --cleanDestinationDir --buildDrafts --buildFuture --environment preview --noBuildLock
|
|
|
|
# no build lock to allow for read-only mounts
|
|
container-serve: module-check ## Boot the development server using container.
|
|
$(CONTAINER_RUN_TTY) --cap-drop=ALL --cap-add=AUDIT_WRITE $(CONTAINER_HUGO_MOUNTS) \
|
|
-p 1313:1313 $(CONTAINER_IMAGE) \
|
|
hugo server --buildDrafts --buildFuture --environment development --bind 0.0.0.0 --destination /tmp/public --cleanDestinationDir --noBuildLock
|
|
|
|
test-examples:
|
|
scripts/test_examples.sh install
|
|
scripts/test_examples.sh run
|
|
|
|
.PHONY: link-checker-setup
|
|
link-checker-image-pull:
|
|
$(CONTAINER_ENGINE) pull wjdp/htmltest
|
|
|
|
docker-internal-linkcheck:
|
|
@echo -e "$(CCRED)**** The use of docker-internal-linkcheck is deprecated. Use container-internal-linkcheck instead. ****$(CCEND)"
|
|
$(MAKE) container-internal-linkcheck
|
|
|
|
container-internal-linkcheck: link-checker-image-pull
|
|
$(CONTAINER_RUN) $(CONTAINER_IMAGE) hugo --config config.toml,linkcheck-config.toml --buildFuture --environment test
|
|
$(CONTAINER_ENGINE) run --mount "type=bind,source=$(CURDIR),target=/test" --rm wjdp/htmltest htmltest
|
|
|
|
clean-api-reference: ## Clean all directories in API reference directory, preserve _index.md
|
|
rm -rf content/en/docs/reference/kubernetes-api/*/
|
|
|
|
api-reference: clean-api-reference ## Build the API reference pages. go needed
|
|
cd api-ref-generator/gen-resourcesdocs && \
|
|
go run cmd/main.go kwebsite --config-dir ../../api-ref-assets/config/ --file ../../api-ref-assets/api/swagger.json --output-dir ../../content/en/docs/reference/kubernetes-api --templates ../../api-ref-assets/templates
|