summaryrefslogtreecommitdiffstats
path: root/onap-dcae-cbs-docker-client/README.md
diff options
context:
space:
mode:
authorTommy Carpenter <tommy@research.att.com>2017-09-20 15:11:00 -0400
committerTommy Carpenter <tommy@research.att.com>2017-09-20 16:55:34 -0400
commitc3a485a0a2805519a217575fd8c984b0312e9b43 (patch)
tree71da2f7e0909a41936542e9dd0ff2209fa74ae56 /onap-dcae-cbs-docker-client/README.md
parent385a2870137aa18d558f413136a361d0562a8ac6 (diff)
Rename the cbs docker client
Issue-ID: DCAEGEN2-60 Change-Id: Ia0d4726215efc1c2fe78bee1bdfdf1403e2c349c Signed-off-by: Tommy Carpenter <tommy@research.att.com>
Diffstat (limited to 'onap-dcae-cbs-docker-client/README.md')
-rw-r--r--onap-dcae-cbs-docker-client/README.md31
1 files changed, 31 insertions, 0 deletions
diff --git a/onap-dcae-cbs-docker-client/README.md b/onap-dcae-cbs-docker-client/README.md
new file mode 100644
index 0000000..b5ddd04
--- /dev/null
+++ b/onap-dcae-cbs-docker-client/README.md
@@ -0,0 +1,31 @@
+# Python CBS Docker Client
+
+Used for DCAE Dockerized microservices written in Python. Pulls your configuration from the config_binding_service. Expects that CONSUL_HOST and HOSTNAME are set as env variables, which is true in DCAE.
+
+# Client Usage
+
+## Development outside of Docker
+To test your raw code without Docker, you will need to set the env variables CONSUL_HOST and HOSTNAME (name of your key to pull from) that are set in DCAEs Docker enviornment.
+1. `CONSUL_HOST` is the hostname only of the Consul instance you are talking to
+2. HOSTNAME is the name of your component in Consul
+
+## Usage in your code
+```
+>>> from onap_dcae_cbs_docker_client import client
+>>> client.get_config()
+```
+
+# Installation
+
+## Via pip
+```
+pip install --extra-index-url https://YOUR_NEXUS_PYPI_SERVER/simple cbs-docker-client
+```
+
+## Via requirements.txt
+Add the following to your requirements.txt file
+```
+--extra-index-url https://YOUR_NEXUS_PYPI_SERVER/simple
+onap-dcae-cbs-docker-client==[version]
+```
+