Browse Source

openstack docker changes in stackforge cookbooks

Change-Id: I0d4beac877266b177bb101e86d025d5c0497c162
root 4 years ago
parent
commit
48929cfba5
1 changed files with 170 additions and 0 deletions
  1. 170
    0
      specs/kilo/openstack-docker/openstack-docker.rst

+ 170
- 0
specs/kilo/openstack-docker/openstack-docker.rst View File

@@ -0,0 +1,170 @@
1
+=================================================
2
+Configure openstack services with docker support
3
+=================================================
4
+
5
+Include the URL of your launchpad blueprint:
6
+
7
+https://blueprints.launchpad.net/openstack-chef/+spec/docker-driver-configuration
8
+
9
+The Docker driver is a hypervisor driver for Openstack Nova Compute. It was introduced with the Havana release.
10
+Docker is an open-source engine which automates the deployment of applications as highly portable, self-sufficient
11
+containers which are independent of hardware, language, framework, packaging system and hosting provider.
12
+
13
+Refer [OPENSTACK_DOCKER_DOCUMENTATION]_.
14
+
15
+This new change proposed will enable deployment and configuration of nova-docker driver, glance repo configuration
16
+and any needed config to support seemless managment of docker nodes in openstack cloud.
17
+
18
+
19
+Problem description
20
+===================
21
+
22
+* Currently, openstack-compute does not support nova-docker driver
23
+
24
+* Currently, openstack-image does not support docker container formats
25
+  for images which includes docker and dockerref
26
+
27
+* [OPENSTACK_DOCKER_COOKBOOK_OLD]_ is an available
28
+  option which is not maintained for last 2 years and it has embedded
29
+  2 years old driver.
30
+
31
+
32
+Proposed change
33
+===============
34
+
35
+Add support in openstack-compute cookbook to configure [NOVA_DOCKER_DRIVER]_.
36
+Current support will be to download the nova docker driver from git repo and configure.
37
+
38
+Also change openstack-image to support container formats for docker images
39
+which includes docker and dockerref
40
+
41
+Alternatives
42
+------------
43
+
44
+None
45
+
46
+Data model impact
47
+-----------------
48
+
49
+None
50
+
51
+REST API impact
52
+---------------
53
+
54
+None
55
+
56
+Security impact
57
+---------------
58
+
59
+None
60
+
61
+Notifications impact
62
+--------------------
63
+
64
+None
65
+
66
+Other end user impact
67
+---------------------
68
+
69
+None
70
+
71
+Performance Impact
72
+------------------
73
+
74
+None
75
+
76
+Other deployer impact
77
+---------------------
78
+
79
+None
80
+
81
+Developer impact
82
+----------------
83
+
84
+None
85
+
86
+
87
+Implementation
88
+==============
89
+
90
+Assignee(s)
91
+-----------
92
+
93
+Primary assignee:
94
+  - skairali@cn.ibm.com
95
+
96
+Other contributors:
97
+  - ashish.billore1@in.ibm.com
98
+
99
+Work Items
100
+----------
101
+
102
+* Add new attributes to openstack-compute
103
+
104
+* Change openstack-compute / nova.conf.erb  template for including nova-docker driver
105
+
106
+* Add new recipe for docker configuration in openstack-compute
107
+
108
+* Change compute.rb  recipe in openstack-compute to include the new recipe based on configuration
109
+
110
+* Add the unit tests.
111
+
112
+* Change openstack-image and add new container formats in attributes
113
+
114
+
115
+Dependencies
116
+============
117
+
118
+* In order to configure nova-docker driver - compute nodes should be pre installed with
119
+  docker runtime. Users can opt to use cookbook [CHEF_DOCKER]_
120
+  In case above cookbook does not support the OS where compute is getting configured
121
+  use doucmentation which is available at [DOCKER_RUNTIME_INSTALLATION]_.
122
+
123
+* This depends on Nova Docker driver [NOVA_DOCKER_DRIVER]_.
124
+  Currently a git clone of above source in .zip format is required to complete nova configuration
125
+
126
+
127
+Testing
128
+=======
129
+
130
+* Add unit tests for the recipes.
131
+
132
+* For function and CI integration test, at least one node with OpenStack
133
+  all-in-one deployment is recommended.
134
+
135
+* In order to configure a compute node as docker compute(while testing using openstack-chef-repo)
136
+  override the attribute to true using environment which indicates whether a node is docker type or not
137
+
138
+* Prior to testing, install docker runtime to all compute nodes. Refer Dependencies for more details
139
+
140
+
141
+Documentation Impact
142
+====================
143
+
144
+* Change README.md. in openstack-compute
145
+
146
+
147
+References
148
+==========
149
+
150
+
151
+.. [CHEF_DOCKER] `Chef docker cookbook
152
+   <https://github.com/bflad/chef-docker>`_
153
+
154
+.. [DOCKER_RUNTIME_INSTALLATION] `Docker runtime installation
155
+   <https://docs.docker.com/installation>`_
156
+
157
+.. [NOVA_DOCKER_DRIVER] `Nova docker driver
158
+   <https://github.com/stackforge/nova-docker/tree/master>`_
159
+
160
+.. [OPENSTACK_DOCKER_COOKBOOK_OLD] `Openstack Docker cookbook old
161
+   <https://github.com/paulczar/cookbook-openstack-docker>`_
162
+
163
+.. [OPENSTACK_DOCKER_DOCUMENTATION] `Openstack Docker Documentation
164
+   <https://wiki.openstack.org/wiki/Docker>`_
165
+
166
+
167
+Possible Future Enhancements
168
+============================
169
+
170
+Change openstack-telemetry cookbook to support monitoring of docker computes

Loading…
Cancel
Save