diff options
author | Tomasz Wrobel <tomasz.wrobel@nokia.com> | 2020-03-26 09:43:41 +0100 |
---|---|---|
committer | Tomasz Wrobel <tomasz.wrobel@nokia.com> | 2020-03-27 08:35:55 +0100 |
commit | 71986212d4088b3cc5c41c2ed96ec352ea899fe5 (patch) | |
tree | adf2f276554908c9f00eddfabbe6fc47b3e2e0bb /docs/sections/configuration.rst | |
parent | 483ccbf2d8f0c71ebb15a4a47246a68a42e68f3e (diff) |
Add Certification Client documentation
Issue-ID: AAF-1091
Signed-off-by: Tomasz Wrobel <tomasz.wrobel@nokia.com>
Change-Id: I8eb762063767f8532845e7f66b1d7398468ab650
Diffstat (limited to 'docs/sections/configuration.rst')
-rw-r--r-- | docs/sections/configuration.rst | 108 |
1 files changed, 95 insertions, 13 deletions
diff --git a/docs/sections/configuration.rst b/docs/sections/configuration.rst index 47f2dd87..d49c86bd 100644 --- a/docs/sections/configuration.rst +++ b/docs/sections/configuration.rst @@ -5,24 +5,106 @@ Configuration ============= -.. note:: - * This section is used to describe the options a software component offers for configuration. +Standalone docker container +--------------------------- - * Configuration is typically: provided for platform-component and sdk projects; - and referenced in developer and user guides. - - * This note must be removed after content has been added. +Certification Service Client image: +.. code-block:: + nexus3.onap.org:10001/onap/org.onap.aaf.certservice.aaf-certservice-client:latest -Example ... -You can provide the following in ``basic.conf`` +1. Create file with environments as in example below. -``host=ADDRESS`` - The address of the host +.. code-block:: -``port=PORT`` - The port used for signaling + #Client envs + REQUEST_URL=http://aaf-cert-service-service:8080/v1/certificate/ + REQUEST_TIMEOUT=1000 + OUTPUT_PATH=/var/certs + CA_NAME=RA + #Csr config envs + COMMON_NAME=onap.org + ORGANIZATION=Linux-Foundation + ORGANIZATION_UNIT=ONAP + LOCATION=San-Francisco + STATE=California + COUNTRY=US + SANS=test.onap.org:onap.com - Optional. Default: ``8080`` + +2. Run docker container with environments file and docker network (API and client must be running in same network). + +.. code-block:: bash + + AAFCERT_CLIENT_IMAGE=nexus3.onap.org:10001/onap/org.onap.aaf.certservice.aaf-certservice-client:latest + DOCKER_ENV_FILE= <path to environment file> + NETWORK_CERT_SERVICE= <docker network of cert service> + DOCKER_VOLUME="<absolute path to local dir>:<output path>" + + docker run --env-file $DOCKER_ENV_FILE --network $NETWORK_CERT_SERVICE --volume $DOCKER_VOLUME $AAFCERT_CLIENT_IMAGE + + + +Init Container for K8s +---------------------- + +Example deployment: + +.. code-block:: yaml + + ... + kind: Deployment + metadata: + ... + spec: + ... + template: + ... + spec: + containers: + - image: sample.image + name: sample.name + ... + volumeMounts: + - mountPath: /var/certs #CERTS CAN BE FOUND IN THIS DIRECTORY + name: certs + ... + initContainers: + - name: cert-service-client + image: nexus3.onap.org:10001/onap/org.onap.aaf.certservice.aaf-certservice-client:latest + imagePullPolicy: Always + env: + - name: REQUEST_URL + value: http://aaf-cert-service-service:8080/v1/certificate/ + - name: REQUEST_TIMEOUT + value: "1000" + - name: OUTPUT_PATH + value: /var/certs + - name: CA_NAME + value: RA + - name: COMMON_NAME + value: onap.org + - name: ORGANIZATION + value: Linux-Foundation + - name: ORGANIZATION_UNIT + value: ONAP + - name: LOCATION + value: San-Francisco + - name: STATE + value: California + - name: COUNTRY + value: US + - name: SANS + value: test.onap.org:onap.com + volumeMounts: + - mountPath: /var/certs + name: certs + ... + volumes: + -emptyDir: {} + name: certs + ... + +
\ No newline at end of file |