bitflicker64 commented on code in PR #540: URL: https://github.com/apache/hugegraph-doc/pull/540#discussion_r4307093847
########## content/cn/docs/quickstart/toolchain/hugegraph-hubble.md: ########## @@ -1,43 +1,42 @@ --- title: "使用 Hubble 实现图可视化：单机快速上手" -description: "用 Docker 启动 RocksDB Server 与 Hubble，从示例图开始理解 Schema、导入 CSV、执行 Gremlin 并查看图结果。" +description: "用 Docker 启动 RocksDB Server 与 Hubble，从示例图开始建模、导入 CSV，并用 Gremlin、Cypher 或 Text2GQL 查询图数据。" linkTitle: "Hubble 基础与单机" weight: 1 -search_keywords: [HugeGraph Hubble, 图可视化, 图形化界面, Web 管理界面, RocksDB] +search_keywords: [HugeGraph Hubble, 图可视化, 图形化界面, Web 管理界面, RocksDB, Text2GQL, 自然语言查询, Prompt] search_boost: 1.6 --- Hubble 是 HugeGraph 的 Web 管理与图可视化界面。你可以在同一个工作台中管理图的 Schema、导入数据、执行查询， -并在图、表格和 JSON 视图之间切换。本文用 **单机 RocksDB Server + Hubble** 走通这些操作，不需要 PD 或 Store。 +并在图、表格和 JSON 视图之间自由切换。本文以 **单机 RocksDB Server + Hubble** 为例走通完整操作，无需预先部署 PD 或 Store。 -如果使用 HStore，请先阅读本文的通用操作，再看 [HStore 分布式补充](/cn/docs/quickstart/toolchain/visualization/hugegraph-hubble-hstore/)。 -本文以 Toolchain `master`（当前为 `1.8.0`）为准；Docker `latest` 是可变标签，使用时应核对实际版本。 +如需搭配 HStore 分布式集群使用，可先了解本文的基础操作，再参考 [HStore 分布式补充](/cn/docs/quickstart/toolchain/visualization/hugegraph-hubble-hstore/)。 +文档内容以 Toolchain 与 Server 的 `master` 分支（当前版本均为 `1.8.0`）为准；Docker `latest` 为动态标签，实际部署建议使用固定版本。 > [!WARNING] -> 不要直接对外暴露 Hubble 或 Server。生产环境使用 HTTPS、容器部署、 -> [认证与授权](/cn/docs/config/config-authentication/)和访问白名单。 - +> 请勿将未配置防护的 Hubble 或 Server 直接暴露在公网上。生产环境请务必开启 HTTPS、容器网络隔离、 +> [认证与授权](/cn/docs/config/config-authentication/)及访问白名单。 ## 启动单机组合 -直接使用主仓库 [docker/docker-compose.yml](https://github.com/apache/hugegraph/blob/master/docker/docker-compose.yml)， -无需另外编写一份 Compose。文件已经组合了 RocksDB Server 与 Hubble，并配置网络、健康检查和数据卷； -部署细节见同目录的 [README](https://github.com/apache/hugegraph/blob/master/docker/README.md)。 +直接使用主仓库提供的 [docker/docker-compose.yml](https://github.com/apache/hugegraph/blob/master/docker/docker-compose.yml) 即可， +无需自行编写 Compose 配置文件。该文件已内置编排了 RocksDB Server 与 Hubble，并配置好网络、健康检查及持久化数据卷； +完整部署说明见同目录的 [README](https://github.com/apache/hugegraph/blob/master/docker/README.md)。 ```bash git clone --branch master --single-branch --depth 1 https://github.com/apache/hugegraph.git cd hugegraph/docker ``` -如果已有主仓库，直接进入它的 `docker/` 目录。Compose 挂载该目录下的 +若本地已有主仓库，直接进入其 `docker/` 目录即可。Compose 会自动挂载该目录下的 [`conf/hubble/standalone.properties`](https://github.com/apache/hugegraph/blob/master/docker/conf/hubble/standalone.properties)， -其中 `pd.enabled=false`、`server.direct_url=http://server:8080`：两个服务在同一 Docker 网络中通信，不需要填写每图 Server 地址。 -不要只下载 YAML 后从其他目录启动，否则相对配置文件路径可能不存在。 +已预设 `pd.enabled=false` 与 `server.direct_url=http://server:8080`。两项服务处于同一 Docker 网络中通信， +无需为每个图单独配置 Server 地址。请直接在 `docker/` 目录下启动，以确保相对配置路径有效。 -Hubble 默认只在宿主机回环地址开放 `8088`；Server 默认发布 `8080`。仅本机试用时，将 Compose 中 Server 的 -`ports` 改为 `127.0.0.1:8080:8080`，避免对其他机器开放匿名接口。 +Hubble 默认只在宿主机回环地址开放 `8088`（由 `HUBBLE_PUBLISH_HOST` 环境变量控制，默认为 `127.0.0.1`）； +Server 默认对外发布 `8080`。若仅供本机试用，可将 Compose 中 Server 的 `ports` 改为 `127.0.0.1:8080:8080`，避免匿名端口暴露到外部网络。 -为本次试用选一个未被使用的项目名，后续命令在同一终端沿用这些变量；另开终端时恢复本次项目名。 +为本次试用指定一个独立的项目名，后续命令在同一终端中沿用这些环境变量；另起终端时请重新设置： Review Comment: Minor: The old text told a reader in a new terminal to restore this trial's project name (`另开终端时恢复本次项目名`). This line now says `另起终端时请重新设置` and ends with a colon before the code block, so that reader re-runs the block. The `export` then makes a new `date`-based name, `up -d --wait` fails because the first project still holds host port `8080`, and the cleanup at line 325 (`down --volumes` on `${HUBBLE_DEMO_PROJECT:?}`) acts on the new name, leaving the original project's containers and volumes in place. The English line at `content/en/docs/quickstart/toolchain/hugegraph-hubble.md:41` dropped the sentence, so the guide no longer says how to recover the name. Please restore it in both languages: in another terminal, export the same `HUBBLE_DEMO_PROJECT` value again (run `docker compose ls` on its own to find it) instead of re-running the block. -- 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]
