You are viewing a plain text version of this content. The canonical link for it is here.
Posted to issues@flink.apache.org by "Ryan-Nightwish (via GitHub)" <gi...@apache.org> on 2026/06/08 07:00:02 UTC
[I] [Tech Debt] Installation doc: wrong Maven version, Python 3.12 mismatch, macOS ARM64 pip failure undocumented [flink-agents]
Ryan-Nightwish opened a new issue, #801:
URL: https://github.com/apache/flink-agents/issues/801
### Search before asking
- [x] I searched in the [issues](https://github.com/apache/flink-agents/issues) and found nothing similar.
### Description
Found during get-started doc verification.
Collection of issues for `docs/content/docs/get-started/installation.md`:
1. **Maven pom.xml example uses `flink.version` `2.2`, which does not exist on Maven Central** (line 263) — the example sets `<flink.version>2.2</flink.version>`, but Maven Central only publishes `2.2.0` (`flink-streaming-java:2.2` returns HTTP 404, confirmed by querying `repo1.maven.org`). Users who copy the example verbatim will get a dependency-resolution failure. Should be `<flink.version>2.2.0</flink.version>`.
2. **`install.sh` rejects Python 3.12, but Prerequisites lists it as supported** (line 39 vs `tools/install.sh` line 1579) — the documentation states "Python 3.10, 3.11, or 3.12", but `install.sh`'s `validate_python_bin` function uses `py_minor -ge 12` which rejects Python 3.12+. Users with Python 3.12 following the Quick Install path will be told no compatible Python was found.
3. **macOS ARM64: `pip install apache-flink` fails on all installation paths, undocumented** (line 62-68 Quick Install, line 137 Manual Install) — `apache-beam` (a transitive dependency of `apache-flink`) publishes no macOS ARM64 wheels for any Python version (3.9-3.12; all macOS wheels are `x86_64`-only). On Apple Silicon, pip falls back to building from source, but pip's PEP 517 build-isolation environment downloads the latest `setuptools>=82` which removed `pkg_resources`, causing the build to fail. The project's own `setuptools<82` constraint in `pyproject.toml` ([PR #526](https://github.com/apache/flink-agents/pull/526), [issue #529](https://github.com/apache/flink-agents/issues/529)) only governs flink-agents' runtime dependencies and does not affect the isolated build environment for `apache-beam`. I tried the command`pip install "setuptools<71" && pip install --no-build-isolation apache-flink==2.2.0` to fix it.
### Where to fix
`docs/content/docs/get-started/installation.md`.
### Version and environment
Flink Agents 0.3.0 (`main`), macOS ARM64 (Apple Silicon), Python 3.11.15 / 3.12.13.
### Are you willing to submit a PR?
- [ ] I'm willing to submit a PR!
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: issues-unsubscribe@flink.apache.org.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
Re: [I] [Tech Debt] Installation doc: wrong Maven version, Python 3.12 mismatch, macOS ARM64 pip failure undocumented [flink-agents]
Posted by "wenjin272 (via GitHub)" <gi...@apache.org>.
wenjin272 closed issue #801: [Tech Debt] Installation doc: wrong Maven version, Python 3.12 mismatch, macOS ARM64 pip failure undocumented
URL: https://github.com/apache/flink-agents/issues/801
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: issues-unsubscribe@flink.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
Re: [I] [Tech Debt] Installation doc: wrong Maven version, Python 3.12 mismatch, macOS ARM64 pip failure undocumented [flink-agents]
Posted by "Ryan-Nightwish (via GitHub)" <gi...@apache.org>.
Ryan-Nightwish commented on issue #801:
URL: https://github.com/apache/flink-agents/issues/801#issuecomment-4658262026
Update on item 3: after further testing, this issue does not reproduce when following the documented From Source installation path. Running `./tools/build.sh -p` first installs `flink-agents` (along with its `setuptools<82` constraint from `pyproject.toml`) into the environment, so the subsequent `pip install apache-flink==2.2.0` builds `apache-beam` with a compatible setuptools version. The earlier failure occurred because I ran `pip install apache-flink` in a fresh venv before installing `flink-agents`, which meant the `setuptools<82` constraint was not yet in effect.
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: issues-unsubscribe@flink.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org