@@ -36,7 +36,6 @@ Since the Senzing library is a prerequisite, it must be installed first.
36
36
export GIT_REPOSITORY=serve-grpc
37
37
export GIT_ACCOUNT_DIR=~/${GIT_ACCOUNT}.git
38
38
export GIT_REPOSITORY_DIR="${GIT_ACCOUNT_DIR}/${GIT_REPOSITORY}"
39
-
40
39
```
41
40
42
41
1. Using the environment variables values just set, follow
@@ -50,7 +49,6 @@ Since the Senzing library is a prerequisite, it must be installed first.
50
49
```console
51
50
cd ${GIT_REPOSITORY_DIR}
52
51
make dependencies-for-development
53
-
54
52
```
55
53
56
54
1. Install dependencies needed for [Go] code.
@@ -59,7 +57,6 @@ Since the Senzing library is a prerequisite, it must be installed first.
59
57
```console
60
58
cd ${GIT_REPOSITORY_DIR}
61
59
make dependencies
62
-
63
60
```
64
61
65
62
## Lint
@@ -70,7 +67,6 @@ Since the Senzing library is a prerequisite, it must be installed first.
70
67
```console
71
68
cd ${GIT_REPOSITORY_DIR}
72
69
make lint
73
-
74
70
```
75
71
76
72
## Build
@@ -81,15 +77,13 @@ Since the Senzing library is a prerequisite, it must be installed first.
81
77
```console
82
78
cd ${GIT_REPOSITORY_DIR}
83
79
make clean build
84
-
85
80
```
86
81
87
82
1. The binaries will be found in the `${GIT_REPOSITORY_DIR}/target` directory.
88
83
Example:
89
84
90
85
```console
91
86
tree ${GIT_REPOSITORY_DIR}/target
92
-
93
87
```
94
88
95
89
## Run
@@ -104,7 +98,6 @@ Since the Senzing library is a prerequisite, it must be installed first.
104
98
105
99
```console
106
100
export SENZING_TOOLS_DATABASE_FILE=/tmp/sqlite/G2C.db
107
-
108
101
```
109
102
110
103
1. Copy template database and run command.
@@ -115,21 +108,18 @@ Since the Senzing library is a prerequisite, it must be installed first.
115
108
cp ${GIT_REPOSITORY_DIR}/testdata/sqlite/G2C.db ${SENZING_TOOLS_DATABASE_FILE}
116
109
export SENZING_TOOLS_DATABASE_URL=sqlite3://na:na@nowhere${SENZING_TOOLS_DATABASE_FILE}
117
110
${GIT_REPOSITORY_DIR}/target/linux-amd64/serve-grpc
118
-
119
111
```
120
112
121
113
1. macOS
122
114
123
115
```console
124
116
${GIT_REPOSITORY_DIR}/target/darwin-amd64/serve-grpc
125
-
126
117
```
127
118
128
119
1. Windows
129
120
130
121
```console
131
122
${GIT_REPOSITORY_DIR}/target/windows-amd64/serve-grpc
132
-
133
123
```
134
124
135
125
1. Clean up.
@@ -138,7 +128,6 @@ Since the Senzing library is a prerequisite, it must be installed first.
138
128
```console
139
129
cd ${GIT_REPOSITORY_DIR}
140
130
make clean
141
-
142
131
```
143
132
144
133
## Test
@@ -149,7 +138,6 @@ Since the Senzing library is a prerequisite, it must be installed first.
149
138
```console
150
139
cd ${GIT_REPOSITORY_DIR}
151
140
make clean setup test
152
-
153
141
```
154
142
155
143
1. **Optional:** View the SQLite database.
@@ -164,7 +152,6 @@ Since the Senzing library is a prerequisite, it must be installed first.
164
152
--tty \
165
153
--volume /tmp/sqlite:/data \
166
154
coleifer/sqlite-web
167
-
168
155
```
169
156
170
157
Visit [localhost:9174].
@@ -179,7 +166,6 @@ Create a code coverage map.
179
166
```console
180
167
cd ${GIT_REPOSITORY_DIR}
181
168
make clean setup coverage
182
-
183
169
```
184
170
185
171
A web-browser will show the results of the coverage.
@@ -194,7 +180,6 @@ Create a code coverage map.
194
180
```console
195
181
cd ${GIT_REPOSITORY_DIR}
196
182
make clean documentation
197
-
198
183
```
199
184
200
185
1. If a web page doesn't appear, visit [localhost:6060].
@@ -212,7 +197,6 @@ Example:
212
197
```console
213
198
cd ${GIT_REPOSITORY_DIR}
214
199
make clean
215
-
216
200
```
217
201
218
202
## Docker
@@ -223,18 +207,18 @@ Example:
223
207
```console
224
208
cd ${GIT_REPOSITORY_DIR}
225
209
make docker-build
226
-
227
210
```
228
211
229
212
1. Run docker container.
230
213
Example:
231
214
232
215
```console
233
216
docker run \
217
+ --interactive \
234
218
--publish 8261:8261 \
235
219
--rm \
220
+ --tty \
236
221
senzing/serve-grpc
237
-
238
222
```
239
223
240
224
1. **Optional:** Test using `docker-compose`.
@@ -243,15 +227,13 @@ Example:
243
227
```console
244
228
cd ${GIT_REPOSITORY_DIR}
245
229
make clean docker-test
246
-
247
230
```
248
231
249
232
To bring the `docker-compose` formation, run
250
233
251
234
```console
252
235
cd ${GIT_REPOSITORY_DIR}
253
236
make clean
254
-
255
237
```
256
238
257
239
## Package
@@ -268,15 +250,13 @@ The actual packaging is done in the [senzing-tools] repository.
268
250
```console
269
251
cd ${GIT_REPOSITORY_DIR}
270
252
make package
271
-
272
253
```
273
254
274
255
1. The results will be in the `${GIT_REPOSITORY_DIR}/target` directory.
275
256
Example:
276
257
277
258
```console
278
259
tree ${GIT_REPOSITORY_DIR}/target
279
-
280
260
```
281
261
282
262
### Test DEB package on Ubuntu
@@ -286,7 +266,6 @@ The actual packaging is done in the [senzing-tools] repository.
286
266
287
267
```console
288
268
apt list --installed | grep serve-grpc
289
-
290
269
```
291
270
292
271
1. :pencil2: Install `serve-grpc`.
@@ -296,15 +275,13 @@ The actual packaging is done in the [senzing-tools] repository.
296
275
```console
297
276
cd ${GIT_REPOSITORY_DIR}/target
298
277
sudo apt install ./serve-grpc-0.0.0.deb
299
-
300
278
```
301
279
302
280
1. :pencil2: Identify a location for database.
303
281
Example:
304
282
305
283
```console
306
284
export SENZING_TOOLS_DATABASE_FILE=/tmp/sqlite/G2C.db
307
-
308
285
```
309
286
310
287
1. Copy template database and run command.
@@ -314,7 +291,6 @@ The actual packaging is done in the [senzing-tools] repository.
314
291
mkdir --parents ${SENZING_TOOLS_DATABASE_FILE%/*}
315
292
cp ${GIT_REPOSITORY_DIR}/testdata/sqlite/G2C.db ${SENZING_TOOLS_DATABASE_FILE}
316
293
export SENZING_TOOLS_DATABASE_URL=sqlite3://na:na@nowhere${SENZING_TOOLS_DATABASE_FILE}
317
-
318
294
```
319
295
320
296
1. :pencil2: Run command.
@@ -323,15 +299,13 @@ The actual packaging is done in the [senzing-tools] repository.
323
299
```console
324
300
export LD_LIBRARY_PATH=/opt/senzing/er/lib/
325
301
serve-grpc
326
-
327
302
```
328
303
329
304
1. Remove `serve-grpc` from system.
330
305
Example:
331
306
332
307
```console
333
308
sudo apt-get remove serve-grpc
334
-
335
309
```
336
310
337
311
### Test RPM package on Centos
@@ -341,7 +315,6 @@ The actual packaging is done in the [senzing-tools] repository.
341
315
342
316
```console
343
317
yum list installed | grep serve-grpc
344
-
345
318
```
346
319
347
320
1. :pencil2: Install `serve-grpc`.
@@ -351,7 +324,6 @@ The actual packaging is done in the [senzing-tools] repository.
351
324
```console
352
325
cd ${GIT_REPOSITORY_DIR}/target
353
326
sudo yum install ./serve-grpc-0.0.0.rpm
354
-
355
327
```
356
328
357
329
1. :pencil2: Identify database.
@@ -360,7 +332,6 @@ The actual packaging is done in the [senzing-tools] repository.
360
332
361
333
```console
362
334
export SENZING_TOOLS_DATABASE_URL=sqlite3://na:na@nowhere/tmp/sqlite/G2C.db
363
-
364
335
```
365
336
366
337
1. Run command.
@@ -369,15 +340,13 @@ The actual packaging is done in the [senzing-tools] repository.
369
340
```console
370
341
export LD_LIBRARY_PATH=/opt/senzing/er/lib/
371
342
serve-grpc
372
-
373
343
```
374
344
375
345
1. Remove `serve-grpc` from system.
376
346
Example:
377
347
378
348
```console
379
349
sudo yum remove serve-grpc
380
-
381
350
```
382
351
383
352
## Specialty
@@ -393,7 +362,6 @@ in testing the `sz-sdk-go-core` packages.
393
362
394
363
```console
395
364
export SENZING_DEMO_DIR=~/my-senzing-demo
396
-
397
365
```
398
366
399
367
1. Bring up the docker-compose stack.
@@ -422,7 +390,6 @@ in testing the `sz-sdk-go-core` packages.
422
390
423
391
cd ${SENZING_DEMO_DIR}
424
392
sudo --preserve-env docker-compose up
425
-
426
393
```
427
394
428
395
1. In a separate terminal window, set environment variables.
@@ -432,15 +399,13 @@ in testing the `sz-sdk-go-core` packages.
432
399
```console
433
400
export LOCAL_IP_ADDRESS=$(curl --silent https://raw.githubusercontent.com/senzing-garage/knowledge-base/main/gists/find-local-ip-address/find-local-ip-address.py | python3 -)
434
401
export SENZING_TOOLS_DATABASE_URL=postgresql://postgres:postgres@${LOCAL_IP_ADDRESS}:5432/er/?sslmode=disable
435
-
436
402
```
437
403
438
404
1. Run tests.
439
405
440
406
```console
441
407
cd ${GIT_REPOSITORY_DIR}
442
408
make clean test
443
-
444
409
```
445
410
446
411
1. **Optional:** View the PostgreSQL database.
@@ -458,7 +423,6 @@ in testing the `sz-sdk-go-core` packages.
458
423
459
424
cd ${GIT_REPOSITORY_DIR}
460
425
make clean
461
-
462
426
```
463
427
464
428
### Test using bloomrpc
@@ -477,7 +441,6 @@ For other gRPC tools, visit [Awesome gRPC].
477
441
```console
478
442
wget https://github.com/bloomrpc/bloomrpc/releases/download/1.5.3/bloomrpc_1.5.3_amd64.deb
479
443
sudo apt install ./bloomrpc_1.5.3_amd64.deb
480
-
481
444
```
482
445
483
446
1. Start the test server.
@@ -486,15 +449,13 @@ For other gRPC tools, visit [Awesome gRPC].
486
449
```console
487
450
cd ${GIT_REPOSITORY_DIR}
488
451
make clean run-serve-grpc
489
-
490
452
```
491
453
492
454
1. In a separate terminal, start the gRPC test client.
493
455
Example:
494
456
495
457
```console
496
458
bloomrpc
497
-
498
459
```
499
460
500
461
1. In `bloomrpc`:
0 commit comments