Skip to content

Commit c67afdc

Browse files
authored
Merge pull request #14 from byran77/qixiao/update-readme
Add quickstart guidance in readme
2 parents 6d6eb12 + dfd21f1 commit c67afdc

File tree

1 file changed

+25
-0
lines changed

1 file changed

+25
-0
lines changed

README.md

Lines changed: 25 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -6,6 +6,31 @@ Support SHIR version: 5.0 or later
66

77
For more information about Azure Data Factory, see [https://docs.microsoft.com/en-us/azure/data-factory/concepts-integration-runtime](https://docs.microsoft.com/en-us/azure/data-factory/concepts-integration-runtime)
88

9+
# QuickStart
10+
1. Prepare [Windows for containers](https://learn.microsoft.com/en-us/virtualization/windowscontainers/quick-start/set-up-environment?tabs=dockerce)
11+
2. Build the Windows container image in the project folder
12+
```bash
13+
> docker build . -t <image-name>
14+
```
15+
3. Run the container with specific arguments by passing environment variables
16+
```bash
17+
> docker run -d -e AUTH_KEY=<ir-authentication-key> \
18+
[-e NODE_NAME=<ir-node-name>] \
19+
[-e ENABLE_HA={true|false}] \
20+
[-e HA_PORT=<port>] \
21+
[-e ENABLE_AE={true|false}] \
22+
[-e AE_TIME=<expiration-time-in-seconds>] \
23+
<image-name>
24+
```
25+
### __Arguments list__
26+
|Name|Necessity|Default|Description|
27+
|---|---|---|---|
28+
| `AUTH_KEY` | Required | | The authentication key for the self-hosted integration runtime. |
29+
| `NODE_NAME` | Optional | `hostname` | The specified name of the node. |
30+
| `ENABLE_HA` | Optional | `false` | The flag to enable high availability and scalability.<br/> It supports up to 4 nodes registered to the same IR when `HA` is enabled, otherwise only 1 is allowed. |
31+
| `HA_PORT` | Optional | `8060` | The port to set up a high availability cluster. |
32+
| `ENABLE_AE` | Optional | `false` | The flag to enable offline nodes auto-expiration.<br/> If enabled, the expired nodes will be removed automatically from the IR when a new node is attempting to register.<br/> Only works when `ENABLE_HA=true`. |
33+
| `AE_TIME` | Optional | `600` | The expiration timeout duration for offline nodes in seconds. <br/>Should be no less than 600 (10 minutes). |
934

1035
# Contributing
1136

0 commit comments

Comments
 (0)