summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authordoufenghu <[email protected]>2023-12-03 14:22:32 +0800
committerdoufenghu <[email protected]>2023-12-03 14:22:32 +0800
commitffa3ed3dded18d086e72046e89b72b7a0dd60e7f (patch)
tree59a97f1bfa5cb75e28cc1071e35b9a7fc15f4d7e /docs
parent5f21adf326bd9c1db7f1bb9faf65d63643c596b9 (diff)
[feature][docs] add readme.md for groot stream platform
Diffstat (limited to 'docs')
-rw-r--r--docs/develop-guide.md41
-rw-r--r--docs/images/groot_stream_architecture.jpegbin0 -> 5167458 bytes
2 files changed, 21 insertions, 20 deletions
diff --git a/docs/develop-guide.md b/docs/develop-guide.md
index d0bbf6f..ededf14 100644
--- a/docs/develop-guide.md
+++ b/docs/develop-guide.md
@@ -1,5 +1,22 @@
# Develop Guide
+## Modules Overview
+
+| Module Name | Description |
+|:----------------|:-----------------------------------------------------------------------------------------------------------|
+| groot-bootstrap | The main module of groot-stream, which is responsible for starting the groot-stream server. |
+| groot-common | Common module of groot-stream, which is responsible for providing common functions. |
+| groot-core | Core module of groot-stream, which is responsible for providing core functions. |
+| groot-connectors| Connector module of groot-stream, which is responsible for providing connectors. |
+| groot-formats | Format module of groot-stream, which is responsible for providing the ability of formatting data. |
+| groot-shade | Shaded module of groot-stream, which is responsible for providing the ability of solving package conflict. |
+| groot-example | Example module of groot-stream, which is responsible for providing examples. |
+|groot-test | Test module of groot-stream, which is responsible for providing test cases. |
+|groot-docs | Docs module of groot-stream, which is responsible for providing documents. |
+|groot-release | Release module of groot-stream, which is responsible for providing release scripts. |
+
+
+
## How to write a high quality Git commit message
> [purpose] [module name] [sub-module name] Description (JIRA Issue ID)
@@ -25,26 +42,11 @@ When throwing an exception with a hint message and ensure that the exception has
}
```
-## How to run a job in IDEA
-1. Set `groot-bootstrap` module pom.xml scope to `compile`.
-2. Open the `Run/Debug Configurations` window.
-3. Choose -cp `groot-bootstrap`
-4. Choose Main Class `com.geedgenetworks.bootstrap.main.GrootStreamServer`.
-5. Add VM options `-e client --target local -c /...../groot-stream/config/grootstream_job_template.yaml`.
-6. Click the `Run` button.
-
-## How to run a job in command line
-- Standalone Mode
-```shell
-cd "groot-stream-${version}"
-./bin/start.sh -c ./config/grootstream_job_template.yaml --target remote -d -n groot-stream-job
-```
-- Yarn Per-job Mode
-```shell
-cd "groot-stream-${version}"
-./bin/start.sh -c ./config/grootstream_job_template.yaml --target yarn-per-job -d -n groot-stream-job
-```
+## Design Principles
+1. Package structure: `com.geedgenetworks.[module].[sub-module]`. `groot-stream` is the parent module, and other modules are dependent on it.
+2. Module naming: `groot-[module]`. e.g. `groot-common`, `groot-core`, `groot-connectors`, `groot-bootstrap`, `groot-example`, etc.
+3. For unchecked exception (RuntimeException) within the 'groot-common' module, a global exception handling class named 'GrootRuntimeException' is defined.
## Run a job example
All examples are in module `groot-stream-example`. You can run the example [ running or debugging a job in IDEA].
@@ -53,4 +55,3 @@ e.g. we use `groot-stream-example/src/main/java/com/geedgenetworks/example/Boots
{"ip_string":"8.8.8.9","fqdn_string":"www.geedgenetworks.com","port_int32":80}
```
-
diff --git a/docs/images/groot_stream_architecture.jpeg b/docs/images/groot_stream_architecture.jpeg
new file mode 100644
index 0000000..7daf2e1
--- /dev/null
+++ b/docs/images/groot_stream_architecture.jpeg
Binary files differ