chore: avoid double slashes in URL (#80)

Signed-off-by: Paulo Rego <[email protected]>

Signed-off-by: Andy Stoneberg <[email protected]>

Author: paulovmr

developing/.gitignore

@@ -0,0 +1,7 @@
+# Binaries for programs and plugins
+*.exe
+*.exe~
+*.dll
+*.so
+*.dylib
+bin/*

workspaces/developing/DEVELOPMENT.md renamed to developing/DEVELOPMENT.md

@@ -43,9 +43,9 @@ node --version
 npm --version
 ```
 
-### Install Kind (Optional)
+### Install Kind
 
-**Note**: Tilt will automatically create a Kind cluster named `tilt` if it doesn't exist. However, you still need to have `kind` installed.
+**Note**: The Makefile will automatically create a Kind cluster named `tilt` if it doesn't exist. However, you still need to have `kind` installed.
 
 ```bash
 # macOS
@@ -54,21 +54,38 @@ brew install kind
 # Or follow instructions at: https://kind.sigs.k8s.io/docs/user/quick-start/#installation
 ```
 
-**Alternative**: If you prefer to use a different Kubernetes cluster (Docker Desktop, Minikube, etc.), you can skip Kind installation. Just ensure your cluster is running and `kubectl` is configured to use it. Tilt will detect and use your current `kubectl` context.
+
+### Using Kind Provider (Optional)
+
+You can choose to set the `KIND_EXPERIMENTAL_PROVIDER` environment variable in your shell session:
+
+```bash
+export KIND_EXPERIMENTAL_PROVIDER=podman
+```
+
+The Makefile will honor this environment variable when creating the Kind cluster.
 
 ## Quick Start
 
 1. **Navigate to the developing directory**:
    ```bash
-   cd workspaces/developing
+   cd developing
    ```
 
-2. **Start Tilt**:
+2. **Start Tilt using the Makefile**:
    ```bash
-   tilt up
+   make tilt
    ```
 
+   **Important**: Always use `make tilt` instead of running `tilt up` directly. The Makefile ensures:
+   - The Kind cluster exists and is properly configured
+   - The Kubernetes context is switched to `kind-tilt`
+   - Cert-manager is installed (required for webhooks)
+   - All prerequisites are met before Tilt starts
+
    This will:
+   - Set up the Kind cluster (if it doesn't exist)
+   - Install cert-manager
    - Open the Tilt UI in your browser (usually http://localhost:10350)
    - Build the controller and backend Docker images
    - Deploy them to your Kubernetes cluster
@@ -80,22 +97,20 @@ brew install kind
 
    Watch the Tilt UI in your browser. You should see:
 
-   1. **Setup Resources** (one-time setup):
-      - `setup-kind` - Creating/verifying Kind cluster (if using Kind)
-      - `setup-cert-manager` - Installing cert-manager (required for webhooks)
-      - `install-crds` - Installing CRDs
-
-   2. **Local Resources**:
+   1. **Local Resources**:
       - `controller-generate` - Generating manifests and code
+      - `install-crds` - Installing CRDs
       - `workspaces-frontend` - Running webpack dev server (if enabled)
 
-   3. **Docker Resources** (building images):
+   2. **Docker Resources** (building images):
       - `workspaces-controller`
       - `workspaces-backend`
 
-   4. **Kubernetes Resources** (deploying):
+   3. **Kubernetes Resources** (deploying):
       - Deployments, Services, etc.
 
+   **Note**: The Kind cluster and cert-manager setup are handled by the Makefile before Tilt starts, so you won't see those as Tilt resources.
+
    Wait until all resources show green/healthy status.
 
 5. **Access the componenets**:
@@ -107,6 +122,8 @@ brew install kind
    ```bash
    # In the terminal where Tilt is running, press Ctrl+C
    # Or in another terminal:
+   make tilt-down
+   # Or:
    tilt down
    ```
 
@@ -128,12 +145,22 @@ kind delete cluster --name tilt
 
 ## Configuration
 
+### Makefile Targets
+
+The Makefile provides several targets for managing your development environment:
+
+- `make tilt` or `make` - Set up Kind cluster, install cert-manager, and start Tilt
+- `make tilt-up` - Alias for `make tilt`
+- `make tilt-down` - Stop Tilt
+- `make setup-kind` - Set up the Kind cluster only (without starting Tilt)
+- `make setup-cert-manager` - Install cert-manager only (requires Kind cluster)
+
 ### Skipping Frontend
 
 To run Tilt without the frontend (useful for backend/controller-only development):
 
 ```bash
-ENABLE_FRONTEND=false tilt up
+ENABLE_FRONTEND=false make tilt
 ```
 
 ### Custom Ports
@@ -206,21 +233,32 @@ export DOCKER_BUILDKIT=0
 
 ### Kubernetes Connection Issues
 
-Ensure:
-- `kubectl` is configured correctly (`kubectl cluster-info`)
-- Your cluster is running and accessible
-- You have permissions to create resources in the `kubeflow-workspaces` namespace
+The Makefile automatically handles context switching to `kind-tilt`. If you encounter issues:
 
-```bash
-# Verify cluster is accessible
-kubectl cluster-info
+1. **Verify the Kind cluster exists**:
+   ```bash
+   kind get clusters
+   ```
 
-# Check current context
-kubectl config current-context
+2. **Check the current context**:
+   ```bash
+   kubectl config current-context
+   # Should be: kind-tilt
+   ```
 
-# List available contexts
-kubectl config get-contexts
-```
+3. **If context is wrong, manually switch**:
+   ```bash
+   kubectl config use-context kind-tilt
+   ```
+
+4. **Verify cluster is accessible**:
+   ```bash
+   kubectl cluster-info
+   ```
+
+5. **Ensure you have permissions** to create resources in the `kubeflow-workspaces` namespace
+
+**Note**: If you're running `tilt up` directly (not via `make tilt`), you may be on the wrong Kubernetes context. Always use `make tilt` to ensure the correct context is set.
 
 ### Port Already in Use
 
@@ -262,5 +300,6 @@ Also check that you have cluster-admin permissions or appropriate RBAC.
    - Node modules: `npm ci` in frontend
 
 3. **Clean up resources**:
-   - Always run `tilt down` when done
+   - Always run `make tilt-down` (or `tilt down`) when done
    - Optionally: `kubectl delete namespace kubeflow-workspaces`
+   - Optionally: `kind delete cluster --name tilt` to remove the Kind cluster

developing/Makefile

@@ -0,0 +1,77 @@
+.PHONY: check-tilt tilt-up tilt-down setup-kind setup-cert-manager kustomize
+
+# Variables
+CLUSTER_NAME := tilt
+KIND_CONTEXT := kind-$(CLUSTER_NAME)
+
+# Location to install dependencies to
+LOCALBIN ?= $(shell pwd)/bin
+$(LOCALBIN):
+	mkdir -p $(LOCALBIN)
+
+# Tool Binaries
+KUSTOMIZE ?= $(LOCALBIN)/kustomize
+
+# Tool Versions
+KUSTOMIZE_VERSION ?= v5.5.0
+
+# Export KIND_EXPERIMENTAL_PROVIDER to honor it if set in user's environment
+# (e.g., KIND_EXPERIMENTAL_PROVIDER=podman for podman support)
+export KIND_EXPERIMENTAL_PROVIDER
+
+# Check if tilt is installed
+.PHONY: check-tilt
+check-tilt:
+	@if ! command -v tilt >/dev/null 2>&1; then \
+		echo "ERROR: tilt is not installed. Please install tilt first:"; \
+		echo "  curl -fsSL https://raw.githubusercontent.com/tilt-dev/tilt/master/scripts/install.sh | bash"; \
+		echo "  or visit: https://docs.tilt.dev/install.html"; \
+		exit 1; \
+	fi
+
+# Ensure kind cluster exists and context is set before running tilt
+setup-kind:
+	@echo "Setting up Kind cluster..."
+	@if [ -n "$$KIND_EXPERIMENTAL_PROVIDER" ]; then \
+		echo "Using KIND_EXPERIMENTAL_PROVIDER=$$KIND_EXPERIMENTAL_PROVIDER"; \
+	fi
+	@./scripts/setup-kind.sh
+
+# Install cert-manager (depends on kind cluster being set up)
+setup-cert-manager: setup-kind
+	@echo "Setting up cert-manager..."
+	@./scripts/setup-cert-manager.sh
+
+
+# Run tilt up with kind cluster and cert-manager setup
+tilt-up: check-tilt setup-cert-manager kustomize
+	@echo "Starting Tilt..."
+	@tilt up
+
+
+# Stop Tilt
+tilt-down: check-tilt kustomize
+	@echo "Stopping Tilt..."
+	@tilt down
+
+# Install kustomize
+kustomize: $(KUSTOMIZE)
+$(KUSTOMIZE): $(LOCALBIN)
+	$(call go-install-tool,$(KUSTOMIZE),sigs.k8s.io/kustomize/kustomize/v5,$(KUSTOMIZE_VERSION))
+
+# go-install-tool will 'go install' any package with custom target and name of binary, if it doesn't exist
+# $1 - target path with name of binary
+# $2 - package url which can be installed
+# $3 - specific version of package
+define go-install-tool
+@[ -f "$(1)-$(3)" ] || { \
+set -e; \
+package=$(2)@$(3) ;\
+echo "Downloading $${package}" ;\
+rm -f $(1) || true ;\
+GOBIN=$(LOCALBIN) go install $${package} ;\
+mv $(1) $(1)-$(3) ;\
+} ;\
+ln -sf $(1)-$(3) $(1)
+endef
+