Skip to content

Commit c0220c7

Browse files
authored
docs: enhance docker instruction with auth opened graph (#2881)
1 parent bc7fb1f commit c0220c7

File tree

2 files changed

+34
-37
lines changed

2 files changed

+34
-37
lines changed

README.md

Lines changed: 15 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -15,12 +15,11 @@
1515

1616
## What is Apache HugeGraph?
1717

18-
[HugeGraph](https://hugegraph.apache.org/) is a fast and highly-scalable [graph database](https://en.wikipedia.org/wiki/Graph_database).
19-
Billions of vertices and edges can be easily stored into and queried from HugeGraph due to its excellent OLTP capabilities.
20-
HugeGraph is compliant with the [Apache TinkerPop 3](https://tinkerpop.apache.org/) framework allowing complicated graph queries to be
18+
[HugeGraph](https://hugegraph.apache.org/) is a fast and highly-scalable [graph database](https://en.wikipedia.org/wiki/Graph_database).
19+
Billions of vertices and edges can be easily stored into and queried from HugeGraph due to its excellent OLTP capabilities.
20+
HugeGraph is compliant with the [Apache TinkerPop 3](https://tinkerpop.apache.org/) framework allowing complicated graph queries to be
2121
achieved through the powerful [Gremlin](https://tinkerpop.apache.org/gremlin.html) graph traversal language.
2222

23-
2423
## Features
2524

2625
- Compliant to [Apache TinkerPop 3](https://tinkerpop.apache.org/), supports [Gremlin](https://tinkerpop.apache.org/gremlin.html) & [Cypher](https://en.wikipedia.org/wiki/Cypher) language
@@ -30,7 +29,6 @@ achieved through the powerful [Gremlin](https://tinkerpop.apache.org/gremlin.htm
3029
- Integration with `Flink/Spark/HDFS`, and friendly to connect other big data platforms
3130
- Complete graph ecosystem (including both in/out-memory `Graph Computing` + `Graph Visualization & Tools` + `Graph Learning & AI`, see [here](#3-build-from-source))
3231

33-
3432
## Quick Start
3533

3634
### 1. Docker (For Test)
@@ -39,9 +37,9 @@ Use Docker to quickly start a HugeGraph server with `RocksDB` (in the background
3937

4038
```
4139
# (Optional)
42-
# 1. add "-e PASSWORD=xxx" to enable the auth system
40+
# 1. remove "-e PASSWORD=xxx" to disable the auth system
4341
# 2. add "-e PRELOAD=true" to auto-load a sample graph
44-
docker run -itd --name=graph -p 8080:8080 hugegraph/hugegraph:1.5.0
42+
docker run -itd --name=graph -e PASSWORD=xxx -p 8080:8080 hugegraph/hugegraph:1.5.0
4543
```
4644

4745
Please visit [doc page](https://hugegraph.apache.org/docs/quickstart/hugegraph-server/#3-deploy) or
@@ -53,20 +51,21 @@ the [README](hugegraph-server/hugegraph-dist/docker/README.md) for more details.
5351
5452
### 2. Download
5553

56-
Visit [Download Page](https://hugegraph.apache.org/docs/download/download/) and refer the [doc](https://hugegraph.apache.org/docs/quickstart/hugegraph-server/#32-download-the-binary-tar-tarball)
54+
Visit [Download Page](https://hugegraph.apache.org/docs/download/download/) and refer the [doc](https://hugegraph.apache.org/docs/quickstart/hugegraph-server/#32-download-the-binary-tar-tarball)
5755
to download the latest release package and start the server.
5856

59-
**Note:** if you want to use it in the production environment or expose it to the public network, must enable the [AuthSystem](https://hugegraph.apache.org/docs/config/config-authentication/) to ensure safe.
57+
**Note:** if you want to use it in the production environment or expose it to the public network, must enable the [AuthSystem](https://hugegraph.apache.org/docs/config/config-authentication/) to ensure safe.
6058

6159
### 3. Build From Source
6260

63-
Visit [Build From Source Page](https://hugegraph.apache.org/docs/quickstart/hugegraph-server/#33-source-code-compilation) and follow the
61+
Visit [Build From Source Page](https://hugegraph.apache.org/docs/quickstart/hugegraph-server/#33-source-code-compilation) and follow the
6462
steps to build the source code and start the server.
6563

6664
The project [doc page](https://hugegraph.apache.org/docs/) contains more information on HugeGraph
6765
and provides detailed documentation for users. (Structure / Usage / API / Configs...)
6866

6967
And here are links of other **HugeGraph** component/repositories:
68+
7069
1. [hugegraph-toolchain](https://github.com/apache/hugegraph-toolchain) (graph tools **[loader](https://github.com/apache/hugegraph-toolchain/tree/master/hugegraph-loader)/[dashboard](https://github.com/apache/hugegraph-toolchain/tree/master/hugegraph-hubble)/[tool](https://github.com/apache/hugegraph-toolchain/tree/master/hugegraph-tools)/[client](https://github.com/apache/hugegraph-toolchain/tree/master/hugegraph-client)**)
7170
2. [hugegraph-computer](https://github.com/apache/hugegraph-computer) (integrated **graph computing** system)
7271
3. [hugegraph-ai](https://github.com/apache/incubator-hugegraph-ai) (integrated **Graph AI/LLM/KG** system)
@@ -76,30 +75,27 @@ And here are links of other **HugeGraph** component/repositories:
7675

7776
HugeGraph is licensed under [Apache 2.0 License](LICENSE).
7877

79-
8078
## Contributing
8179

82-
- Welcome to contribute to HugeGraph, please see [`How to Contribute`](CONTRIBUTING.md) & [Guidelines](https://hugegraph.apache.org/docs/contribution-guidelines/) for more information.
83-
- Note: It's recommended to use [GitHub Desktop](https://desktop.github.com/) to greatly simplify the PR and commit process.
80+
- Welcome to contribute to HugeGraph, please see [`How to Contribute`](CONTRIBUTING.md) & [Guidelines](https://hugegraph.apache.org/docs/contribution-guidelines/) for more information.
81+
- Note: It's recommended to use [GitHub Desktop](https://desktop.github.com/) to greatly simplify the PR and commit process.
8482
- Thank you to all the people who already contributed to HugeGraph!
8583

8684
[![contributors graph](https://contrib.rocks/image?repo=apache/hugegraph)](https://github.com/apache/incubator-hugegraph/graphs/contributors)
8785

88-
8986
## Thanks
9087

91-
HugeGraph relies on the [TinkerPop](http://tinkerpop.apache.org) framework, we refer to the storage structure of Titan and the schema definition of DataStax.
88+
HugeGraph relies on the [TinkerPop](http://tinkerpop.apache.org) framework, we refer to the storage structure of Titan and the schema definition of DataStax.
9289
Thanks to TinkerPop, thanks to Titan, thanks to DataStax. Thanks to all other organizations or authors who contributed to the project.
9390

94-
You are welcome to contribute to HugeGraph,
91+
You are welcome to contribute to HugeGraph,
9592
and we are looking forward to working with you to build an excellent open-source community.
9693

97-
9894
## Contact Us
9995

10096
- [GitHub Issues](https://github.com/apache/hugegraph/issues): Feedback on usage issues and functional requirements (quick response)
101-
- Feedback Email: [[email protected]](mailto:[email protected]) ([subscriber](https://hugegraph.apache.org/docs/contribution-guidelines/subscribe/) only)
102-
- WeChat public account: Apache HugeGraph, welcome to scan this QR code to follow us.
97+
- Feedback Email: [[email protected]](mailto:[email protected]) ([subscriber](https://hugegraph.apache.org/docs/contribution-guidelines/subscribe/) only)
98+
- WeChat public account: Apache HugeGraph, welcome to scan this QR code to follow us.
10399

104100
<img src="https://github.com/apache/hugegraph-doc/blob/master/assets/images/wechat.png?raw=true" alt="QR png" width="300"/>
105101

hugegraph-server/hugegraph-dist/docker/README.md

Lines changed: 19 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,9 @@
11
# Deploy Hugegraph server with docker
22

33
> Note:
4-
>
4+
>
55
> 1. The docker image of hugegraph is a convenience release, not official distribution artifacts from ASF. You can find more details from [ASF Release Distribution Policy](https://infra.apache.org/release-distribution.html#dockerhub).
6-
>
6+
>
77
> 2. Recommend to use `release tag` (like `1.3.0`/`1.5.0`) for the stable version. Use `latest` tag to experience the newest functions in development.
88
99
## 1. Deploy
@@ -12,11 +12,11 @@ We can use docker to quickly start an inner HugeGraph server with RocksDB in the
1212

1313
1. Using docker run
1414

15-
Use `docker run -itd --name=graph -p 8080:8080 hugegraph/hugegraph:1.3.0` to start hugegraph server.
15+
Use `docker run -itd --name=graph -p 8080:8080 hugegraph/hugegraph:1.3.0` to start hugegraph server.
1616

1717
2. Using docker compose
1818

19-
Certainly we can only deploy server without other instance. Additionally, if we want to manage other HugeGraph-related instances with `server` in a single file, we can deploy HugeGraph-related instances via `docker-compose up -d`. The `docker-compose.yaml` is as below:
19+
Certainly we can only deploy server without other instance. Additionally, if we want to manage other HugeGraph-related instances with `server` in a single file, we can deploy HugeGraph-related instances via `docker-compose up -d`. The `docker-compose.yaml` is as below:
2020

2121
```yaml
2222
version: '3'
@@ -35,12 +35,12 @@ If you want to customize the preloaded data, please mount the groovy scripts (no
3535

3636
1. Using docker run
3737

38-
Use `docker run -itd --name=graph -p 8080:8080 -e PRELOAD=true -v /path/to/script:/hugegraph-server/scripts/example.groovy hugegraph/hugegraph:1.3.0`
39-
to start hugegraph server.
38+
Use `docker run -itd --name=graph -p 8080:8080 -e PRELOAD=true -v /path/to/script:/hugegraph-server/scripts/example.groovy hugegraph/hugegraph:1.3.0`
39+
to start hugegraph server.
4040

41-
2. Using docker compose
41+
2. Using docker compose
4242

43-
We can also use `docker-compose up -d` to quickly start. The `docker-compose.yaml` is below. [example.groovy](https://github.com/apache/incubator-hugegraph/blob/master/hugegraph-server/hugegraph-dist/src/assembly/static/scripts/example.groovy) is a pre-defined script. If needed, we can mount a new `example.groovy` to preload different data:
43+
We can also use `docker-compose up -d` to quickly start. The `docker-compose.yaml` is below. [example.groovy](https://github.com/apache/incubator-hugegraph/blob/master/hugegraph-server/hugegraph-dist/src/assembly/static/scripts/example.groovy) is a pre-defined script. If needed, we can mount a new `example.groovy` to preload different data:
4444

4545
```yaml
4646
version: '3'
@@ -57,17 +57,17 @@ If you want to customize the preloaded data, please mount the groovy scripts (no
5757

5858
3. Using start-hugegraph.sh
5959

60-
If you deploy HugeGraph server without docker, you can also pass arguments using `-p`, like this: `bin/start-hugegraph.sh -p true`.
60+
If you deploy HugeGraph server without docker, you can also pass arguments using `-p`, like this: `bin/start-hugegraph.sh -p true`.
6161

6262
## 3. Enable Authentication
6363

6464
1. Using docker run
6565

66-
Use `docker run -itd --name=graph -p 8080:8080 -e AUTH=true -e PASSWORD=123456 hugegraph/hugegraph:1.3.0` to enable the authentication and set the password with `-e AUTH=true -e PASSWORD=123456`.
66+
Use `docker run -itd --name=graph -p 8080:8080 -e AUTH=true -e PASSWORD=xxx hugegraph/hugegraph:1.3.0` to enable the authentication and set the password with `-e AUTH=true -e PASSWORD=xxx`.
6767

6868
2. Using docker compose
6969

70-
Similarly, we can set the environment variables in the docker-compose.yaml:
70+
Similarly, we can set the environment variables in the docker-compose.yaml:
7171

7272
```yaml
7373
version: '3'
@@ -79,37 +79,38 @@ If you want to customize the preloaded data, please mount the groovy scripts (no
7979
- 8080:8080
8080
environment:
8181
- AUTH=true
82-
- PASSWORD=123456
82+
- PASSWORD=xxx
8383
```
8484

8585
## 4. Running Open-Telemetry-Collector
8686

8787
> CAUTION:
88-
>
88+
>
8989
> The `docker-compose-trace.yaml` utilizes `Grafana` and `Grafana-Tempo`, both of them are licensed under [AGPL-3.0](https://www.gnu.org/licenses/agpl-3.0.en.html), you should be aware of and use them with caution. Currently, we mainly provide this template for everyone to **test**
9090
>
91+
9192
1. Start Open-Telemetry-Collector
9293

9394
```bash
9495
cd hugegraph-server/hugegraph-dist/docker/example
9596
docker-compose -f docker-compose-trace.yaml -p hugegraph-trace up -d
9697
```
97-
98+
9899
2. Active Open-Telemetry-Agent
99100

100101
```bash
101102
./start-hugegraph.sh -y true
102103
```
103-
104+
104105
3. Stop Open-Telemetry-Collector
105106

106107
```bash
107108
cd hugegraph-server/hugegraph-dist/docker/example
108109
docker-compose -f docker-compose-trace.yaml -p hugegraph-trace stop
109110
```
110-
111+
111112
4. References
112113

113-
- [What is OpenTelemetry](https://opentelemetry.io/docs/what-is-opentelemetry/)
114+
- [What is OpenTelemetry](https://opentelemetry.io/docs/what-is-opentelemetry/)
114115

115-
- [Tempo in Grafana](https://grafana.com/docs/tempo/latest/getting-started/tempo-in-grafana/)
116+
- [Tempo in Grafana](https://grafana.com/docs/tempo/latest/getting-started/tempo-in-grafana/)

0 commit comments

Comments
 (0)