Expose Fleet via port-forward on port 8585 instead of fleet.localhost
Helm Chart CI & Release / Lint Helm Chart (push) Failing after 30s
Helm Chart CI & Release / Release Helm Chart (push) Has been skipped

- Add make port-forward target (default: https://0.0.0.0:8585)
- FLEET_PORT variable for custom port
- Update README with port-forward instructions

Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
2026-02-19 19:40:02 +00:00
parent 3ff3a30838
commit 2ae7844ab2
2 changed files with 26 additions and 27 deletions
+16 -19
View File
@@ -18,6 +18,9 @@ make install
# Verify deployment
make verify
# Access Fleet UI at https://localhost:8585
make port-forward
```
## Installation
@@ -49,23 +52,16 @@ This will:
### 3. Access Fleet UI
**Kind:**
```bash
# Add to /etc/hosts (or equivalent)
echo "127.0.0.1 fleet.localhost" | sudo tee -a /etc/hosts
# Port-forward Fleet to https://localhost:8585
make port-forward
# Access via ingress (ensure ingress-nginx is ready)
curl -H "Host: fleet.localhost" http://localhost
# Or open http://localhost in a browser with Host: fleet.localhost
# Or use a custom port
make port-forward FLEET_PORT=9090
```
**Minikube:**
```bash
minikube tunnel
# Then add fleet.localhost to /etc/hosts pointing to minikube IP
```
Open **https://localhost:8585** in your browser (accept the self-signed certificate).
Fleet setup wizard will guide you through initial configuration.
## Teardown
@@ -87,7 +83,7 @@ Verification checklist:
| Component | Check |
| ----------- | ----------------------------------------------------------------- |
| **FleetDM** | Pods running; ingress `fleet.localhost` serves Fleet UI |
| **FleetDM** | Pods running; `make port-forward` → https://localhost:8585 |
| **MySQL** | `fleetdm-stack-mysql` service; Fleet connects and runs migrations |
| **Redis** | `fleetdm-stack-redis-master` service; Fleet uses it for cache |
@@ -129,17 +125,18 @@ For local development, the chart includes self-signed TLS certificates (generate
## FleetDM agent reachability
The chart exposes Fleet via ingress so:
Fleet is exposed via port-forward (`make port-forward`) or ingress:
- **Fleet UI** is available at `http://fleet.localhost`
- **Agent endpoints** (`/api/v1/osquery/*`, `/api/fleet/orbit/*`, etc.) are reachable under the same host
- **Fleet UI** `https://localhost:8585` (via port-forward)
- **Agent endpoints** (`/api/v1/osquery/*`, `/api/fleet/orbit/*`) — same URL
- Ingress with `fleet.localhost` is also configured as a fallback
For production, configure TLS and ensure agents can reach the Fleet server hostname.
For production, configure proper TLS and a stable DNS name for agents.
## Enhancements implemented
1. **Basic CI pipeline** — GitHub Actions releases new Helm chart versions (see [.github/workflows/release.yaml](.github/workflows/release.yaml))
2. **Exposed Fleet UI**Ingress with `fleet.localhost` for UI and agent enrollment
2. **Exposed Fleet UI**`make port-forward` on port 8585 (+ ingress `fleet.localhost`)
3. **`fleet prepare db`** — Handled by `autoApplySQLMigrations: true` in the Fleet Helm chart
## Project Structure