* Adding explicit MPL license for sub-package. This directory and its subdirectories (packages) contain files licensed with the MPLv2 `LICENSE` file in this directory and are intentionally licensed separately from the BSL `LICENSE` file at the root of this repository. * Adding explicit MPL license for sub-package This directory and its subdirectories (packages) contain files licensed with the MPLv2 `LICENSE` file in this directory and are intentionally licensed separately from the BSL `LICENSE` file at the root of this repository. * Updating the license from MPL to Business Source License Going forward, this project will be licensed under the Business Source License v1.1. Please see our blog post for more details at https://hashi.co/bsl-blog, FAQ at www.hashicorp.com/licensing-faq, and details of the license at www.hashicorp.com/bsl. * Update copyright file headers to BUS-1.1 * Rerun make gen This will pick up the last of the license changes * Revert "Rerun make gen" This reverts commit dbe0968bffd92745d8663c6940debae098395a6b. * Remove copywrite from generation script The current version of copywrite is not sophisticated enough to only apply the copywrite changes to certain subdirectories, so to avoid accidentally relicensing our api and sdk modules, we will stop running the copywrite script until such time that it can do the right thing. * License protobuf API as MPL The protobuf API files are used to generate the SDK, since we want the SDK to be MPL, the protobuf files must also be MPL. This extends to all protobuf files whose sources end up in the SDK directory, including: - internal/proto/controller/api - internal/proto/controller/custom_options - internal/proto/plugin It also includes the generated service directory in internal/gen/controller/api/services, since they are generated from the protobuf sources used for the SDK. * Change website license file name This makes the naming scheme consistent with the rest of the repository. * Add note on licensing to README * Set copywrite license to BUSL * Revert "Add note on licensing to README" This reverts commit 4d865a91a7a4f11605f0dc4609355d7e3c3cfffe. --------- Co-authored-by: hashicorp-copywrite[bot] <110428419+hashicorp-copywrite[bot]@users.noreply.github.com> Co-authored-by: Johan Brandhorst-Satzkorn <johan.brandhorst@gmail.com>
398 lines
16 KiB
Makefile
398 lines
16 KiB
Makefile
# Determine this makefile's path.
|
|
# Be sure to place this BEFORE `include` directives, if any.
|
|
THIS_FILE := $(lastword $(MAKEFILE_LIST))
|
|
THIS_DIR := $(dir $(realpath $(firstword $(MAKEFILE_LIST))))
|
|
|
|
TMP_DIR := $(shell mktemp -d)
|
|
REPO_PATH := github.com/hashicorp/boundary
|
|
|
|
TEST_PACKAGE ?= ./...
|
|
TEST_TIMEOUT ?= 30m
|
|
|
|
CGO_ENABLED?=0
|
|
GO_PATH = $(shell go env GOPATH)
|
|
|
|
export GEN_BASEPATH := $(shell pwd)
|
|
|
|
.PHONY: api
|
|
api:
|
|
$(MAKE) --environment-overrides -C internal/api/genapi api
|
|
|
|
.PHONY: cli
|
|
cli:
|
|
$(MAKE) --environment-overrides -C internal/cmd/gencli cli
|
|
|
|
.PHONY: tools
|
|
tools: golangci-lint
|
|
go generate -tags tools tools/tools.go
|
|
go install github.com/bufbuild/buf/cmd/buf@v1.15.1
|
|
go install github.com/mfridman/tparse@v0.10.3
|
|
go install github.com/hashicorp/copywrite@v0.15.0
|
|
|
|
# golangci-lint recommends installing the binary directly, instead of using go get
|
|
# See the note: https://golangci-lint.run/usage/install/#install-from-source
|
|
.PHONY: golangci-lint
|
|
golangci-lint:
|
|
$(eval GOLINT_INSTALLED := $(shell which golangci-lint))
|
|
|
|
if [ "$(GOLINT_INSTALLED)" = "" ]; then \
|
|
sh scripts/install-golangci-lint.sh -b $(GO_PATH)/bin v1.52.2; \
|
|
fi;
|
|
|
|
.PHONY: cleangen
|
|
cleangen:
|
|
@rm -f $(shell find ${THIS_DIR} -name '*.gen.go' && find ${THIS_DIR} -name '*.pb.go' && find ${THIS_DIR} -name '*.pb.gw.go')
|
|
|
|
.PHONY: dev
|
|
dev:
|
|
@echo "This command has changed. Please use:"
|
|
@echo "==> make build"
|
|
@echo " to build the binary into the bin/ directory"
|
|
@echo "==> make install"
|
|
@echo " to build the binary and install it into GOPATH/bin"
|
|
|
|
.PHONY: build
|
|
build: BUILD_TAGS+=ui
|
|
build: build-ui-ifne
|
|
@echo "==> Building Boundary with UI features enabled"
|
|
@CGO_ENABLED=$(CGO_ENABLED) BUILD_TAGS='$(BUILD_TAGS)' sh -c "'$(CURDIR)/scripts/build.sh'"
|
|
|
|
.PHONY: install
|
|
install: export BOUNDARY_INSTALL_BINARY=1
|
|
install: build
|
|
|
|
.PHONY: install-no-plugins
|
|
install-no-plugins: export SKIP_PLUGIN_BUILD=1
|
|
install-no-plugins: install
|
|
|
|
.PHONY: build-memprof
|
|
build-memprof: BUILD_TAGS+=memprofiler
|
|
build-memprof:
|
|
@echo "==> Building Boundary with memory profiling enabled"
|
|
@CGO_ENABLED=$(CGO_ENABLED) BUILD_TAGS='$(BUILD_TAGS)' sh -c "'$(CURDIR)/scripts/build.sh'"
|
|
|
|
# Format Go files, ignoring files marked as generated through the header defined at
|
|
# https://pkg.go.dev/cmd/go#hdr-Generate_Go_files_by_processing_source
|
|
.PHONY: fmt
|
|
fmt:
|
|
grep -L -R "^\/\/ Code generated .* DO NOT EDIT\.$$" --exclude-dir=.git --include="*.go" . | xargs gofumpt -w
|
|
buf format -w
|
|
|
|
lint:
|
|
golangci-lint run --timeout 10m
|
|
|
|
ifndef LINT_DIFF_BRANCH
|
|
override LINT_DIFF_BRANCH = main
|
|
endif
|
|
|
|
lint-diff:
|
|
@echo "Checking for lint compared to $(LINT_DIFF_BRANCH)"
|
|
golangci-lint run --timeout 10m --new-from-rev=$(LINT_DIFF_BRANCH)
|
|
|
|
# Set env for all UI targets.
|
|
UI_TARGETS := update-ui-version build-ui build-ui-ifne clean-ui
|
|
# Note the extra .tmp path segment in UI_CLONE_DIR is significant and required.
|
|
$(UI_TARGETS): export UI_CLONE_DIR := internal/ui/.tmp/boundary-ui
|
|
$(UI_TARGETS): export UI_VERSION_FILE := internal/ui/VERSION
|
|
$(UI_TARGETS): export UI_DEFAULT_BRANCH := main
|
|
$(UI_TARGETS): export UI_COMMITISH ?=
|
|
|
|
.PHONY: update-ui-version
|
|
update-ui-version:
|
|
@if [ -z "$(UI_COMMITISH)" ]; then \
|
|
echo "==> Setting UI version to latest commit on branch '$(UI_DEFAULT_BRANCH)'"; \
|
|
export UI_COMMITISH="$(UI_DEFAULT_BRANCH)"; \
|
|
else \
|
|
echo "==> Setting to latest commit matching '$(UI_COMMITISH)'"; \
|
|
fi; \
|
|
./scripts/uiupdate.sh
|
|
|
|
.PHONY: build-ui
|
|
build-ui:
|
|
./scripts/build-ui.sh
|
|
|
|
.PHONY: build-plugins
|
|
build-plugins:
|
|
@CGO_ENABLED=$(CGO_ENABLED) BUILD_TAGS='$(BUILD_TAGS)' sh -c "'$(CURDIR)/scripts/plugins.sh'"
|
|
|
|
.PHONY: clean-ui
|
|
clean-ui:
|
|
rm -rf ${UI_CLONE_DIR}
|
|
|
|
.PHONY: build-ui-ifne
|
|
build-ui-ifne:
|
|
ifeq (,$(wildcard internal/ui/.tmp/boundary-ui))
|
|
@echo "==> No UI assets found, building..."
|
|
@$(MAKE) build-ui
|
|
else
|
|
@echo "==> UI assets found, use build-ui target to update"
|
|
endif
|
|
|
|
.PHONY: perms-table
|
|
perms-table:
|
|
@go run internal/website/permstable/permstable.go
|
|
|
|
.PHONY: gen
|
|
gen: cleangen proto api cli perms-table fmt
|
|
|
|
### oplog requires protoc-gen-go v1.20.0 or later
|
|
# GO111MODULE=on go get -u github.com/golang/protobuf/protoc-gen-go@v1.40
|
|
.PHONY: proto
|
|
proto: protolint protobuild
|
|
|
|
.PHONY: protobuild
|
|
protobuild:
|
|
@buf generate -o "${TMP_DIR}" internal/proto
|
|
|
|
# Move the generated files from the tmp file subdirectories into the current repo.
|
|
cp -R ${TMP_DIR}/${REPO_PATH}/* ${THIS_DIR}
|
|
|
|
@buf generate --template buf.openapiv2.gen.yaml --path internal/proto/controller/api/services/v1/
|
|
cd internal/bsr/ && buf generate proto/
|
|
|
|
@protoc-go-inject-tag -input=./internal/oplog/store/oplog.pb.go
|
|
@protoc-go-inject-tag -input=./internal/oplog/oplog_test/oplog_test.pb.go
|
|
@protoc-go-inject-tag -input=./internal/iam/store/group_member.pb.go
|
|
@protoc-go-inject-tag -input=./internal/iam/store/role.pb.go
|
|
@protoc-go-inject-tag -input=./internal/iam/store/principal_role.pb.go
|
|
@protoc-go-inject-tag -input=./internal/iam/store/role_grant.pb.go
|
|
@protoc-go-inject-tag -input=./internal/iam/store/user.pb.go
|
|
@protoc-go-inject-tag -input=./internal/iam/store/scope.pb.go
|
|
@protoc-go-inject-tag -input=./internal/iam/store/group.pb.go
|
|
@protoc-go-inject-tag -input=./internal/db/db_test/db_test.pb.go
|
|
@protoc-go-inject-tag -input=./internal/host/store/host.pb.go
|
|
@protoc-go-inject-tag -input=./internal/host/static/store/static.pb.go
|
|
@protoc-go-inject-tag -input=./internal/host/plugin/store/host.pb.go
|
|
@protoc-go-inject-tag -input=./internal/plugin/store/plugin.pb.go
|
|
@protoc-go-inject-tag -input=./internal/authtoken/store/authtoken.pb.go
|
|
@protoc-go-inject-tag -input=./internal/auth/store/account.pb.go
|
|
@protoc-go-inject-tag -input=./internal/auth/password/store/password.pb.go
|
|
@protoc-go-inject-tag -input=./internal/auth/password/store/argon2.pb.go
|
|
@protoc-go-inject-tag -input=./internal/kms/store/root_key.pb.go
|
|
@protoc-go-inject-tag -input=./internal/kms/store/database_key.pb.go
|
|
@protoc-go-inject-tag -input=./internal/kms/store/oplog_key.pb.go
|
|
@protoc-go-inject-tag -input=./internal/kms/store/token_key.pb.go
|
|
@protoc-go-inject-tag -input=./internal/kms/store/session_key.pb.go
|
|
@protoc-go-inject-tag -input=./internal/kms/store/oidc_key.pb.go
|
|
@protoc-go-inject-tag -input=./internal/kms/store/data_key_version_destruction_job.pb.go
|
|
@protoc-go-inject-tag -input=./internal/kms/store/data_key_version_destruction_job_run.pb.go
|
|
@protoc-go-inject-tag -input=./internal/kms/store/data_key_version_destruction_job_progress.pb.go
|
|
@protoc-go-inject-tag -input=./internal/kms/store/data_key_version_destruction_job_run_allowed_table_name.pb.go
|
|
@protoc-go-inject-tag -input=./internal/server/store/controller.pb.go
|
|
@protoc-go-inject-tag -input=./internal/server/store/worker.pb.go
|
|
@protoc-go-inject-tag -input=./internal/server/store/root_certificate.pb.go
|
|
@protoc-go-inject-tag -input=./internal/server/store/worker_auth.pb.go
|
|
@protoc-go-inject-tag -input=./internal/target/store/target.pb.go
|
|
@protoc-go-inject-tag -input=./internal/target/targettest/store/target.pb.go
|
|
@protoc-go-inject-tag -input=./internal/target/tcp/store/target.pb.go
|
|
@protoc-go-inject-tag -input=./internal/auth/oidc/store/oidc.pb.go
|
|
@protoc-go-inject-tag -input=./internal/scheduler/job/store/job.pb.go
|
|
@protoc-go-inject-tag -input=./internal/credential/store/credential.pb.go
|
|
@protoc-go-inject-tag -input=./internal/credential/vault/store/vault.pb.go
|
|
@protoc-go-inject-tag -input=./internal/credential/static/store/static.pb.go
|
|
@protoc-go-inject-tag -input=./internal/kms/store/audit_key.pb.go
|
|
@protoc-go-inject-tag -input=./internal/auth/ldap/store/ldap.pb.go
|
|
@protoc-go-inject-tag -input=./internal/gen/controller/servers/services/upstream_message_service.pb.go
|
|
@protoc-go-inject-tag -input=./internal/storage/plugin/store/storage.pb.go
|
|
|
|
# inject classification tags (see: https://github.com/hashicorp/go-eventlogger/tree/main/filters/encrypt)
|
|
@protoc-go-inject-tag -input=./internal/gen/controller/api/services/auth_method_service.pb.go
|
|
@protoc-go-inject-tag -input=./sdk/pbs/controller/api/resources/authmethods/auth_method.pb.go
|
|
@protoc-go-inject-tag -input=./sdk/pbs/controller/api/resources/scopes/scope.pb.go
|
|
@protoc-go-inject-tag -input=./internal/gen/controller/api/services/scope_service.pb.go
|
|
@protoc-go-inject-tag -input=./internal/gen/controller/servers/services/session_service.pb.go
|
|
@protoc-go-inject-tag -input=./sdk/pbs/controller/api/resources/targets/target.pb.go
|
|
@protoc-go-inject-tag -input=./internal/gen/controller/api/services/target_service.pb.go
|
|
@protoc-go-inject-tag -input=./sdk/pbs/controller/api/resources/accounts/account.pb.go
|
|
@protoc-go-inject-tag -input=./internal/gen/controller/api/services/account_service.pb.go
|
|
@protoc-go-inject-tag -input=./sdk/pbs/controller/api/resources/hosts/host.pb.go
|
|
@protoc-go-inject-tag -input=./internal/gen/controller/api/services/host_service.pb.go
|
|
@protoc-go-inject-tag -input=./sdk/pbs/controller/api/resources/plugins/plugin.pb.go
|
|
@protoc-go-inject-tag -input=./sdk/pbs/controller/api/resources/hostcatalogs/host_catalog.pb.go
|
|
@protoc-go-inject-tag -input=./internal/gen/controller/api/services/host_catalog_service.pb.go
|
|
@protoc-go-inject-tag -input=./sdk/pbs/controller/api/resources/hostsets/host_set.pb.go
|
|
@protoc-go-inject-tag -input=./internal/gen/controller/api/services/host_set_service.pb.go
|
|
@protoc-go-inject-tag -input=./sdk/pbs/controller/api/resources/storagebuckets/storage_bucket.pb.go
|
|
@protoc-go-inject-tag -input=./internal/gen/controller/api/services/storage_bucket_service.pb.go
|
|
@protoc-go-inject-tag -input=./sdk/pbs/controller/api/resources/authtokens/authtoken.pb.go
|
|
@protoc-go-inject-tag -input=./internal/gen/controller/api/services/authtokens_service.pb.go
|
|
@protoc-go-inject-tag -input=./sdk/pbs/controller/api/resources/managedgroups/managed_group.pb.go
|
|
@protoc-go-inject-tag -input=./internal/gen/controller/api/services/managed_group_service.pb.go
|
|
@protoc-go-inject-tag -input=./sdk/pbs/controller/api/resources/groups/group.pb.go
|
|
@protoc-go-inject-tag -input=./internal/gen/controller/api/services/group_service.pb.go
|
|
@protoc-go-inject-tag -input=./sdk/pbs/controller/api/resources/credentialstores/credential_store.pb.go
|
|
@protoc-go-inject-tag -input=./internal/gen/controller/api/services/credential_store_service.pb.go
|
|
@protoc-go-inject-tag -input=./sdk/pbs/controller/api/resources/credentiallibraries/credential_library.pb.go
|
|
@protoc-go-inject-tag -input=./internal/gen/controller/api/services/credential_library_service.pb.go
|
|
@protoc-go-inject-tag -input=./sdk/pbs/controller/api/resources/credentials/credential.pb.go
|
|
@protoc-go-inject-tag -input=./internal/gen/controller/api/services/credential_service.pb.go
|
|
@protoc-go-inject-tag -input=./sdk/pbs/controller/api/resources/roles/role.pb.go
|
|
@protoc-go-inject-tag -input=./internal/gen/controller/api/services/role_service.pb.go
|
|
@protoc-go-inject-tag -input=./sdk/pbs/controller/api/resources/sessions/session.pb.go
|
|
@protoc-go-inject-tag -input=./internal/gen/controller/api/services/session_service.pb.go
|
|
@protoc-go-inject-tag -input=./sdk/pbs/controller/api/resources/users/user.pb.go
|
|
@protoc-go-inject-tag -input=./internal/gen/controller/api/services/user_service.pb.go
|
|
@protoc-go-inject-tag -input=./sdk/pbs/controller/api/resources/workers/worker.pb.go
|
|
@protoc-go-inject-tag -input=./internal/gen/controller/api/services/session_recording_service.pb.go
|
|
@protoc-go-inject-tag -input=./sdk/pbs/controller/api/resources/session_recordings/session_recording.pb.go
|
|
@protoc-go-inject-tag -input=./internal/gen/controller/api/services/worker_service.pb.go
|
|
@protoc-go-inject-tag -input=./internal/gen/controller/servers/services/server_coordination_service.pb.go
|
|
@protoc-go-inject-tag -input=./internal/gen/controller/servers/servers.pb.go
|
|
|
|
|
|
# these protos, services and openapi artifacts are purely for testing purposes
|
|
@protoc-go-inject-tag -input=./internal/gen/testing/event/event.pb.go
|
|
@buf generate --template buf.testing.gen.yaml --path internal/proto/testing/event/v1/
|
|
|
|
@go run ./scripts/remove-gotags-comments/ -path ./internal/gen/controller.swagger.json
|
|
|
|
@rm -R ${TMP_DIR}
|
|
|
|
.PHONY: protolint
|
|
protolint:
|
|
@buf lint
|
|
# First check all protos except controller/servers and controller/storage for WIRE_JSON compatibility
|
|
cd internal/proto && buf breaking --against 'https://github.com/hashicorp/boundary.git#branch=stable-website,subdir=internal/proto' \
|
|
--exclude-path=controller/servers \
|
|
--exclude-path=controller/storage \
|
|
--config buf.breaking.json.yaml
|
|
# Next check all protos for WIRE compatibility. WIRE is a subset of WIRE_JSON so we don't need to exclude any files.
|
|
cd internal/proto && buf breaking --against 'https://github.com/hashicorp/boundary.git#branch=stable-website,subdir=internal/proto' \
|
|
--config buf.breaking.wire.yaml
|
|
|
|
.PHONY: copywrite
|
|
copywrite:
|
|
copywrite headers
|
|
|
|
.PHONY: website
|
|
# must have nodejs and npm installed
|
|
website: website-install website-start
|
|
|
|
.PHONY: website-install
|
|
website-install:
|
|
@npm install --prefix website/
|
|
|
|
.PHONY: website-start
|
|
website-start:
|
|
@npm start --prefix website/
|
|
|
|
.PHONY: test-database-up
|
|
test-database-up:
|
|
make -C testing/dbtest/docker database-up
|
|
|
|
.PHONY: test-database-down
|
|
test-database-down:
|
|
make -C testing/dbtest/docker clean
|
|
|
|
.PHONY: generate-database-dumps
|
|
generate-database-dumps:
|
|
@$(MAKE) -C testing/dbtest/docker generate-database-dumps
|
|
|
|
.PHONY: test-sql
|
|
test-sql:
|
|
$(MAKE) -C internal/db/sqltest/ test
|
|
|
|
.PHONY: test
|
|
test:
|
|
go test "$(TEST_PACKAGE)" -tags="$(BUILD_TAGS)" $(TESTARGS) -json -cover -timeout $(TEST_TIMEOUT) | tparse -follow
|
|
|
|
.PHONY: test-sdk
|
|
test-sdk:
|
|
$(MAKE) -C sdk/ test
|
|
|
|
.PHONY: test-api
|
|
test-api:
|
|
$(MAKE) -C api/ test
|
|
|
|
.PHONY: test-cli
|
|
test-cli:
|
|
$(MAKE) -C internal/tests/cli test
|
|
|
|
.PHONY: test-all
|
|
test-all: test-sdk test-api test
|
|
|
|
BENCH_TIME?=1s
|
|
BENCH_COUNT?=1s
|
|
.PHONY: benchmark
|
|
benchmark:
|
|
@go test \
|
|
-timeout 60m \
|
|
./internal/servers/controller/handlers/sessions/ \
|
|
-v \
|
|
-bench '^BenchmarkSessionList$$' \
|
|
-benchtime $(BENCH_TIME) \
|
|
-count $(BENCH_COUNT) \
|
|
-run '^$$'
|
|
|
|
.PHONY: install-go
|
|
install-go:
|
|
./ci/goinstall.sh
|
|
|
|
# Docker build and publish variables and targets
|
|
REGISTRY_NAME?=docker.io/hashicorp
|
|
IMAGE_NAME=boundary
|
|
VERSION?=0.7.4
|
|
IMAGE_TAG=$(REGISTRY_NAME)/$(IMAGE_NAME):$(VERSION)
|
|
IMAGE_TAG_DEV?=$(REGISTRY_NAME)/$(IMAGE_NAME):latest-$(shell git rev-parse --short HEAD)
|
|
|
|
.PHONY: docker
|
|
docker: docker-build
|
|
|
|
.PHONY: docker-build
|
|
# Builds from the releases.hashicorp.com official binary
|
|
docker-build:
|
|
docker build \
|
|
--tag $(IMAGE_TAG) \
|
|
--tag hashicorp/boundary:latest \
|
|
--target=official \
|
|
--build-arg VERSION=$(VERSION) \
|
|
.
|
|
|
|
.PHONY: docker-multiarch-build
|
|
# Builds multiarch from the releases.hashicorp.com official binary
|
|
docker-multiarch-build:
|
|
docker buildx build \
|
|
--tag $(IMAGE_TAG) \
|
|
--tag hashicorp/boundary:latest \
|
|
--target=official \
|
|
--build-arg VERSION=$(VERSION) \
|
|
--platform linux/amd64,linux/arm64 \
|
|
.
|
|
|
|
DEV_DOCKER_GOOS ?= linux
|
|
DEV_DOCKER_GOARCH ?= amd64
|
|
|
|
.PHONY: docker-build-dev
|
|
# Builds from the locally generated binary in ./bin/
|
|
docker-build-dev: export GOOS=$(DEV_DOCKER_GOOS)
|
|
docker-build-dev: export GOARCH=$(DEV_DOCKER_GOARCH)
|
|
docker-build-dev: build
|
|
docker buildx build \
|
|
--load \
|
|
--platform $(DEV_DOCKER_GOOS)/$(DEV_DOCKER_GOARCH) \
|
|
--tag $(IMAGE_TAG_DEV) \
|
|
--target=dev \
|
|
--build-arg=boundary \
|
|
.
|
|
@echo "Successfully built $(IMAGE_TAG_DEV)"
|
|
|
|
.NOTPARALLEL:
|
|
|
|
.PHONY: version
|
|
# This is used for release builds by .github/workflows/build.yml
|
|
version:
|
|
@go run \
|
|
-ldflags "-X 'github.com/hashicorp/boundary/version.Version=$(shell cat version/VERSION)'" \
|
|
./cmd/boundary version \
|
|
| awk '/Version Number:/ { print $$3 }'
|
|
|
|
EDITION?=
|
|
.PHONY: edition
|
|
# This is used for release builds by .github/workflows/build.yml
|
|
edition:
|
|
@if [ -z "$(EDITION)" ]; then \
|
|
go run ./cmd/boundary version -format=json | jq -r '.version_metadata // "oss"'; \
|
|
else \
|
|
echo $(EDITION); \
|
|
fi; \
|