cli_test.py 37 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982
  1. from __future__ import absolute_import
  2. from __future__ import unicode_literals
  3. import os
  4. import shlex
  5. import signal
  6. import subprocess
  7. import time
  8. from collections import namedtuple
  9. from operator import attrgetter
  10. from textwrap import dedent
  11. from docker import errors
  12. from .. import mock
  13. from compose.cli.command import get_project
  14. from compose.cli.docker_client import docker_client
  15. from compose.container import Container
  16. from tests.integration.testcases import DockerClientTestCase
  17. from tests.integration.testcases import get_links
  18. from tests.integration.testcases import pull_busybox
  19. ProcessResult = namedtuple('ProcessResult', 'stdout stderr')
  20. BUILD_CACHE_TEXT = 'Using cache'
  21. BUILD_PULL_TEXT = 'Status: Image is up to date for busybox:latest'
  22. def start_process(base_dir, options):
  23. proc = subprocess.Popen(
  24. ['docker-compose'] + options,
  25. stdout=subprocess.PIPE,
  26. stderr=subprocess.PIPE,
  27. cwd=base_dir)
  28. print("Running process: %s" % proc.pid)
  29. return proc
  30. def wait_on_process(proc, returncode=0):
  31. stdout, stderr = proc.communicate()
  32. if proc.returncode != returncode:
  33. print(stderr.decode('utf-8'))
  34. assert proc.returncode == returncode
  35. return ProcessResult(stdout.decode('utf-8'), stderr.decode('utf-8'))
  36. def wait_on_condition(condition, delay=0.1, timeout=20):
  37. start_time = time.time()
  38. while not condition():
  39. if time.time() - start_time > timeout:
  40. raise AssertionError("Timeout: %s" % condition)
  41. time.sleep(delay)
  42. def kill_service(service):
  43. for container in service.containers():
  44. container.kill()
  45. class ContainerCountCondition(object):
  46. def __init__(self, project, expected):
  47. self.project = project
  48. self.expected = expected
  49. def __call__(self):
  50. return len(self.project.containers()) == self.expected
  51. def __str__(self):
  52. return "waiting for counter count == %s" % self.expected
  53. class ContainerStateCondition(object):
  54. def __init__(self, client, name, running):
  55. self.client = client
  56. self.name = name
  57. self.running = running
  58. # State.Running == true
  59. def __call__(self):
  60. try:
  61. container = self.client.inspect_container(self.name)
  62. return container['State']['Running'] == self.running
  63. except errors.APIError:
  64. return False
  65. def __str__(self):
  66. return "waiting for container to have state %s" % self.expected
  67. class CLITestCase(DockerClientTestCase):
  68. def setUp(self):
  69. super(CLITestCase, self).setUp()
  70. self.base_dir = 'tests/fixtures/simple-composefile'
  71. def tearDown(self):
  72. if self.base_dir:
  73. self.project.kill()
  74. self.project.remove_stopped()
  75. for container in self.project.containers(stopped=True, one_off=True):
  76. container.remove(force=True)
  77. super(CLITestCase, self).tearDown()
  78. @property
  79. def project(self):
  80. # Hack: allow project to be overridden
  81. if not hasattr(self, '_project'):
  82. self._project = get_project(self.base_dir)
  83. return self._project
  84. def dispatch(self, options, project_options=None, returncode=0):
  85. project_options = project_options or []
  86. proc = start_process(self.base_dir, project_options + options)
  87. return wait_on_process(proc, returncode=returncode)
  88. def test_help(self):
  89. self.base_dir = 'tests/fixtures/no-composefile'
  90. result = self.dispatch(['help', 'up'], returncode=1)
  91. assert 'Usage: up [options] [SERVICE...]' in result.stderr
  92. # Prevent tearDown from trying to create a project
  93. self.base_dir = None
  94. def test_config_list_services(self):
  95. result = self.dispatch(['config', '--services'])
  96. assert set(result.stdout.rstrip().split('\n')) == {'simple', 'another'}
  97. def test_config_quiet_with_error(self):
  98. self.base_dir = None
  99. result = self.dispatch([
  100. '-f', 'tests/fixtures/invalid-composefile/invalid.yml',
  101. 'config', '-q'
  102. ], returncode=1)
  103. assert "'notaservice' doesn't have any configuration" in result.stderr
  104. def test_config_quiet(self):
  105. assert self.dispatch(['config', '-q']).stdout == ''
  106. def test_config_default(self):
  107. result = self.dispatch(['config'])
  108. assert dedent("""
  109. simple:
  110. command: top
  111. image: busybox:latest
  112. """).lstrip() in result.stdout
  113. assert dedent("""
  114. another:
  115. command: top
  116. image: busybox:latest
  117. """).lstrip() in result.stdout
  118. def test_ps(self):
  119. self.project.get_service('simple').create_container()
  120. result = self.dispatch(['ps'])
  121. assert 'simplecomposefile_simple_1' in result.stdout
  122. def test_ps_default_composefile(self):
  123. self.base_dir = 'tests/fixtures/multiple-composefiles'
  124. self.dispatch(['up', '-d'])
  125. result = self.dispatch(['ps'])
  126. self.assertIn('multiplecomposefiles_simple_1', result.stdout)
  127. self.assertIn('multiplecomposefiles_another_1', result.stdout)
  128. self.assertNotIn('multiplecomposefiles_yetanother_1', result.stdout)
  129. def test_ps_alternate_composefile(self):
  130. config_path = os.path.abspath(
  131. 'tests/fixtures/multiple-composefiles/compose2.yml')
  132. self._project = get_project(self.base_dir, [config_path])
  133. self.base_dir = 'tests/fixtures/multiple-composefiles'
  134. self.dispatch(['-f', 'compose2.yml', 'up', '-d'])
  135. result = self.dispatch(['-f', 'compose2.yml', 'ps'])
  136. self.assertNotIn('multiplecomposefiles_simple_1', result.stdout)
  137. self.assertNotIn('multiplecomposefiles_another_1', result.stdout)
  138. self.assertIn('multiplecomposefiles_yetanother_1', result.stdout)
  139. def test_pull(self):
  140. result = self.dispatch(['pull'])
  141. assert sorted(result.stderr.split('\n'))[1:] == [
  142. 'Pulling another (busybox:latest)...',
  143. 'Pulling simple (busybox:latest)...',
  144. ]
  145. def test_pull_with_digest(self):
  146. result = self.dispatch(['-f', 'digest.yml', 'pull'])
  147. assert 'Pulling simple (busybox:latest)...' in result.stderr
  148. assert ('Pulling digest (busybox@'
  149. 'sha256:38a203e1986cf79639cfb9b2e1d6e773de84002feea2d4eb006b520'
  150. '04ee8502d)...') in result.stderr
  151. def test_pull_with_ignore_pull_failures(self):
  152. result = self.dispatch([
  153. '-f', 'ignore-pull-failures.yml',
  154. 'pull', '--ignore-pull-failures'])
  155. assert 'Pulling simple (busybox:latest)...' in result.stderr
  156. assert 'Pulling another (nonexisting-image:latest)...' in result.stderr
  157. assert 'Error: image library/nonexisting-image:latest not found' in result.stderr
  158. def test_build_plain(self):
  159. self.base_dir = 'tests/fixtures/simple-dockerfile'
  160. self.dispatch(['build', 'simple'])
  161. result = self.dispatch(['build', 'simple'])
  162. assert BUILD_CACHE_TEXT in result.stdout
  163. assert BUILD_PULL_TEXT not in result.stdout
  164. def test_build_no_cache(self):
  165. self.base_dir = 'tests/fixtures/simple-dockerfile'
  166. self.dispatch(['build', 'simple'])
  167. result = self.dispatch(['build', '--no-cache', 'simple'])
  168. assert BUILD_CACHE_TEXT not in result.stdout
  169. assert BUILD_PULL_TEXT not in result.stdout
  170. def test_build_pull(self):
  171. # Make sure we have the latest busybox already
  172. pull_busybox(self.client)
  173. self.base_dir = 'tests/fixtures/simple-dockerfile'
  174. self.dispatch(['build', 'simple'], None)
  175. result = self.dispatch(['build', '--pull', 'simple'])
  176. assert BUILD_CACHE_TEXT in result.stdout
  177. assert BUILD_PULL_TEXT in result.stdout
  178. def test_build_no_cache_pull(self):
  179. # Make sure we have the latest busybox already
  180. pull_busybox(self.client)
  181. self.base_dir = 'tests/fixtures/simple-dockerfile'
  182. self.dispatch(['build', 'simple'])
  183. result = self.dispatch(['build', '--no-cache', '--pull', 'simple'])
  184. assert BUILD_CACHE_TEXT not in result.stdout
  185. assert BUILD_PULL_TEXT in result.stdout
  186. def test_build_failed(self):
  187. self.base_dir = 'tests/fixtures/simple-failing-dockerfile'
  188. self.dispatch(['build', 'simple'], returncode=1)
  189. labels = ["com.docker.compose.test_failing_image=true"]
  190. containers = [
  191. Container.from_ps(self.project.client, c)
  192. for c in self.project.client.containers(
  193. all=True,
  194. filters={"label": labels})
  195. ]
  196. assert len(containers) == 1
  197. def test_build_failed_forcerm(self):
  198. self.base_dir = 'tests/fixtures/simple-failing-dockerfile'
  199. self.dispatch(['build', '--force-rm', 'simple'], returncode=1)
  200. labels = ["com.docker.compose.test_failing_image=true"]
  201. containers = [
  202. Container.from_ps(self.project.client, c)
  203. for c in self.project.client.containers(
  204. all=True,
  205. filters={"label": labels})
  206. ]
  207. assert not containers
  208. def test_create(self):
  209. self.dispatch(['create'])
  210. service = self.project.get_service('simple')
  211. another = self.project.get_service('another')
  212. self.assertEqual(len(service.containers()), 0)
  213. self.assertEqual(len(another.containers()), 0)
  214. self.assertEqual(len(service.containers(stopped=True)), 1)
  215. self.assertEqual(len(another.containers(stopped=True)), 1)
  216. def test_create_with_force_recreate(self):
  217. self.dispatch(['create'], None)
  218. service = self.project.get_service('simple')
  219. self.assertEqual(len(service.containers()), 0)
  220. self.assertEqual(len(service.containers(stopped=True)), 1)
  221. old_ids = [c.id for c in service.containers(stopped=True)]
  222. self.dispatch(['create', '--force-recreate'], None)
  223. self.assertEqual(len(service.containers()), 0)
  224. self.assertEqual(len(service.containers(stopped=True)), 1)
  225. new_ids = [c.id for c in service.containers(stopped=True)]
  226. self.assertNotEqual(old_ids, new_ids)
  227. def test_create_with_no_recreate(self):
  228. self.dispatch(['create'], None)
  229. service = self.project.get_service('simple')
  230. self.assertEqual(len(service.containers()), 0)
  231. self.assertEqual(len(service.containers(stopped=True)), 1)
  232. old_ids = [c.id for c in service.containers(stopped=True)]
  233. self.dispatch(['create', '--no-recreate'], None)
  234. self.assertEqual(len(service.containers()), 0)
  235. self.assertEqual(len(service.containers(stopped=True)), 1)
  236. new_ids = [c.id for c in service.containers(stopped=True)]
  237. self.assertEqual(old_ids, new_ids)
  238. def test_create_with_force_recreate_and_no_recreate(self):
  239. self.dispatch(
  240. ['create', '--force-recreate', '--no-recreate'],
  241. returncode=1)
  242. def test_up_detached(self):
  243. self.dispatch(['up', '-d'])
  244. service = self.project.get_service('simple')
  245. another = self.project.get_service('another')
  246. self.assertEqual(len(service.containers()), 1)
  247. self.assertEqual(len(another.containers()), 1)
  248. # Ensure containers don't have stdin and stdout connected in -d mode
  249. container, = service.containers()
  250. self.assertFalse(container.get('Config.AttachStderr'))
  251. self.assertFalse(container.get('Config.AttachStdout'))
  252. self.assertFalse(container.get('Config.AttachStdin'))
  253. def test_up_attached(self):
  254. self.base_dir = 'tests/fixtures/echo-services'
  255. result = self.dispatch(['up', '--no-color'])
  256. assert 'simple_1 | simple' in result.stdout
  257. assert 'another_1 | another' in result.stdout
  258. def test_up_without_networking(self):
  259. self.require_api_version('1.21')
  260. self.base_dir = 'tests/fixtures/links-composefile'
  261. self.dispatch(['up', '-d'], None)
  262. client = docker_client(version='1.21')
  263. networks = client.networks(names=[self.project.name])
  264. self.assertEqual(len(networks), 0)
  265. for service in self.project.get_services():
  266. containers = service.containers()
  267. self.assertEqual(len(containers), 1)
  268. self.assertNotEqual(containers[0].get('Config.Hostname'), service.name)
  269. web_container = self.project.get_service('web').containers()[0]
  270. self.assertTrue(web_container.get('HostConfig.Links'))
  271. def test_up_with_networking(self):
  272. self.require_api_version('1.21')
  273. self.base_dir = 'tests/fixtures/links-composefile'
  274. self.dispatch(['--x-networking', 'up', '-d'], None)
  275. client = docker_client(version='1.21')
  276. services = self.project.get_services()
  277. networks = client.networks(names=[self.project.name])
  278. for n in networks:
  279. self.addCleanup(client.remove_network, n['Id'])
  280. self.assertEqual(len(networks), 1)
  281. self.assertEqual(networks[0]['Driver'], 'bridge')
  282. network = client.inspect_network(networks[0]['Id'])
  283. self.assertEqual(len(network['Containers']), len(services))
  284. for service in services:
  285. containers = service.containers()
  286. self.assertEqual(len(containers), 1)
  287. self.assertIn(containers[0].id, network['Containers'])
  288. web_container = self.project.get_service('web').containers()[0]
  289. self.assertFalse(web_container.get('HostConfig.Links'))
  290. def test_up_with_links(self):
  291. self.base_dir = 'tests/fixtures/links-composefile'
  292. self.dispatch(['up', '-d', 'web'], None)
  293. web = self.project.get_service('web')
  294. db = self.project.get_service('db')
  295. console = self.project.get_service('console')
  296. self.assertEqual(len(web.containers()), 1)
  297. self.assertEqual(len(db.containers()), 1)
  298. self.assertEqual(len(console.containers()), 0)
  299. def test_up_with_no_deps(self):
  300. self.base_dir = 'tests/fixtures/links-composefile'
  301. self.dispatch(['up', '-d', '--no-deps', 'web'], None)
  302. web = self.project.get_service('web')
  303. db = self.project.get_service('db')
  304. console = self.project.get_service('console')
  305. self.assertEqual(len(web.containers()), 1)
  306. self.assertEqual(len(db.containers()), 0)
  307. self.assertEqual(len(console.containers()), 0)
  308. def test_up_with_force_recreate(self):
  309. self.dispatch(['up', '-d'], None)
  310. service = self.project.get_service('simple')
  311. self.assertEqual(len(service.containers()), 1)
  312. old_ids = [c.id for c in service.containers()]
  313. self.dispatch(['up', '-d', '--force-recreate'], None)
  314. self.assertEqual(len(service.containers()), 1)
  315. new_ids = [c.id for c in service.containers()]
  316. self.assertNotEqual(old_ids, new_ids)
  317. def test_up_with_no_recreate(self):
  318. self.dispatch(['up', '-d'], None)
  319. service = self.project.get_service('simple')
  320. self.assertEqual(len(service.containers()), 1)
  321. old_ids = [c.id for c in service.containers()]
  322. self.dispatch(['up', '-d', '--no-recreate'], None)
  323. self.assertEqual(len(service.containers()), 1)
  324. new_ids = [c.id for c in service.containers()]
  325. self.assertEqual(old_ids, new_ids)
  326. def test_up_with_force_recreate_and_no_recreate(self):
  327. self.dispatch(
  328. ['up', '-d', '--force-recreate', '--no-recreate'],
  329. returncode=1)
  330. def test_up_with_timeout(self):
  331. self.dispatch(['up', '-d', '-t', '1'])
  332. service = self.project.get_service('simple')
  333. another = self.project.get_service('another')
  334. self.assertEqual(len(service.containers()), 1)
  335. self.assertEqual(len(another.containers()), 1)
  336. # Ensure containers don't have stdin and stdout connected in -d mode
  337. config = service.containers()[0].inspect()['Config']
  338. self.assertFalse(config['AttachStderr'])
  339. self.assertFalse(config['AttachStdout'])
  340. self.assertFalse(config['AttachStdin'])
  341. def test_up_handles_sigint(self):
  342. proc = start_process(self.base_dir, ['up', '-t', '2'])
  343. wait_on_condition(ContainerCountCondition(self.project, 2))
  344. os.kill(proc.pid, signal.SIGINT)
  345. wait_on_condition(ContainerCountCondition(self.project, 0))
  346. def test_up_handles_sigterm(self):
  347. proc = start_process(self.base_dir, ['up', '-t', '2'])
  348. wait_on_condition(ContainerCountCondition(self.project, 2))
  349. os.kill(proc.pid, signal.SIGTERM)
  350. wait_on_condition(ContainerCountCondition(self.project, 0))
  351. def test_run_service_without_links(self):
  352. self.base_dir = 'tests/fixtures/links-composefile'
  353. self.dispatch(['run', 'console', '/bin/true'])
  354. self.assertEqual(len(self.project.containers()), 0)
  355. # Ensure stdin/out was open
  356. container = self.project.containers(stopped=True, one_off=True)[0]
  357. config = container.inspect()['Config']
  358. self.assertTrue(config['AttachStderr'])
  359. self.assertTrue(config['AttachStdout'])
  360. self.assertTrue(config['AttachStdin'])
  361. def test_run_service_with_links(self):
  362. self.base_dir = 'tests/fixtures/links-composefile'
  363. self.dispatch(['run', 'web', '/bin/true'], None)
  364. db = self.project.get_service('db')
  365. console = self.project.get_service('console')
  366. self.assertEqual(len(db.containers()), 1)
  367. self.assertEqual(len(console.containers()), 0)
  368. def test_run_with_no_deps(self):
  369. self.base_dir = 'tests/fixtures/links-composefile'
  370. self.dispatch(['run', '--no-deps', 'web', '/bin/true'])
  371. db = self.project.get_service('db')
  372. self.assertEqual(len(db.containers()), 0)
  373. def test_run_does_not_recreate_linked_containers(self):
  374. self.base_dir = 'tests/fixtures/links-composefile'
  375. self.dispatch(['up', '-d', 'db'])
  376. db = self.project.get_service('db')
  377. self.assertEqual(len(db.containers()), 1)
  378. old_ids = [c.id for c in db.containers()]
  379. self.dispatch(['run', 'web', '/bin/true'], None)
  380. self.assertEqual(len(db.containers()), 1)
  381. new_ids = [c.id for c in db.containers()]
  382. self.assertEqual(old_ids, new_ids)
  383. def test_run_without_command(self):
  384. self.base_dir = 'tests/fixtures/commands-composefile'
  385. self.check_build('tests/fixtures/simple-dockerfile', tag='composetest_test')
  386. self.dispatch(['run', 'implicit'])
  387. service = self.project.get_service('implicit')
  388. containers = service.containers(stopped=True, one_off=True)
  389. self.assertEqual(
  390. [c.human_readable_command for c in containers],
  391. [u'/bin/sh -c echo "success"'],
  392. )
  393. self.dispatch(['run', 'explicit'])
  394. service = self.project.get_service('explicit')
  395. containers = service.containers(stopped=True, one_off=True)
  396. self.assertEqual(
  397. [c.human_readable_command for c in containers],
  398. [u'/bin/true'],
  399. )
  400. def test_run_service_with_entrypoint_overridden(self):
  401. self.base_dir = 'tests/fixtures/dockerfile_with_entrypoint'
  402. name = 'service'
  403. self.dispatch(['run', '--entrypoint', '/bin/echo', name, 'helloworld'])
  404. service = self.project.get_service(name)
  405. container = service.containers(stopped=True, one_off=True)[0]
  406. self.assertEqual(
  407. shlex.split(container.human_readable_command),
  408. [u'/bin/echo', u'helloworld'],
  409. )
  410. def test_run_service_with_user_overridden(self):
  411. self.base_dir = 'tests/fixtures/user-composefile'
  412. name = 'service'
  413. user = 'sshd'
  414. self.dispatch(['run', '--user={user}'.format(user=user), name], returncode=1)
  415. service = self.project.get_service(name)
  416. container = service.containers(stopped=True, one_off=True)[0]
  417. self.assertEqual(user, container.get('Config.User'))
  418. def test_run_service_with_user_overridden_short_form(self):
  419. self.base_dir = 'tests/fixtures/user-composefile'
  420. name = 'service'
  421. user = 'sshd'
  422. self.dispatch(['run', '-u', user, name], returncode=1)
  423. service = self.project.get_service(name)
  424. container = service.containers(stopped=True, one_off=True)[0]
  425. self.assertEqual(user, container.get('Config.User'))
  426. def test_run_service_with_environement_overridden(self):
  427. name = 'service'
  428. self.base_dir = 'tests/fixtures/environment-composefile'
  429. self.dispatch([
  430. 'run', '-e', 'foo=notbar',
  431. '-e', 'allo=moto=bobo',
  432. '-e', 'alpha=beta',
  433. name,
  434. '/bin/true',
  435. ])
  436. service = self.project.get_service(name)
  437. container = service.containers(stopped=True, one_off=True)[0]
  438. # env overriden
  439. self.assertEqual('notbar', container.environment['foo'])
  440. # keep environement from yaml
  441. self.assertEqual('world', container.environment['hello'])
  442. # added option from command line
  443. self.assertEqual('beta', container.environment['alpha'])
  444. # make sure a value with a = don't crash out
  445. self.assertEqual('moto=bobo', container.environment['allo'])
  446. def test_run_service_without_map_ports(self):
  447. # create one off container
  448. self.base_dir = 'tests/fixtures/ports-composefile'
  449. self.dispatch(['run', '-d', 'simple'])
  450. container = self.project.get_service('simple').containers(one_off=True)[0]
  451. # get port information
  452. port_random = container.get_local_port(3000)
  453. port_assigned = container.get_local_port(3001)
  454. # close all one off containers we just created
  455. container.stop()
  456. # check the ports
  457. self.assertEqual(port_random, None)
  458. self.assertEqual(port_assigned, None)
  459. def test_run_service_with_map_ports(self):
  460. # create one off container
  461. self.base_dir = 'tests/fixtures/ports-composefile'
  462. self.dispatch(['run', '-d', '--service-ports', 'simple'])
  463. container = self.project.get_service('simple').containers(one_off=True)[0]
  464. # get port information
  465. port_random = container.get_local_port(3000)
  466. port_assigned = container.get_local_port(3001)
  467. port_range = container.get_local_port(3002), container.get_local_port(3003)
  468. # close all one off containers we just created
  469. container.stop()
  470. # check the ports
  471. self.assertNotEqual(port_random, None)
  472. self.assertIn("0.0.0.0", port_random)
  473. self.assertEqual(port_assigned, "0.0.0.0:49152")
  474. self.assertEqual(port_range[0], "0.0.0.0:49153")
  475. self.assertEqual(port_range[1], "0.0.0.0:49154")
  476. def test_run_service_with_explicitly_maped_ports(self):
  477. # create one off container
  478. self.base_dir = 'tests/fixtures/ports-composefile'
  479. self.dispatch(['run', '-d', '-p', '30000:3000', '--publish', '30001:3001', 'simple'])
  480. container = self.project.get_service('simple').containers(one_off=True)[0]
  481. # get port information
  482. port_short = container.get_local_port(3000)
  483. port_full = container.get_local_port(3001)
  484. # close all one off containers we just created
  485. container.stop()
  486. # check the ports
  487. self.assertEqual(port_short, "0.0.0.0:30000")
  488. self.assertEqual(port_full, "0.0.0.0:30001")
  489. def test_run_service_with_explicitly_maped_ip_ports(self):
  490. # create one off container
  491. self.base_dir = 'tests/fixtures/ports-composefile'
  492. self.dispatch(['run', '-d', '-p', '127.0.0.1:30000:3000', '--publish', '127.0.0.1:30001:3001', 'simple'], None)
  493. container = self.project.get_service('simple').containers(one_off=True)[0]
  494. # get port information
  495. port_short = container.get_local_port(3000)
  496. port_full = container.get_local_port(3001)
  497. # close all one off containers we just created
  498. container.stop()
  499. # check the ports
  500. self.assertEqual(port_short, "127.0.0.1:30000")
  501. self.assertEqual(port_full, "127.0.0.1:30001")
  502. def test_run_with_custom_name(self):
  503. self.base_dir = 'tests/fixtures/environment-composefile'
  504. name = 'the-container-name'
  505. self.dispatch(['run', '--name', name, 'service', '/bin/true'])
  506. service = self.project.get_service('service')
  507. container, = service.containers(stopped=True, one_off=True)
  508. self.assertEqual(container.name, name)
  509. def test_run_with_networking(self):
  510. self.require_api_version('1.21')
  511. client = docker_client(version='1.21')
  512. self.base_dir = 'tests/fixtures/simple-dockerfile'
  513. self.dispatch(['--x-networking', 'run', 'simple', 'true'], None)
  514. service = self.project.get_service('simple')
  515. container, = service.containers(stopped=True, one_off=True)
  516. networks = client.networks(names=[self.project.name])
  517. for n in networks:
  518. self.addCleanup(client.remove_network, n['Id'])
  519. self.assertEqual(len(networks), 1)
  520. self.assertEqual(container.human_readable_command, u'true')
  521. def test_run_handles_sigint(self):
  522. proc = start_process(self.base_dir, ['run', '-T', 'simple', 'top'])
  523. wait_on_condition(ContainerStateCondition(
  524. self.project.client,
  525. 'simplecomposefile_simple_run_1',
  526. running=True))
  527. os.kill(proc.pid, signal.SIGINT)
  528. wait_on_condition(ContainerStateCondition(
  529. self.project.client,
  530. 'simplecomposefile_simple_run_1',
  531. running=False))
  532. def test_run_handles_sigterm(self):
  533. proc = start_process(self.base_dir, ['run', '-T', 'simple', 'top'])
  534. wait_on_condition(ContainerStateCondition(
  535. self.project.client,
  536. 'simplecomposefile_simple_run_1',
  537. running=True))
  538. os.kill(proc.pid, signal.SIGTERM)
  539. wait_on_condition(ContainerStateCondition(
  540. self.project.client,
  541. 'simplecomposefile_simple_run_1',
  542. running=False))
  543. def test_rm(self):
  544. service = self.project.get_service('simple')
  545. service.create_container()
  546. kill_service(service)
  547. self.assertEqual(len(service.containers(stopped=True)), 1)
  548. self.dispatch(['rm', '--force'], None)
  549. self.assertEqual(len(service.containers(stopped=True)), 0)
  550. service = self.project.get_service('simple')
  551. service.create_container()
  552. kill_service(service)
  553. self.assertEqual(len(service.containers(stopped=True)), 1)
  554. self.dispatch(['rm', '-f'], None)
  555. self.assertEqual(len(service.containers(stopped=True)), 0)
  556. def test_stop(self):
  557. self.dispatch(['up', '-d'], None)
  558. service = self.project.get_service('simple')
  559. self.assertEqual(len(service.containers()), 1)
  560. self.assertTrue(service.containers()[0].is_running)
  561. self.dispatch(['stop', '-t', '1'], None)
  562. self.assertEqual(len(service.containers(stopped=True)), 1)
  563. self.assertFalse(service.containers(stopped=True)[0].is_running)
  564. def test_start_no_containers(self):
  565. result = self.dispatch(['start'], returncode=1)
  566. assert 'No containers to start' in result.stderr
  567. def test_up_logging(self):
  568. self.base_dir = 'tests/fixtures/logging-composefile'
  569. self.dispatch(['up', '-d'])
  570. simple = self.project.get_service('simple').containers()[0]
  571. log_config = simple.get('HostConfig.LogConfig')
  572. self.assertTrue(log_config)
  573. self.assertEqual(log_config.get('Type'), 'none')
  574. another = self.project.get_service('another').containers()[0]
  575. log_config = another.get('HostConfig.LogConfig')
  576. self.assertTrue(log_config)
  577. self.assertEqual(log_config.get('Type'), 'json-file')
  578. self.assertEqual(log_config.get('Config')['max-size'], '10m')
  579. def test_up_logging_with_multiple_files(self):
  580. self.base_dir = 'tests/fixtures/logging-composefile'
  581. config_paths = [
  582. 'docker-compose.yml',
  583. 'compose2.yml',
  584. ]
  585. self._project = get_project(self.base_dir, config_paths)
  586. self.dispatch(
  587. [
  588. '-f', config_paths[0],
  589. '-f', config_paths[1],
  590. 'up', '-d',
  591. ],
  592. None)
  593. containers = self.project.containers()
  594. self.assertEqual(len(containers), 2)
  595. another = self.project.get_service('another').containers()[0]
  596. log_config = another.get('HostConfig.LogConfig')
  597. self.assertTrue(log_config)
  598. self.assertEqual(log_config.get('Type'), 'none')
  599. def test_pause_unpause(self):
  600. self.dispatch(['up', '-d'], None)
  601. service = self.project.get_service('simple')
  602. self.assertFalse(service.containers()[0].is_paused)
  603. self.dispatch(['pause'], None)
  604. self.assertTrue(service.containers()[0].is_paused)
  605. self.dispatch(['unpause'], None)
  606. self.assertFalse(service.containers()[0].is_paused)
  607. def test_pause_no_containers(self):
  608. result = self.dispatch(['pause'], returncode=1)
  609. assert 'No containers to pause' in result.stderr
  610. def test_unpause_no_containers(self):
  611. result = self.dispatch(['unpause'], returncode=1)
  612. assert 'No containers to unpause' in result.stderr
  613. def test_logs_invalid_service_name(self):
  614. self.dispatch(['logs', 'madeupname'], returncode=1)
  615. def test_kill(self):
  616. self.dispatch(['up', '-d'], None)
  617. service = self.project.get_service('simple')
  618. self.assertEqual(len(service.containers()), 1)
  619. self.assertTrue(service.containers()[0].is_running)
  620. self.dispatch(['kill'], None)
  621. self.assertEqual(len(service.containers(stopped=True)), 1)
  622. self.assertFalse(service.containers(stopped=True)[0].is_running)
  623. def test_kill_signal_sigstop(self):
  624. self.dispatch(['up', '-d'], None)
  625. service = self.project.get_service('simple')
  626. self.assertEqual(len(service.containers()), 1)
  627. self.assertTrue(service.containers()[0].is_running)
  628. self.dispatch(['kill', '-s', 'SIGSTOP'], None)
  629. self.assertEqual(len(service.containers()), 1)
  630. # The container is still running. It has only been paused
  631. self.assertTrue(service.containers()[0].is_running)
  632. def test_kill_stopped_service(self):
  633. self.dispatch(['up', '-d'], None)
  634. service = self.project.get_service('simple')
  635. self.dispatch(['kill', '-s', 'SIGSTOP'], None)
  636. self.assertTrue(service.containers()[0].is_running)
  637. self.dispatch(['kill', '-s', 'SIGKILL'], None)
  638. self.assertEqual(len(service.containers(stopped=True)), 1)
  639. self.assertFalse(service.containers(stopped=True)[0].is_running)
  640. def test_restart(self):
  641. service = self.project.get_service('simple')
  642. container = service.create_container()
  643. container.start()
  644. started_at = container.dictionary['State']['StartedAt']
  645. self.dispatch(['restart', '-t', '1'], None)
  646. container.inspect()
  647. self.assertNotEqual(
  648. container.dictionary['State']['FinishedAt'],
  649. '0001-01-01T00:00:00Z',
  650. )
  651. self.assertNotEqual(
  652. container.dictionary['State']['StartedAt'],
  653. started_at,
  654. )
  655. def test_restart_stopped_container(self):
  656. service = self.project.get_service('simple')
  657. container = service.create_container()
  658. container.start()
  659. container.kill()
  660. self.assertEqual(len(service.containers(stopped=True)), 1)
  661. self.dispatch(['restart', '-t', '1'], None)
  662. self.assertEqual(len(service.containers(stopped=False)), 1)
  663. def test_restart_no_containers(self):
  664. result = self.dispatch(['restart'], returncode=1)
  665. assert 'No containers to restart' in result.stderr
  666. def test_scale(self):
  667. project = self.project
  668. self.dispatch(['scale', 'simple=1'])
  669. self.assertEqual(len(project.get_service('simple').containers()), 1)
  670. self.dispatch(['scale', 'simple=3', 'another=2'])
  671. self.assertEqual(len(project.get_service('simple').containers()), 3)
  672. self.assertEqual(len(project.get_service('another').containers()), 2)
  673. self.dispatch(['scale', 'simple=1', 'another=1'])
  674. self.assertEqual(len(project.get_service('simple').containers()), 1)
  675. self.assertEqual(len(project.get_service('another').containers()), 1)
  676. self.dispatch(['scale', 'simple=1', 'another=1'])
  677. self.assertEqual(len(project.get_service('simple').containers()), 1)
  678. self.assertEqual(len(project.get_service('another').containers()), 1)
  679. self.dispatch(['scale', 'simple=0', 'another=0'])
  680. self.assertEqual(len(project.get_service('simple').containers()), 0)
  681. self.assertEqual(len(project.get_service('another').containers()), 0)
  682. def test_port(self):
  683. self.base_dir = 'tests/fixtures/ports-composefile'
  684. self.dispatch(['up', '-d'], None)
  685. container = self.project.get_service('simple').get_container()
  686. def get_port(number):
  687. result = self.dispatch(['port', 'simple', str(number)])
  688. return result.stdout.rstrip()
  689. self.assertEqual(get_port(3000), container.get_local_port(3000))
  690. self.assertEqual(get_port(3001), "0.0.0.0:49152")
  691. self.assertEqual(get_port(3002), "0.0.0.0:49153")
  692. def test_port_with_scale(self):
  693. self.base_dir = 'tests/fixtures/ports-composefile-scale'
  694. self.dispatch(['scale', 'simple=2'], None)
  695. containers = sorted(
  696. self.project.containers(service_names=['simple']),
  697. key=attrgetter('name'))
  698. def get_port(number, index=None):
  699. if index is None:
  700. result = self.dispatch(['port', 'simple', str(number)])
  701. else:
  702. result = self.dispatch(['port', '--index=' + str(index), 'simple', str(number)])
  703. return result.stdout.rstrip()
  704. self.assertEqual(get_port(3000), containers[0].get_local_port(3000))
  705. self.assertEqual(get_port(3000, index=1), containers[0].get_local_port(3000))
  706. self.assertEqual(get_port(3000, index=2), containers[1].get_local_port(3000))
  707. self.assertEqual(get_port(3002), "")
  708. def test_env_file_relative_to_compose_file(self):
  709. config_path = os.path.abspath('tests/fixtures/env-file/docker-compose.yml')
  710. self.dispatch(['-f', config_path, 'up', '-d'], None)
  711. self._project = get_project(self.base_dir, [config_path])
  712. containers = self.project.containers(stopped=True)
  713. self.assertEqual(len(containers), 1)
  714. self.assertIn("FOO=1", containers[0].get('Config.Env'))
  715. @mock.patch.dict(os.environ)
  716. def test_home_and_env_var_in_volume_path(self):
  717. os.environ['VOLUME_NAME'] = 'my-volume'
  718. os.environ['HOME'] = '/tmp/home-dir'
  719. self.base_dir = 'tests/fixtures/volume-path-interpolation'
  720. self.dispatch(['up', '-d'], None)
  721. container = self.project.containers(stopped=True)[0]
  722. actual_host_path = container.get_mount('/container-path')['Source']
  723. components = actual_host_path.split('/')
  724. assert components[-2:] == ['home-dir', 'my-volume']
  725. def test_up_with_default_override_file(self):
  726. self.base_dir = 'tests/fixtures/override-files'
  727. self.dispatch(['up', '-d'], None)
  728. containers = self.project.containers()
  729. self.assertEqual(len(containers), 2)
  730. web, db = containers
  731. self.assertEqual(web.human_readable_command, 'top')
  732. self.assertEqual(db.human_readable_command, 'top')
  733. def test_up_with_multiple_files(self):
  734. self.base_dir = 'tests/fixtures/override-files'
  735. config_paths = [
  736. 'docker-compose.yml',
  737. 'docker-compose.override.yml',
  738. 'extra.yml',
  739. ]
  740. self._project = get_project(self.base_dir, config_paths)
  741. self.dispatch(
  742. [
  743. '-f', config_paths[0],
  744. '-f', config_paths[1],
  745. '-f', config_paths[2],
  746. 'up', '-d',
  747. ],
  748. None)
  749. containers = self.project.containers()
  750. self.assertEqual(len(containers), 3)
  751. web, other, db = containers
  752. self.assertEqual(web.human_readable_command, 'top')
  753. self.assertTrue({'db', 'other'} <= set(get_links(web)))
  754. self.assertEqual(db.human_readable_command, 'top')
  755. self.assertEqual(other.human_readable_command, 'top')
  756. def test_up_with_extends(self):
  757. self.base_dir = 'tests/fixtures/extends'
  758. self.dispatch(['up', '-d'], None)
  759. self.assertEqual(
  760. set([s.name for s in self.project.services]),
  761. set(['mydb', 'myweb']),
  762. )
  763. # Sort by name so we get [db, web]
  764. containers = sorted(
  765. self.project.containers(stopped=True),
  766. key=lambda c: c.name,
  767. )
  768. self.assertEqual(len(containers), 2)
  769. web = containers[1]
  770. self.assertEqual(
  771. set(get_links(web)),
  772. set(['db', 'mydb_1', 'extends_mydb_1']))
  773. expected_env = set([
  774. "FOO=1",
  775. "BAR=2",
  776. "BAZ=2",
  777. ])
  778. self.assertTrue(expected_env <= set(web.get('Config.Env')))