wadm 0.5.0

wasmCloud Application Deployment Manager: A tool for running Wasm applications in wasmCloud
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115

SHELL := bash

.ONESHELL:
.SHELLFLAGS := -eu -o pipefail -c

.DELETE_ON_ERROR:
MAKEFLAGS += --warn-undefined-variables

MAKEFLAGS += --no-builtin-rules

MAKEFLAGS += --no-print-directory

MAKEFLAGS += -S


.DEFAULT: help


CARGO ?= cargo

CARGO_CLIPPY ?= cargo-clippy

DOCKER ?= docker

NATS ?= nats


# Defaulting to the local registry since multi-arch containers have to be pushed
WADM_TAG ?= localhost:5000/wasmcloud/wadm:latest

# These should be either built locally or downloaded from a release.
BIN_AMD64 ?= wadm-amd64

BIN_ARM64 ?= wadm-aarch64


help:  ## Display this help

	@awk 'BEGIN {FS = ":.*##"; printf "\nUsage:\n  make \033[36m<target>\033[0m\n"} /^[a-zA-Z_\-.*]+:.*?##/ { printf "  \033[36m%-15s\033[0m %s\n", $$1, $$2 } /^##@/ { printf "\n\033[1m%s\033[0m\n", substr($$0, 5) } ' $(MAKEFILE_LIST)


all: build test


###########
# Tooling #
###########

# Ensure that clippy is installed
check-cargo-clippy:
ifeq ("",$(shell command -v $(CARGO_CLIPPY)))
	$(error "ERROR: clippy is not installed (see: https://doc.rust-lang.org/clippy/installation.html)")

endif

#########
# Build #
#########

lint: check-cargo-clippy ## Run code lint

	$(CARGO) fmt --all --check

	$(CARGO) clippy --all-features --all-targets --workspace


build: ## Build wadm

	$(CARGO) build --bin wadm --features cli


build-docker: ## Build wadm docker image

    ifndef BIN_AMD64
        $(error BIN_AMD64 is not set, required for docker building)

    endif

    ifndef BIN_ARM64

        $(error BIN_ARM64 is not set, required for docker building)

    endif


	$(DOCKER) buildx build --platform linux/amd64,linux/arm64 \
		--build-arg BIN_AMD64=$(BIN_AMD64) \

		--build-arg BIN_ARM64=$(BIN_ARM64) \

		-t $(WADM_TAG) \
		--push .


########
# Test #
########

# An optional specific test for cargo to target

CARGO_TEST_TARGET ?=

test:: ## Run tests

ifeq ($(shell nc -czt -w1 127.0.0.1 4222 || echo fail),fail)
	$(DOCKER) run --rm -d --name wadm-test -p 127.0.0.1:4222:4222 nats:2.9 -js

	$(CARGO) test $(CARGO_TEST_TARGET) -- --nocapture

	$(DOCKER) stop wadm-test

else
	$(CARGO) test $(CARGO_TEST_TARGET) -- --nocapture

endif

test-e2e:: ## Run e2e tests

ifeq ($(shell nc -czt -w1 127.0.0.1 4222 || echo fail),fail)
	@$(MAKE) build

	RUST_BACKTRACE=1 $(CARGO) test --test e2e_multitenant --features _e2e_tests --  --nocapture 

	RUST_BACKTRACE=1 $(CARGO) test --test e2e_multiple_hosts --features _e2e_tests --  --nocapture 

	RUST_BACKTRACE=1 $(CARGO) test --test e2e_upgrades --features _e2e_tests --  --nocapture 

else
	@echo "WARN: Not running e2e tests. NATS must not be currently running"

	exit 1

endif

test-individual-e2e:: ## Runs an individual e2e test based on the WADM_E2E_TEST env var

ifeq ($(shell nc -czt -w1 127.0.0.1 4222 || echo fail),fail)
	@$(MAKE) build

	RUST_BACKTRACE=1 $(CARGO) test --test $(WADM_E2E_TEST) --features _e2e_tests --  --nocapture 

else
	@echo "WARN: Not running e2e tests. NATS must not be currently running"

	exit 1

endif

###########
# Cleanup #
###########

stream-cleanup: ## Removes all streams that wadm creates

	-$(NATS) stream del wadm_commands --force

	-$(NATS) stream del wadm_events --force

	-$(NATS) stream del wadm_notify --force

	-$(NATS) stream del wadm_mirror --force

	-$(NATS) stream del wadm_multitenant_mirror --force

	-$(NATS) stream del wadm_status --force

	-$(NATS) stream del KV_wadm_state --force

	-$(NATS) stream del KV_wadm_manifests --force


.PHONY: check-cargo-clippy lint build build-watch test stream-cleanup clean test-e2e test