project_test.py 46 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041104210431044104510461047104810491050105110521053105410551056105710581059106010611062106310641065106610671068106910701071107210731074107510761077107810791080108110821083108410851086108710881089109010911092109310941095109610971098109911001101110211031104110511061107110811091110111111121113111411151116111711181119112011211122112311241125112611271128112911301131113211331134113511361137113811391140114111421143114411451146114711481149115011511152115311541155115611571158115911601161116211631164116511661167116811691170117111721173117411751176117711781179118011811182118311841185118611871188118911901191119211931194119511961197119811991200120112021203120412051206120712081209121012111212121312141215121612171218121912201221122212231224122512261227122812291230123112321233123412351236123712381239124012411242124312441245124612471248124912501251125212531254125512561257125812591260126112621263126412651266126712681269127012711272127312741275127612771278127912801281128212831284128512861287128812891290129112921293129412951296129712981299130013011302130313041305130613071308130913101311131213131314131513161317131813191320132113221323132413251326132713281329133013311332133313341335133613371338133913401341134213431344134513461347134813491350135113521353135413551356135713581359136013611362136313641365136613671368136913701371137213731374137513761377
  1. from __future__ import absolute_import
  2. from __future__ import unicode_literals
  3. import random
  4. import py
  5. import pytest
  6. from docker.errors import NotFound
  7. from .. import mock
  8. from ..helpers import build_config
  9. from .testcases import DockerClientTestCase
  10. from compose.config import config
  11. from compose.config import ConfigurationError
  12. from compose.config.config import V2_0
  13. from compose.config.config import V2_1
  14. from compose.config.types import VolumeFromSpec
  15. from compose.config.types import VolumeSpec
  16. from compose.const import LABEL_PROJECT
  17. from compose.const import LABEL_SERVICE
  18. from compose.container import Container
  19. from compose.project import Project
  20. from compose.project import ProjectError
  21. from compose.service import ConvergenceStrategy
  22. from tests.integration.testcases import v2_1_only
  23. from tests.integration.testcases import v2_only
  24. class ProjectTest(DockerClientTestCase):
  25. def test_containers(self):
  26. web = self.create_service('web')
  27. db = self.create_service('db')
  28. project = Project('composetest', [web, db], self.client)
  29. project.up()
  30. containers = project.containers()
  31. self.assertEqual(len(containers), 2)
  32. def test_containers_with_service_names(self):
  33. web = self.create_service('web')
  34. db = self.create_service('db')
  35. project = Project('composetest', [web, db], self.client)
  36. project.up()
  37. containers = project.containers(['web'])
  38. self.assertEqual(
  39. [c.name for c in containers],
  40. ['composetest_web_1'])
  41. def test_containers_with_extra_service(self):
  42. web = self.create_service('web')
  43. web_1 = web.create_container()
  44. db = self.create_service('db')
  45. db_1 = db.create_container()
  46. self.create_service('extra').create_container()
  47. project = Project('composetest', [web, db], self.client)
  48. self.assertEqual(
  49. set(project.containers(stopped=True)),
  50. set([web_1, db_1]),
  51. )
  52. def test_volumes_from_service(self):
  53. project = Project.from_config(
  54. name='composetest',
  55. config_data=build_config({
  56. 'data': {
  57. 'image': 'busybox:latest',
  58. 'volumes': ['/var/data'],
  59. },
  60. 'db': {
  61. 'image': 'busybox:latest',
  62. 'volumes_from': ['data'],
  63. },
  64. }),
  65. client=self.client,
  66. )
  67. db = project.get_service('db')
  68. data = project.get_service('data')
  69. self.assertEqual(db.volumes_from, [VolumeFromSpec(data, 'rw', 'service')])
  70. def test_volumes_from_container(self):
  71. data_container = Container.create(
  72. self.client,
  73. image='busybox:latest',
  74. volumes=['/var/data'],
  75. name='composetest_data_container',
  76. labels={LABEL_PROJECT: 'composetest'},
  77. )
  78. project = Project.from_config(
  79. name='composetest',
  80. config_data=build_config({
  81. 'db': {
  82. 'image': 'busybox:latest',
  83. 'volumes_from': ['composetest_data_container'],
  84. },
  85. }),
  86. client=self.client,
  87. )
  88. db = project.get_service('db')
  89. self.assertEqual(db._get_volumes_from(), [data_container.id + ':rw'])
  90. @v2_only()
  91. def test_network_mode_from_service(self):
  92. project = Project.from_config(
  93. name='composetest',
  94. client=self.client,
  95. config_data=build_config({
  96. 'version': V2_0,
  97. 'services': {
  98. 'net': {
  99. 'image': 'busybox:latest',
  100. 'command': ["top"]
  101. },
  102. 'web': {
  103. 'image': 'busybox:latest',
  104. 'network_mode': 'service:net',
  105. 'command': ["top"]
  106. },
  107. },
  108. }),
  109. )
  110. project.up()
  111. web = project.get_service('web')
  112. net = project.get_service('net')
  113. self.assertEqual(web.network_mode.mode, 'container:' + net.containers()[0].id)
  114. @v2_only()
  115. def test_network_mode_from_container(self):
  116. def get_project():
  117. return Project.from_config(
  118. name='composetest',
  119. config_data=build_config({
  120. 'version': V2_0,
  121. 'services': {
  122. 'web': {
  123. 'image': 'busybox:latest',
  124. 'network_mode': 'container:composetest_net_container'
  125. },
  126. },
  127. }),
  128. client=self.client,
  129. )
  130. with pytest.raises(ConfigurationError) as excinfo:
  131. get_project()
  132. assert "container 'composetest_net_container' which does not exist" in excinfo.exconly()
  133. net_container = Container.create(
  134. self.client,
  135. image='busybox:latest',
  136. name='composetest_net_container',
  137. command='top',
  138. labels={LABEL_PROJECT: 'composetest'},
  139. )
  140. net_container.start()
  141. project = get_project()
  142. project.up()
  143. web = project.get_service('web')
  144. self.assertEqual(web.network_mode.mode, 'container:' + net_container.id)
  145. def test_net_from_service_v1(self):
  146. project = Project.from_config(
  147. name='composetest',
  148. config_data=build_config({
  149. 'net': {
  150. 'image': 'busybox:latest',
  151. 'command': ["top"]
  152. },
  153. 'web': {
  154. 'image': 'busybox:latest',
  155. 'net': 'container:net',
  156. 'command': ["top"]
  157. },
  158. }),
  159. client=self.client,
  160. )
  161. project.up()
  162. web = project.get_service('web')
  163. net = project.get_service('net')
  164. self.assertEqual(web.network_mode.mode, 'container:' + net.containers()[0].id)
  165. def test_net_from_container_v1(self):
  166. def get_project():
  167. return Project.from_config(
  168. name='composetest',
  169. config_data=build_config({
  170. 'web': {
  171. 'image': 'busybox:latest',
  172. 'net': 'container:composetest_net_container'
  173. },
  174. }),
  175. client=self.client,
  176. )
  177. with pytest.raises(ConfigurationError) as excinfo:
  178. get_project()
  179. assert "container 'composetest_net_container' which does not exist" in excinfo.exconly()
  180. net_container = Container.create(
  181. self.client,
  182. image='busybox:latest',
  183. name='composetest_net_container',
  184. command='top',
  185. labels={LABEL_PROJECT: 'composetest'},
  186. )
  187. net_container.start()
  188. project = get_project()
  189. project.up()
  190. web = project.get_service('web')
  191. self.assertEqual(web.network_mode.mode, 'container:' + net_container.id)
  192. def test_start_pause_unpause_stop_kill_remove(self):
  193. web = self.create_service('web')
  194. db = self.create_service('db')
  195. project = Project('composetest', [web, db], self.client)
  196. project.start()
  197. self.assertEqual(len(web.containers()), 0)
  198. self.assertEqual(len(db.containers()), 0)
  199. web_container_1 = web.create_container()
  200. web_container_2 = web.create_container()
  201. db_container = db.create_container()
  202. project.start(service_names=['web'])
  203. self.assertEqual(
  204. set(c.name for c in project.containers()),
  205. set([web_container_1.name, web_container_2.name]))
  206. project.start()
  207. self.assertEqual(
  208. set(c.name for c in project.containers()),
  209. set([web_container_1.name, web_container_2.name, db_container.name]))
  210. project.pause(service_names=['web'])
  211. self.assertEqual(
  212. set([c.name for c in project.containers() if c.is_paused]),
  213. set([web_container_1.name, web_container_2.name]))
  214. project.pause()
  215. self.assertEqual(
  216. set([c.name for c in project.containers() if c.is_paused]),
  217. set([web_container_1.name, web_container_2.name, db_container.name]))
  218. project.unpause(service_names=['db'])
  219. self.assertEqual(len([c.name for c in project.containers() if c.is_paused]), 2)
  220. project.unpause()
  221. self.assertEqual(len([c.name for c in project.containers() if c.is_paused]), 0)
  222. project.stop(service_names=['web'], timeout=1)
  223. self.assertEqual(set(c.name for c in project.containers()), set([db_container.name]))
  224. project.kill(service_names=['db'])
  225. self.assertEqual(len(project.containers()), 0)
  226. self.assertEqual(len(project.containers(stopped=True)), 3)
  227. project.remove_stopped(service_names=['web'])
  228. self.assertEqual(len(project.containers(stopped=True)), 1)
  229. project.remove_stopped()
  230. self.assertEqual(len(project.containers(stopped=True)), 0)
  231. def test_create(self):
  232. web = self.create_service('web')
  233. db = self.create_service('db', volumes=[VolumeSpec.parse('/var/db')])
  234. project = Project('composetest', [web, db], self.client)
  235. project.create(['db'])
  236. self.assertEqual(len(project.containers()), 0)
  237. self.assertEqual(len(project.containers(stopped=True)), 1)
  238. self.assertEqual(len(db.containers()), 0)
  239. self.assertEqual(len(db.containers(stopped=True)), 1)
  240. self.assertEqual(len(web.containers(stopped=True)), 0)
  241. def test_create_twice(self):
  242. web = self.create_service('web')
  243. db = self.create_service('db', volumes=[VolumeSpec.parse('/var/db')])
  244. project = Project('composetest', [web, db], self.client)
  245. project.create(['db', 'web'])
  246. project.create(['db', 'web'])
  247. self.assertEqual(len(project.containers()), 0)
  248. self.assertEqual(len(project.containers(stopped=True)), 2)
  249. self.assertEqual(len(db.containers()), 0)
  250. self.assertEqual(len(db.containers(stopped=True)), 1)
  251. self.assertEqual(len(web.containers()), 0)
  252. self.assertEqual(len(web.containers(stopped=True)), 1)
  253. def test_create_with_links(self):
  254. db = self.create_service('db')
  255. web = self.create_service('web', links=[(db, 'db')])
  256. project = Project('composetest', [db, web], self.client)
  257. project.create(['web'])
  258. self.assertEqual(len(project.containers()), 0)
  259. self.assertEqual(len(project.containers(stopped=True)), 2)
  260. self.assertEqual(len(db.containers()), 0)
  261. self.assertEqual(len(db.containers(stopped=True)), 1)
  262. self.assertEqual(len(web.containers()), 0)
  263. self.assertEqual(len(web.containers(stopped=True)), 1)
  264. def test_create_strategy_always(self):
  265. db = self.create_service('db')
  266. project = Project('composetest', [db], self.client)
  267. project.create(['db'])
  268. old_id = project.containers(stopped=True)[0].id
  269. project.create(['db'], strategy=ConvergenceStrategy.always)
  270. self.assertEqual(len(project.containers()), 0)
  271. self.assertEqual(len(project.containers(stopped=True)), 1)
  272. db_container = project.containers(stopped=True)[0]
  273. self.assertNotEqual(db_container.id, old_id)
  274. def test_create_strategy_never(self):
  275. db = self.create_service('db')
  276. project = Project('composetest', [db], self.client)
  277. project.create(['db'])
  278. old_id = project.containers(stopped=True)[0].id
  279. project.create(['db'], strategy=ConvergenceStrategy.never)
  280. self.assertEqual(len(project.containers()), 0)
  281. self.assertEqual(len(project.containers(stopped=True)), 1)
  282. db_container = project.containers(stopped=True)[0]
  283. self.assertEqual(db_container.id, old_id)
  284. def test_project_up(self):
  285. web = self.create_service('web')
  286. db = self.create_service('db', volumes=[VolumeSpec.parse('/var/db')])
  287. project = Project('composetest', [web, db], self.client)
  288. project.start()
  289. self.assertEqual(len(project.containers()), 0)
  290. project.up(['db'])
  291. self.assertEqual(len(project.containers()), 1)
  292. self.assertEqual(len(db.containers()), 1)
  293. self.assertEqual(len(web.containers()), 0)
  294. def test_project_up_starts_uncreated_services(self):
  295. db = self.create_service('db')
  296. web = self.create_service('web', links=[(db, 'db')])
  297. project = Project('composetest', [db, web], self.client)
  298. project.up(['db'])
  299. self.assertEqual(len(project.containers()), 1)
  300. project.up()
  301. self.assertEqual(len(project.containers()), 2)
  302. self.assertEqual(len(db.containers()), 1)
  303. self.assertEqual(len(web.containers()), 1)
  304. def test_recreate_preserves_volumes(self):
  305. web = self.create_service('web')
  306. db = self.create_service('db', volumes=[VolumeSpec.parse('/etc')])
  307. project = Project('composetest', [web, db], self.client)
  308. project.start()
  309. self.assertEqual(len(project.containers()), 0)
  310. project.up(['db'])
  311. self.assertEqual(len(project.containers()), 1)
  312. old_db_id = project.containers()[0].id
  313. db_volume_path = project.containers()[0].get('Volumes./etc')
  314. project.up(strategy=ConvergenceStrategy.always)
  315. self.assertEqual(len(project.containers()), 2)
  316. db_container = [c for c in project.containers() if 'db' in c.name][0]
  317. self.assertNotEqual(db_container.id, old_db_id)
  318. self.assertEqual(db_container.get('Volumes./etc'), db_volume_path)
  319. def test_project_up_with_no_recreate_running(self):
  320. web = self.create_service('web')
  321. db = self.create_service('db', volumes=[VolumeSpec.parse('/var/db')])
  322. project = Project('composetest', [web, db], self.client)
  323. project.start()
  324. self.assertEqual(len(project.containers()), 0)
  325. project.up(['db'])
  326. self.assertEqual(len(project.containers()), 1)
  327. old_db_id = project.containers()[0].id
  328. container, = project.containers()
  329. db_volume_path = container.get_mount('/var/db')['Source']
  330. project.up(strategy=ConvergenceStrategy.never)
  331. self.assertEqual(len(project.containers()), 2)
  332. db_container = [c for c in project.containers() if 'db' in c.name][0]
  333. self.assertEqual(db_container.id, old_db_id)
  334. self.assertEqual(
  335. db_container.get_mount('/var/db')['Source'],
  336. db_volume_path)
  337. def test_project_up_with_no_recreate_stopped(self):
  338. web = self.create_service('web')
  339. db = self.create_service('db', volumes=[VolumeSpec.parse('/var/db')])
  340. project = Project('composetest', [web, db], self.client)
  341. project.start()
  342. self.assertEqual(len(project.containers()), 0)
  343. project.up(['db'])
  344. project.kill()
  345. old_containers = project.containers(stopped=True)
  346. self.assertEqual(len(old_containers), 1)
  347. old_container, = old_containers
  348. old_db_id = old_container.id
  349. db_volume_path = old_container.get_mount('/var/db')['Source']
  350. project.up(strategy=ConvergenceStrategy.never)
  351. new_containers = project.containers(stopped=True)
  352. self.assertEqual(len(new_containers), 2)
  353. self.assertEqual([c.is_running for c in new_containers], [True, True])
  354. db_container = [c for c in new_containers if 'db' in c.name][0]
  355. self.assertEqual(db_container.id, old_db_id)
  356. self.assertEqual(
  357. db_container.get_mount('/var/db')['Source'],
  358. db_volume_path)
  359. def test_project_up_without_all_services(self):
  360. console = self.create_service('console')
  361. db = self.create_service('db')
  362. project = Project('composetest', [console, db], self.client)
  363. project.start()
  364. self.assertEqual(len(project.containers()), 0)
  365. project.up()
  366. self.assertEqual(len(project.containers()), 2)
  367. self.assertEqual(len(db.containers()), 1)
  368. self.assertEqual(len(console.containers()), 1)
  369. def test_project_up_starts_links(self):
  370. console = self.create_service('console')
  371. db = self.create_service('db', volumes=[VolumeSpec.parse('/var/db')])
  372. web = self.create_service('web', links=[(db, 'db')])
  373. project = Project('composetest', [web, db, console], self.client)
  374. project.start()
  375. self.assertEqual(len(project.containers()), 0)
  376. project.up(['web'])
  377. self.assertEqual(len(project.containers()), 2)
  378. self.assertEqual(len(web.containers()), 1)
  379. self.assertEqual(len(db.containers()), 1)
  380. self.assertEqual(len(console.containers()), 0)
  381. def test_project_up_starts_depends(self):
  382. project = Project.from_config(
  383. name='composetest',
  384. config_data=build_config({
  385. 'console': {
  386. 'image': 'busybox:latest',
  387. 'command': ["top"],
  388. },
  389. 'data': {
  390. 'image': 'busybox:latest',
  391. 'command': ["top"]
  392. },
  393. 'db': {
  394. 'image': 'busybox:latest',
  395. 'command': ["top"],
  396. 'volumes_from': ['data'],
  397. },
  398. 'web': {
  399. 'image': 'busybox:latest',
  400. 'command': ["top"],
  401. 'links': ['db'],
  402. },
  403. }),
  404. client=self.client,
  405. )
  406. project.start()
  407. self.assertEqual(len(project.containers()), 0)
  408. project.up(['web'])
  409. self.assertEqual(len(project.containers()), 3)
  410. self.assertEqual(len(project.get_service('web').containers()), 1)
  411. self.assertEqual(len(project.get_service('db').containers()), 1)
  412. self.assertEqual(len(project.get_service('data').containers()), 1)
  413. self.assertEqual(len(project.get_service('console').containers()), 0)
  414. def test_project_up_with_no_deps(self):
  415. project = Project.from_config(
  416. name='composetest',
  417. config_data=build_config({
  418. 'console': {
  419. 'image': 'busybox:latest',
  420. 'command': ["top"],
  421. },
  422. 'data': {
  423. 'image': 'busybox:latest',
  424. 'command': ["top"]
  425. },
  426. 'db': {
  427. 'image': 'busybox:latest',
  428. 'command': ["top"],
  429. 'volumes_from': ['data'],
  430. },
  431. 'web': {
  432. 'image': 'busybox:latest',
  433. 'command': ["top"],
  434. 'links': ['db'],
  435. },
  436. }),
  437. client=self.client,
  438. )
  439. project.start()
  440. self.assertEqual(len(project.containers()), 0)
  441. project.up(['db'], start_deps=False)
  442. self.assertEqual(len(project.containers(stopped=True)), 2)
  443. self.assertEqual(len(project.get_service('web').containers()), 0)
  444. self.assertEqual(len(project.get_service('db').containers()), 1)
  445. self.assertEqual(len(project.get_service('data').containers()), 0)
  446. self.assertEqual(len(project.get_service('data').containers(stopped=True)), 1)
  447. self.assertEqual(len(project.get_service('console').containers()), 0)
  448. def test_unscale_after_restart(self):
  449. web = self.create_service('web')
  450. project = Project('composetest', [web], self.client)
  451. project.start()
  452. service = project.get_service('web')
  453. service.scale(1)
  454. self.assertEqual(len(service.containers()), 1)
  455. service.scale(3)
  456. self.assertEqual(len(service.containers()), 3)
  457. project.up()
  458. service = project.get_service('web')
  459. self.assertEqual(len(service.containers()), 3)
  460. service.scale(1)
  461. self.assertEqual(len(service.containers()), 1)
  462. project.up()
  463. service = project.get_service('web')
  464. self.assertEqual(len(service.containers()), 1)
  465. # does scale=0 ,makes any sense? after recreating at least 1 container is running
  466. service.scale(0)
  467. project.up()
  468. service = project.get_service('web')
  469. self.assertEqual(len(service.containers()), 1)
  470. @v2_only()
  471. def test_project_up_networks(self):
  472. config_data = config.Config(
  473. version=V2_0,
  474. services=[{
  475. 'name': 'web',
  476. 'image': 'busybox:latest',
  477. 'command': 'top',
  478. 'networks': {
  479. 'foo': None,
  480. 'bar': None,
  481. 'baz': {'aliases': ['extra']},
  482. },
  483. }],
  484. volumes={},
  485. networks={
  486. 'foo': {'driver': 'bridge'},
  487. 'bar': {'driver': None},
  488. 'baz': {},
  489. },
  490. )
  491. project = Project.from_config(
  492. client=self.client,
  493. name='composetest',
  494. config_data=config_data,
  495. )
  496. project.up()
  497. containers = project.containers()
  498. assert len(containers) == 1
  499. container, = containers
  500. for net_name in ['foo', 'bar', 'baz']:
  501. full_net_name = 'composetest_{}'.format(net_name)
  502. network_data = self.client.inspect_network(full_net_name)
  503. assert network_data['Name'] == full_net_name
  504. aliases_key = 'NetworkSettings.Networks.{net}.Aliases'
  505. assert 'web' in container.get(aliases_key.format(net='composetest_foo'))
  506. assert 'web' in container.get(aliases_key.format(net='composetest_baz'))
  507. assert 'extra' in container.get(aliases_key.format(net='composetest_baz'))
  508. foo_data = self.client.inspect_network('composetest_foo')
  509. assert foo_data['Driver'] == 'bridge'
  510. @v2_only()
  511. def test_up_with_ipam_config(self):
  512. config_data = config.Config(
  513. version=V2_0,
  514. services=[{
  515. 'name': 'web',
  516. 'image': 'busybox:latest',
  517. 'networks': {'front': None},
  518. }],
  519. volumes={},
  520. networks={
  521. 'front': {
  522. 'driver': 'bridge',
  523. 'driver_opts': {
  524. "com.docker.network.bridge.enable_icc": "false",
  525. },
  526. 'ipam': {
  527. 'driver': 'default',
  528. 'config': [{
  529. "subnet": "172.28.0.0/16",
  530. "ip_range": "172.28.5.0/24",
  531. "gateway": "172.28.5.254",
  532. "aux_addresses": {
  533. "a": "172.28.1.5",
  534. "b": "172.28.1.6",
  535. "c": "172.28.1.7",
  536. },
  537. }],
  538. },
  539. },
  540. },
  541. )
  542. project = Project.from_config(
  543. client=self.client,
  544. name='composetest',
  545. config_data=config_data,
  546. )
  547. project.up()
  548. network = self.client.networks(names=['composetest_front'])[0]
  549. assert network['Options'] == {
  550. "com.docker.network.bridge.enable_icc": "false"
  551. }
  552. assert network['IPAM'] == {
  553. 'Driver': 'default',
  554. 'Options': None,
  555. 'Config': [{
  556. 'Subnet': "172.28.0.0/16",
  557. 'IPRange': "172.28.5.0/24",
  558. 'Gateway': "172.28.5.254",
  559. 'AuxiliaryAddresses': {
  560. 'a': '172.28.1.5',
  561. 'b': '172.28.1.6',
  562. 'c': '172.28.1.7',
  563. },
  564. }],
  565. }
  566. @v2_only()
  567. def test_up_with_network_static_addresses(self):
  568. config_data = config.Config(
  569. version=V2_0,
  570. services=[{
  571. 'name': 'web',
  572. 'image': 'busybox:latest',
  573. 'command': 'top',
  574. 'networks': {
  575. 'static_test': {
  576. 'ipv4_address': '172.16.100.100',
  577. 'ipv6_address': 'fe80::1001:102'
  578. }
  579. },
  580. }],
  581. volumes={},
  582. networks={
  583. 'static_test': {
  584. 'driver': 'bridge',
  585. 'driver_opts': {
  586. "com.docker.network.enable_ipv6": "true",
  587. },
  588. 'ipam': {
  589. 'driver': 'default',
  590. 'config': [
  591. {"subnet": "172.16.100.0/24",
  592. "gateway": "172.16.100.1"},
  593. {"subnet": "fe80::/64",
  594. "gateway": "fe80::1001:1"}
  595. ]
  596. }
  597. }
  598. }
  599. )
  600. project = Project.from_config(
  601. client=self.client,
  602. name='composetest',
  603. config_data=config_data,
  604. )
  605. project.up(detached=True)
  606. network = self.client.networks(names=['static_test'])[0]
  607. service_container = project.get_service('web').containers()[0]
  608. assert network['Options'] == {
  609. "com.docker.network.enable_ipv6": "true"
  610. }
  611. IPAMConfig = (service_container.inspect().get('NetworkSettings', {}).
  612. get('Networks', {}).get('composetest_static_test', {}).
  613. get('IPAMConfig', {}))
  614. assert IPAMConfig.get('IPv4Address') == '172.16.100.100'
  615. assert IPAMConfig.get('IPv6Address') == 'fe80::1001:102'
  616. @v2_1_only()
  617. def test_up_with_enable_ipv6(self):
  618. self.require_api_version('1.23')
  619. config_data = config.Config(
  620. version=V2_0,
  621. services=[{
  622. 'name': 'web',
  623. 'image': 'busybox:latest',
  624. 'command': 'top',
  625. 'networks': {
  626. 'static_test': {
  627. 'ipv6_address': 'fe80::1001:102'
  628. }
  629. },
  630. }],
  631. volumes={},
  632. networks={
  633. 'static_test': {
  634. 'driver': 'bridge',
  635. 'enable_ipv6': True,
  636. 'ipam': {
  637. 'driver': 'default',
  638. 'config': [
  639. {"subnet": "fe80::/64",
  640. "gateway": "fe80::1001:1"}
  641. ]
  642. }
  643. }
  644. }
  645. )
  646. project = Project.from_config(
  647. client=self.client,
  648. name='composetest',
  649. config_data=config_data,
  650. )
  651. project.up(detached=True)
  652. network = self.client.networks(names=['static_test'])[0]
  653. service_container = project.get_service('web').containers()[0]
  654. assert network['EnableIPv6'] is True
  655. ipam_config = (service_container.inspect().get('NetworkSettings', {}).
  656. get('Networks', {}).get('composetest_static_test', {}).
  657. get('IPAMConfig', {}))
  658. assert ipam_config.get('IPv6Address') == 'fe80::1001:102'
  659. @v2_only()
  660. def test_up_with_network_static_addresses_missing_subnet(self):
  661. config_data = config.Config(
  662. version=V2_0,
  663. services=[{
  664. 'name': 'web',
  665. 'image': 'busybox:latest',
  666. 'networks': {
  667. 'static_test': {
  668. 'ipv4_address': '172.16.100.100',
  669. 'ipv6_address': 'fe80::1001:101'
  670. }
  671. },
  672. }],
  673. volumes={},
  674. networks={
  675. 'static_test': {
  676. 'driver': 'bridge',
  677. 'driver_opts': {
  678. "com.docker.network.enable_ipv6": "true",
  679. },
  680. 'ipam': {
  681. 'driver': 'default',
  682. },
  683. },
  684. },
  685. )
  686. project = Project.from_config(
  687. client=self.client,
  688. name='composetest',
  689. config_data=config_data,
  690. )
  691. with self.assertRaises(ProjectError):
  692. project.up()
  693. @v2_1_only()
  694. def test_up_with_network_link_local_ips(self):
  695. config_data = config.Config(
  696. version=V2_1,
  697. services=[{
  698. 'name': 'web',
  699. 'image': 'busybox:latest',
  700. 'networks': {
  701. 'linklocaltest': {
  702. 'link_local_ips': ['169.254.8.8']
  703. }
  704. }
  705. }],
  706. volumes={},
  707. networks={
  708. 'linklocaltest': {'driver': 'bridge'}
  709. }
  710. )
  711. project = Project.from_config(
  712. client=self.client,
  713. name='composetest',
  714. config_data=config_data
  715. )
  716. project.up(detached=True)
  717. service_container = project.get_service('web').containers(stopped=True)[0]
  718. ipam_config = service_container.inspect().get(
  719. 'NetworkSettings', {}
  720. ).get(
  721. 'Networks', {}
  722. ).get(
  723. 'composetest_linklocaltest', {}
  724. ).get('IPAMConfig', {})
  725. assert 'LinkLocalIPs' in ipam_config
  726. assert ipam_config['LinkLocalIPs'] == ['169.254.8.8']
  727. @v2_1_only()
  728. def test_up_with_isolation(self):
  729. self.require_api_version('1.24')
  730. config_data = config.Config(
  731. version=V2_1,
  732. services=[{
  733. 'name': 'web',
  734. 'image': 'busybox:latest',
  735. 'isolation': 'default'
  736. }],
  737. volumes={},
  738. networks={}
  739. )
  740. project = Project.from_config(
  741. client=self.client,
  742. name='composetest',
  743. config_data=config_data
  744. )
  745. project.up(detached=True)
  746. service_container = project.get_service('web').containers(stopped=True)[0]
  747. assert service_container.inspect()['HostConfig']['Isolation'] == 'default'
  748. @v2_1_only()
  749. def test_up_with_invalid_isolation(self):
  750. self.require_api_version('1.24')
  751. config_data = config.Config(
  752. version=V2_1,
  753. services=[{
  754. 'name': 'web',
  755. 'image': 'busybox:latest',
  756. 'isolation': 'foobar'
  757. }],
  758. volumes={},
  759. networks={}
  760. )
  761. project = Project.from_config(
  762. client=self.client,
  763. name='composetest',
  764. config_data=config_data
  765. )
  766. with self.assertRaises(ProjectError):
  767. project.up()
  768. @v2_only()
  769. def test_project_up_with_network_internal(self):
  770. self.require_api_version('1.23')
  771. config_data = config.Config(
  772. version=V2_0,
  773. services=[{
  774. 'name': 'web',
  775. 'image': 'busybox:latest',
  776. 'networks': {'internal': None},
  777. }],
  778. volumes={},
  779. networks={
  780. 'internal': {'driver': 'bridge', 'internal': True},
  781. },
  782. )
  783. project = Project.from_config(
  784. client=self.client,
  785. name='composetest',
  786. config_data=config_data,
  787. )
  788. project.up()
  789. network = self.client.networks(names=['composetest_internal'])[0]
  790. assert network['Internal'] is True
  791. @v2_1_only()
  792. def test_project_up_with_network_label(self):
  793. self.require_api_version('1.23')
  794. network_name = 'network_with_label'
  795. config_data = config.Config(
  796. version=V2_0,
  797. services=[{
  798. 'name': 'web',
  799. 'image': 'busybox:latest',
  800. 'networks': {network_name: None}
  801. }],
  802. volumes={},
  803. networks={
  804. network_name: {'labels': {'label_key': 'label_val'}}
  805. }
  806. )
  807. project = Project.from_config(
  808. client=self.client,
  809. name='composetest',
  810. config_data=config_data
  811. )
  812. project.up()
  813. networks = [
  814. n for n in self.client.networks()
  815. if n['Name'].startswith('composetest_')
  816. ]
  817. assert [n['Name'] for n in networks] == ['composetest_{}'.format(network_name)]
  818. assert 'label_key' in networks[0]['Labels']
  819. assert networks[0]['Labels']['label_key'] == 'label_val'
  820. @v2_only()
  821. def test_project_up_volumes(self):
  822. vol_name = '{0:x}'.format(random.getrandbits(32))
  823. full_vol_name = 'composetest_{0}'.format(vol_name)
  824. config_data = config.Config(
  825. version=V2_0,
  826. services=[{
  827. 'name': 'web',
  828. 'image': 'busybox:latest',
  829. 'command': 'top'
  830. }],
  831. volumes={vol_name: {'driver': 'local'}},
  832. networks={},
  833. )
  834. project = Project.from_config(
  835. name='composetest',
  836. config_data=config_data, client=self.client
  837. )
  838. project.up()
  839. self.assertEqual(len(project.containers()), 1)
  840. volume_data = self.client.inspect_volume(full_vol_name)
  841. self.assertEqual(volume_data['Name'], full_vol_name)
  842. self.assertEqual(volume_data['Driver'], 'local')
  843. @v2_1_only()
  844. def test_project_up_with_volume_labels(self):
  845. self.require_api_version('1.23')
  846. volume_name = 'volume_with_label'
  847. config_data = config.Config(
  848. version=V2_0,
  849. services=[{
  850. 'name': 'web',
  851. 'image': 'busybox:latest',
  852. 'volumes': [VolumeSpec.parse('{}:/data'.format(volume_name))]
  853. }],
  854. volumes={
  855. volume_name: {
  856. 'labels': {
  857. 'label_key': 'label_val'
  858. }
  859. }
  860. },
  861. networks={},
  862. )
  863. project = Project.from_config(
  864. client=self.client,
  865. name='composetest',
  866. config_data=config_data,
  867. )
  868. project.up()
  869. volumes = [
  870. v for v in self.client.volumes().get('Volumes', [])
  871. if v['Name'].startswith('composetest_')
  872. ]
  873. assert [v['Name'] for v in volumes] == ['composetest_{}'.format(volume_name)]
  874. assert 'label_key' in volumes[0]['Labels']
  875. assert volumes[0]['Labels']['label_key'] == 'label_val'
  876. @v2_only()
  877. def test_project_up_logging_with_multiple_files(self):
  878. base_file = config.ConfigFile(
  879. 'base.yml',
  880. {
  881. 'version': V2_0,
  882. 'services': {
  883. 'simple': {'image': 'busybox:latest', 'command': 'top'},
  884. 'another': {
  885. 'image': 'busybox:latest',
  886. 'command': 'top',
  887. 'logging': {
  888. 'driver': "json-file",
  889. 'options': {
  890. 'max-size': "10m"
  891. }
  892. }
  893. }
  894. }
  895. })
  896. override_file = config.ConfigFile(
  897. 'override.yml',
  898. {
  899. 'version': V2_0,
  900. 'services': {
  901. 'another': {
  902. 'logging': {
  903. 'driver': "none"
  904. }
  905. }
  906. }
  907. })
  908. details = config.ConfigDetails('.', [base_file, override_file])
  909. tmpdir = py.test.ensuretemp('logging_test')
  910. self.addCleanup(tmpdir.remove)
  911. with tmpdir.as_cwd():
  912. config_data = config.load(details)
  913. project = Project.from_config(
  914. name='composetest', config_data=config_data, client=self.client
  915. )
  916. project.up()
  917. containers = project.containers()
  918. self.assertEqual(len(containers), 2)
  919. another = project.get_service('another').containers()[0]
  920. log_config = another.get('HostConfig.LogConfig')
  921. self.assertTrue(log_config)
  922. self.assertEqual(log_config.get('Type'), 'none')
  923. @v2_only()
  924. def test_project_up_port_mappings_with_multiple_files(self):
  925. base_file = config.ConfigFile(
  926. 'base.yml',
  927. {
  928. 'version': V2_0,
  929. 'services': {
  930. 'simple': {
  931. 'image': 'busybox:latest',
  932. 'command': 'top',
  933. 'ports': ['1234:1234']
  934. },
  935. },
  936. })
  937. override_file = config.ConfigFile(
  938. 'override.yml',
  939. {
  940. 'version': V2_0,
  941. 'services': {
  942. 'simple': {
  943. 'ports': ['1234:1234']
  944. }
  945. }
  946. })
  947. details = config.ConfigDetails('.', [base_file, override_file])
  948. config_data = config.load(details)
  949. project = Project.from_config(
  950. name='composetest', config_data=config_data, client=self.client
  951. )
  952. project.up()
  953. containers = project.containers()
  954. self.assertEqual(len(containers), 1)
  955. @v2_only()
  956. def test_initialize_volumes(self):
  957. vol_name = '{0:x}'.format(random.getrandbits(32))
  958. full_vol_name = 'composetest_{0}'.format(vol_name)
  959. config_data = config.Config(
  960. version=V2_0,
  961. services=[{
  962. 'name': 'web',
  963. 'image': 'busybox:latest',
  964. 'command': 'top'
  965. }],
  966. volumes={vol_name: {}},
  967. networks={},
  968. )
  969. project = Project.from_config(
  970. name='composetest',
  971. config_data=config_data, client=self.client
  972. )
  973. project.volumes.initialize()
  974. volume_data = self.client.inspect_volume(full_vol_name)
  975. self.assertEqual(volume_data['Name'], full_vol_name)
  976. self.assertEqual(volume_data['Driver'], 'local')
  977. @v2_only()
  978. def test_project_up_implicit_volume_driver(self):
  979. vol_name = '{0:x}'.format(random.getrandbits(32))
  980. full_vol_name = 'composetest_{0}'.format(vol_name)
  981. config_data = config.Config(
  982. version=V2_0,
  983. services=[{
  984. 'name': 'web',
  985. 'image': 'busybox:latest',
  986. 'command': 'top'
  987. }],
  988. volumes={vol_name: {}},
  989. networks={},
  990. )
  991. project = Project.from_config(
  992. name='composetest',
  993. config_data=config_data, client=self.client
  994. )
  995. project.up()
  996. volume_data = self.client.inspect_volume(full_vol_name)
  997. self.assertEqual(volume_data['Name'], full_vol_name)
  998. self.assertEqual(volume_data['Driver'], 'local')
  999. @v2_only()
  1000. def test_initialize_volumes_invalid_volume_driver(self):
  1001. vol_name = '{0:x}'.format(random.getrandbits(32))
  1002. config_data = config.Config(
  1003. version=V2_0,
  1004. services=[{
  1005. 'name': 'web',
  1006. 'image': 'busybox:latest',
  1007. 'command': 'top'
  1008. }],
  1009. volumes={vol_name: {'driver': 'foobar'}},
  1010. networks={},
  1011. )
  1012. project = Project.from_config(
  1013. name='composetest',
  1014. config_data=config_data, client=self.client
  1015. )
  1016. with self.assertRaises(config.ConfigurationError):
  1017. project.volumes.initialize()
  1018. @v2_only()
  1019. def test_initialize_volumes_updated_driver(self):
  1020. vol_name = '{0:x}'.format(random.getrandbits(32))
  1021. full_vol_name = 'composetest_{0}'.format(vol_name)
  1022. config_data = config.Config(
  1023. version=V2_0,
  1024. services=[{
  1025. 'name': 'web',
  1026. 'image': 'busybox:latest',
  1027. 'command': 'top'
  1028. }],
  1029. volumes={vol_name: {'driver': 'local'}},
  1030. networks={},
  1031. )
  1032. project = Project.from_config(
  1033. name='composetest',
  1034. config_data=config_data, client=self.client
  1035. )
  1036. project.volumes.initialize()
  1037. volume_data = self.client.inspect_volume(full_vol_name)
  1038. self.assertEqual(volume_data['Name'], full_vol_name)
  1039. self.assertEqual(volume_data['Driver'], 'local')
  1040. config_data = config_data._replace(
  1041. volumes={vol_name: {'driver': 'smb'}}
  1042. )
  1043. project = Project.from_config(
  1044. name='composetest',
  1045. config_data=config_data,
  1046. client=self.client
  1047. )
  1048. with self.assertRaises(config.ConfigurationError) as e:
  1049. project.volumes.initialize()
  1050. assert 'Configuration for volume {0} specifies driver smb'.format(
  1051. vol_name
  1052. ) in str(e.exception)
  1053. @v2_only()
  1054. def test_initialize_volumes_updated_blank_driver(self):
  1055. vol_name = '{0:x}'.format(random.getrandbits(32))
  1056. full_vol_name = 'composetest_{0}'.format(vol_name)
  1057. config_data = config.Config(
  1058. version=V2_0,
  1059. services=[{
  1060. 'name': 'web',
  1061. 'image': 'busybox:latest',
  1062. 'command': 'top'
  1063. }],
  1064. volumes={vol_name: {'driver': 'local'}},
  1065. networks={},
  1066. )
  1067. project = Project.from_config(
  1068. name='composetest',
  1069. config_data=config_data, client=self.client
  1070. )
  1071. project.volumes.initialize()
  1072. volume_data = self.client.inspect_volume(full_vol_name)
  1073. self.assertEqual(volume_data['Name'], full_vol_name)
  1074. self.assertEqual(volume_data['Driver'], 'local')
  1075. config_data = config_data._replace(
  1076. volumes={vol_name: {}}
  1077. )
  1078. project = Project.from_config(
  1079. name='composetest',
  1080. config_data=config_data,
  1081. client=self.client
  1082. )
  1083. project.volumes.initialize()
  1084. volume_data = self.client.inspect_volume(full_vol_name)
  1085. self.assertEqual(volume_data['Name'], full_vol_name)
  1086. self.assertEqual(volume_data['Driver'], 'local')
  1087. @v2_only()
  1088. def test_initialize_volumes_external_volumes(self):
  1089. # Use composetest_ prefix so it gets garbage-collected in tearDown()
  1090. vol_name = 'composetest_{0:x}'.format(random.getrandbits(32))
  1091. full_vol_name = 'composetest_{0}'.format(vol_name)
  1092. self.client.create_volume(vol_name)
  1093. config_data = config.Config(
  1094. version=V2_0,
  1095. services=[{
  1096. 'name': 'web',
  1097. 'image': 'busybox:latest',
  1098. 'command': 'top'
  1099. }],
  1100. volumes={
  1101. vol_name: {'external': True, 'external_name': vol_name}
  1102. },
  1103. networks=None,
  1104. )
  1105. project = Project.from_config(
  1106. name='composetest',
  1107. config_data=config_data, client=self.client
  1108. )
  1109. project.volumes.initialize()
  1110. with self.assertRaises(NotFound):
  1111. self.client.inspect_volume(full_vol_name)
  1112. @v2_only()
  1113. def test_initialize_volumes_inexistent_external_volume(self):
  1114. vol_name = '{0:x}'.format(random.getrandbits(32))
  1115. config_data = config.Config(
  1116. version=V2_0,
  1117. services=[{
  1118. 'name': 'web',
  1119. 'image': 'busybox:latest',
  1120. 'command': 'top'
  1121. }],
  1122. volumes={
  1123. vol_name: {'external': True, 'external_name': vol_name}
  1124. },
  1125. networks=None,
  1126. )
  1127. project = Project.from_config(
  1128. name='composetest',
  1129. config_data=config_data, client=self.client
  1130. )
  1131. with self.assertRaises(config.ConfigurationError) as e:
  1132. project.volumes.initialize()
  1133. assert 'Volume {0} declared as external'.format(
  1134. vol_name
  1135. ) in str(e.exception)
  1136. @v2_only()
  1137. def test_project_up_named_volumes_in_binds(self):
  1138. vol_name = '{0:x}'.format(random.getrandbits(32))
  1139. full_vol_name = 'composetest_{0}'.format(vol_name)
  1140. base_file = config.ConfigFile(
  1141. 'base.yml',
  1142. {
  1143. 'version': V2_0,
  1144. 'services': {
  1145. 'simple': {
  1146. 'image': 'busybox:latest',
  1147. 'command': 'top',
  1148. 'volumes': ['{0}:/data'.format(vol_name)]
  1149. },
  1150. },
  1151. 'volumes': {
  1152. vol_name: {'driver': 'local'}
  1153. }
  1154. })
  1155. config_details = config.ConfigDetails('.', [base_file])
  1156. config_data = config.load(config_details)
  1157. project = Project.from_config(
  1158. name='composetest', config_data=config_data, client=self.client
  1159. )
  1160. service = project.services[0]
  1161. self.assertEqual(service.name, 'simple')
  1162. volumes = service.options.get('volumes')
  1163. self.assertEqual(len(volumes), 1)
  1164. self.assertEqual(volumes[0].external, full_vol_name)
  1165. project.up()
  1166. engine_volumes = self.client.volumes()['Volumes']
  1167. container = service.get_container()
  1168. assert [mount['Name'] for mount in container.get('Mounts')] == [full_vol_name]
  1169. assert next((v for v in engine_volumes if v['Name'] == vol_name), None) is None
  1170. def test_project_up_orphans(self):
  1171. config_dict = {
  1172. 'service1': {
  1173. 'image': 'busybox:latest',
  1174. 'command': 'top',
  1175. }
  1176. }
  1177. config_data = build_config(config_dict)
  1178. project = Project.from_config(
  1179. name='composetest', config_data=config_data, client=self.client
  1180. )
  1181. project.up()
  1182. config_dict['service2'] = config_dict['service1']
  1183. del config_dict['service1']
  1184. config_data = build_config(config_dict)
  1185. project = Project.from_config(
  1186. name='composetest', config_data=config_data, client=self.client
  1187. )
  1188. with mock.patch('compose.project.log') as mock_log:
  1189. project.up()
  1190. mock_log.warning.assert_called_once_with(mock.ANY)
  1191. assert len([
  1192. ctnr for ctnr in project._labeled_containers()
  1193. if ctnr.labels.get(LABEL_SERVICE) == 'service1'
  1194. ]) == 1
  1195. project.up(remove_orphans=True)
  1196. assert len([
  1197. ctnr for ctnr in project._labeled_containers()
  1198. if ctnr.labels.get(LABEL_SERVICE) == 'service1'
  1199. ]) == 0