You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardexpand all lines: README.md
+47
Original file line number
Diff line number
Diff line change
@@ -60,9 +60,56 @@ When running locally they can be accessed here: http://localhost:8080/swagger-ui
60
60
Dockerfile Location: `Dockerfile`
61
61
Build Context: `/`
62
62
`Autobuild` is set to the ON position
63
+
63
64
`Build Caching` is set to the ON position
64
65
4. Then save the configuration
65
66
67
+
### Docker Song Client
68
+
The `song-client` is a CLI tool used for communicating with a `song-server`.
69
+
70
+
#### Building
71
+
Simply running `mvn clean package` will package the client into a `-dist.tar.gz` file.
72
+
73
+
#### Configuration
74
+
After unarchiving the distribution, it can be configured via the `./conf/application.yml` file. Alternatively, the client can be configured through environment variables, which take presedence over the `application.yml` config.
75
+
For example, to run the `song-client config` command using environment variables with the same values as the `application.yml` configuration below:
76
+
77
+
```yaml
78
+
client:
79
+
serverUrl: http://localhost:8080
80
+
studyId: ABC123-CA
81
+
programName: sing
82
+
debug: true
83
+
accessToken: myAccessToken
84
+
```
85
+
86
+
could be done via:
87
+
88
+
```bash
89
+
CLIENT_SERVER_URL=http://localhost:8080 \
90
+
CLIENT_STUDY_ID=ABC123-CA \
91
+
CLIENT_PROGRAM_NAME=sing \
92
+
CLIENT_DEBUG=true \
93
+
CLIENT_ACCESS_TOKEN=myAccessToken \
94
+
./bin/sing config
95
+
```
96
+
97
+
#### Running the client locally
98
+
The `song-client` can be run using the `./bin/sing` script.
99
+
100
+
#### Running the client using Docker
101
+
Alternatively, the `song-client` can be run using docker. To run the dockerized client with the configurations above, the following command could be executed:
102
+
```bash
103
+
docker run --rm \
104
+
-e 'CLIENT_SERVER_URL=http://localhost:8080' \
105
+
-e 'CLIENT_STUDY_ID=ABC123-CA' \
106
+
-e 'CLIENT_PROGRAM_NAME=sing' \
107
+
-e 'CLIENT_DEBUG=true' \
108
+
-e 'CLIENT_ACCESS_TOKEN=myAccessToken' \
109
+
overture/song-client:latest
110
+
bin/sing config
111
+
```
112
+
66
113
### Notes
67
114
68
115
When running with the secure profile enabled, an oauth2 server is needed.
0 commit comments