summaryrefslogtreecommitdiffstats
path: root/docs/developer_info/Working_with_SO_Docker.rst
blob: ee958efa418b2ade93a6639b2dbc372dddb98aa9 (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
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
.. This work is licensed under a Creative Commons Attribution 4.0 International License.
.. http://creativecommons.org/licenses/by/4.0
.. Copyright 2017 Huawei Technologies Co., Ltd.

Working with SO Docker
======================

Verify that docker images are built
------------------------------------

.. code-block:: bash

  docker images openecomp/mso

  *Example Output:*

  REPOSITORY     TAG                                  IMAGE ID     CREATED       SIZE

  openecomp/mso  1.1-SNAPSHOT-latest                  419e9d8a17e8 3 minutes ago 1.62GB

  openecomp/mso  1.1.0-SNAPSHOT-STAGING-20170926T2015 419e9d8a17e8 3 minutes ago 1.62GB

  openecomp/mso  latest                               419e9d8a17e8 3 minutes ago 1.62GB

Start the mariadb container
----------------------------

.. code-block:: bash

  cd $HOME/onap/workspace/SO/docker-config

  MTU=1500 docker-compose up mariadb

*Example Output:*

.. code-block:: bash

  . . . many lines omitted . . .
  mariadb_1  | Version: '10.1.11-MariaDB-1~jessie-log'  socket: '/var/run/mysqld/mysqld.sock'  port: 3306  mariadb.org binary distribution

Log into the mariadb container and run the mysql client program
---------------------------------------------------------------

.. code-block:: bash

  docker exec -it dockerconfig_mariadb_1 /bin/bash
  mysql -uroot -ppassword

Start the mso container
-----------------------

.. code-block:: bash

  cd $HOME/onap/workspace/SO/docker-config

  MTU=1500 docker-compose up mso

*Example Output:*

.. code-block:: bash

  . . . many lines omitted . . .
  mso_1      | 20:59:31,586 INFO  [org.jboss.as] (Controller Boot Thread) WFLYSRV0025: WildFly Full 10.1.0.Final 
  (WildFly Core 2.2.0.Final) started in 59937ms - Started 2422 of 2747 services (604 services are lazy, passive or
  on-demand)

Log into the mso container
--------------------------

.. code-block:: bash

  docker exec -it dockerconfig_mso_1 /bin/bash

Inspect a docker image
----------------------

This command shows interesting information about the structure of the mso image.  Note that an image is NOT a running container.  It is the template that a container is created from.

.. code-block:: bash

  docker inspect openecomp/mso
  Example Output:

  [
    {
        "Id": "sha256:419e9d8a17e8d7e876dfc36c1f3ed946bccbb29aa6faa6cd8e32fbc77c0ef6e5",
        "RepoTags": [
            "openecomp/mso:1.1-SNAPSHOT-latest",
            "openecomp/mso:1.1.0-SNAPSHOT-STAGING-20170926T2015",
            "openecomp/mso:latest"
        ],
        "RepoDigests": [],
        "Parent": "sha256:70f1ba3d6289411fce96ba78755a3fd6055a370d33464553d72c753889b12693",
        "Comment": "",
        "Created": "2017-09-26T20:40:10.179358574Z",
        "Container": "284aa05909390a3c0ffc1ec6d0f6e2071799d56b08369707505897bc73d2ea30",
        "ContainerConfig": {
            "Hostname": "6397aa10f0c4",
            "Domainname": "",
            "User": "root",
            "AttachStdin": false,
            "AttachStdout": false,
            "AttachStderr": false,
            "ExposedPorts": {
                "8080/tcp": {}
            },
            "Tty": false,
            "OpenStdin": false,
            "StdinOnce": false,
            "Env": [
                "PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin",
                "HTTP_PROXY=",
                "HTTPS_PROXY=",
                "http_proxy=",
                "https_proxy=",
                "JBOSS_HOME=/opt/jboss",
                "CHEF_REPO_NAME=chef-repo",
                "CHEF_CONFIG_NAME=mso-config"
            ],
            "Cmd": [
                "/bin/sh",
                "-c",
                "#(nop) ",
                "CMD [\"/opt/mso/scripts/start-jboss-server.sh\"]"
            ],
            "ArgsEscaped": true,
            "Image": "sha256:70f1ba3d6289411fce96ba78755a3fd6055a370d33464553d72c753889b12693",
            "Volumes": {
                "/shared": {}
            },
            "WorkingDir": "",
            "Entrypoint": null,
            "OnBuild": [],
            "Labels": {
                "Description": "This image contains the ONAP SO",
                "Version": "1.0"
            }
        },
        "DockerVersion": "17.05.0-ce",
        "Author": "\"The ONAP Team\"",
        "Config": {
            "Hostname": "6397aa10f0c4",
            "Domainname": "",
            "User": "root",
            "AttachStdin": false,
            "AttachStdout": false,
            "AttachStderr": false,
            "ExposedPorts": {
                "8080/tcp": {}
            },
            "Tty": false,
            "OpenStdin": false,
            "StdinOnce": false,
            "Env": [
                "PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin",
                "HTTP_PROXY=",
                "HTTPS_PROXY=",
                "http_proxy=",
                "https_proxy=",
                "JBOSS_HOME=/opt/jboss",
                "CHEF_REPO_NAME=chef-repo",
                "CHEF_CONFIG_NAME=mso-config"
            ],
            "Cmd": [
                "/opt/mso/scripts/start-jboss-server.sh"
            ],
            "ArgsEscaped": true,
            "Image": "sha256:70f1ba3d6289411fce96ba78755a3fd6055a370d33464553d72c753889b12693",
            "Volumes": {
                "/shared": {}
            },
            "WorkingDir": "",
            "Entrypoint": null,
            "OnBuild": [],
            "Labels": {
                "Description": "This image contains the ONAP SO",
                "Version": "1.0"
            }
        },
        "Architecture": "amd64",
        "Os": "linux",
        "Size": 1616881263,
        "VirtualSize": 1616881263,
        "GraphDriver": {
            "Data": null,
            "Name": "aufs"
        },
        "RootFS": {
            "Type": "layers",
            "Layers": [
                "sha256:a2022691bf950a72f9d2d84d557183cb9eee07c065a76485f1695784855c5193",
                "sha256:ae620432889d2553535199dbdd8ba5a264ce85fcdcd5a430974d81fc27c02b45",
                . . .  many lines omitted . . .
                "sha256:0f9e9dacce9191617e979f05e32ee782b1632e07130fd7fee19b0b2d635aa006",
                "sha256:84572c6389f8ae41150e14a8f1a28a70720de91ab1032f8755b5449dc04449c9"
            ]
        }
    }
]

Log into the mso image
-----------------------

This command allows you to inspect the files inside the mso image.  Note that an image is NOT a running container.  It is the template that a container is created from.

.. code-block:: bash

  docker run -it --entrypoint=/bin/bash openecomp/mso -i