cli_test.py 66 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041104210431044104510461047104810491050105110521053105410551056105710581059106010611062106310641065106610671068106910701071107210731074107510761077107810791080108110821083108410851086108710881089109010911092109310941095109610971098109911001101110211031104110511061107110811091110111111121113111411151116111711181119112011211122112311241125112611271128112911301131113211331134113511361137113811391140114111421143114411451146114711481149115011511152115311541155115611571158115911601161116211631164116511661167116811691170117111721173117411751176117711781179118011811182118311841185118611871188118911901191119211931194119511961197119811991200120112021203120412051206120712081209121012111212121312141215121612171218121912201221122212231224122512261227122812291230123112321233123412351236123712381239124012411242124312441245124612471248124912501251125212531254125512561257125812591260126112621263126412651266126712681269127012711272127312741275127612771278127912801281128212831284128512861287128812891290129112921293129412951296129712981299130013011302130313041305130613071308130913101311131213131314131513161317131813191320132113221323132413251326132713281329133013311332133313341335133613371338133913401341134213431344134513461347134813491350135113521353135413551356135713581359136013611362136313641365136613671368136913701371137213731374137513761377137813791380138113821383138413851386138713881389139013911392139313941395139613971398139914001401140214031404140514061407140814091410141114121413141414151416141714181419142014211422142314241425142614271428142914301431143214331434143514361437143814391440144114421443144414451446144714481449145014511452145314541455145614571458145914601461146214631464146514661467146814691470147114721473147414751476147714781479148014811482148314841485148614871488148914901491149214931494149514961497149814991500150115021503150415051506150715081509151015111512151315141515151615171518151915201521152215231524152515261527152815291530153115321533153415351536153715381539154015411542154315441545154615471548154915501551155215531554155515561557155815591560156115621563156415651566156715681569157015711572157315741575157615771578157915801581158215831584158515861587158815891590159115921593159415951596159715981599160016011602160316041605160616071608160916101611161216131614161516161617161816191620162116221623162416251626162716281629163016311632163316341635163616371638163916401641164216431644164516461647164816491650165116521653165416551656165716581659166016611662166316641665166616671668166916701671167216731674167516761677167816791680168116821683168416851686168716881689169016911692169316941695169616971698169917001701170217031704170517061707170817091710171117121713171417151716171717181719172017211722
  1. from __future__ import absolute_import
  2. from __future__ import unicode_literals
  3. import datetime
  4. import json
  5. import os
  6. import signal
  7. import subprocess
  8. import time
  9. from collections import Counter
  10. from collections import namedtuple
  11. from operator import attrgetter
  12. import py
  13. import yaml
  14. from docker import errors
  15. from .. import mock
  16. from compose.cli.command import get_project
  17. from compose.container import Container
  18. from compose.project import OneOffFilter
  19. from tests.integration.testcases import DockerClientTestCase
  20. from tests.integration.testcases import get_links
  21. from tests.integration.testcases import pull_busybox
  22. from tests.integration.testcases import v2_only
  23. ProcessResult = namedtuple('ProcessResult', 'stdout stderr')
  24. BUILD_CACHE_TEXT = 'Using cache'
  25. BUILD_PULL_TEXT = 'Status: Image is up to date for busybox:latest'
  26. def start_process(base_dir, options):
  27. proc = subprocess.Popen(
  28. ['docker-compose'] + options,
  29. stdout=subprocess.PIPE,
  30. stderr=subprocess.PIPE,
  31. cwd=base_dir)
  32. print("Running process: %s" % proc.pid)
  33. return proc
  34. def wait_on_process(proc, returncode=0):
  35. stdout, stderr = proc.communicate()
  36. if proc.returncode != returncode:
  37. print("Stderr: {}".format(stderr))
  38. print("Stdout: {}".format(stdout))
  39. assert proc.returncode == returncode
  40. return ProcessResult(stdout.decode('utf-8'), stderr.decode('utf-8'))
  41. def wait_on_condition(condition, delay=0.1, timeout=40):
  42. start_time = time.time()
  43. while not condition():
  44. if time.time() - start_time > timeout:
  45. raise AssertionError("Timeout: %s" % condition)
  46. time.sleep(delay)
  47. def kill_service(service):
  48. for container in service.containers():
  49. container.kill()
  50. class ContainerCountCondition(object):
  51. def __init__(self, project, expected):
  52. self.project = project
  53. self.expected = expected
  54. def __call__(self):
  55. return len(self.project.containers()) == self.expected
  56. def __str__(self):
  57. return "waiting for counter count == %s" % self.expected
  58. class ContainerStateCondition(object):
  59. def __init__(self, client, name, status):
  60. self.client = client
  61. self.name = name
  62. self.status = status
  63. def __call__(self):
  64. try:
  65. container = self.client.inspect_container(self.name)
  66. return container['State']['Status'] == self.status
  67. except errors.APIError:
  68. return False
  69. def __str__(self):
  70. return "waiting for container to be %s" % self.status
  71. class CLITestCase(DockerClientTestCase):
  72. def setUp(self):
  73. super(CLITestCase, self).setUp()
  74. self.base_dir = 'tests/fixtures/simple-composefile'
  75. def tearDown(self):
  76. if self.base_dir:
  77. self.project.kill()
  78. self.project.remove_stopped()
  79. for container in self.project.containers(stopped=True, one_off=OneOffFilter.only):
  80. container.remove(force=True)
  81. networks = self.client.networks()
  82. for n in networks:
  83. if n['Name'].startswith('{}_'.format(self.project.name)):
  84. self.client.remove_network(n['Name'])
  85. if hasattr(self, '_project'):
  86. del self._project
  87. super(CLITestCase, self).tearDown()
  88. @property
  89. def project(self):
  90. # Hack: allow project to be overridden
  91. if not hasattr(self, '_project'):
  92. self._project = get_project(self.base_dir)
  93. return self._project
  94. def dispatch(self, options, project_options=None, returncode=0):
  95. project_options = project_options or []
  96. proc = start_process(self.base_dir, project_options + options)
  97. return wait_on_process(proc, returncode=returncode)
  98. def execute(self, container, cmd):
  99. # Remove once Hijack and CloseNotifier sign a peace treaty
  100. self.client.close()
  101. exc = self.client.exec_create(container.id, cmd)
  102. self.client.exec_start(exc)
  103. return self.client.exec_inspect(exc)['ExitCode']
  104. def lookup(self, container, hostname):
  105. return self.execute(container, ["nslookup", hostname]) == 0
  106. def test_help(self):
  107. self.base_dir = 'tests/fixtures/no-composefile'
  108. result = self.dispatch(['help', 'up'], returncode=0)
  109. assert 'Usage: up [options] [SERVICE...]' in result.stdout
  110. # Prevent tearDown from trying to create a project
  111. self.base_dir = None
  112. def test_shorthand_host_opt(self):
  113. self.dispatch(
  114. ['-H={0}'.format(os.environ.get('DOCKER_HOST', 'unix://')),
  115. 'up', '-d'],
  116. returncode=0
  117. )
  118. def test_host_not_reachable(self):
  119. result = self.dispatch(['-H=tcp://doesnotexist:8000', 'ps'], returncode=1)
  120. assert "Couldn't connect to Docker daemon" in result.stderr
  121. def test_host_not_reachable_volumes_from_container(self):
  122. self.base_dir = 'tests/fixtures/volumes-from-container'
  123. container = self.client.create_container('busybox', 'true', name='composetest_data_container')
  124. self.addCleanup(self.client.remove_container, container)
  125. result = self.dispatch(['-H=tcp://doesnotexist:8000', 'ps'], returncode=1)
  126. assert "Couldn't connect to Docker daemon" in result.stderr
  127. def test_config_list_services(self):
  128. self.base_dir = 'tests/fixtures/v2-full'
  129. result = self.dispatch(['config', '--services'])
  130. assert set(result.stdout.rstrip().split('\n')) == {'web', 'other'}
  131. def test_config_quiet_with_error(self):
  132. self.base_dir = None
  133. result = self.dispatch([
  134. '-f', 'tests/fixtures/invalid-composefile/invalid.yml',
  135. 'config', '-q'
  136. ], returncode=1)
  137. assert "'notaservice' must be a mapping" in result.stderr
  138. def test_config_quiet(self):
  139. self.base_dir = 'tests/fixtures/v2-full'
  140. assert self.dispatch(['config', '-q']).stdout == ''
  141. def test_config_default(self):
  142. self.base_dir = 'tests/fixtures/v2-full'
  143. result = self.dispatch(['config'])
  144. # assert there are no python objects encoded in the output
  145. assert '!!' not in result.stdout
  146. output = yaml.load(result.stdout)
  147. expected = {
  148. 'version': '2.0',
  149. 'volumes': {'data': {'driver': 'local'}},
  150. 'networks': {'front': {}},
  151. 'services': {
  152. 'web': {
  153. 'build': {
  154. 'context': os.path.abspath(self.base_dir),
  155. },
  156. 'networks': {'front': None, 'default': None},
  157. 'volumes_from': ['service:other:rw'],
  158. },
  159. 'other': {
  160. 'image': 'busybox:latest',
  161. 'command': 'top',
  162. 'volumes': ['/data:rw'],
  163. },
  164. },
  165. }
  166. assert output == expected
  167. def test_config_restart(self):
  168. self.base_dir = 'tests/fixtures/restart'
  169. result = self.dispatch(['config'])
  170. assert yaml.load(result.stdout) == {
  171. 'version': '2.0',
  172. 'services': {
  173. 'never': {
  174. 'image': 'busybox',
  175. 'restart': 'no',
  176. },
  177. 'always': {
  178. 'image': 'busybox',
  179. 'restart': 'always',
  180. },
  181. 'on-failure': {
  182. 'image': 'busybox',
  183. 'restart': 'on-failure',
  184. },
  185. 'on-failure-5': {
  186. 'image': 'busybox',
  187. 'restart': 'on-failure:5',
  188. },
  189. },
  190. 'networks': {},
  191. 'volumes': {},
  192. }
  193. def test_config_external_network(self):
  194. self.base_dir = 'tests/fixtures/networks'
  195. result = self.dispatch(['-f', 'external-networks.yml', 'config'])
  196. json_result = yaml.load(result.stdout)
  197. assert 'networks' in json_result
  198. assert json_result['networks'] == {
  199. 'networks_foo': {
  200. 'external': True # {'name': 'networks_foo'}
  201. },
  202. 'bar': {
  203. 'external': {'name': 'networks_bar'}
  204. }
  205. }
  206. def test_config_v1(self):
  207. self.base_dir = 'tests/fixtures/v1-config'
  208. result = self.dispatch(['config'])
  209. assert yaml.load(result.stdout) == {
  210. 'version': '2.1',
  211. 'services': {
  212. 'net': {
  213. 'image': 'busybox',
  214. 'network_mode': 'bridge',
  215. },
  216. 'volume': {
  217. 'image': 'busybox',
  218. 'volumes': ['/data:rw'],
  219. 'network_mode': 'bridge',
  220. },
  221. 'app': {
  222. 'image': 'busybox',
  223. 'volumes_from': ['service:volume:rw'],
  224. 'network_mode': 'service:net',
  225. },
  226. },
  227. 'networks': {},
  228. 'volumes': {},
  229. }
  230. def test_ps(self):
  231. self.project.get_service('simple').create_container()
  232. result = self.dispatch(['ps'])
  233. assert 'simplecomposefile_simple_1' in result.stdout
  234. def test_ps_default_composefile(self):
  235. self.base_dir = 'tests/fixtures/multiple-composefiles'
  236. self.dispatch(['up', '-d'])
  237. result = self.dispatch(['ps'])
  238. self.assertIn('multiplecomposefiles_simple_1', result.stdout)
  239. self.assertIn('multiplecomposefiles_another_1', result.stdout)
  240. self.assertNotIn('multiplecomposefiles_yetanother_1', result.stdout)
  241. def test_ps_alternate_composefile(self):
  242. config_path = os.path.abspath(
  243. 'tests/fixtures/multiple-composefiles/compose2.yml')
  244. self._project = get_project(self.base_dir, [config_path])
  245. self.base_dir = 'tests/fixtures/multiple-composefiles'
  246. self.dispatch(['-f', 'compose2.yml', 'up', '-d'])
  247. result = self.dispatch(['-f', 'compose2.yml', 'ps'])
  248. self.assertNotIn('multiplecomposefiles_simple_1', result.stdout)
  249. self.assertNotIn('multiplecomposefiles_another_1', result.stdout)
  250. self.assertIn('multiplecomposefiles_yetanother_1', result.stdout)
  251. def test_pull(self):
  252. result = self.dispatch(['pull'])
  253. assert sorted(result.stderr.split('\n'))[1:] == [
  254. 'Pulling another (busybox:latest)...',
  255. 'Pulling simple (busybox:latest)...',
  256. ]
  257. def test_pull_with_digest(self):
  258. result = self.dispatch(['-f', 'digest.yml', 'pull'])
  259. assert 'Pulling simple (busybox:latest)...' in result.stderr
  260. assert ('Pulling digest (busybox@'
  261. 'sha256:38a203e1986cf79639cfb9b2e1d6e773de84002feea2d4eb006b520'
  262. '04ee8502d)...') in result.stderr
  263. def test_pull_with_ignore_pull_failures(self):
  264. result = self.dispatch([
  265. '-f', 'ignore-pull-failures.yml',
  266. 'pull', '--ignore-pull-failures'])
  267. assert 'Pulling simple (busybox:latest)...' in result.stderr
  268. assert 'Pulling another (nonexisting-image:latest)...' in result.stderr
  269. assert 'Error: image library/nonexisting-image' in result.stderr
  270. assert 'not found' in result.stderr
  271. def test_build_plain(self):
  272. self.base_dir = 'tests/fixtures/simple-dockerfile'
  273. self.dispatch(['build', 'simple'])
  274. result = self.dispatch(['build', 'simple'])
  275. assert BUILD_CACHE_TEXT in result.stdout
  276. assert BUILD_PULL_TEXT not in result.stdout
  277. def test_build_no_cache(self):
  278. self.base_dir = 'tests/fixtures/simple-dockerfile'
  279. self.dispatch(['build', 'simple'])
  280. result = self.dispatch(['build', '--no-cache', 'simple'])
  281. assert BUILD_CACHE_TEXT not in result.stdout
  282. assert BUILD_PULL_TEXT not in result.stdout
  283. def test_build_pull(self):
  284. # Make sure we have the latest busybox already
  285. pull_busybox(self.client)
  286. self.base_dir = 'tests/fixtures/simple-dockerfile'
  287. self.dispatch(['build', 'simple'], None)
  288. result = self.dispatch(['build', '--pull', 'simple'])
  289. assert BUILD_CACHE_TEXT in result.stdout
  290. assert BUILD_PULL_TEXT in result.stdout
  291. def test_build_no_cache_pull(self):
  292. # Make sure we have the latest busybox already
  293. pull_busybox(self.client)
  294. self.base_dir = 'tests/fixtures/simple-dockerfile'
  295. self.dispatch(['build', 'simple'])
  296. result = self.dispatch(['build', '--no-cache', '--pull', 'simple'])
  297. assert BUILD_CACHE_TEXT not in result.stdout
  298. assert BUILD_PULL_TEXT in result.stdout
  299. def test_build_failed(self):
  300. self.base_dir = 'tests/fixtures/simple-failing-dockerfile'
  301. self.dispatch(['build', 'simple'], returncode=1)
  302. labels = ["com.docker.compose.test_failing_image=true"]
  303. containers = [
  304. Container.from_ps(self.project.client, c)
  305. for c in self.project.client.containers(
  306. all=True,
  307. filters={"label": labels})
  308. ]
  309. assert len(containers) == 1
  310. def test_build_failed_forcerm(self):
  311. self.base_dir = 'tests/fixtures/simple-failing-dockerfile'
  312. self.dispatch(['build', '--force-rm', 'simple'], returncode=1)
  313. labels = ["com.docker.compose.test_failing_image=true"]
  314. containers = [
  315. Container.from_ps(self.project.client, c)
  316. for c in self.project.client.containers(
  317. all=True,
  318. filters={"label": labels})
  319. ]
  320. assert not containers
  321. def test_bundle_with_digests(self):
  322. self.base_dir = 'tests/fixtures/bundle-with-digests/'
  323. tmpdir = py.test.ensuretemp('cli_test_bundle')
  324. self.addCleanup(tmpdir.remove)
  325. filename = str(tmpdir.join('example.dab'))
  326. self.dispatch(['bundle', '--output', filename])
  327. with open(filename, 'r') as fh:
  328. bundle = json.load(fh)
  329. assert bundle == {
  330. 'Version': '0.1',
  331. 'Services': {
  332. 'web': {
  333. 'Image': ('dockercloud/hello-world@sha256:fe79a2cfbd17eefc3'
  334. '44fb8419420808df95a1e22d93b7f621a7399fd1e9dca1d'),
  335. 'Networks': ['default'],
  336. },
  337. 'redis': {
  338. 'Image': ('redis@sha256:a84cb8f53a70e19f61ff2e1d5e73fb7ae62d'
  339. '374b2b7392de1e7d77be26ef8f7b'),
  340. 'Networks': ['default'],
  341. }
  342. },
  343. }
  344. def test_create(self):
  345. self.dispatch(['create'])
  346. service = self.project.get_service('simple')
  347. another = self.project.get_service('another')
  348. self.assertEqual(len(service.containers()), 0)
  349. self.assertEqual(len(another.containers()), 0)
  350. self.assertEqual(len(service.containers(stopped=True)), 1)
  351. self.assertEqual(len(another.containers(stopped=True)), 1)
  352. def test_create_with_force_recreate(self):
  353. self.dispatch(['create'], None)
  354. service = self.project.get_service('simple')
  355. self.assertEqual(len(service.containers()), 0)
  356. self.assertEqual(len(service.containers(stopped=True)), 1)
  357. old_ids = [c.id for c in service.containers(stopped=True)]
  358. self.dispatch(['create', '--force-recreate'], None)
  359. self.assertEqual(len(service.containers()), 0)
  360. self.assertEqual(len(service.containers(stopped=True)), 1)
  361. new_ids = [c.id for c in service.containers(stopped=True)]
  362. self.assertNotEqual(old_ids, new_ids)
  363. def test_create_with_no_recreate(self):
  364. self.dispatch(['create'], None)
  365. service = self.project.get_service('simple')
  366. self.assertEqual(len(service.containers()), 0)
  367. self.assertEqual(len(service.containers(stopped=True)), 1)
  368. old_ids = [c.id for c in service.containers(stopped=True)]
  369. self.dispatch(['create', '--no-recreate'], None)
  370. self.assertEqual(len(service.containers()), 0)
  371. self.assertEqual(len(service.containers(stopped=True)), 1)
  372. new_ids = [c.id for c in service.containers(stopped=True)]
  373. self.assertEqual(old_ids, new_ids)
  374. def test_create_with_force_recreate_and_no_recreate(self):
  375. self.dispatch(
  376. ['create', '--force-recreate', '--no-recreate'],
  377. returncode=1)
  378. def test_down_invalid_rmi_flag(self):
  379. result = self.dispatch(['down', '--rmi', 'bogus'], returncode=1)
  380. assert '--rmi flag must be' in result.stderr
  381. @v2_only()
  382. def test_down(self):
  383. self.base_dir = 'tests/fixtures/v2-full'
  384. self.dispatch(['up', '-d'])
  385. wait_on_condition(ContainerCountCondition(self.project, 2))
  386. self.dispatch(['run', 'web', 'true'])
  387. self.dispatch(['run', '-d', 'web', 'tail', '-f', '/dev/null'])
  388. assert len(self.project.containers(one_off=OneOffFilter.only, stopped=True)) == 2
  389. result = self.dispatch(['down', '--rmi=local', '--volumes'])
  390. assert 'Stopping v2full_web_1' in result.stderr
  391. assert 'Stopping v2full_other_1' in result.stderr
  392. assert 'Stopping v2full_web_run_2' in result.stderr
  393. assert 'Removing v2full_web_1' in result.stderr
  394. assert 'Removing v2full_other_1' in result.stderr
  395. assert 'Removing v2full_web_run_1' in result.stderr
  396. assert 'Removing v2full_web_run_2' in result.stderr
  397. assert 'Removing volume v2full_data' in result.stderr
  398. assert 'Removing image v2full_web' in result.stderr
  399. assert 'Removing image busybox' not in result.stderr
  400. assert 'Removing network v2full_default' in result.stderr
  401. assert 'Removing network v2full_front' in result.stderr
  402. def test_up_detached(self):
  403. self.dispatch(['up', '-d'])
  404. service = self.project.get_service('simple')
  405. another = self.project.get_service('another')
  406. self.assertEqual(len(service.containers()), 1)
  407. self.assertEqual(len(another.containers()), 1)
  408. # Ensure containers don't have stdin and stdout connected in -d mode
  409. container, = service.containers()
  410. self.assertFalse(container.get('Config.AttachStderr'))
  411. self.assertFalse(container.get('Config.AttachStdout'))
  412. self.assertFalse(container.get('Config.AttachStdin'))
  413. def test_up_attached(self):
  414. self.base_dir = 'tests/fixtures/echo-services'
  415. result = self.dispatch(['up', '--no-color'])
  416. assert 'simple_1 | simple' in result.stdout
  417. assert 'another_1 | another' in result.stdout
  418. assert 'simple_1 exited with code 0' in result.stdout
  419. assert 'another_1 exited with code 0' in result.stdout
  420. @v2_only()
  421. def test_up(self):
  422. self.base_dir = 'tests/fixtures/v2-simple'
  423. self.dispatch(['up', '-d'], None)
  424. services = self.project.get_services()
  425. network_name = self.project.networks.networks['default'].full_name
  426. networks = self.client.networks(names=[network_name])
  427. self.assertEqual(len(networks), 1)
  428. self.assertEqual(networks[0]['Driver'], 'bridge')
  429. assert 'com.docker.network.bridge.enable_icc' not in networks[0]['Options']
  430. network = self.client.inspect_network(networks[0]['Id'])
  431. for service in services:
  432. containers = service.containers()
  433. self.assertEqual(len(containers), 1)
  434. container = containers[0]
  435. self.assertIn(container.id, network['Containers'])
  436. networks = container.get('NetworkSettings.Networks')
  437. self.assertEqual(list(networks), [network['Name']])
  438. self.assertEqual(
  439. sorted(networks[network['Name']]['Aliases']),
  440. sorted([service.name, container.short_id]))
  441. for service in services:
  442. assert self.lookup(container, service.name)
  443. @v2_only()
  444. def test_up_with_default_network_config(self):
  445. filename = 'default-network-config.yml'
  446. self.base_dir = 'tests/fixtures/networks'
  447. self._project = get_project(self.base_dir, [filename])
  448. self.dispatch(['-f', filename, 'up', '-d'], None)
  449. network_name = self.project.networks.networks['default'].full_name
  450. networks = self.client.networks(names=[network_name])
  451. assert networks[0]['Options']['com.docker.network.bridge.enable_icc'] == 'false'
  452. @v2_only()
  453. def test_up_with_network_aliases(self):
  454. filename = 'network-aliases.yml'
  455. self.base_dir = 'tests/fixtures/networks'
  456. self.dispatch(['-f', filename, 'up', '-d'], None)
  457. back_name = '{}_back'.format(self.project.name)
  458. front_name = '{}_front'.format(self.project.name)
  459. networks = [
  460. n for n in self.client.networks()
  461. if n['Name'].startswith('{}_'.format(self.project.name))
  462. ]
  463. # Two networks were created: back and front
  464. assert sorted(n['Name'] for n in networks) == [back_name, front_name]
  465. web_container = self.project.get_service('web').containers()[0]
  466. back_aliases = web_container.get(
  467. 'NetworkSettings.Networks.{}.Aliases'.format(back_name)
  468. )
  469. assert 'web' in back_aliases
  470. front_aliases = web_container.get(
  471. 'NetworkSettings.Networks.{}.Aliases'.format(front_name)
  472. )
  473. assert 'web' in front_aliases
  474. assert 'forward_facing' in front_aliases
  475. assert 'ahead' in front_aliases
  476. @v2_only()
  477. def test_up_with_network_internal(self):
  478. self.require_api_version('1.23')
  479. filename = 'network-internal.yml'
  480. self.base_dir = 'tests/fixtures/networks'
  481. self.dispatch(['-f', filename, 'up', '-d'], None)
  482. internal_net = '{}_internal'.format(self.project.name)
  483. networks = [
  484. n for n in self.client.networks()
  485. if n['Name'].startswith('{}_'.format(self.project.name))
  486. ]
  487. # One network was created: internal
  488. assert sorted(n['Name'] for n in networks) == [internal_net]
  489. assert networks[0]['Internal'] is True
  490. @v2_only()
  491. def test_up_with_network_static_addresses(self):
  492. filename = 'network-static-addresses.yml'
  493. ipv4_address = '172.16.100.100'
  494. ipv6_address = 'fe80::1001:100'
  495. self.base_dir = 'tests/fixtures/networks'
  496. self.dispatch(['-f', filename, 'up', '-d'], None)
  497. static_net = '{}_static_test'.format(self.project.name)
  498. networks = [
  499. n for n in self.client.networks()
  500. if n['Name'].startswith('{}_'.format(self.project.name))
  501. ]
  502. # One networks was created: front
  503. assert sorted(n['Name'] for n in networks) == [static_net]
  504. web_container = self.project.get_service('web').containers()[0]
  505. ipam_config = web_container.get(
  506. 'NetworkSettings.Networks.{}.IPAMConfig'.format(static_net)
  507. )
  508. assert ipv4_address in ipam_config.values()
  509. assert ipv6_address in ipam_config.values()
  510. @v2_only()
  511. def test_up_with_networks(self):
  512. self.base_dir = 'tests/fixtures/networks'
  513. self.dispatch(['up', '-d'], None)
  514. back_name = '{}_back'.format(self.project.name)
  515. front_name = '{}_front'.format(self.project.name)
  516. networks = [
  517. n for n in self.client.networks()
  518. if n['Name'].startswith('{}_'.format(self.project.name))
  519. ]
  520. # Two networks were created: back and front
  521. assert sorted(n['Name'] for n in networks) == [back_name, front_name]
  522. back_network = [n for n in networks if n['Name'] == back_name][0]
  523. front_network = [n for n in networks if n['Name'] == front_name][0]
  524. web_container = self.project.get_service('web').containers()[0]
  525. app_container = self.project.get_service('app').containers()[0]
  526. db_container = self.project.get_service('db').containers()[0]
  527. for net_name in [front_name, back_name]:
  528. links = app_container.get('NetworkSettings.Networks.{}.Links'.format(net_name))
  529. assert '{}:database'.format(db_container.name) in links
  530. # db and app joined the back network
  531. assert sorted(back_network['Containers']) == sorted([db_container.id, app_container.id])
  532. # web and app joined the front network
  533. assert sorted(front_network['Containers']) == sorted([web_container.id, app_container.id])
  534. # web can see app but not db
  535. assert self.lookup(web_container, "app")
  536. assert not self.lookup(web_container, "db")
  537. # app can see db
  538. assert self.lookup(app_container, "db")
  539. # app has aliased db to "database"
  540. assert self.lookup(app_container, "database")
  541. @v2_only()
  542. def test_up_missing_network(self):
  543. self.base_dir = 'tests/fixtures/networks'
  544. result = self.dispatch(
  545. ['-f', 'missing-network.yml', 'up', '-d'],
  546. returncode=1)
  547. assert 'Service "web" uses an undefined network "foo"' in result.stderr
  548. @v2_only()
  549. def test_up_with_network_mode(self):
  550. c = self.client.create_container('busybox', 'top', name='composetest_network_mode_container')
  551. self.addCleanup(self.client.remove_container, c, force=True)
  552. self.client.start(c)
  553. container_mode_source = 'container:{}'.format(c['Id'])
  554. filename = 'network-mode.yml'
  555. self.base_dir = 'tests/fixtures/networks'
  556. self._project = get_project(self.base_dir, [filename])
  557. self.dispatch(['-f', filename, 'up', '-d'], None)
  558. networks = [
  559. n for n in self.client.networks()
  560. if n['Name'].startswith('{}_'.format(self.project.name))
  561. ]
  562. assert not networks
  563. for name in ['bridge', 'host', 'none']:
  564. container = self.project.get_service(name).containers()[0]
  565. assert list(container.get('NetworkSettings.Networks')) == [name]
  566. assert container.get('HostConfig.NetworkMode') == name
  567. service_mode_source = 'container:{}'.format(
  568. self.project.get_service('bridge').containers()[0].id)
  569. service_mode_container = self.project.get_service('service').containers()[0]
  570. assert not service_mode_container.get('NetworkSettings.Networks')
  571. assert service_mode_container.get('HostConfig.NetworkMode') == service_mode_source
  572. container_mode_container = self.project.get_service('container').containers()[0]
  573. assert not container_mode_container.get('NetworkSettings.Networks')
  574. assert container_mode_container.get('HostConfig.NetworkMode') == container_mode_source
  575. @v2_only()
  576. def test_up_external_networks(self):
  577. filename = 'external-networks.yml'
  578. self.base_dir = 'tests/fixtures/networks'
  579. self._project = get_project(self.base_dir, [filename])
  580. result = self.dispatch(['-f', filename, 'up', '-d'], returncode=1)
  581. assert 'declared as external, but could not be found' in result.stderr
  582. networks = [
  583. n['Name'] for n in self.client.networks()
  584. if n['Name'].startswith('{}_'.format(self.project.name))
  585. ]
  586. assert not networks
  587. network_names = ['{}_{}'.format(self.project.name, n) for n in ['foo', 'bar']]
  588. for name in network_names:
  589. self.client.create_network(name)
  590. self.dispatch(['-f', filename, 'up', '-d'])
  591. container = self.project.containers()[0]
  592. assert sorted(list(container.get('NetworkSettings.Networks'))) == sorted(network_names)
  593. @v2_only()
  594. def test_up_with_external_default_network(self):
  595. filename = 'external-default.yml'
  596. self.base_dir = 'tests/fixtures/networks'
  597. self._project = get_project(self.base_dir, [filename])
  598. result = self.dispatch(['-f', filename, 'up', '-d'], returncode=1)
  599. assert 'declared as external, but could not be found' in result.stderr
  600. networks = [
  601. n['Name'] for n in self.client.networks()
  602. if n['Name'].startswith('{}_'.format(self.project.name))
  603. ]
  604. assert not networks
  605. network_name = 'composetest_external_network'
  606. self.client.create_network(network_name)
  607. self.dispatch(['-f', filename, 'up', '-d'])
  608. container = self.project.containers()[0]
  609. assert list(container.get('NetworkSettings.Networks')) == [network_name]
  610. @v2_only()
  611. def test_up_no_services(self):
  612. self.base_dir = 'tests/fixtures/no-services'
  613. self.dispatch(['up', '-d'], None)
  614. network_names = [
  615. n['Name'] for n in self.client.networks()
  616. if n['Name'].startswith('{}_'.format(self.project.name))
  617. ]
  618. assert network_names == []
  619. def test_up_with_links_v1(self):
  620. self.base_dir = 'tests/fixtures/links-composefile'
  621. self.dispatch(['up', '-d', 'web'], None)
  622. # No network was created
  623. network_name = self.project.networks.networks['default'].full_name
  624. networks = self.client.networks(names=[network_name])
  625. assert networks == []
  626. web = self.project.get_service('web')
  627. db = self.project.get_service('db')
  628. console = self.project.get_service('console')
  629. # console was not started
  630. self.assertEqual(len(web.containers()), 1)
  631. self.assertEqual(len(db.containers()), 1)
  632. self.assertEqual(len(console.containers()), 0)
  633. # web has links
  634. web_container = web.containers()[0]
  635. self.assertTrue(web_container.get('HostConfig.Links'))
  636. def test_up_with_net_is_invalid(self):
  637. self.base_dir = 'tests/fixtures/net-container'
  638. result = self.dispatch(
  639. ['-f', 'v2-invalid.yml', 'up', '-d'],
  640. returncode=1)
  641. assert "Unsupported config option for services.bar: 'net'" in result.stderr
  642. def test_up_with_net_v1(self):
  643. self.base_dir = 'tests/fixtures/net-container'
  644. self.dispatch(['up', '-d'], None)
  645. bar = self.project.get_service('bar')
  646. bar_container = bar.containers()[0]
  647. foo = self.project.get_service('foo')
  648. foo_container = foo.containers()[0]
  649. assert foo_container.get('HostConfig.NetworkMode') == \
  650. 'container:{}'.format(bar_container.id)
  651. def test_up_with_no_deps(self):
  652. self.base_dir = 'tests/fixtures/links-composefile'
  653. self.dispatch(['up', '-d', '--no-deps', 'web'], None)
  654. web = self.project.get_service('web')
  655. db = self.project.get_service('db')
  656. console = self.project.get_service('console')
  657. self.assertEqual(len(web.containers()), 1)
  658. self.assertEqual(len(db.containers()), 0)
  659. self.assertEqual(len(console.containers()), 0)
  660. def test_up_with_force_recreate(self):
  661. self.dispatch(['up', '-d'], None)
  662. service = self.project.get_service('simple')
  663. self.assertEqual(len(service.containers()), 1)
  664. old_ids = [c.id for c in service.containers()]
  665. self.dispatch(['up', '-d', '--force-recreate'], None)
  666. self.assertEqual(len(service.containers()), 1)
  667. new_ids = [c.id for c in service.containers()]
  668. self.assertNotEqual(old_ids, new_ids)
  669. def test_up_with_no_recreate(self):
  670. self.dispatch(['up', '-d'], None)
  671. service = self.project.get_service('simple')
  672. self.assertEqual(len(service.containers()), 1)
  673. old_ids = [c.id for c in service.containers()]
  674. self.dispatch(['up', '-d', '--no-recreate'], None)
  675. self.assertEqual(len(service.containers()), 1)
  676. new_ids = [c.id for c in service.containers()]
  677. self.assertEqual(old_ids, new_ids)
  678. def test_up_with_force_recreate_and_no_recreate(self):
  679. self.dispatch(
  680. ['up', '-d', '--force-recreate', '--no-recreate'],
  681. returncode=1)
  682. def test_up_with_timeout(self):
  683. self.dispatch(['up', '-d', '-t', '1'])
  684. service = self.project.get_service('simple')
  685. another = self.project.get_service('another')
  686. self.assertEqual(len(service.containers()), 1)
  687. self.assertEqual(len(another.containers()), 1)
  688. # Ensure containers don't have stdin and stdout connected in -d mode
  689. config = service.containers()[0].inspect()['Config']
  690. self.assertFalse(config['AttachStderr'])
  691. self.assertFalse(config['AttachStdout'])
  692. self.assertFalse(config['AttachStdin'])
  693. def test_up_handles_sigint(self):
  694. proc = start_process(self.base_dir, ['up', '-t', '2'])
  695. wait_on_condition(ContainerCountCondition(self.project, 2))
  696. os.kill(proc.pid, signal.SIGINT)
  697. wait_on_condition(ContainerCountCondition(self.project, 0))
  698. def test_up_handles_sigterm(self):
  699. proc = start_process(self.base_dir, ['up', '-t', '2'])
  700. wait_on_condition(ContainerCountCondition(self.project, 2))
  701. os.kill(proc.pid, signal.SIGTERM)
  702. wait_on_condition(ContainerCountCondition(self.project, 0))
  703. @v2_only()
  704. def test_up_handles_force_shutdown(self):
  705. self.base_dir = 'tests/fixtures/sleeps-composefile'
  706. proc = start_process(self.base_dir, ['up', '-t', '200'])
  707. wait_on_condition(ContainerCountCondition(self.project, 2))
  708. os.kill(proc.pid, signal.SIGTERM)
  709. time.sleep(0.1)
  710. os.kill(proc.pid, signal.SIGTERM)
  711. wait_on_condition(ContainerCountCondition(self.project, 0))
  712. def test_up_handles_abort_on_container_exit(self):
  713. start_process(self.base_dir, ['up', '--abort-on-container-exit'])
  714. wait_on_condition(ContainerCountCondition(self.project, 2))
  715. self.project.stop(['simple'])
  716. wait_on_condition(ContainerCountCondition(self.project, 0))
  717. def test_exec_without_tty(self):
  718. self.base_dir = 'tests/fixtures/links-composefile'
  719. self.dispatch(['up', '-d', 'console'])
  720. self.assertEqual(len(self.project.containers()), 1)
  721. stdout, stderr = self.dispatch(['exec', '-T', 'console', 'ls', '-1d', '/'])
  722. self.assertEquals(stdout, "/\n")
  723. self.assertEquals(stderr, "")
  724. def test_exec_custom_user(self):
  725. self.base_dir = 'tests/fixtures/links-composefile'
  726. self.dispatch(['up', '-d', 'console'])
  727. self.assertEqual(len(self.project.containers()), 1)
  728. stdout, stderr = self.dispatch(['exec', '-T', '--user=operator', 'console', 'whoami'])
  729. self.assertEquals(stdout, "operator\n")
  730. self.assertEquals(stderr, "")
  731. def test_run_service_without_links(self):
  732. self.base_dir = 'tests/fixtures/links-composefile'
  733. self.dispatch(['run', 'console', '/bin/true'])
  734. self.assertEqual(len(self.project.containers()), 0)
  735. # Ensure stdin/out was open
  736. container = self.project.containers(stopped=True, one_off=OneOffFilter.only)[0]
  737. config = container.inspect()['Config']
  738. self.assertTrue(config['AttachStderr'])
  739. self.assertTrue(config['AttachStdout'])
  740. self.assertTrue(config['AttachStdin'])
  741. def test_run_service_with_links(self):
  742. self.base_dir = 'tests/fixtures/links-composefile'
  743. self.dispatch(['run', 'web', '/bin/true'], None)
  744. db = self.project.get_service('db')
  745. console = self.project.get_service('console')
  746. self.assertEqual(len(db.containers()), 1)
  747. self.assertEqual(len(console.containers()), 0)
  748. @v2_only()
  749. def test_run_service_with_dependencies(self):
  750. self.base_dir = 'tests/fixtures/v2-dependencies'
  751. self.dispatch(['run', 'web', '/bin/true'], None)
  752. db = self.project.get_service('db')
  753. console = self.project.get_service('console')
  754. self.assertEqual(len(db.containers()), 1)
  755. self.assertEqual(len(console.containers()), 0)
  756. def test_run_with_no_deps(self):
  757. self.base_dir = 'tests/fixtures/links-composefile'
  758. self.dispatch(['run', '--no-deps', 'web', '/bin/true'])
  759. db = self.project.get_service('db')
  760. self.assertEqual(len(db.containers()), 0)
  761. def test_run_does_not_recreate_linked_containers(self):
  762. self.base_dir = 'tests/fixtures/links-composefile'
  763. self.dispatch(['up', '-d', 'db'])
  764. db = self.project.get_service('db')
  765. self.assertEqual(len(db.containers()), 1)
  766. old_ids = [c.id for c in db.containers()]
  767. self.dispatch(['run', 'web', '/bin/true'], None)
  768. self.assertEqual(len(db.containers()), 1)
  769. new_ids = [c.id for c in db.containers()]
  770. self.assertEqual(old_ids, new_ids)
  771. def test_run_without_command(self):
  772. self.base_dir = 'tests/fixtures/commands-composefile'
  773. self.check_build('tests/fixtures/simple-dockerfile', tag='composetest_test')
  774. self.dispatch(['run', 'implicit'])
  775. service = self.project.get_service('implicit')
  776. containers = service.containers(stopped=True, one_off=OneOffFilter.only)
  777. self.assertEqual(
  778. [c.human_readable_command for c in containers],
  779. [u'/bin/sh -c echo "success"'],
  780. )
  781. self.dispatch(['run', 'explicit'])
  782. service = self.project.get_service('explicit')
  783. containers = service.containers(stopped=True, one_off=OneOffFilter.only)
  784. self.assertEqual(
  785. [c.human_readable_command for c in containers],
  786. [u'/bin/true'],
  787. )
  788. def test_run_service_with_dockerfile_entrypoint(self):
  789. self.base_dir = 'tests/fixtures/entrypoint-dockerfile'
  790. self.dispatch(['run', 'test'])
  791. container = self.project.containers(stopped=True, one_off=OneOffFilter.only)[0]
  792. assert container.get('Config.Entrypoint') == ['printf']
  793. assert container.get('Config.Cmd') == ['default', 'args']
  794. def test_run_service_with_dockerfile_entrypoint_overridden(self):
  795. self.base_dir = 'tests/fixtures/entrypoint-dockerfile'
  796. self.dispatch(['run', '--entrypoint', 'echo', 'test'])
  797. container = self.project.containers(stopped=True, one_off=OneOffFilter.only)[0]
  798. assert container.get('Config.Entrypoint') == ['echo']
  799. assert not container.get('Config.Cmd')
  800. def test_run_service_with_dockerfile_entrypoint_and_command_overridden(self):
  801. self.base_dir = 'tests/fixtures/entrypoint-dockerfile'
  802. self.dispatch(['run', '--entrypoint', 'echo', 'test', 'foo'])
  803. container = self.project.containers(stopped=True, one_off=OneOffFilter.only)[0]
  804. assert container.get('Config.Entrypoint') == ['echo']
  805. assert container.get('Config.Cmd') == ['foo']
  806. def test_run_service_with_compose_file_entrypoint(self):
  807. self.base_dir = 'tests/fixtures/entrypoint-composefile'
  808. self.dispatch(['run', 'test'])
  809. container = self.project.containers(stopped=True, one_off=OneOffFilter.only)[0]
  810. assert container.get('Config.Entrypoint') == ['printf']
  811. assert container.get('Config.Cmd') == ['default', 'args']
  812. def test_run_service_with_compose_file_entrypoint_overridden(self):
  813. self.base_dir = 'tests/fixtures/entrypoint-composefile'
  814. self.dispatch(['run', '--entrypoint', 'echo', 'test'])
  815. container = self.project.containers(stopped=True, one_off=OneOffFilter.only)[0]
  816. assert container.get('Config.Entrypoint') == ['echo']
  817. assert not container.get('Config.Cmd')
  818. def test_run_service_with_compose_file_entrypoint_and_command_overridden(self):
  819. self.base_dir = 'tests/fixtures/entrypoint-composefile'
  820. self.dispatch(['run', '--entrypoint', 'echo', 'test', 'foo'])
  821. container = self.project.containers(stopped=True, one_off=OneOffFilter.only)[0]
  822. assert container.get('Config.Entrypoint') == ['echo']
  823. assert container.get('Config.Cmd') == ['foo']
  824. def test_run_service_with_compose_file_entrypoint_and_empty_string_command(self):
  825. self.base_dir = 'tests/fixtures/entrypoint-composefile'
  826. self.dispatch(['run', '--entrypoint', 'echo', 'test', ''])
  827. container = self.project.containers(stopped=True, one_off=OneOffFilter.only)[0]
  828. assert container.get('Config.Entrypoint') == ['echo']
  829. assert container.get('Config.Cmd') == ['']
  830. def test_run_service_with_user_overridden(self):
  831. self.base_dir = 'tests/fixtures/user-composefile'
  832. name = 'service'
  833. user = 'sshd'
  834. self.dispatch(['run', '--user={user}'.format(user=user), name], returncode=1)
  835. service = self.project.get_service(name)
  836. container = service.containers(stopped=True, one_off=OneOffFilter.only)[0]
  837. self.assertEqual(user, container.get('Config.User'))
  838. def test_run_service_with_user_overridden_short_form(self):
  839. self.base_dir = 'tests/fixtures/user-composefile'
  840. name = 'service'
  841. user = 'sshd'
  842. self.dispatch(['run', '-u', user, name], returncode=1)
  843. service = self.project.get_service(name)
  844. container = service.containers(stopped=True, one_off=OneOffFilter.only)[0]
  845. self.assertEqual(user, container.get('Config.User'))
  846. def test_run_service_with_environement_overridden(self):
  847. name = 'service'
  848. self.base_dir = 'tests/fixtures/environment-composefile'
  849. self.dispatch([
  850. 'run', '-e', 'foo=notbar',
  851. '-e', 'allo=moto=bobo',
  852. '-e', 'alpha=beta',
  853. name,
  854. '/bin/true',
  855. ])
  856. service = self.project.get_service(name)
  857. container = service.containers(stopped=True, one_off=OneOffFilter.only)[0]
  858. # env overriden
  859. self.assertEqual('notbar', container.environment['foo'])
  860. # keep environement from yaml
  861. self.assertEqual('world', container.environment['hello'])
  862. # added option from command line
  863. self.assertEqual('beta', container.environment['alpha'])
  864. # make sure a value with a = don't crash out
  865. self.assertEqual('moto=bobo', container.environment['allo'])
  866. def test_run_service_without_map_ports(self):
  867. # create one off container
  868. self.base_dir = 'tests/fixtures/ports-composefile'
  869. self.dispatch(['run', '-d', 'simple'])
  870. container = self.project.get_service('simple').containers(one_off=OneOffFilter.only)[0]
  871. # get port information
  872. port_random = container.get_local_port(3000)
  873. port_assigned = container.get_local_port(3001)
  874. # close all one off containers we just created
  875. container.stop()
  876. # check the ports
  877. self.assertEqual(port_random, None)
  878. self.assertEqual(port_assigned, None)
  879. def test_run_service_with_map_ports(self):
  880. # create one off container
  881. self.base_dir = 'tests/fixtures/ports-composefile'
  882. self.dispatch(['run', '-d', '--service-ports', 'simple'])
  883. container = self.project.get_service('simple').containers(one_off=OneOffFilter.only)[0]
  884. # get port information
  885. port_random = container.get_local_port(3000)
  886. port_assigned = container.get_local_port(3001)
  887. port_range = container.get_local_port(3002), container.get_local_port(3003)
  888. # close all one off containers we just created
  889. container.stop()
  890. # check the ports
  891. self.assertNotEqual(port_random, None)
  892. self.assertIn("0.0.0.0", port_random)
  893. self.assertEqual(port_assigned, "0.0.0.0:49152")
  894. self.assertEqual(port_range[0], "0.0.0.0:49153")
  895. self.assertEqual(port_range[1], "0.0.0.0:49154")
  896. def test_run_service_with_explicitly_maped_ports(self):
  897. # create one off container
  898. self.base_dir = 'tests/fixtures/ports-composefile'
  899. self.dispatch(['run', '-d', '-p', '30000:3000', '--publish', '30001:3001', 'simple'])
  900. container = self.project.get_service('simple').containers(one_off=OneOffFilter.only)[0]
  901. # get port information
  902. port_short = container.get_local_port(3000)
  903. port_full = container.get_local_port(3001)
  904. # close all one off containers we just created
  905. container.stop()
  906. # check the ports
  907. self.assertEqual(port_short, "0.0.0.0:30000")
  908. self.assertEqual(port_full, "0.0.0.0:30001")
  909. def test_run_service_with_explicitly_maped_ip_ports(self):
  910. # create one off container
  911. self.base_dir = 'tests/fixtures/ports-composefile'
  912. self.dispatch([
  913. 'run', '-d',
  914. '-p', '127.0.0.1:30000:3000',
  915. '--publish', '127.0.0.1:30001:3001',
  916. 'simple'
  917. ])
  918. container = self.project.get_service('simple').containers(one_off=OneOffFilter.only)[0]
  919. # get port information
  920. port_short = container.get_local_port(3000)
  921. port_full = container.get_local_port(3001)
  922. # close all one off containers we just created
  923. container.stop()
  924. # check the ports
  925. self.assertEqual(port_short, "127.0.0.1:30000")
  926. self.assertEqual(port_full, "127.0.0.1:30001")
  927. def test_run_with_expose_ports(self):
  928. # create one off container
  929. self.base_dir = 'tests/fixtures/expose-composefile'
  930. self.dispatch(['run', '-d', '--service-ports', 'simple'])
  931. container = self.project.get_service('simple').containers(one_off=OneOffFilter.only)[0]
  932. ports = container.ports
  933. self.assertEqual(len(ports), 9)
  934. # exposed ports are not mapped to host ports
  935. assert ports['3000/tcp'] is None
  936. assert ports['3001/tcp'] is None
  937. assert ports['3001/udp'] is None
  938. assert ports['3002/tcp'] is None
  939. assert ports['3003/tcp'] is None
  940. assert ports['3004/tcp'] is None
  941. assert ports['3005/tcp'] is None
  942. assert ports['3006/udp'] is None
  943. assert ports['3007/udp'] is None
  944. # close all one off containers we just created
  945. container.stop()
  946. def test_run_with_custom_name(self):
  947. self.base_dir = 'tests/fixtures/environment-composefile'
  948. name = 'the-container-name'
  949. self.dispatch(['run', '--name', name, 'service', '/bin/true'])
  950. service = self.project.get_service('service')
  951. container, = service.containers(stopped=True, one_off=OneOffFilter.only)
  952. self.assertEqual(container.name, name)
  953. def test_run_service_with_workdir_overridden(self):
  954. self.base_dir = 'tests/fixtures/run-workdir'
  955. name = 'service'
  956. workdir = '/var'
  957. self.dispatch(['run', '--workdir={workdir}'.format(workdir=workdir), name])
  958. service = self.project.get_service(name)
  959. container = service.containers(stopped=True, one_off=True)[0]
  960. self.assertEqual(workdir, container.get('Config.WorkingDir'))
  961. def test_run_service_with_workdir_overridden_short_form(self):
  962. self.base_dir = 'tests/fixtures/run-workdir'
  963. name = 'service'
  964. workdir = '/var'
  965. self.dispatch(['run', '-w', workdir, name])
  966. service = self.project.get_service(name)
  967. container = service.containers(stopped=True, one_off=True)[0]
  968. self.assertEqual(workdir, container.get('Config.WorkingDir'))
  969. @v2_only()
  970. def test_run_interactive_connects_to_network(self):
  971. self.base_dir = 'tests/fixtures/networks'
  972. self.dispatch(['up', '-d'])
  973. self.dispatch(['run', 'app', 'nslookup', 'app'])
  974. self.dispatch(['run', 'app', 'nslookup', 'db'])
  975. containers = self.project.get_service('app').containers(
  976. stopped=True, one_off=OneOffFilter.only)
  977. assert len(containers) == 2
  978. for container in containers:
  979. networks = container.get('NetworkSettings.Networks')
  980. assert sorted(list(networks)) == [
  981. '{}_{}'.format(self.project.name, name)
  982. for name in ['back', 'front']
  983. ]
  984. for _, config in networks.items():
  985. # TODO: once we drop support for API <1.24, this can be changed to:
  986. # assert config['Aliases'] == [container.short_id]
  987. aliases = set(config['Aliases'] or []) - set([container.short_id])
  988. assert not aliases
  989. @v2_only()
  990. def test_run_detached_connects_to_network(self):
  991. self.base_dir = 'tests/fixtures/networks'
  992. self.dispatch(['up', '-d'])
  993. self.dispatch(['run', '-d', 'app', 'top'])
  994. container = self.project.get_service('app').containers(one_off=OneOffFilter.only)[0]
  995. networks = container.get('NetworkSettings.Networks')
  996. assert sorted(list(networks)) == [
  997. '{}_{}'.format(self.project.name, name)
  998. for name in ['back', 'front']
  999. ]
  1000. for _, config in networks.items():
  1001. # TODO: once we drop support for API <1.24, this can be changed to:
  1002. # assert config['Aliases'] == [container.short_id]
  1003. aliases = set(config['Aliases'] or []) - set([container.short_id])
  1004. assert not aliases
  1005. assert self.lookup(container, 'app')
  1006. assert self.lookup(container, 'db')
  1007. def test_run_handles_sigint(self):
  1008. proc = start_process(self.base_dir, ['run', '-T', 'simple', 'top'])
  1009. wait_on_condition(ContainerStateCondition(
  1010. self.project.client,
  1011. 'simplecomposefile_simple_run_1',
  1012. 'running'))
  1013. os.kill(proc.pid, signal.SIGINT)
  1014. wait_on_condition(ContainerStateCondition(
  1015. self.project.client,
  1016. 'simplecomposefile_simple_run_1',
  1017. 'exited'))
  1018. def test_run_handles_sigterm(self):
  1019. proc = start_process(self.base_dir, ['run', '-T', 'simple', 'top'])
  1020. wait_on_condition(ContainerStateCondition(
  1021. self.project.client,
  1022. 'simplecomposefile_simple_run_1',
  1023. 'running'))
  1024. os.kill(proc.pid, signal.SIGTERM)
  1025. wait_on_condition(ContainerStateCondition(
  1026. self.project.client,
  1027. 'simplecomposefile_simple_run_1',
  1028. 'exited'))
  1029. @mock.patch.dict(os.environ)
  1030. def test_run_env_values_from_system(self):
  1031. os.environ['FOO'] = 'bar'
  1032. os.environ['BAR'] = 'baz'
  1033. self.dispatch(['run', '-e', 'FOO', 'simple', 'true'], None)
  1034. container = self.project.containers(one_off=OneOffFilter.only, stopped=True)[0]
  1035. environment = container.get('Config.Env')
  1036. assert 'FOO=bar' in environment
  1037. assert 'BAR=baz' not in environment
  1038. def test_rm(self):
  1039. service = self.project.get_service('simple')
  1040. service.create_container()
  1041. kill_service(service)
  1042. self.assertEqual(len(service.containers(stopped=True)), 1)
  1043. self.dispatch(['rm', '--force'], None)
  1044. self.assertEqual(len(service.containers(stopped=True)), 0)
  1045. service = self.project.get_service('simple')
  1046. service.create_container()
  1047. kill_service(service)
  1048. self.assertEqual(len(service.containers(stopped=True)), 1)
  1049. self.dispatch(['rm', '-f'], None)
  1050. self.assertEqual(len(service.containers(stopped=True)), 0)
  1051. def test_rm_all(self):
  1052. service = self.project.get_service('simple')
  1053. service.create_container(one_off=False)
  1054. service.create_container(one_off=True)
  1055. kill_service(service)
  1056. self.assertEqual(len(service.containers(stopped=True)), 1)
  1057. self.assertEqual(len(service.containers(stopped=True, one_off=OneOffFilter.only)), 1)
  1058. self.dispatch(['rm', '-f'], None)
  1059. self.assertEqual(len(service.containers(stopped=True)), 0)
  1060. self.assertEqual(len(service.containers(stopped=True, one_off=OneOffFilter.only)), 0)
  1061. service.create_container(one_off=False)
  1062. service.create_container(one_off=True)
  1063. kill_service(service)
  1064. self.assertEqual(len(service.containers(stopped=True)), 1)
  1065. self.assertEqual(len(service.containers(stopped=True, one_off=OneOffFilter.only)), 1)
  1066. self.dispatch(['rm', '-f', '--all'], None)
  1067. self.assertEqual(len(service.containers(stopped=True)), 0)
  1068. self.assertEqual(len(service.containers(stopped=True, one_off=OneOffFilter.only)), 0)
  1069. def test_stop(self):
  1070. self.dispatch(['up', '-d'], None)
  1071. service = self.project.get_service('simple')
  1072. self.assertEqual(len(service.containers()), 1)
  1073. self.assertTrue(service.containers()[0].is_running)
  1074. self.dispatch(['stop', '-t', '1'], None)
  1075. self.assertEqual(len(service.containers(stopped=True)), 1)
  1076. self.assertFalse(service.containers(stopped=True)[0].is_running)
  1077. def test_stop_signal(self):
  1078. self.base_dir = 'tests/fixtures/stop-signal-composefile'
  1079. self.dispatch(['up', '-d'], None)
  1080. service = self.project.get_service('simple')
  1081. self.assertEqual(len(service.containers()), 1)
  1082. self.assertTrue(service.containers()[0].is_running)
  1083. self.dispatch(['stop', '-t', '1'], None)
  1084. self.assertEqual(len(service.containers(stopped=True)), 1)
  1085. self.assertFalse(service.containers(stopped=True)[0].is_running)
  1086. self.assertEqual(service.containers(stopped=True)[0].exit_code, 0)
  1087. def test_start_no_containers(self):
  1088. result = self.dispatch(['start'], returncode=1)
  1089. assert 'No containers to start' in result.stderr
  1090. @v2_only()
  1091. def test_up_logging(self):
  1092. self.base_dir = 'tests/fixtures/logging-composefile'
  1093. self.dispatch(['up', '-d'])
  1094. simple = self.project.get_service('simple').containers()[0]
  1095. log_config = simple.get('HostConfig.LogConfig')
  1096. self.assertTrue(log_config)
  1097. self.assertEqual(log_config.get('Type'), 'none')
  1098. another = self.project.get_service('another').containers()[0]
  1099. log_config = another.get('HostConfig.LogConfig')
  1100. self.assertTrue(log_config)
  1101. self.assertEqual(log_config.get('Type'), 'json-file')
  1102. self.assertEqual(log_config.get('Config')['max-size'], '10m')
  1103. def test_up_logging_legacy(self):
  1104. self.base_dir = 'tests/fixtures/logging-composefile-legacy'
  1105. self.dispatch(['up', '-d'])
  1106. simple = self.project.get_service('simple').containers()[0]
  1107. log_config = simple.get('HostConfig.LogConfig')
  1108. self.assertTrue(log_config)
  1109. self.assertEqual(log_config.get('Type'), 'none')
  1110. another = self.project.get_service('another').containers()[0]
  1111. log_config = another.get('HostConfig.LogConfig')
  1112. self.assertTrue(log_config)
  1113. self.assertEqual(log_config.get('Type'), 'json-file')
  1114. self.assertEqual(log_config.get('Config')['max-size'], '10m')
  1115. def test_pause_unpause(self):
  1116. self.dispatch(['up', '-d'], None)
  1117. service = self.project.get_service('simple')
  1118. self.assertFalse(service.containers()[0].is_paused)
  1119. self.dispatch(['pause'], None)
  1120. self.assertTrue(service.containers()[0].is_paused)
  1121. self.dispatch(['unpause'], None)
  1122. self.assertFalse(service.containers()[0].is_paused)
  1123. def test_pause_no_containers(self):
  1124. result = self.dispatch(['pause'], returncode=1)
  1125. assert 'No containers to pause' in result.stderr
  1126. def test_unpause_no_containers(self):
  1127. result = self.dispatch(['unpause'], returncode=1)
  1128. assert 'No containers to unpause' in result.stderr
  1129. def test_logs_invalid_service_name(self):
  1130. self.dispatch(['logs', 'madeupname'], returncode=1)
  1131. def test_logs_follow(self):
  1132. self.base_dir = 'tests/fixtures/echo-services'
  1133. self.dispatch(['up', '-d'])
  1134. result = self.dispatch(['logs', '-f'])
  1135. assert result.stdout.count('\n') == 5
  1136. assert 'simple' in result.stdout
  1137. assert 'another' in result.stdout
  1138. assert 'exited with code 0' in result.stdout
  1139. def test_logs_follow_logs_from_new_containers(self):
  1140. self.base_dir = 'tests/fixtures/logs-composefile'
  1141. self.dispatch(['up', '-d', 'simple'])
  1142. proc = start_process(self.base_dir, ['logs', '-f'])
  1143. self.dispatch(['up', '-d', 'another'])
  1144. wait_on_condition(ContainerStateCondition(
  1145. self.project.client,
  1146. 'logscomposefile_another_1',
  1147. 'exited'))
  1148. self.dispatch(['kill', 'simple'])
  1149. result = wait_on_process(proc)
  1150. assert 'hello' in result.stdout
  1151. assert 'test' in result.stdout
  1152. assert 'logscomposefile_another_1 exited with code 0' in result.stdout
  1153. assert 'logscomposefile_simple_1 exited with code 137' in result.stdout
  1154. def test_logs_default(self):
  1155. self.base_dir = 'tests/fixtures/logs-composefile'
  1156. self.dispatch(['up', '-d'])
  1157. result = self.dispatch(['logs'])
  1158. assert 'hello' in result.stdout
  1159. assert 'test' in result.stdout
  1160. assert 'exited with' not in result.stdout
  1161. def test_logs_on_stopped_containers_exits(self):
  1162. self.base_dir = 'tests/fixtures/echo-services'
  1163. self.dispatch(['up'])
  1164. result = self.dispatch(['logs'])
  1165. assert 'simple' in result.stdout
  1166. assert 'another' in result.stdout
  1167. assert 'exited with' not in result.stdout
  1168. def test_logs_timestamps(self):
  1169. self.base_dir = 'tests/fixtures/echo-services'
  1170. self.dispatch(['up', '-d'])
  1171. result = self.dispatch(['logs', '-f', '-t'])
  1172. self.assertRegexpMatches(result.stdout, '(\d{4})-(\d{2})-(\d{2})T(\d{2})\:(\d{2})\:(\d{2})')
  1173. def test_logs_tail(self):
  1174. self.base_dir = 'tests/fixtures/logs-tail-composefile'
  1175. self.dispatch(['up'])
  1176. result = self.dispatch(['logs', '--tail', '2'])
  1177. assert result.stdout.count('\n') == 3
  1178. def test_kill(self):
  1179. self.dispatch(['up', '-d'], None)
  1180. service = self.project.get_service('simple')
  1181. self.assertEqual(len(service.containers()), 1)
  1182. self.assertTrue(service.containers()[0].is_running)
  1183. self.dispatch(['kill'], None)
  1184. self.assertEqual(len(service.containers(stopped=True)), 1)
  1185. self.assertFalse(service.containers(stopped=True)[0].is_running)
  1186. def test_kill_signal_sigstop(self):
  1187. self.dispatch(['up', '-d'], None)
  1188. service = self.project.get_service('simple')
  1189. self.assertEqual(len(service.containers()), 1)
  1190. self.assertTrue(service.containers()[0].is_running)
  1191. self.dispatch(['kill', '-s', 'SIGSTOP'], None)
  1192. self.assertEqual(len(service.containers()), 1)
  1193. # The container is still running. It has only been paused
  1194. self.assertTrue(service.containers()[0].is_running)
  1195. def test_kill_stopped_service(self):
  1196. self.dispatch(['up', '-d'], None)
  1197. service = self.project.get_service('simple')
  1198. self.dispatch(['kill', '-s', 'SIGSTOP'], None)
  1199. self.assertTrue(service.containers()[0].is_running)
  1200. self.dispatch(['kill', '-s', 'SIGKILL'], None)
  1201. self.assertEqual(len(service.containers(stopped=True)), 1)
  1202. self.assertFalse(service.containers(stopped=True)[0].is_running)
  1203. def test_restart(self):
  1204. service = self.project.get_service('simple')
  1205. container = service.create_container()
  1206. service.start_container(container)
  1207. started_at = container.dictionary['State']['StartedAt']
  1208. self.dispatch(['restart', '-t', '1'], None)
  1209. container.inspect()
  1210. self.assertNotEqual(
  1211. container.dictionary['State']['FinishedAt'],
  1212. '0001-01-01T00:00:00Z',
  1213. )
  1214. self.assertNotEqual(
  1215. container.dictionary['State']['StartedAt'],
  1216. started_at,
  1217. )
  1218. def test_restart_stopped_container(self):
  1219. service = self.project.get_service('simple')
  1220. container = service.create_container()
  1221. container.start()
  1222. container.kill()
  1223. self.assertEqual(len(service.containers(stopped=True)), 1)
  1224. self.dispatch(['restart', '-t', '1'], None)
  1225. self.assertEqual(len(service.containers(stopped=False)), 1)
  1226. def test_restart_no_containers(self):
  1227. result = self.dispatch(['restart'], returncode=1)
  1228. assert 'No containers to restart' in result.stderr
  1229. def test_scale(self):
  1230. project = self.project
  1231. self.dispatch(['scale', 'simple=1'])
  1232. self.assertEqual(len(project.get_service('simple').containers()), 1)
  1233. self.dispatch(['scale', 'simple=3', 'another=2'])
  1234. self.assertEqual(len(project.get_service('simple').containers()), 3)
  1235. self.assertEqual(len(project.get_service('another').containers()), 2)
  1236. self.dispatch(['scale', 'simple=1', 'another=1'])
  1237. self.assertEqual(len(project.get_service('simple').containers()), 1)
  1238. self.assertEqual(len(project.get_service('another').containers()), 1)
  1239. self.dispatch(['scale', 'simple=1', 'another=1'])
  1240. self.assertEqual(len(project.get_service('simple').containers()), 1)
  1241. self.assertEqual(len(project.get_service('another').containers()), 1)
  1242. self.dispatch(['scale', 'simple=0', 'another=0'])
  1243. self.assertEqual(len(project.get_service('simple').containers()), 0)
  1244. self.assertEqual(len(project.get_service('another').containers()), 0)
  1245. def test_port(self):
  1246. self.base_dir = 'tests/fixtures/ports-composefile'
  1247. self.dispatch(['up', '-d'], None)
  1248. container = self.project.get_service('simple').get_container()
  1249. def get_port(number):
  1250. result = self.dispatch(['port', 'simple', str(number)])
  1251. return result.stdout.rstrip()
  1252. self.assertEqual(get_port(3000), container.get_local_port(3000))
  1253. self.assertEqual(get_port(3001), "0.0.0.0:49152")
  1254. self.assertEqual(get_port(3002), "0.0.0.0:49153")
  1255. def test_port_with_scale(self):
  1256. self.base_dir = 'tests/fixtures/ports-composefile-scale'
  1257. self.dispatch(['scale', 'simple=2'], None)
  1258. containers = sorted(
  1259. self.project.containers(service_names=['simple']),
  1260. key=attrgetter('name'))
  1261. def get_port(number, index=None):
  1262. if index is None:
  1263. result = self.dispatch(['port', 'simple', str(number)])
  1264. else:
  1265. result = self.dispatch(['port', '--index=' + str(index), 'simple', str(number)])
  1266. return result.stdout.rstrip()
  1267. self.assertEqual(get_port(3000), containers[0].get_local_port(3000))
  1268. self.assertEqual(get_port(3000, index=1), containers[0].get_local_port(3000))
  1269. self.assertEqual(get_port(3000, index=2), containers[1].get_local_port(3000))
  1270. self.assertEqual(get_port(3002), "")
  1271. def test_events_json(self):
  1272. events_proc = start_process(self.base_dir, ['events', '--json'])
  1273. self.dispatch(['up', '-d'])
  1274. wait_on_condition(ContainerCountCondition(self.project, 2))
  1275. os.kill(events_proc.pid, signal.SIGINT)
  1276. result = wait_on_process(events_proc, returncode=1)
  1277. lines = [json.loads(line) for line in result.stdout.rstrip().split('\n')]
  1278. assert Counter(e['action'] for e in lines) == {'create': 2, 'start': 2}
  1279. def test_events_human_readable(self):
  1280. def has_timestamp(string):
  1281. str_iso_date, str_iso_time, container_info = string.split(' ', 2)
  1282. try:
  1283. return isinstance(datetime.datetime.strptime(
  1284. '%s %s' % (str_iso_date, str_iso_time),
  1285. '%Y-%m-%d %H:%M:%S.%f'),
  1286. datetime.datetime)
  1287. except ValueError:
  1288. return False
  1289. events_proc = start_process(self.base_dir, ['events'])
  1290. self.dispatch(['up', '-d', 'simple'])
  1291. wait_on_condition(ContainerCountCondition(self.project, 1))
  1292. os.kill(events_proc.pid, signal.SIGINT)
  1293. result = wait_on_process(events_proc, returncode=1)
  1294. lines = result.stdout.rstrip().split('\n')
  1295. assert len(lines) == 2
  1296. container, = self.project.containers()
  1297. expected_template = (
  1298. ' container {} {} (image=busybox:latest, '
  1299. 'name=simplecomposefile_simple_1)')
  1300. assert expected_template.format('create', container.id) in lines[0]
  1301. assert expected_template.format('start', container.id) in lines[1]
  1302. assert has_timestamp(lines[0])
  1303. def test_env_file_relative_to_compose_file(self):
  1304. config_path = os.path.abspath('tests/fixtures/env-file/docker-compose.yml')
  1305. self.dispatch(['-f', config_path, 'up', '-d'], None)
  1306. self._project = get_project(self.base_dir, [config_path])
  1307. containers = self.project.containers(stopped=True)
  1308. self.assertEqual(len(containers), 1)
  1309. self.assertIn("FOO=1", containers[0].get('Config.Env'))
  1310. @mock.patch.dict(os.environ)
  1311. def test_home_and_env_var_in_volume_path(self):
  1312. os.environ['VOLUME_NAME'] = 'my-volume'
  1313. os.environ['HOME'] = '/tmp/home-dir'
  1314. self.base_dir = 'tests/fixtures/volume-path-interpolation'
  1315. self.dispatch(['up', '-d'], None)
  1316. container = self.project.containers(stopped=True)[0]
  1317. actual_host_path = container.get_mount('/container-path')['Source']
  1318. components = actual_host_path.split('/')
  1319. assert components[-2:] == ['home-dir', 'my-volume']
  1320. def test_up_with_default_override_file(self):
  1321. self.base_dir = 'tests/fixtures/override-files'
  1322. self.dispatch(['up', '-d'], None)
  1323. containers = self.project.containers()
  1324. self.assertEqual(len(containers), 2)
  1325. web, db = containers
  1326. self.assertEqual(web.human_readable_command, 'top')
  1327. self.assertEqual(db.human_readable_command, 'top')
  1328. def test_up_with_multiple_files(self):
  1329. self.base_dir = 'tests/fixtures/override-files'
  1330. config_paths = [
  1331. 'docker-compose.yml',
  1332. 'docker-compose.override.yml',
  1333. 'extra.yml',
  1334. ]
  1335. self._project = get_project(self.base_dir, config_paths)
  1336. self.dispatch(
  1337. [
  1338. '-f', config_paths[0],
  1339. '-f', config_paths[1],
  1340. '-f', config_paths[2],
  1341. 'up', '-d',
  1342. ],
  1343. None)
  1344. containers = self.project.containers()
  1345. self.assertEqual(len(containers), 3)
  1346. web, other, db = containers
  1347. self.assertEqual(web.human_readable_command, 'top')
  1348. self.assertTrue({'db', 'other'} <= set(get_links(web)))
  1349. self.assertEqual(db.human_readable_command, 'top')
  1350. self.assertEqual(other.human_readable_command, 'top')
  1351. def test_up_with_extends(self):
  1352. self.base_dir = 'tests/fixtures/extends'
  1353. self.dispatch(['up', '-d'], None)
  1354. self.assertEqual(
  1355. set([s.name for s in self.project.services]),
  1356. set(['mydb', 'myweb']),
  1357. )
  1358. # Sort by name so we get [db, web]
  1359. containers = sorted(
  1360. self.project.containers(stopped=True),
  1361. key=lambda c: c.name,
  1362. )
  1363. self.assertEqual(len(containers), 2)
  1364. web = containers[1]
  1365. self.assertEqual(
  1366. set(get_links(web)),
  1367. set(['db', 'mydb_1', 'extends_mydb_1']))
  1368. expected_env = set([
  1369. "FOO=1",
  1370. "BAR=2",
  1371. "BAZ=2",
  1372. ])
  1373. self.assertTrue(expected_env <= set(web.get('Config.Env')))