rustfs/Makefile

###########
# Remote development requires VSCode with Dev Containers, Remote SSH, Remote Explorer
# https://code.visualstudio.com/docs/remote/containers
###########
DOCKER_CLI ?= docker
IMAGE_NAME ?= rustfs:v1.0.0
CONTAINER_NAME ?= rustfs-dev
# Docker build configurations
DOCKERFILE_PRODUCTION = Dockerfile
DOCKERFILE_SOURCE = Dockerfile.source

# Code quality and formatting targets
.PHONY: fmt
fmt:
	@echo "🔧 Formatting code..."
	cargo fmt --all

.PHONY: fmt-check
fmt-check:
	@echo "📝 Checking code formatting..."
	cargo fmt --all --check

.PHONY: clippy
clippy:
	@echo "🔍 Running clippy checks..."
	cargo clippy --fix --allow-dirty 
	cargo clippy --all-targets --all-features -- -D warnings

.PHONY: check
check:
	@echo "🔨 Running compilation check..."
	cargo check --all-targets

.PHONY: test
test:
	@echo "🧪 Running tests..."
	cargo nextest run --all --exclude e2e_test
	cargo test --all --doc

.PHONY: pre-commit
pre-commit: fmt clippy check test
	@echo "✅ All pre-commit checks passed!"

.PHONY: setup-hooks
setup-hooks:
	@echo "🔧 Setting up git hooks..."
	chmod +x .git/hooks/pre-commit
	@echo "✅ Git hooks setup complete!"

.PHONY: e2e-server
e2e-server:
	sh $(shell pwd)/scripts/run.sh

.PHONY: probe-e2e
probe-e2e:
	sh $(shell pwd)/scripts/probe.sh

# Native build using build-rustfs.sh script
.PHONY: build
build:
	@echo "🔨 Building RustFS using build-rustfs.sh script..."
	./build-rustfs.sh

.PHONY: build-dev
build-dev:
	@echo "🔨 Building RustFS in development mode..."
	./build-rustfs.sh --dev

# Docker-based build (alternative approach)
# Usage: make BUILD_OS=ubuntu22.04 build-docker
# Output: target/ubuntu22.04/release/rustfs
BUILD_OS ?= rockylinux9.3
.PHONY: build-docker
build-docker: SOURCE_BUILD_IMAGE_NAME = rustfs-$(BUILD_OS):v1
build-docker: SOURCE_BUILD_CONTAINER_NAME = rustfs-$(BUILD_OS)-build
build-docker: BUILD_CMD = /root/.cargo/bin/cargo build --release --bin rustfs --target-dir /root/s3-rustfs/target/$(BUILD_OS)
build-docker:
	@echo "🐳 Building RustFS using Docker ($(BUILD_OS))..."
	$(DOCKER_CLI) buildx build -t $(SOURCE_BUILD_IMAGE_NAME) -f $(DOCKERFILE_SOURCE) .
	$(DOCKER_CLI) run --rm --name $(SOURCE_BUILD_CONTAINER_NAME) -v $(shell pwd):/root/s3-rustfs -it $(SOURCE_BUILD_IMAGE_NAME) $(BUILD_CMD)

.PHONY: build-musl
build-musl:
	@echo "🔨 Building rustfs for x86_64-unknown-linux-musl..."
	@echo "💡 On macOS/Windows, use 'make build-docker' or 'make docker-dev' instead"
	./build-rustfs.sh --platform x86_64-unknown-linux-musl

.PHONY: build-gnu
build-gnu:
	@echo "🔨 Building rustfs for x86_64-unknown-linux-gnu..."
	@echo "💡 On macOS/Windows, use 'make build-docker' or 'make docker-dev' instead"
	./build-rustfs.sh --platform x86_64-unknown-linux-gnu

.PHONY: build-musl-arm64
build-musl-arm64:
	@echo "🔨 Building rustfs for aarch64-unknown-linux-musl..."
	@echo "💡 On macOS/Windows, use 'make build-docker' or 'make docker-dev' instead"
	./build-rustfs.sh --platform aarch64-unknown-linux-musl

.PHONY: build-gnu-arm64
build-gnu-arm64:
	@echo "🔨 Building rustfs for aarch64-unknown-linux-gnu..."
	@echo "💡 On macOS/Windows, use 'make build-docker' or 'make docker-dev' instead"
	./build-rustfs.sh --platform aarch64-unknown-linux-gnu

.PHONY: deploy-dev
deploy-dev: build-musl
	@echo "🚀 Deploying to dev server: $${IP}"
	./scripts/dev_deploy.sh $${IP}

# ========================================================================================
# Docker Multi-Architecture Builds (Primary Methods)
# ========================================================================================

# Production builds using docker-buildx.sh (for CI/CD and production)
.PHONY: docker-buildx
docker-buildx:
	@echo "🏗️ Building multi-architecture production Docker images with buildx..."
	./docker-buildx.sh

.PHONY: docker-buildx-push
docker-buildx-push:
	@echo "🚀 Building and pushing multi-architecture production Docker images with buildx..."
	./docker-buildx.sh --push

.PHONY: docker-buildx-version
docker-buildx-version:
	@if [ -z "$(VERSION)" ]; then \
		echo "❌ Error: Please specify version, example: make docker-buildx-version VERSION=v1.0.0"; \
		exit 1; \
	fi
	@echo "🏗️ Building multi-architecture production Docker images (version: $(VERSION))..."
	./docker-buildx.sh --release $(VERSION)

.PHONY: docker-buildx-push-version
docker-buildx-push-version:
	@if [ -z "$(VERSION)" ]; then \
		echo "❌ Error: Please specify version, example: make docker-buildx-push-version VERSION=v1.0.0"; \
		exit 1; \
	fi
	@echo "🚀 Building and pushing multi-architecture production Docker images (version: $(VERSION))..."
	./docker-buildx.sh --release $(VERSION) --push

# Development/Source builds using direct buildx commands
.PHONY: docker-dev
docker-dev:
	@echo "🏗️ Building multi-architecture development Docker images with buildx..."
	@echo "💡 This builds from source code and is intended for local development and testing"
	@echo "⚠️  Multi-arch images cannot be loaded locally, use docker-dev-push to push to registry"
	$(DOCKER_CLI) buildx build \
		--platform linux/amd64,linux/arm64 \
		--file $(DOCKERFILE_SOURCE) \
		--tag rustfs:source-latest \
		--tag rustfs:dev-latest \
		.

.PHONY: docker-dev-local
docker-dev-local:
	@echo "🏗️ Building single-architecture development Docker image for local use..."
	@echo "💡 This builds from source code for the current platform and loads locally"
	$(DOCKER_CLI) buildx build \
		--file $(DOCKERFILE_SOURCE) \
		--tag rustfs:source-latest \
		--tag rustfs:dev-latest \
		--load \
		.

.PHONY: docker-dev-push
docker-dev-push:
	@if [ -z "$(REGISTRY)" ]; then \
		echo "❌ Error: Please specify registry, example: make docker-dev-push REGISTRY=ghcr.io/username"; \
		exit 1; \
	fi
	@echo "🚀 Building and pushing multi-architecture development Docker images..."
	@echo "💡 Pushing to registry: $(REGISTRY)"
	$(DOCKER_CLI) buildx build \
		--platform linux/amd64,linux/arm64 \
		--file $(DOCKERFILE_SOURCE) \
		--tag $(REGISTRY)/rustfs:source-latest \
		--tag $(REGISTRY)/rustfs:dev-latest \
		--push \
		.



# Local production builds using direct buildx (alternative to docker-buildx.sh)
.PHONY: docker-buildx-production-local
docker-buildx-production-local:
	@echo "🏗️ Building single-architecture production Docker image locally..."
	@echo "💡 Alternative to docker-buildx.sh for local testing"
	$(DOCKER_CLI) buildx build \
		--file $(DOCKERFILE_PRODUCTION) \
		--tag rustfs:production-latest \
		--tag rustfs:latest \
		--load \
		--build-arg RELEASE=latest \
		.

# ========================================================================================
# Single Architecture Docker Builds (Traditional)
# ========================================================================================

.PHONY: docker-build-production
docker-build-production:
	@echo "🏗️ Building single-architecture production Docker image..."
	@echo "💡 Consider using 'make docker-buildx-production-local' for multi-arch support"
	$(DOCKER_CLI) build -f $(DOCKERFILE_PRODUCTION) -t rustfs:latest .

.PHONY: docker-build-source
docker-build-source:
	@echo "🏗️ Building single-architecture source Docker image..."
	@echo "💡 Consider using 'make docker-dev-local' for multi-arch support"
	$(DOCKER_CLI) build -f $(DOCKERFILE_SOURCE) -t rustfs:source .

# ========================================================================================
# Development Environment
# ========================================================================================

.PHONY: dev-env-start
dev-env-start:
	@echo "🚀 Starting development environment..."
	$(DOCKER_CLI) buildx build \
		--file $(DOCKERFILE_SOURCE) \
		--tag rustfs:dev \
		--load \
		.
	$(DOCKER_CLI) stop $(CONTAINER_NAME) 2>/dev/null || true
	$(DOCKER_CLI) rm $(CONTAINER_NAME) 2>/dev/null || true
	$(DOCKER_CLI) run -d --name $(CONTAINER_NAME) \
		-p 9010:9010 -p 9000:9000 \
		-v $(shell pwd):/workspace \
		-it rustfs:dev

.PHONY: dev-env-stop
dev-env-stop:
	@echo "🛑 Stopping development environment..."
	$(DOCKER_CLI) stop $(CONTAINER_NAME) 2>/dev/null || true
	$(DOCKER_CLI) rm $(CONTAINER_NAME) 2>/dev/null || true

.PHONY: dev-env-restart
dev-env-restart: dev-env-stop dev-env-start



# ========================================================================================
# Build Utilities
# ========================================================================================

.PHONY: docker-inspect-multiarch
docker-inspect-multiarch:
	@if [ -z "$(IMAGE)" ]; then \
		echo "❌ Error: Please specify image, example: make docker-inspect-multiarch IMAGE=rustfs/rustfs:latest"; \
		exit 1; \
	fi
	@echo "🔍 Inspecting multi-architecture image: $(IMAGE)"
	docker buildx imagetools inspect $(IMAGE)

.PHONY: build-cross-all
build-cross-all:
	@echo "🔧 Building all target architectures..."
	@echo "💡 On macOS/Windows, use 'make docker-dev' for reliable multi-arch builds"
	@echo "🔨 Generating protobuf code..."
	cargo run --bin gproto || true
	@echo "🔨 Building x86_64-unknown-linux-gnu..."
	./build-rustfs.sh --platform x86_64-unknown-linux-gnu
	@echo "🔨 Building aarch64-unknown-linux-gnu..."
	./build-rustfs.sh --platform aarch64-unknown-linux-gnu
	@echo "🔨 Building x86_64-unknown-linux-musl..."
	./build-rustfs.sh --platform x86_64-unknown-linux-musl
	@echo "🔨 Building aarch64-unknown-linux-musl..."
	./build-rustfs.sh --platform aarch64-unknown-linux-musl
	@echo "✅ All architectures built successfully!"

# ========================================================================================
# Help and Documentation
# ========================================================================================

.PHONY: help-build
help-build:
	@echo "🔨 RustFS Build Help:"
	@echo ""
	@echo "🚀 Local Build (Recommended):"
	@echo "  make build                               # Build RustFS binary (includes console by default)"
	@echo "  make build-dev                           # Development mode build"
	@echo "  make build-musl                          # Build x86_64 musl version"
	@echo "  make build-gnu                           # Build x86_64 GNU version"
	@echo "  make build-musl-arm64                    # Build aarch64 musl version"
	@echo "  make build-gnu-arm64                     # Build aarch64 GNU version"
	@echo ""
	@echo "🐳 Docker Build:"
	@echo "  make build-docker                        # Build using Docker container"
	@echo "  make build-docker BUILD_OS=ubuntu22.04   # Specify build system"
	@echo ""
	@echo "🏗️ Cross-architecture Build:"
	@echo "  make build-cross-all                     # Build binaries for all architectures"
	@echo ""
	@echo "🔧 Direct usage of build-rustfs.sh script:"
	@echo "  ./build-rustfs.sh --help                 # View script help"
	@echo "  ./build-rustfs.sh --no-console           # Build without console resources"
	@echo "  ./build-rustfs.sh --force-console-update # Force update console resources"
	@echo "  ./build-rustfs.sh --dev                  # Development mode build"
	@echo "  ./build-rustfs.sh --sign                 # Sign binary files"
	@echo "  ./build-rustfs.sh --platform x86_64-unknown-linux-gnu   # Specify target platform"
	@echo "  ./build-rustfs.sh --skip-verification    # Skip binary verification"
	@echo ""
	@echo "💡 build-rustfs.sh script provides more options, smart detection and binary verification"

.PHONY: help-docker
help-docker:
	@echo "🐳 Docker Multi-architecture Build Help:"
	@echo ""
	@echo "🚀 Production Image Build (Recommended to use docker-buildx.sh):"
	@echo "  make docker-buildx                       # Build production multi-arch image (no push)"
	@echo "  make docker-buildx-push                  # Build and push production multi-arch image"
	@echo "  make docker-buildx-version VERSION=v1.0.0        # Build specific version"
	@echo "  make docker-buildx-push-version VERSION=v1.0.0   # Build and push specific version"
	@echo ""
	@echo "🔧 Development/Source Image Build (Local development testing):"
	@echo "  make docker-dev                          # Build dev multi-arch image (cannot load locally)"
	@echo "  make docker-dev-local                    # Build dev single-arch image (local load)"
	@echo "  make docker-dev-push REGISTRY=xxx       # Build and push dev image"
	@echo ""
	@echo "🏗️ Local Production Image Build (Alternative):"
	@echo "  make docker-buildx-production-local      # Build production single-arch image locally"
	@echo ""
	@echo "📦 Single-architecture Build (Traditional way):"
	@echo "  make docker-build-production             # Build single-arch production image"
	@echo "  make docker-build-source                 # Build single-arch source image"
	@echo ""
	@echo "🚀 Development Environment Management:"
	@echo "  make dev-env-start                       # Start development container environment"
	@echo "  make dev-env-stop                        # Stop development container environment"
	@echo "  make dev-env-restart                     # Restart development container environment"
	@echo ""
	@echo "🔧 Auxiliary Tools:"
	@echo "  make build-cross-all                     # Build binaries for all architectures"
	@echo "  make docker-inspect-multiarch IMAGE=xxx  # Check image architecture support"
	@echo ""
	@echo "📋 Environment Variables:"
	@echo "  REGISTRY          Image registry address (required for push)"
	@echo "  DOCKERHUB_USERNAME    Docker Hub username"
	@echo "  DOCKERHUB_TOKEN       Docker Hub access token"
	@echo "  GITHUB_TOKEN          GitHub access token"
	@echo ""
	@echo "💡 Suggestions:"
	@echo "  - Production use: Use docker-buildx* commands (based on precompiled binaries)"
	@echo "  - Local development: Use docker-dev* commands (build from source)"
	@echo "  - Development environment: Use dev-env-* commands to manage dev containers"

.PHONY: help
help:
	@echo "🦀 RustFS Makefile Help:"
	@echo ""
	@echo "📋 Main Command Categories:"
	@echo "  make help-build                          # Show build-related help"
	@echo "  make help-docker                         # Show Docker-related help"
	@echo ""
	@echo "🔧 Code Quality:"
	@echo "  make fmt                                 # Format code"
	@echo "  make clippy                              # Run clippy checks"
	@echo "  make test                                # Run tests"
	@echo "  make pre-commit                          # Run all pre-commit checks"
	@echo ""
	@echo "🚀 Quick Start:"
	@echo "  make build                               # Build RustFS binary"
	@echo "  make docker-dev-local                    # Build development Docker image (local)"
	@echo "  make dev-env-start                       # Start development environment"
	@echo ""
	@echo "💡 For more help use 'make help-build' or 'make help-docker'"