blob: 7f4cf3ab40ed94fcf98e8ae1ff9c1f9e8c62887e (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
|
# Vagrant for DCAE runtime
This project provides component developers the means to stand up their own local DCAE runtime environment to do local onboarding through the dcae-cli. [Vagrant](https://www.vagrantup.com/) is the technology used and is required to the provided Vagrantfile.
## Pre-req
1. Install Docker
2. Install Vagrant
3. Install VirtualBox
4. Add the following to your `/etc/hosts` (or equivalent):
```
127.0.0.1 vagrant-dcae
```
## Run
Clone the [dcaegen2.platform.cli](https://gerrit.onap.org/r/#/admin/projects/dcaegen2/platform/cli) project.
```
cd vagrant
vagrant up
```
Open the following [Consul link](http://vagrant-dcae:8500/ui) to verify that Consul is running and review the listed services by clicking on each:
* [`config_binding_service`](http://vagrant-dcae:8500/ui/#/vagrant-dcae/services/config_binding_service)
* [`onboardingdb`](http://vagrant-dcae:8500/ui/#/vagrant-dcae/services/onboardingdb)
NOTE: The vagrant DCAE runtime requires several ports on the host machine. See the [Vagrantfile](Vagrantfile) for all the lines that contain `forwarded_port`.
## Post run
Post run involves setting up the dcae-cli to work with the newly instantiated local DCAE runtime environment.
### Install
First install [dcae-cli](https://pypi.org/project/onap-dcae-cli/).
Even if you have already installed dcae-cli before, please take the time now to upgrade:
```
pip install --upgrade onap-dcae-cli
```
### Configure
Type the following command and you will be taken through a series of prompts to configure dcae-cli. For the most part, use the responses shown below except for the *user id*:
```
$ dcae_cli --reinit
Warning! Reinitializing your dcae-cli configuration
Please enter the remote server url: https://git.onap.org/dcaegen2/platform/cli/plain
Could not download initial configuration from remote server. Attempt manually setting up? [y/N]: y
Please enter your user id: <your user id>
Now we need to set up access to the onboarding catalog
Please enter the onboarding catalog hostname: vagrant-dcae
Please enter the onboarding catalog user: postgres
Please enter the onboarding catalog password: onap123
Could not download initial profiles from remote server. Set empty default? [y/N]: y
Reinitialize done
```
#### Profile
Next you will need to setup your default profile.
Running the following, you should see the following:
```
$ dcae_cli profiles show default
{
"cdap_broker": "cdap_broker",
"config_binding_service": "config_binding_service",
"consul_host": "",
"docker_host": ""
}
```
You need to set `consul_host` and `docker_host` by running the following:
```
$ dcae_cli profiles set default consul_host vagrant-dcae
$ dcae_cli profiles set default docker_host vagrant-dcae:2376
```
Repeating `dcae_cli profiles show default` should show those parameters now filled.
### Run
You must point your Docker client to the Docker engine running in the VirtualBox instance by doing the following:
```
export DOCKER_HOST="tcp://vagrant-dcae:2376"
```
You must have this environment variable set everytime before you run the dcae-cli.
## TODO
* There is a known issue where Consul does not recover after doing a `vagrant reload`. It get
|
