Skip to content

feat!: pyfly management port (app 8080 / mgmt 9090); pyfly from GitHub v26.06.103 - #34

Merged
ancongui merged 1 commit into
mainfrom
feat/pyfly-mgmt-ports-8080-9090
Jun 15, 2026
Merged

feat!: pyfly management port (app 8080 / mgmt 9090); pyfly from GitHub v26.06.103#34
ancongui merged 1 commit into
mainfrom
feat/pyfly-mgmt-ports-8080-9090

Conversation

@ancongui

Copy link
Copy Markdown
Contributor

What & why

Adopts pyfly v26.06.103's separate management port and standardises flydocs on the canonical ports 8080 (business API) + 9090 (management).

Breaking changes

  • Business API: 84008080 (pyfly.server.port).
  • Actuator (/actuator/*) + admin (/admin) → management port 9090 (pyfly.management.server.port). Health checks, Kubernetes probes and Prometheus must target :9090. Set PYFLY_MANAGEMENT_SERVER_PORT=8080 to collapse back to a single port.

Changes

  • Dependency: pyfly now consumed from git tag v26.06.103 (was a local editable path), matching the fireflyframework-agentic pattern; floor >=26.6.103. uv resolves it from GitHub (the vendoring sed no-ops on a git source, exactly like agentic).
  • Runtime: pyfly.yaml (server.port: 8080, management.server.port: 9090), config.py (port=8080, worker_health_port=9090), main.py (pyfly.web.hostpyfly.server.host).
  • Docker: EXPOSE 8080 9090; compose maps both for the API and each worker's management port (9091/9092); all healthchecks probe :9090/actuator/health/readiness.
  • Python SDK: optional management_url so health() targets :9090 (back-compatible; unset → base_url).
  • Sweep: 8400→8080 / actuator→9090 across docs, Python+Java SDK docs/examples, and scripts (~35 files).

Verification

Local gate green: ruff check + ruff format --check, pyright (0 errors), unit suite 292 passed, Python SDK suite 156 passed. pyfly verified installing from git+…@v26.06.103.

Ships as v26.6.10.

…y from GitHub v26.06.103

BREAKING: business API moves 8400 -> 8080 (pyfly.server.port); actuator (/actuator/*)
and admin (/admin) now serve on the separate management port 9090
(pyfly.management.server.port). Healthchecks/K8s probes/Prometheus target 9090.

- pyfly consumed from git tag v26.06.103 (was local editable path); floor >=26.6.103.
- pyfly.yaml/config.py/env default to 8080; management.server.port: 9090; worker
  health server defaults to 9090. Dockerfile EXPOSE 8080 9090; compose maps both
  for the API + worker management ports (9091/9092); all healthchecks -> 9090.
- main.py: pyfly.web.host -> pyfly.server.host.
- Python SDK: optional management_url so health() targets :9090 (back-compatible).
- Full 8400->8080 / actuator->9090 sweep across docs, Python+Java SDK docs/examples,
  scripts. Release v26.6.10.
@ancongui
ancongui merged commit ad9f92c into main Jun 15, 2026
8 checks passed
@ancongui
ancongui deleted the feat/pyfly-mgmt-ports-8080-9090 branch June 15, 2026 16:52
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant