| Chengkai Yan | 7f278e3 | 2018-11-06 16:32:03 +0100 | [diff] [blame] | 1 | .. This work is licensed under a Creative Commons Attribution 4.0 International License.
|
| 2 | .. http://creativecommons.org/licenses/by/4.0
|
| 3 |
|
| 4 | Installation
|
| 5 | ============
|
| 6 |
|
| 7 | An environment suitable for running docker containers is recommended.
|
| 8 |
|
| maximesson | e707b22 | 2019-05-09 14:27:34 +0000 | [diff] [blame] | 9 | Using Cloudify deployment
|
| 10 | -------------------------
|
| Chengkai Yan | 7f278e3 | 2018-11-06 16:32:03 +0100 | [diff] [blame] | 11 |
|
| maximesson | e707b22 | 2019-05-09 14:27:34 +0000 | [diff] [blame] | 12 | The first possibility is to use blueprints and cfy commands.
|
| 13 |
|
| 14 | Deployment Prerequisite/dependencies
|
| 15 | ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
| 16 |
|
| 17 | Make sure that **cfy** is installed and configured to work with the Cloudify deployment.
|
| 18 |
|
| 19 | Make sure the Message Router and Data Router are running.
|
| 20 |
|
| 21 | Deployment steps
|
| 22 | ^^^^^^^^^^^^^^^^
|
| 23 |
|
| maximesson | 4ad6838 | 2019-06-05 17:51:29 +0200 | [diff] [blame] | 24 | 1. Execute bash on the cloudify manager kubernetes pod.
|
| maximesson | e707b22 | 2019-05-09 14:27:34 +0000 | [diff] [blame] | 25 |
|
| maximesson | 4ad6838 | 2019-06-05 17:51:29 +0200 | [diff] [blame] | 26 | ``kubectl -n onap exec -it <dev-dcaegen2-dcae-cloudify-manager> bash``
|
| maximesson | e707b22 | 2019-05-09 14:27:34 +0000 | [diff] [blame] | 27 |
|
| 28 | 2. Download the dfc `blueprint`_.
|
| maximesson | e707b22 | 2019-05-09 14:27:34 +0000 | [diff] [blame] | 29 |
|
| maximesson | 4ad6838 | 2019-06-05 17:51:29 +0200 | [diff] [blame] | 30 | .. _blueprint: https://gerrit.onap.org/r/gitweb?p=dcaegen2/platform/blueprints.git;a=blob;f=blueprints/reference_templates/k8s-datafile-collector.yaml-template;h=17d2aedec131154b4f5f84a08a099b0364b1e627;hb=HEAD
|
| maximesson | e707b22 | 2019-05-09 14:27:34 +0000 | [diff] [blame] | 31 |
|
| 32 | 3. Run Cloudify Install command to install dfc.
|
| 33 |
|
| maximesson | 4ad6838 | 2019-06-05 17:51:29 +0200 | [diff] [blame] | 34 | ``cfy install <dfc-blueprint-path>``
|
| maximesson | e707b22 | 2019-05-09 14:27:34 +0000 | [diff] [blame] | 35 |
|
| 36 | Sample output:
|
| 37 |
|
| maximesson | 4ad6838 | 2019-06-05 17:51:29 +0200 | [diff] [blame] | 38 | ``cfy install k8s-datafile.yaml``
|
| maximesson | e707b22 | 2019-05-09 14:27:34 +0000 | [diff] [blame] | 39 |
|
| 40 | Run '*cfy events list -e 37da3f5f-a06b-4ce8-84d3-8b64ccd81c33'* to retrieve the execution's events/logs.
|
| 41 |
|
| 42 | Validation
|
| 43 | ^^^^^^^^^^
|
| 44 |
|
| 45 | curl <dcaegen2-dcae-healthcheck> and check if datafile-collector is in *'ready'* state.
|
| 46 |
|
| 47 | Standalone deployment of a container
|
| 48 | ------------------------------------
|
| 49 |
|
| 50 | DFC is delivered as a docker container based on openjdk:8-jre-alpine. The
|
| Chengkai Yan | 7f278e3 | 2018-11-06 16:32:03 +0100 | [diff] [blame] | 51 | host or VM that will run this container must have the docker application
|
| 52 | loaded and available to the userID that will be running the DFC container.
|
| 53 |
|
| maximesson | e707b22 | 2019-05-09 14:27:34 +0000 | [diff] [blame] | 54 | Also required is a working DMAAP/MR and DMAAP/DR environment. DFC
|
| Chengkai Yan | 7f278e3 | 2018-11-06 16:32:03 +0100 | [diff] [blame] | 55 | subscribes to DMAAP/MR fileReady event as JSON messages and publishes the downloaded files to the DMAAP/DR.
|
| 56 |
|
| 57 | Installation
|
| 58 | ^^^^^^^^^^^^
|
| 59 |
|
| maximesson | 4ad6838 | 2019-06-05 17:51:29 +0200 | [diff] [blame] | 60 | The following command will download the Dublin version of the datafile image from
|
| Chengkai Yan | 7f278e3 | 2018-11-06 16:32:03 +0100 | [diff] [blame] | 61 | nexus and launch it in the container named "datafile":
|
| 62 |
|
| maximesson | 4ad6838 | 2019-06-05 17:51:29 +0200 | [diff] [blame] | 63 | ``docker run -d -p 8100:8100 -p 8433:8433 nexus3.onap.org:10001/onap/org.onap.dcaegen2.collectors.datafile.datafile-app-server:1.1.3``
|
| maximesson | e707b22 | 2019-05-09 14:27:34 +0000 | [diff] [blame] | 64 |
|
| maximesson | 4ad6838 | 2019-06-05 17:51:29 +0200 | [diff] [blame] | 65 | For another version, it is possible to replace the tag '1.1.3' with any version that seems suitable (including latest).
|
| maximesson | e707b22 | 2019-05-09 14:27:34 +0000 | [diff] [blame] | 66 | Available images are visible following this `link`_.
|
| 67 |
|
| maximesson | 4ad6838 | 2019-06-05 17:51:29 +0200 | [diff] [blame] | 68 | .. _link: https://nexus3.onap.org/#browse/search=keyword%3D*datafile*
|
| maximesson | e707b22 | 2019-05-09 14:27:34 +0000 | [diff] [blame] | 69 |
|
| maximesson | 4ad6838 | 2019-06-05 17:51:29 +0200 | [diff] [blame] | 70 | Another option is to pull the image first, and then run the image's container with the image ID:
|
| maximesson | e707b22 | 2019-05-09 14:27:34 +0000 | [diff] [blame] | 71 |
|
| 72 | ``docker pull nexus3.onap.org:10001/onap/org.onap.dcaegen2.collectors.datafile.datafile-app-server:latest``
|
| 73 |
|
| 74 | ``docker images | grep 'datafile'``
|
| 75 |
|
| 76 | ``docker run -d -p 8100:8100 -p 8433:8433 <image ID>``
|
| 77 |
|
| 78 | The grep command will display the images corresponding to DFC. There can be several due to remotely or locally built
|
| 79 | image, and also to different tags, i.e. different versions.
|
| ecaiyanlinux | 7b9db0f | 2019-08-21 08:38:04 +0000 | [diff] [blame^] | 80 |
|
| 81 | Certifcates
|
| 82 | ^^^^^^^^^^^
|
| 83 | .. _page: ./certifcates.rst
|