...
Note |
---|
This quickstart-guide with Docker provides an easy way to run, test and develop with SAGA, but in order to do a production deployment or expose these services publicly, you will need to do all the changes required, including changing of configurations, creation of certificates, enabling security measures and whatever is needed to production environments. |
In order to run all elements of the SAGA Suite and Elasticsearch, the saga-quickstart.zip contains the files needed. So, the steps to run are the following:
...
Info |
---|
The first time you start these scripts, it may take a some time to start everything because they need to download the images and then run them in order. |
When you are done with your work, you can remove everything by executing the uninstall scripts (bat in Windows, sh in Linux).
...
This cleanup script stops the docker containers running, deletes them after stopped and removes the network where they were running.
Now, if you only require the docker image of Saga-Server, then you do not need to download, run and mount the whole quickstart from above.
You can get pull the image from our official repository using:
Code Block |
---|
docker pull docker.repository.sca.accenture.com/docker/saga-server:latest
//OR
docker pull docker.repository.sca.accenture.com/docker/saga-server:latest-tensor-jenkins |
And from then you can configure it and use it as you need, however there are some things you need to know before pulling and running this docker image:
If it is your first time pulling the images, you will need to login with docker to our artifactory, otherwise, you will not be able to pull the image.
Code Block |
---|
docker login docker.repository.sca.accenture.com |
Then, as said before, you must enter your artifactory credentials.
NEW_CONFIG : this JSON-like string contains all the config to overwrite the default one that comes with the image. It must be a one liner string due to environmental limitations when using docker.
For example:
This is a fragment of the config for SAGA to run.
Code Block | ||
---|---|---|
| ||
{ "config": { "apiPort": 8080, "host": "0.0.0.0", "security": { "enable": false, "encryptionKeyFile" : "./bin/saga.ek", "inactiveInterval": 600, "users": [{ "username": "admin", "password": "password", "roles": "admin" }] }, "providers": [ { "name": "filesystem-provider", "type": "FileSystem", "baseDir": "./config" }, { "name": "saga-provider", "type": "Elastic", "nodeUrls": ["http://localhost:9200"], "timestamp": "updatedAt", "indexName": "saga", "encryptionKeyFile" : "./bin/saga.ek", "authentication": "none", "timeout": 90, "exclude": [ "updatedAt", "createdAt" ] } ], "solutions": [ { "display": "Saga", "elasticSearch": { "nodeUrls": ["http://localhost:9200"], "indexName": "saga", "encryptionKeyFile" : "./bin/saga.ek", "authentication": "none", "timeout": 90, "delay": 5, "retries": 3 } } ] } } |
And this is in the one-liner style that the NEW_CONFIG environmental variable accepts:
Code Block | ||
---|---|---|
| ||
{"config":{"apiPort":8080,"host":"0.0.0.0","security":{"enable":false,"encryptionKeyFile":"./bin/saga.ek","inactiveInterval":600,"users":[{"username":"admin","password":"password","roles":"admin"}]},"providers":[{"name":"filesystem-provider","type":"FileSystem","baseDir":"./config"},{"name":"saga-provider","type":"Elastic","nodeUrls":["http://localhost:9200"],"timestamp":"updatedAt","indexName":"saga","encryptionKeyFile":"./bin/saga.ek","authentication":"none","timeout":90,"exclude":["updatedAt","createdAt"]}],"solutions":[{"display":"Saga","elasticSearch":{"nodeUrls":["http://localhost:9200"],"indexName":"saga","encryptionKeyFile":"./bin/saga.ek","authentication":"none","timeout":90,"delay":5,"retries":3}}]}} |
Note |
---|
This NEW_CONFIG is temporal, we needed a way to configure environmental variables quickly. |
JAVA_MAX_META_MEMORY : The amount of initial memory Saga will start with. Default is '1024m'.
Info |
---|
All these values can be marked as ‘g' for GB, ‘m' for MB and ‘k' for KB. |
As well as the SAGA image, you can download the Enterprise Search UI docker image and run it where you need it using:
...
For the Saga-Python-Bridge, the image can be downloaded using:
Code Block |
---|
docker pull docker.repository.sca.accenture.com/docker/saga-python-bridge:latest |
Content by Label | ||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
...