Add "version lock" mechanism to proto files

Because dapr/dapr is not registered in the buf registry we can't
leverage of it's version locking capability. This should make it safe
to only pull new changes when desired for now.

Signed-off-by: Tiago Scolari <[email protected]>

Author: tscolari

.dapr-proto-ref

@@ -0,0 +1 @@
+ac5845ff5c5617c4c949c82e4e331dca5dddfc8d

Makefile

@@ -64,12 +64,21 @@ modtidy:
 
 .PHONY: proto
 proto:
-	@rm -rf ./internal/proto/*
-	@buf generate \
+	@if [ ! -f .dapr-proto-ref ]; then echo "No .dapr-proto-ref file found. Run 'make proto-update' first."; exit 1; fi
+	@find ./internal/proto -type f -name '*.go' -delete
+	@COMMIT=$$(cat .dapr-proto-ref | tr -d '\n'); \
+	buf generate \
 		--template buf.gen.yaml \
 		--path dapr/proto/common/v1 \
 		--path dapr/proto/runtime/v1 \
-		'https://github.com/dapr/dapr.git'
+		"https://github.com/dapr/dapr.git#commit=$$COMMIT"
+
+.PHONY: proto-update
+proto-update:
+	@echo "Updating Dapr to latest commit..."
+	@git ls-remote https://github.com/dapr/dapr.git HEAD | cut -f1 > .dapr-proto-ref
+	@echo "Updated .dapr-proto-ref to: $$(cat .dapr-proto-ref)"
+	@$(MAKE) proto
 
 PROTO_PATH := internal/proto
 .PHONY: proto-check-diff

internal/proto/README.md

@@ -0,0 +1,13 @@
+# Dapr Protos
+
+These are generated protos from the [Dapr](https://github.com/dapr/dapr/tree/master/dapr) repository.
+
+They are version locked using the [.dapr-proto-ref](../../.dapr-proto-ref) file.
+
+### Bumping the version of the proto files
+
+The command `make proto-update` makes it easier to bump the proto files version.
+
+### Generating protos
+
+To generate the protos, using the current locked version, use the command `make proto`