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