Copilot commented on code in PR #501: URL: https://github.com/apache/hugegraph-doc/pull/501#discussion_r4111747513
########## content/cn/docs/quickstart/hugegraph-ai/_index.md: ########## @@ -15,15 +15,16 @@ weight: 3 - [hugegraph-python-client](https://github.com/apache/hugegraph-ai/tree/main/hugegraph-python-client)：管理 Schema、图数据和 Gremlin 查询的 Python SDK。 - [vermeer-python-client](https://github.com/apache/hugegraph-ai/tree/main/vermeer-python-client)：调用 Vermeer 图计算服务的 Python SDK。 -仓库使用 `uv` workspace，其成员是 `hugegraph-llm` 和 `hugegraph-python-client`。`hugegraph-ml` 和 `vermeer-python-client` 是可编辑的路径依赖，不在 workspace members 中。当前仓库版本为 `1.7.0`。 +仓库使用 `uv` workspace，其成员是 `hugegraph-llm` 和 `hugegraph-python-client`。`hugegraph-ml` 和 `vermeer-python-client` 是可编辑的路径依赖，不在 workspace members 中。当前仓库版本为 `1.7.0`。客户端源码目录叫 `hugegraph-python-client`，但发行包名是 `hugegraph-python`。 ## 环境要求 -- HugeGraph-LLM：Python 3.10 或 3.11（`>=3.10,<3.12`） +- HugeGraph-AI 根目录 workspace：Python 3.10 或更高版本；HugeGraph-LLM 还要求低于 3.12 - HugeGraph-ML：Python 3.10 或更高版本 -- HugeGraph Python 客户端、Vermeer Python 客户端：Python 3.9 或更高版本 +- PyPI 上的 `hugegraph-python` 1.5.0：Python 3.9 或更高版本；当前仓库源码随 workspace 使用 Python 3.10 或更高版本 +- Vermeer Python 客户端：Python 3.9 或更高版本 Review Comment: This contradicts the dedicated client page and the current source: `client.py` and `vermeer_requests.py` use PEP 604 unions such as `tuple[float, float] | None`, which Python 3.9 cannot parse. Advertising 3.9 here sends users into an immediate import-time syntax error; state Python 3.10+ consistently (while noting separately that the package metadata is stale, if useful). ########## content/cn/docs/quickstart/hugegraph/hugegraph-hstore.md: ########## @@ -70,157 +70,84 @@ mvn clean package -pl hugegraph-store/hg-store-dist -am -DskipTests #### 3.3 Docker 部署 -HugeGraph-Store Docker 镜像已发布在 Docker Hub，镜像名是 `hugegraph/store`。 +`HG_STORE_*` 环境变量映射是当前主线源码提供的功能；server 的 `1.7.0` 发布源码标签尚无这些映射。本文下面的 Docker 示例仅适用于从当前主线源码构建并使用同一个本地标签的 PD、Store 和 HStore Server 镜像： -> 注: 后续步骤皆假设你本地**已拉取** `hugegraph` 主仓库代码 (至少是 docker 目录) +```bash +# 在 hugegraph 仓库根目录执行 +docker build -f hugegraph-pd/Dockerfile -t hugegraph/pd:local . +docker build -f hugegraph-store/Dockerfile -t hugegraph/store:local . +docker build -f hugegraph-server/Dockerfile-hstore -t hugegraph/server:local . + +# 只启动 PD、Store、Server，不启动需要额外 Hubble 配置的可选 Hubble 服务 +export HG_PD_AUTH_SECRET_KEY="$(openssl rand -hex 24)" +cd docker +HUGEGRAPH_VERSION=local HUGEGRAPH_PULL_POLICY=never \ + docker compose -f docker-compose-hstore.yml \ + up -d --wait pd store server Review Comment: The generated PD secret exists only in this shell, but the next sentence requires reusing it for later restarts. Once the shell closes, Compose's required-variable expansion fails; rerunning this line generates a different secret for the existing PD data. Persist the generated value in the gitignored `docker/.env` (with restrictive permissions) and source that file before every lifecycle command, as the HA instructions already do. -- 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: [email protected] For queries about this service, please contact Infrastructure at: [email protected] --------------------------------------------------------------------- To unsubscribe, e-mail: [email protected] For additional commands, e-mail: [email protected]
