service_test.py 37 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908
  1. from __future__ import absolute_import
  2. from __future__ import unicode_literals
  3. import os
  4. import shutil
  5. import tempfile
  6. from os import path
  7. from docker.errors import APIError
  8. from six import StringIO
  9. from six import text_type
  10. from .. import mock
  11. from .testcases import DockerClientTestCase
  12. from compose import __version__
  13. from compose.const import LABEL_CONTAINER_NUMBER
  14. from compose.const import LABEL_ONE_OFF
  15. from compose.const import LABEL_PROJECT
  16. from compose.const import LABEL_SERVICE
  17. from compose.const import LABEL_VERSION
  18. from compose.container import Container
  19. from compose.service import build_extra_hosts
  20. from compose.service import ConfigError
  21. from compose.service import ConvergencePlan
  22. from compose.service import Service
  23. def create_and_start_container(service, **override_options):
  24. container = service.create_container(**override_options)
  25. return service.start_container(container)
  26. class ServiceTest(DockerClientTestCase):
  27. def test_containers(self):
  28. foo = self.create_service('foo')
  29. bar = self.create_service('bar')
  30. create_and_start_container(foo)
  31. self.assertEqual(len(foo.containers()), 1)
  32. self.assertEqual(foo.containers()[0].name, 'composetest_foo_1')
  33. self.assertEqual(len(bar.containers()), 0)
  34. create_and_start_container(bar)
  35. create_and_start_container(bar)
  36. self.assertEqual(len(foo.containers()), 1)
  37. self.assertEqual(len(bar.containers()), 2)
  38. names = [c.name for c in bar.containers()]
  39. self.assertIn('composetest_bar_1', names)
  40. self.assertIn('composetest_bar_2', names)
  41. def test_containers_one_off(self):
  42. db = self.create_service('db')
  43. container = db.create_container(one_off=True)
  44. self.assertEqual(db.containers(stopped=True), [])
  45. self.assertEqual(db.containers(one_off=True, stopped=True), [container])
  46. def test_project_is_added_to_container_name(self):
  47. service = self.create_service('web')
  48. create_and_start_container(service)
  49. self.assertEqual(service.containers()[0].name, 'composetest_web_1')
  50. def test_start_stop(self):
  51. service = self.create_service('scalingtest')
  52. self.assertEqual(len(service.containers(stopped=True)), 0)
  53. service.create_container()
  54. self.assertEqual(len(service.containers()), 0)
  55. self.assertEqual(len(service.containers(stopped=True)), 1)
  56. service.start()
  57. self.assertEqual(len(service.containers()), 1)
  58. self.assertEqual(len(service.containers(stopped=True)), 1)
  59. service.stop(timeout=1)
  60. self.assertEqual(len(service.containers()), 0)
  61. self.assertEqual(len(service.containers(stopped=True)), 1)
  62. service.stop(timeout=1)
  63. self.assertEqual(len(service.containers()), 0)
  64. self.assertEqual(len(service.containers(stopped=True)), 1)
  65. def test_kill_remove(self):
  66. service = self.create_service('scalingtest')
  67. create_and_start_container(service)
  68. self.assertEqual(len(service.containers()), 1)
  69. service.remove_stopped()
  70. self.assertEqual(len(service.containers()), 1)
  71. service.kill()
  72. self.assertEqual(len(service.containers()), 0)
  73. self.assertEqual(len(service.containers(stopped=True)), 1)
  74. service.remove_stopped()
  75. self.assertEqual(len(service.containers(stopped=True)), 0)
  76. def test_create_container_with_one_off(self):
  77. db = self.create_service('db')
  78. container = db.create_container(one_off=True)
  79. self.assertEqual(container.name, 'composetest_db_run_1')
  80. def test_create_container_with_one_off_when_existing_container_is_running(self):
  81. db = self.create_service('db')
  82. db.start()
  83. container = db.create_container(one_off=True)
  84. self.assertEqual(container.name, 'composetest_db_run_1')
  85. def test_create_container_with_unspecified_volume(self):
  86. service = self.create_service('db', volumes=['/var/db'])
  87. container = service.create_container()
  88. service.start_container(container)
  89. self.assertIn('/var/db', container.get('Volumes'))
  90. def test_create_container_with_volume_driver(self):
  91. service = self.create_service('db', volume_driver='foodriver')
  92. container = service.create_container()
  93. service.start_container(container)
  94. self.assertEqual('foodriver', container.get('Config.VolumeDriver'))
  95. def test_create_container_with_cpu_shares(self):
  96. service = self.create_service('db', cpu_shares=73)
  97. container = service.create_container()
  98. service.start_container(container)
  99. self.assertEqual(container.get('HostConfig.CpuShares'), 73)
  100. def test_build_extra_hosts(self):
  101. # string
  102. self.assertRaises(ConfigError, lambda: build_extra_hosts("www.example.com: 192.168.0.17"))
  103. # list of strings
  104. self.assertEqual(build_extra_hosts(
  105. ["www.example.com:192.168.0.17"]),
  106. {'www.example.com': '192.168.0.17'})
  107. self.assertEqual(build_extra_hosts(
  108. ["www.example.com: 192.168.0.17"]),
  109. {'www.example.com': '192.168.0.17'})
  110. self.assertEqual(build_extra_hosts(
  111. ["www.example.com: 192.168.0.17",
  112. "static.example.com:192.168.0.19",
  113. "api.example.com: 192.168.0.18"]),
  114. {'www.example.com': '192.168.0.17',
  115. 'static.example.com': '192.168.0.19',
  116. 'api.example.com': '192.168.0.18'})
  117. # list of dictionaries
  118. self.assertRaises(ConfigError, lambda: build_extra_hosts(
  119. [{'www.example.com': '192.168.0.17'},
  120. {'api.example.com': '192.168.0.18'}]))
  121. # dictionaries
  122. self.assertEqual(build_extra_hosts(
  123. {'www.example.com': '192.168.0.17',
  124. 'api.example.com': '192.168.0.18'}),
  125. {'www.example.com': '192.168.0.17',
  126. 'api.example.com': '192.168.0.18'})
  127. def test_create_container_with_extra_hosts_list(self):
  128. extra_hosts = ['somehost:162.242.195.82', 'otherhost:50.31.209.229']
  129. service = self.create_service('db', extra_hosts=extra_hosts)
  130. container = service.create_container()
  131. service.start_container(container)
  132. self.assertEqual(set(container.get('HostConfig.ExtraHosts')), set(extra_hosts))
  133. def test_create_container_with_extra_hosts_dicts(self):
  134. extra_hosts = {'somehost': '162.242.195.82', 'otherhost': '50.31.209.229'}
  135. extra_hosts_list = ['somehost:162.242.195.82', 'otherhost:50.31.209.229']
  136. service = self.create_service('db', extra_hosts=extra_hosts)
  137. container = service.create_container()
  138. service.start_container(container)
  139. self.assertEqual(set(container.get('HostConfig.ExtraHosts')), set(extra_hosts_list))
  140. def test_create_container_with_cpu_set(self):
  141. service = self.create_service('db', cpuset='0')
  142. container = service.create_container()
  143. service.start_container(container)
  144. self.assertEqual(container.get('HostConfig.CpusetCpus'), '0')
  145. def test_create_container_with_read_only_root_fs(self):
  146. read_only = True
  147. service = self.create_service('db', read_only=read_only)
  148. container = service.create_container()
  149. service.start_container(container)
  150. self.assertEqual(container.get('HostConfig.ReadonlyRootfs'), read_only, container.get('HostConfig'))
  151. def test_create_container_with_security_opt(self):
  152. security_opt = ['label:disable']
  153. service = self.create_service('db', security_opt=security_opt)
  154. container = service.create_container()
  155. service.start_container(container)
  156. self.assertEqual(set(container.get('HostConfig.SecurityOpt')), set(security_opt))
  157. def test_create_container_with_mac_address(self):
  158. service = self.create_service('db', mac_address='02:42:ac:11:65:43')
  159. container = service.create_container()
  160. service.start_container(container)
  161. self.assertEqual(container.inspect()['Config']['MacAddress'], '02:42:ac:11:65:43')
  162. def test_create_container_with_specified_volume(self):
  163. host_path = '/tmp/host-path'
  164. container_path = '/container-path'
  165. service = self.create_service('db', volumes=['%s:%s' % (host_path, container_path)])
  166. container = service.create_container()
  167. service.start_container(container)
  168. volumes = container.inspect()['Volumes']
  169. self.assertIn(container_path, volumes)
  170. # Match the last component ("host-path"), because boot2docker symlinks /tmp
  171. actual_host_path = volumes[container_path]
  172. self.assertTrue(path.basename(actual_host_path) == path.basename(host_path),
  173. msg=("Last component differs: %s, %s" % (actual_host_path, host_path)))
  174. def test_recreate_preserves_volume_with_trailing_slash(self):
  175. """
  176. When the Compose file specifies a trailing slash in the container path, make
  177. sure we copy the volume over when recreating.
  178. """
  179. service = self.create_service('data', volumes=['/data/'])
  180. old_container = create_and_start_container(service)
  181. volume_path = old_container.get('Volumes')['/data']
  182. new_container = service.recreate_container(old_container)
  183. self.assertEqual(new_container.get('Volumes')['/data'], volume_path)
  184. def test_duplicate_volume_trailing_slash(self):
  185. """
  186. When an image specifies a volume, and the Compose file specifies a host path
  187. but adds a trailing slash, make sure that we don't create duplicate binds.
  188. """
  189. host_path = '/tmp/data'
  190. container_path = '/data'
  191. volumes = ['{}:{}/'.format(host_path, container_path)]
  192. tmp_container = self.client.create_container(
  193. 'busybox', 'true',
  194. volumes={container_path: {}},
  195. labels={'com.docker.compose.test_image': 'true'},
  196. )
  197. image = self.client.commit(tmp_container)['Id']
  198. service = self.create_service('db', image=image, volumes=volumes)
  199. old_container = create_and_start_container(service)
  200. self.assertEqual(
  201. old_container.get('Config.Volumes'),
  202. {container_path: {}},
  203. )
  204. service = self.create_service('db', image=image, volumes=volumes)
  205. new_container = service.recreate_container(old_container)
  206. self.assertEqual(
  207. new_container.get('Config.Volumes'),
  208. {container_path: {}},
  209. )
  210. self.assertEqual(service.containers(stopped=False), [new_container])
  211. def test_create_container_with_volumes_from(self):
  212. volume_service = self.create_service('data')
  213. volume_container_1 = volume_service.create_container()
  214. volume_container_2 = Container.create(
  215. self.client,
  216. image='busybox:latest',
  217. command=["top"],
  218. labels={LABEL_PROJECT: 'composetest'},
  219. )
  220. host_service = self.create_service('host', volumes_from=[volume_service, volume_container_2])
  221. host_container = host_service.create_container()
  222. host_service.start_container(host_container)
  223. self.assertIn(volume_container_1.id,
  224. host_container.get('HostConfig.VolumesFrom'))
  225. self.assertIn(volume_container_2.id,
  226. host_container.get('HostConfig.VolumesFrom'))
  227. def test_execute_convergence_plan_recreate(self):
  228. service = self.create_service(
  229. 'db',
  230. environment={'FOO': '1'},
  231. volumes=['/etc'],
  232. entrypoint=['top'],
  233. command=['-d', '1']
  234. )
  235. old_container = service.create_container()
  236. self.assertEqual(old_container.get('Config.Entrypoint'), ['top'])
  237. self.assertEqual(old_container.get('Config.Cmd'), ['-d', '1'])
  238. self.assertIn('FOO=1', old_container.get('Config.Env'))
  239. self.assertEqual(old_container.name, 'composetest_db_1')
  240. service.start_container(old_container)
  241. old_container.inspect() # reload volume data
  242. volume_path = old_container.get('Volumes')['/etc']
  243. num_containers_before = len(self.client.containers(all=True))
  244. service.options['environment']['FOO'] = '2'
  245. new_container, = service.execute_convergence_plan(
  246. ConvergencePlan('recreate', [old_container]))
  247. self.assertEqual(new_container.get('Config.Entrypoint'), ['top'])
  248. self.assertEqual(new_container.get('Config.Cmd'), ['-d', '1'])
  249. self.assertIn('FOO=2', new_container.get('Config.Env'))
  250. self.assertEqual(new_container.name, 'composetest_db_1')
  251. self.assertEqual(new_container.get('Volumes')['/etc'], volume_path)
  252. self.assertIn(
  253. 'affinity:container==%s' % old_container.id,
  254. new_container.get('Config.Env'))
  255. self.assertEqual(len(self.client.containers(all=True)), num_containers_before)
  256. self.assertNotEqual(old_container.id, new_container.id)
  257. self.assertRaises(APIError,
  258. self.client.inspect_container,
  259. old_container.id)
  260. def test_execute_convergence_plan_when_containers_are_stopped(self):
  261. service = self.create_service(
  262. 'db',
  263. environment={'FOO': '1'},
  264. volumes=['/var/db'],
  265. entrypoint=['top'],
  266. command=['-d', '1']
  267. )
  268. service.create_container()
  269. containers = service.containers(stopped=True)
  270. self.assertEqual(len(containers), 1)
  271. container, = containers
  272. self.assertFalse(container.is_running)
  273. service.execute_convergence_plan(ConvergencePlan('start', [container]))
  274. containers = service.containers()
  275. self.assertEqual(len(containers), 1)
  276. container.inspect()
  277. self.assertEqual(container, containers[0])
  278. self.assertTrue(container.is_running)
  279. def test_execute_convergence_plan_with_image_declared_volume(self):
  280. service = Service(
  281. project='composetest',
  282. name='db',
  283. client=self.client,
  284. build='tests/fixtures/dockerfile-with-volume',
  285. )
  286. old_container = create_and_start_container(service)
  287. self.assertEqual(list(old_container.get('Volumes').keys()), ['/data'])
  288. volume_path = old_container.get('Volumes')['/data']
  289. new_container, = service.execute_convergence_plan(
  290. ConvergencePlan('recreate', [old_container]))
  291. self.assertEqual(list(new_container.get('Volumes')), ['/data'])
  292. self.assertEqual(new_container.get('Volumes')['/data'], volume_path)
  293. def test_start_container_passes_through_options(self):
  294. db = self.create_service('db')
  295. create_and_start_container(db, environment={'FOO': 'BAR'})
  296. self.assertEqual(db.containers()[0].environment['FOO'], 'BAR')
  297. def test_start_container_inherits_options_from_constructor(self):
  298. db = self.create_service('db', environment={'FOO': 'BAR'})
  299. create_and_start_container(db)
  300. self.assertEqual(db.containers()[0].environment['FOO'], 'BAR')
  301. def test_start_container_creates_links(self):
  302. db = self.create_service('db')
  303. web = self.create_service('web', links=[(db, None)])
  304. create_and_start_container(db)
  305. create_and_start_container(db)
  306. create_and_start_container(web)
  307. self.assertEqual(
  308. set(web.containers()[0].links()),
  309. set([
  310. 'composetest_db_1', 'db_1',
  311. 'composetest_db_2', 'db_2',
  312. 'db'])
  313. )
  314. def test_start_container_creates_links_with_names(self):
  315. db = self.create_service('db')
  316. web = self.create_service('web', links=[(db, 'custom_link_name')])
  317. create_and_start_container(db)
  318. create_and_start_container(db)
  319. create_and_start_container(web)
  320. self.assertEqual(
  321. set(web.containers()[0].links()),
  322. set([
  323. 'composetest_db_1', 'db_1',
  324. 'composetest_db_2', 'db_2',
  325. 'custom_link_name'])
  326. )
  327. def test_start_container_with_external_links(self):
  328. db = self.create_service('db')
  329. web = self.create_service('web', external_links=['composetest_db_1',
  330. 'composetest_db_2',
  331. 'composetest_db_3:db_3'])
  332. for _ in range(3):
  333. create_and_start_container(db)
  334. create_and_start_container(web)
  335. self.assertEqual(
  336. set(web.containers()[0].links()),
  337. set([
  338. 'composetest_db_1',
  339. 'composetest_db_2',
  340. 'db_3']),
  341. )
  342. def test_start_normal_container_does_not_create_links_to_its_own_service(self):
  343. db = self.create_service('db')
  344. create_and_start_container(db)
  345. create_and_start_container(db)
  346. c = create_and_start_container(db)
  347. self.assertEqual(set(c.links()), set([]))
  348. def test_start_one_off_container_creates_links_to_its_own_service(self):
  349. db = self.create_service('db')
  350. create_and_start_container(db)
  351. create_and_start_container(db)
  352. c = create_and_start_container(db, one_off=True)
  353. self.assertEqual(
  354. set(c.links()),
  355. set([
  356. 'composetest_db_1', 'db_1',
  357. 'composetest_db_2', 'db_2',
  358. 'db'])
  359. )
  360. def test_start_container_builds_images(self):
  361. service = Service(
  362. name='test',
  363. client=self.client,
  364. build='tests/fixtures/simple-dockerfile',
  365. project='composetest',
  366. )
  367. container = create_and_start_container(service)
  368. container.wait()
  369. self.assertIn(b'success', container.logs())
  370. self.assertEqual(len(self.client.images(name='composetest_test')), 1)
  371. def test_start_container_uses_tagged_image_if_it_exists(self):
  372. self.check_build('tests/fixtures/simple-dockerfile', tag='composetest_test')
  373. service = Service(
  374. name='test',
  375. client=self.client,
  376. build='this/does/not/exist/and/will/throw/error',
  377. project='composetest',
  378. )
  379. container = create_and_start_container(service)
  380. container.wait()
  381. self.assertIn(b'success', container.logs())
  382. def test_start_container_creates_ports(self):
  383. service = self.create_service('web', ports=[8000])
  384. container = create_and_start_container(service).inspect()
  385. self.assertEqual(list(container['NetworkSettings']['Ports'].keys()), ['8000/tcp'])
  386. self.assertNotEqual(container['NetworkSettings']['Ports']['8000/tcp'][0]['HostPort'], '8000')
  387. def test_build(self):
  388. base_dir = tempfile.mkdtemp()
  389. self.addCleanup(shutil.rmtree, base_dir)
  390. with open(os.path.join(base_dir, 'Dockerfile'), 'w') as f:
  391. f.write("FROM busybox\n")
  392. self.create_service('web', build=base_dir).build()
  393. self.assertEqual(len(self.client.images(name='composetest_web')), 1)
  394. def test_build_non_ascii_filename(self):
  395. base_dir = tempfile.mkdtemp()
  396. self.addCleanup(shutil.rmtree, base_dir)
  397. with open(os.path.join(base_dir, 'Dockerfile'), 'w') as f:
  398. f.write("FROM busybox\n")
  399. with open(os.path.join(base_dir.encode('utf8'), b'foo\xE2bar'), 'w') as f:
  400. f.write("hello world\n")
  401. self.create_service('web', build=text_type(base_dir)).build()
  402. self.assertEqual(len(self.client.images(name='composetest_web')), 1)
  403. def test_start_container_stays_unpriviliged(self):
  404. service = self.create_service('web')
  405. container = create_and_start_container(service).inspect()
  406. self.assertEqual(container['HostConfig']['Privileged'], False)
  407. def test_start_container_becomes_priviliged(self):
  408. service = self.create_service('web', privileged=True)
  409. container = create_and_start_container(service).inspect()
  410. self.assertEqual(container['HostConfig']['Privileged'], True)
  411. def test_expose_does_not_publish_ports(self):
  412. service = self.create_service('web', expose=["8000"])
  413. container = create_and_start_container(service).inspect()
  414. self.assertEqual(container['NetworkSettings']['Ports'], {'8000/tcp': None})
  415. def test_start_container_creates_port_with_explicit_protocol(self):
  416. service = self.create_service('web', ports=['8000/udp'])
  417. container = create_and_start_container(service).inspect()
  418. self.assertEqual(list(container['NetworkSettings']['Ports'].keys()), ['8000/udp'])
  419. def test_start_container_creates_fixed_external_ports(self):
  420. service = self.create_service('web', ports=['8000:8000'])
  421. container = create_and_start_container(service).inspect()
  422. self.assertIn('8000/tcp', container['NetworkSettings']['Ports'])
  423. self.assertEqual(container['NetworkSettings']['Ports']['8000/tcp'][0]['HostPort'], '8000')
  424. def test_start_container_creates_fixed_external_ports_when_it_is_different_to_internal_port(self):
  425. service = self.create_service('web', ports=['8001:8000'])
  426. container = create_and_start_container(service).inspect()
  427. self.assertIn('8000/tcp', container['NetworkSettings']['Ports'])
  428. self.assertEqual(container['NetworkSettings']['Ports']['8000/tcp'][0]['HostPort'], '8001')
  429. def test_port_with_explicit_interface(self):
  430. service = self.create_service('web', ports=[
  431. '127.0.0.1:8001:8000',
  432. '0.0.0.0:9001:9000/udp',
  433. ])
  434. container = create_and_start_container(service).inspect()
  435. self.assertEqual(container['NetworkSettings']['Ports'], {
  436. '8000/tcp': [
  437. {
  438. 'HostIp': '127.0.0.1',
  439. 'HostPort': '8001',
  440. },
  441. ],
  442. '9000/udp': [
  443. {
  444. 'HostIp': '0.0.0.0',
  445. 'HostPort': '9001',
  446. },
  447. ],
  448. })
  449. def test_create_with_image_id(self):
  450. # Image id for the current busybox:latest
  451. service = self.create_service('foo', image='8c2e06607696')
  452. service.create_container()
  453. def test_scale(self):
  454. service = self.create_service('web')
  455. service.scale(1)
  456. self.assertEqual(len(service.containers()), 1)
  457. # Ensure containers don't have stdout or stdin connected
  458. container = service.containers()[0]
  459. config = container.inspect()['Config']
  460. self.assertFalse(config['AttachStderr'])
  461. self.assertFalse(config['AttachStdout'])
  462. self.assertFalse(config['AttachStdin'])
  463. service.scale(3)
  464. self.assertEqual(len(service.containers()), 3)
  465. service.scale(1)
  466. self.assertEqual(len(service.containers()), 1)
  467. service.scale(0)
  468. self.assertEqual(len(service.containers()), 0)
  469. def test_scale_with_stopped_containers(self):
  470. """
  471. Given there are some stopped containers and scale is called with a
  472. desired number that is the same as the number of stopped containers,
  473. test that those containers are restarted and not removed/recreated.
  474. """
  475. service = self.create_service('web')
  476. next_number = service._next_container_number()
  477. valid_numbers = [next_number, next_number + 1]
  478. service.create_container(number=next_number)
  479. service.create_container(number=next_number + 1)
  480. with mock.patch('sys.stdout', new_callable=StringIO) as mock_stdout:
  481. service.scale(2)
  482. for container in service.containers():
  483. self.assertTrue(container.is_running)
  484. self.assertTrue(container.number in valid_numbers)
  485. captured_output = mock_stdout.getvalue()
  486. self.assertNotIn('Creating', captured_output)
  487. self.assertIn('Starting', captured_output)
  488. @mock.patch('sys.stdout', new_callable=StringIO)
  489. def test_scale_with_stopped_containers_and_needing_creation(self, mock_stdout):
  490. """
  491. Given there are some stopped containers and scale is called with a
  492. desired number that is greater than the number of stopped containers,
  493. test that those containers are restarted and required number are created.
  494. """
  495. service = self.create_service('web')
  496. next_number = service._next_container_number()
  497. service.create_container(number=next_number, quiet=True)
  498. for container in service.containers():
  499. self.assertFalse(container.is_running)
  500. service.scale(2)
  501. self.assertEqual(len(service.containers()), 2)
  502. for container in service.containers():
  503. self.assertTrue(container.is_running)
  504. captured_output = mock_stdout.getvalue()
  505. self.assertIn('Creating', captured_output)
  506. self.assertIn('Starting', captured_output)
  507. @mock.patch('sys.stdout', new_callable=StringIO)
  508. def test_scale_with_api_returns_errors(self, mock_stdout):
  509. """
  510. Test that when scaling if the API returns an error, that error is handled
  511. and the remaining threads continue.
  512. """
  513. service = self.create_service('web')
  514. next_number = service._next_container_number()
  515. service.create_container(number=next_number, quiet=True)
  516. with mock.patch(
  517. 'compose.container.Container.create',
  518. side_effect=APIError(message="testing", response={}, explanation="Boom")):
  519. service.scale(3)
  520. self.assertEqual(len(service.containers()), 1)
  521. self.assertTrue(service.containers()[0].is_running)
  522. self.assertIn("ERROR: for 2 Boom", mock_stdout.getvalue())
  523. @mock.patch('sys.stdout', new_callable=StringIO)
  524. def test_scale_with_api_returns_unexpected_exception(self, mock_stdout):
  525. """
  526. Test that when scaling if the API returns an error, that is not of type
  527. APIError, that error is re-raised.
  528. """
  529. service = self.create_service('web')
  530. next_number = service._next_container_number()
  531. service.create_container(number=next_number, quiet=True)
  532. with mock.patch(
  533. 'compose.container.Container.create',
  534. side_effect=ValueError("BOOM")):
  535. with self.assertRaises(ValueError):
  536. service.scale(3)
  537. self.assertEqual(len(service.containers()), 1)
  538. self.assertTrue(service.containers()[0].is_running)
  539. @mock.patch('compose.service.log')
  540. def test_scale_with_desired_number_already_achieved(self, mock_log):
  541. """
  542. Test that calling scale with a desired number that is equal to the
  543. number of containers already running results in no change.
  544. """
  545. service = self.create_service('web')
  546. next_number = service._next_container_number()
  547. container = service.create_container(number=next_number, quiet=True)
  548. container.start()
  549. self.assertTrue(container.is_running)
  550. self.assertEqual(len(service.containers()), 1)
  551. service.scale(1)
  552. self.assertEqual(len(service.containers()), 1)
  553. container.inspect()
  554. self.assertTrue(container.is_running)
  555. captured_output = mock_log.info.call_args[0]
  556. self.assertIn('Desired container number already achieved', captured_output)
  557. @mock.patch('compose.service.log')
  558. def test_scale_with_custom_container_name_outputs_warning(self, mock_log):
  559. """
  560. Test that calling scale on a service that has a custom container name
  561. results in warning output.
  562. """
  563. service = self.create_service('app', container_name='custom-container')
  564. self.assertEqual(service.custom_container_name(), 'custom-container')
  565. service.scale(3)
  566. captured_output = mock_log.warn.call_args[0][0]
  567. self.assertEqual(len(service.containers()), 1)
  568. self.assertIn(
  569. "Remove the custom name to scale the service.",
  570. captured_output
  571. )
  572. def test_scale_sets_ports(self):
  573. service = self.create_service('web', ports=['8000'])
  574. service.scale(2)
  575. containers = service.containers()
  576. self.assertEqual(len(containers), 2)
  577. for container in containers:
  578. self.assertEqual(list(container.inspect()['HostConfig']['PortBindings'].keys()), ['8000/tcp'])
  579. def test_network_mode_none(self):
  580. service = self.create_service('web', net='none')
  581. container = create_and_start_container(service)
  582. self.assertEqual(container.get('HostConfig.NetworkMode'), 'none')
  583. def test_network_mode_bridged(self):
  584. service = self.create_service('web', net='bridge')
  585. container = create_and_start_container(service)
  586. self.assertEqual(container.get('HostConfig.NetworkMode'), 'bridge')
  587. def test_network_mode_host(self):
  588. service = self.create_service('web', net='host')
  589. container = create_and_start_container(service)
  590. self.assertEqual(container.get('HostConfig.NetworkMode'), 'host')
  591. def test_pid_mode_none_defined(self):
  592. service = self.create_service('web', pid=None)
  593. container = create_and_start_container(service)
  594. self.assertEqual(container.get('HostConfig.PidMode'), '')
  595. def test_pid_mode_host(self):
  596. service = self.create_service('web', pid='host')
  597. container = create_and_start_container(service)
  598. self.assertEqual(container.get('HostConfig.PidMode'), 'host')
  599. def test_dns_no_value(self):
  600. service = self.create_service('web')
  601. container = create_and_start_container(service)
  602. self.assertIsNone(container.get('HostConfig.Dns'))
  603. def test_dns_single_value(self):
  604. service = self.create_service('web', dns='8.8.8.8')
  605. container = create_and_start_container(service)
  606. self.assertEqual(container.get('HostConfig.Dns'), ['8.8.8.8'])
  607. def test_dns_list(self):
  608. service = self.create_service('web', dns=['8.8.8.8', '9.9.9.9'])
  609. container = create_and_start_container(service)
  610. self.assertEqual(container.get('HostConfig.Dns'), ['8.8.8.8', '9.9.9.9'])
  611. def test_restart_always_value(self):
  612. service = self.create_service('web', restart='always')
  613. container = create_and_start_container(service)
  614. self.assertEqual(container.get('HostConfig.RestartPolicy.Name'), 'always')
  615. def test_restart_on_failure_value(self):
  616. service = self.create_service('web', restart='on-failure:5')
  617. container = create_and_start_container(service)
  618. self.assertEqual(container.get('HostConfig.RestartPolicy.Name'), 'on-failure')
  619. self.assertEqual(container.get('HostConfig.RestartPolicy.MaximumRetryCount'), 5)
  620. def test_cap_add_list(self):
  621. service = self.create_service('web', cap_add=['SYS_ADMIN', 'NET_ADMIN'])
  622. container = create_and_start_container(service)
  623. self.assertEqual(container.get('HostConfig.CapAdd'), ['SYS_ADMIN', 'NET_ADMIN'])
  624. def test_cap_drop_list(self):
  625. service = self.create_service('web', cap_drop=['SYS_ADMIN', 'NET_ADMIN'])
  626. container = create_and_start_container(service)
  627. self.assertEqual(container.get('HostConfig.CapDrop'), ['SYS_ADMIN', 'NET_ADMIN'])
  628. def test_dns_search_no_value(self):
  629. service = self.create_service('web')
  630. container = create_and_start_container(service)
  631. self.assertIsNone(container.get('HostConfig.DnsSearch'))
  632. def test_dns_search_single_value(self):
  633. service = self.create_service('web', dns_search='example.com')
  634. container = create_and_start_container(service)
  635. self.assertEqual(container.get('HostConfig.DnsSearch'), ['example.com'])
  636. def test_dns_search_list(self):
  637. service = self.create_service('web', dns_search=['dc1.example.com', 'dc2.example.com'])
  638. container = create_and_start_container(service)
  639. self.assertEqual(container.get('HostConfig.DnsSearch'), ['dc1.example.com', 'dc2.example.com'])
  640. def test_working_dir_param(self):
  641. service = self.create_service('container', working_dir='/working/dir/sample')
  642. container = service.create_container()
  643. self.assertEqual(container.get('Config.WorkingDir'), '/working/dir/sample')
  644. def test_split_env(self):
  645. service = self.create_service('web', environment=['NORMAL=F1', 'CONTAINS_EQUALS=F=2', 'TRAILING_EQUALS='])
  646. env = create_and_start_container(service).environment
  647. for k, v in {'NORMAL': 'F1', 'CONTAINS_EQUALS': 'F=2', 'TRAILING_EQUALS': ''}.items():
  648. self.assertEqual(env[k], v)
  649. def test_env_from_file_combined_with_env(self):
  650. service = self.create_service(
  651. 'web',
  652. environment=['ONE=1', 'TWO=2', 'THREE=3'],
  653. env_file=['tests/fixtures/env/one.env', 'tests/fixtures/env/two.env'])
  654. env = create_and_start_container(service).environment
  655. for k, v in {'ONE': '1', 'TWO': '2', 'THREE': '3', 'FOO': 'baz', 'DOO': 'dah'}.items():
  656. self.assertEqual(env[k], v)
  657. @mock.patch.dict(os.environ)
  658. def test_resolve_env(self):
  659. os.environ['FILE_DEF'] = 'E1'
  660. os.environ['FILE_DEF_EMPTY'] = 'E2'
  661. os.environ['ENV_DEF'] = 'E3'
  662. service = self.create_service('web', environment={'FILE_DEF': 'F1', 'FILE_DEF_EMPTY': '', 'ENV_DEF': None, 'NO_DEF': None})
  663. env = create_and_start_container(service).environment
  664. for k, v in {'FILE_DEF': 'F1', 'FILE_DEF_EMPTY': '', 'ENV_DEF': 'E3', 'NO_DEF': ''}.items():
  665. self.assertEqual(env[k], v)
  666. def test_labels(self):
  667. labels_dict = {
  668. 'com.example.description': "Accounting webapp",
  669. 'com.example.department': "Finance",
  670. 'com.example.label-with-empty-value': "",
  671. }
  672. compose_labels = {
  673. LABEL_CONTAINER_NUMBER: '1',
  674. LABEL_ONE_OFF: 'False',
  675. LABEL_PROJECT: 'composetest',
  676. LABEL_SERVICE: 'web',
  677. LABEL_VERSION: __version__,
  678. }
  679. expected = dict(labels_dict, **compose_labels)
  680. service = self.create_service('web', labels=labels_dict)
  681. labels = create_and_start_container(service).labels.items()
  682. for pair in expected.items():
  683. self.assertIn(pair, labels)
  684. service.kill()
  685. service.remove_stopped()
  686. labels_list = ["%s=%s" % pair for pair in labels_dict.items()]
  687. service = self.create_service('web', labels=labels_list)
  688. labels = create_and_start_container(service).labels.items()
  689. for pair in expected.items():
  690. self.assertIn(pair, labels)
  691. def test_empty_labels(self):
  692. labels_list = ['foo', 'bar']
  693. service = self.create_service('web', labels=labels_list)
  694. labels = create_and_start_container(service).labels.items()
  695. for name in labels_list:
  696. self.assertIn((name, ''), labels)
  697. def test_custom_container_name(self):
  698. service = self.create_service('web', container_name='my-web-container')
  699. self.assertEqual(service.custom_container_name(), 'my-web-container')
  700. container = create_and_start_container(service)
  701. self.assertEqual(container.name, 'my-web-container')
  702. one_off_container = service.create_container(one_off=True)
  703. self.assertNotEqual(one_off_container.name, 'my-web-container')
  704. def test_log_drive_invalid(self):
  705. service = self.create_service('web', log_driver='xxx')
  706. self.assertRaises(ValueError, lambda: create_and_start_container(service))
  707. def test_log_drive_empty_default_jsonfile(self):
  708. service = self.create_service('web')
  709. log_config = create_and_start_container(service).log_config
  710. self.assertEqual('json-file', log_config['Type'])
  711. self.assertFalse(log_config['Config'])
  712. def test_log_drive_none(self):
  713. service = self.create_service('web', log_driver='none')
  714. log_config = create_and_start_container(service).log_config
  715. self.assertEqual('none', log_config['Type'])
  716. self.assertFalse(log_config['Config'])
  717. def test_devices(self):
  718. service = self.create_service('web', devices=["/dev/random:/dev/mapped-random"])
  719. device_config = create_and_start_container(service).get('HostConfig.Devices')
  720. device_dict = {
  721. 'PathOnHost': '/dev/random',
  722. 'CgroupPermissions': 'rwm',
  723. 'PathInContainer': '/dev/mapped-random'
  724. }
  725. self.assertEqual(1, len(device_config))
  726. self.assertDictEqual(device_dict, device_config[0])
  727. def test_duplicate_containers(self):
  728. service = self.create_service('web')
  729. options = service._get_container_create_options({}, 1)
  730. original = Container.create(service.client, **options)
  731. self.assertEqual(set(service.containers(stopped=True)), set([original]))
  732. self.assertEqual(set(service.duplicate_containers()), set())
  733. options['name'] = 'temporary_container_name'
  734. duplicate = Container.create(service.client, **options)
  735. self.assertEqual(set(service.containers(stopped=True)), set([original, duplicate]))
  736. self.assertEqual(set(service.duplicate_containers()), set([duplicate]))