Expose Fleet via port-forward on port 8585 instead of fleet.localhost
- 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:
@@ -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
|
||||
|
||||
Reference in New Issue
Block a user