service_test.py 13 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303
  1. from __future__ import unicode_literals
  2. from __future__ import absolute_import
  3. from fig import Service
  4. from fig.service import CannotBeScaledError
  5. from fig.container import Container
  6. from fig.packages.docker.errors import APIError
  7. from .testcases import DockerClientTestCase
  8. class ServiceTest(DockerClientTestCase):
  9. def test_containers(self):
  10. foo = self.create_service('foo')
  11. bar = self.create_service('bar')
  12. foo.start_container()
  13. self.assertEqual(len(foo.containers()), 1)
  14. self.assertEqual(foo.containers()[0].name, 'figtest_foo_1')
  15. self.assertEqual(len(bar.containers()), 0)
  16. bar.start_container()
  17. bar.start_container()
  18. self.assertEqual(len(foo.containers()), 1)
  19. self.assertEqual(len(bar.containers()), 2)
  20. names = [c.name for c in bar.containers()]
  21. self.assertIn('figtest_bar_1', names)
  22. self.assertIn('figtest_bar_2', names)
  23. def test_containers_one_off(self):
  24. db = self.create_service('db')
  25. container = db.create_container(one_off=True)
  26. self.assertEqual(db.containers(stopped=True), [])
  27. self.assertEqual(db.containers(one_off=True, stopped=True), [container])
  28. def test_project_is_added_to_container_name(self):
  29. service = self.create_service('web')
  30. service.start_container()
  31. self.assertEqual(service.containers()[0].name, 'figtest_web_1')
  32. def test_start_stop(self):
  33. service = self.create_service('scalingtest')
  34. self.assertEqual(len(service.containers(stopped=True)), 0)
  35. service.create_container()
  36. self.assertEqual(len(service.containers()), 0)
  37. self.assertEqual(len(service.containers(stopped=True)), 1)
  38. service.start()
  39. self.assertEqual(len(service.containers()), 1)
  40. self.assertEqual(len(service.containers(stopped=True)), 1)
  41. service.stop(timeout=1)
  42. self.assertEqual(len(service.containers()), 0)
  43. self.assertEqual(len(service.containers(stopped=True)), 1)
  44. service.stop(timeout=1)
  45. self.assertEqual(len(service.containers()), 0)
  46. self.assertEqual(len(service.containers(stopped=True)), 1)
  47. def test_kill_remove(self):
  48. service = self.create_service('scalingtest')
  49. service.start_container()
  50. self.assertEqual(len(service.containers()), 1)
  51. service.remove_stopped()
  52. self.assertEqual(len(service.containers()), 1)
  53. service.kill()
  54. self.assertEqual(len(service.containers()), 0)
  55. self.assertEqual(len(service.containers(stopped=True)), 1)
  56. service.remove_stopped()
  57. self.assertEqual(len(service.containers(stopped=True)), 0)
  58. def test_create_container_with_one_off(self):
  59. db = self.create_service('db')
  60. container = db.create_container(one_off=True)
  61. self.assertEqual(container.name, 'figtest_db_run_1')
  62. def test_create_container_with_one_off_when_existing_container_is_running(self):
  63. db = self.create_service('db')
  64. db.start()
  65. container = db.create_container(one_off=True)
  66. self.assertEqual(container.name, 'figtest_db_run_1')
  67. def test_create_container_with_unspecified_volume(self):
  68. service = self.create_service('db', volumes=['/var/db'])
  69. container = service.create_container()
  70. service.start_container(container)
  71. self.assertIn('/var/db', container.inspect()['Volumes'])
  72. def test_create_container_with_specified_volume(self):
  73. service = self.create_service('db', volumes=['/tmp:/host-tmp'])
  74. container = service.create_container()
  75. service.start_container(container)
  76. self.assertIn('/host-tmp', container.inspect()['Volumes'])
  77. def test_create_container_with_volumes_from(self):
  78. volume_service = self.create_service('data')
  79. volume_container_1 = volume_service.create_container()
  80. volume_container_2 = Container.create(self.client, image='busybox:latest', command=["/bin/sleep", "300"])
  81. host_service = self.create_service('host', volumes_from=[volume_service, volume_container_2])
  82. host_container = host_service.create_container()
  83. host_service.start_container(host_container)
  84. self.assertIn(volume_container_1.id, host_container.inspect()['HostConfig']['VolumesFrom'])
  85. self.assertIn(volume_container_2.id, host_container.inspect()['HostConfig']['VolumesFrom'])
  86. def test_recreate_containers(self):
  87. service = self.create_service(
  88. 'db',
  89. environment={'FOO': '1'},
  90. volumes=['/var/db'],
  91. entrypoint=['ps'],
  92. command=['ax']
  93. )
  94. old_container = service.create_container()
  95. self.assertEqual(old_container.dictionary['Config']['Entrypoint'], ['ps'])
  96. self.assertEqual(old_container.dictionary['Config']['Cmd'], ['ax'])
  97. self.assertIn('FOO=1', old_container.dictionary['Config']['Env'])
  98. self.assertEqual(old_container.name, 'figtest_db_1')
  99. service.start_container(old_container)
  100. volume_path = old_container.inspect()['Volumes']['/var/db']
  101. num_containers_before = len(self.client.containers(all=True))
  102. service.options['environment']['FOO'] = '2'
  103. tuples = service.recreate_containers()
  104. self.assertEqual(len(tuples), 1)
  105. intermediate_container = tuples[0][0]
  106. new_container = tuples[0][1]
  107. self.assertEqual(intermediate_container.dictionary['Config']['Entrypoint'], ['echo'])
  108. self.assertEqual(new_container.dictionary['Config']['Entrypoint'], ['ps'])
  109. self.assertEqual(new_container.dictionary['Config']['Cmd'], ['ax'])
  110. self.assertIn('FOO=2', new_container.dictionary['Config']['Env'])
  111. self.assertEqual(new_container.name, 'figtest_db_1')
  112. self.assertEqual(new_container.inspect()['Volumes']['/var/db'], volume_path)
  113. self.assertIn(intermediate_container.id, new_container.dictionary['HostConfig']['VolumesFrom'])
  114. self.assertEqual(len(self.client.containers(all=True)), num_containers_before)
  115. self.assertNotEqual(old_container.id, new_container.id)
  116. self.assertRaises(APIError, lambda: self.client.inspect_container(intermediate_container.id))
  117. def test_start_container_passes_through_options(self):
  118. db = self.create_service('db')
  119. db.start_container(environment={'FOO': 'BAR'})
  120. self.assertEqual(db.containers()[0].environment['FOO'], 'BAR')
  121. def test_start_container_inherits_options_from_constructor(self):
  122. db = self.create_service('db', environment={'FOO': 'BAR'})
  123. db.start_container()
  124. self.assertEqual(db.containers()[0].environment['FOO'], 'BAR')
  125. def test_start_container_creates_links(self):
  126. db = self.create_service('db')
  127. web = self.create_service('web', links=[(db, None)])
  128. db.start_container()
  129. web.start_container()
  130. self.assertIn('figtest_db_1', web.containers()[0].links())
  131. self.assertIn('db_1', web.containers()[0].links())
  132. def test_start_container_creates_links_with_names(self):
  133. db = self.create_service('db')
  134. web = self.create_service('web', links=[(db, 'custom_link_name')])
  135. db.start_container()
  136. web.start_container()
  137. self.assertIn('custom_link_name', web.containers()[0].links())
  138. def test_start_normal_container_does_not_create_links_to_its_own_service(self):
  139. db = self.create_service('db')
  140. c1 = db.start_container()
  141. c2 = db.start_container()
  142. self.assertNotIn(c1.name, c2.links())
  143. def test_start_one_off_container_creates_links_to_its_own_service(self):
  144. db = self.create_service('db')
  145. c1 = db.start_container()
  146. c2 = db.start_container(one_off=True)
  147. self.assertIn(c1.name, c2.links())
  148. def test_start_container_builds_images(self):
  149. service = Service(
  150. name='test',
  151. client=self.client,
  152. build='tests/fixtures/simple-dockerfile',
  153. project='figtest',
  154. )
  155. container = service.start_container()
  156. container.wait()
  157. self.assertIn('success', container.logs())
  158. self.assertEqual(len(self.client.images(name='figtest_test')), 1)
  159. def test_start_container_uses_tagged_image_if_it_exists(self):
  160. self.client.build('tests/fixtures/simple-dockerfile', tag='figtest_test')
  161. service = Service(
  162. name='test',
  163. client=self.client,
  164. build='this/does/not/exist/and/will/throw/error',
  165. project='figtest',
  166. )
  167. container = service.start_container()
  168. container.wait()
  169. self.assertIn('success', container.logs())
  170. def test_start_container_creates_ports(self):
  171. service = self.create_service('web', ports=[8000])
  172. container = service.start_container().inspect()
  173. self.assertEqual(list(container['NetworkSettings']['Ports'].keys()), ['8000/tcp'])
  174. self.assertNotEqual(container['NetworkSettings']['Ports']['8000/tcp'][0]['HostPort'], '8000')
  175. def test_start_container_stays_unpriviliged(self):
  176. service = self.create_service('web')
  177. container = service.start_container().inspect()
  178. self.assertEqual(container['HostConfig']['Privileged'], False)
  179. def test_start_container_becomes_priviliged(self):
  180. service = self.create_service('web', privileged = True)
  181. container = service.start_container().inspect()
  182. self.assertEqual(container['HostConfig']['Privileged'], True)
  183. def test_expose_does_not_publish_ports(self):
  184. service = self.create_service('web', expose=[8000])
  185. container = service.start_container().inspect()
  186. self.assertEqual(container['NetworkSettings']['Ports'], {'8000/tcp': None})
  187. def test_start_container_creates_port_with_explicit_protocol(self):
  188. service = self.create_service('web', ports=['8000/udp'])
  189. container = service.start_container().inspect()
  190. self.assertEqual(list(container['NetworkSettings']['Ports'].keys()), ['8000/udp'])
  191. def test_start_container_creates_fixed_external_ports(self):
  192. service = self.create_service('web', ports=['8000:8000'])
  193. container = service.start_container().inspect()
  194. self.assertIn('8000/tcp', container['NetworkSettings']['Ports'])
  195. self.assertEqual(container['NetworkSettings']['Ports']['8000/tcp'][0]['HostPort'], '8000')
  196. def test_start_container_creates_fixed_external_ports_when_it_is_different_to_internal_port(self):
  197. service = self.create_service('web', ports=['8001:8000'])
  198. container = service.start_container().inspect()
  199. self.assertIn('8000/tcp', container['NetworkSettings']['Ports'])
  200. self.assertEqual(container['NetworkSettings']['Ports']['8000/tcp'][0]['HostPort'], '8001')
  201. def test_port_with_explicit_interface(self):
  202. service = self.create_service('web', ports=[
  203. '127.0.0.1:8001:8000',
  204. '0.0.0.0:9001:9000',
  205. ])
  206. container = service.start_container().inspect()
  207. self.assertEqual(container['NetworkSettings']['Ports'], {
  208. '8000/tcp': [
  209. {
  210. 'HostIp': '127.0.0.1',
  211. 'HostPort': '8001',
  212. },
  213. ],
  214. '9000/tcp': [
  215. {
  216. 'HostIp': '0.0.0.0',
  217. 'HostPort': '9001',
  218. },
  219. ],
  220. })
  221. def test_scale(self):
  222. service = self.create_service('web')
  223. service.scale(1)
  224. self.assertEqual(len(service.containers()), 1)
  225. service.scale(3)
  226. self.assertEqual(len(service.containers()), 3)
  227. service.scale(1)
  228. self.assertEqual(len(service.containers()), 1)
  229. service.scale(0)
  230. self.assertEqual(len(service.containers()), 0)
  231. def test_scale_on_service_that_cannot_be_scaled(self):
  232. service = self.create_service('web', ports=['8000:8000'])
  233. self.assertRaises(CannotBeScaledError, lambda: service.scale(1))
  234. def test_scale_sets_ports(self):
  235. service = self.create_service('web', ports=['8000'])
  236. service.scale(2)
  237. containers = service.containers()
  238. self.assertEqual(len(containers), 2)
  239. for container in containers:
  240. self.assertEqual(list(container.inspect()['HostConfig']['PortBindings'].keys()), ['8000/tcp'])
  241. def test_network_mode_none(self):
  242. service = self.create_service('web', net='none')
  243. container = service.start_container().inspect()
  244. self.assertEqual(container['HostConfig']['NetworkMode'], 'none')
  245. def test_network_mode_bridged(self):
  246. service = self.create_service('web', net='bridge')
  247. container = service.start_container().inspect()
  248. self.assertEqual(container['HostConfig']['NetworkMode'], 'bridge')
  249. def test_network_mode_host(self):
  250. service = self.create_service('web', net='host')
  251. container = service.start_container().inspect()
  252. self.assertEqual(container['HostConfig']['NetworkMode'], 'host')