cli_test.py 110 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041104210431044104510461047104810491050105110521053105410551056105710581059106010611062106310641065106610671068106910701071107210731074107510761077107810791080108110821083108410851086108710881089109010911092109310941095109610971098109911001101110211031104110511061107110811091110111111121113111411151116111711181119112011211122112311241125112611271128112911301131113211331134113511361137113811391140114111421143114411451146114711481149115011511152115311541155115611571158115911601161116211631164116511661167116811691170117111721173117411751176117711781179118011811182118311841185118611871188118911901191119211931194119511961197119811991200120112021203120412051206120712081209121012111212121312141215121612171218121912201221122212231224122512261227122812291230123112321233123412351236123712381239124012411242124312441245124612471248124912501251125212531254125512561257125812591260126112621263126412651266126712681269127012711272127312741275127612771278127912801281128212831284128512861287128812891290129112921293129412951296129712981299130013011302130313041305130613071308130913101311131213131314131513161317131813191320132113221323132413251326132713281329133013311332133313341335133613371338133913401341134213431344134513461347134813491350135113521353135413551356135713581359136013611362136313641365136613671368136913701371137213731374137513761377137813791380138113821383138413851386138713881389139013911392139313941395139613971398139914001401140214031404140514061407140814091410141114121413141414151416141714181419142014211422142314241425142614271428142914301431143214331434143514361437143814391440144114421443144414451446144714481449145014511452145314541455145614571458145914601461146214631464146514661467146814691470147114721473147414751476147714781479148014811482148314841485148614871488148914901491149214931494149514961497149814991500150115021503150415051506150715081509151015111512151315141515151615171518151915201521152215231524152515261527152815291530153115321533153415351536153715381539154015411542154315441545154615471548154915501551155215531554155515561557155815591560156115621563156415651566156715681569157015711572157315741575157615771578157915801581158215831584158515861587158815891590159115921593159415951596159715981599160016011602160316041605160616071608160916101611161216131614161516161617161816191620162116221623162416251626162716281629163016311632163316341635163616371638163916401641164216431644164516461647164816491650165116521653165416551656165716581659166016611662166316641665166616671668166916701671167216731674167516761677167816791680168116821683168416851686168716881689169016911692169316941695169616971698169917001701170217031704170517061707170817091710171117121713171417151716171717181719172017211722172317241725172617271728172917301731173217331734173517361737173817391740174117421743174417451746174717481749175017511752175317541755175617571758175917601761176217631764176517661767176817691770177117721773177417751776177717781779178017811782178317841785178617871788178917901791179217931794179517961797179817991800180118021803180418051806180718081809181018111812181318141815181618171818181918201821182218231824182518261827182818291830183118321833183418351836183718381839184018411842184318441845184618471848184918501851185218531854185518561857185818591860186118621863186418651866186718681869187018711872187318741875187618771878187918801881188218831884188518861887188818891890189118921893189418951896189718981899190019011902190319041905190619071908190919101911191219131914191519161917191819191920192119221923192419251926192719281929193019311932193319341935193619371938193919401941194219431944194519461947194819491950195119521953195419551956195719581959196019611962196319641965196619671968196919701971197219731974197519761977197819791980198119821983198419851986198719881989199019911992199319941995199619971998199920002001200220032004200520062007200820092010201120122013201420152016201720182019202020212022202320242025202620272028202920302031203220332034203520362037203820392040204120422043204420452046204720482049205020512052205320542055205620572058205920602061206220632064206520662067206820692070207120722073207420752076207720782079208020812082208320842085208620872088208920902091209220932094209520962097209820992100210121022103210421052106210721082109211021112112211321142115211621172118211921202121212221232124212521262127212821292130213121322133213421352136213721382139214021412142214321442145214621472148214921502151215221532154215521562157215821592160216121622163216421652166216721682169217021712172217321742175217621772178217921802181218221832184218521862187218821892190219121922193219421952196219721982199220022012202220322042205220622072208220922102211221222132214221522162217221822192220222122222223222422252226222722282229223022312232223322342235223622372238223922402241224222432244224522462247224822492250225122522253225422552256225722582259226022612262226322642265226622672268226922702271227222732274227522762277227822792280228122822283228422852286228722882289229022912292229322942295229622972298229923002301230223032304230523062307230823092310231123122313231423152316231723182319232023212322232323242325232623272328232923302331233223332334233523362337233823392340234123422343234423452346234723482349235023512352235323542355235623572358235923602361236223632364236523662367236823692370237123722373237423752376237723782379238023812382238323842385238623872388238923902391239223932394239523962397239823992400240124022403240424052406240724082409241024112412241324142415241624172418241924202421242224232424242524262427242824292430243124322433243424352436243724382439244024412442244324442445244624472448244924502451245224532454245524562457245824592460246124622463246424652466246724682469247024712472247324742475247624772478247924802481248224832484248524862487248824892490249124922493249424952496249724982499250025012502250325042505250625072508250925102511251225132514251525162517251825192520252125222523252425252526252725282529253025312532253325342535253625372538253925402541254225432544254525462547254825492550255125522553255425552556255725582559256025612562256325642565256625672568256925702571257225732574257525762577257825792580258125822583258425852586258725882589259025912592259325942595259625972598259926002601260226032604260526062607260826092610261126122613261426152616261726182619262026212622262326242625262626272628262926302631263226332634263526362637263826392640264126422643264426452646264726482649265026512652265326542655265626572658265926602661266226632664266526662667266826692670267126722673267426752676267726782679268026812682268326842685268626872688268926902691269226932694269526962697269826992700270127022703270427052706270727082709271027112712271327142715271627172718271927202721272227232724272527262727272827292730273127322733273427352736273727382739274027412742274327442745274627472748274927502751275227532754275527562757275827592760276127622763276427652766276727682769277027712772277327742775277627772778277927802781278227832784278527862787278827892790279127922793279427952796279727982799280028012802280328042805280628072808280928102811281228132814281528162817281828192820282128222823282428252826282728282829283028312832283328342835283628372838283928402841284228432844284528462847284828492850285128522853285428552856285728582859286028612862286328642865286628672868
  1. # -*- coding: utf-8 -*-
  2. from __future__ import absolute_import
  3. from __future__ import unicode_literals
  4. import datetime
  5. import json
  6. import os.path
  7. import re
  8. import signal
  9. import subprocess
  10. import time
  11. from collections import Counter
  12. from collections import namedtuple
  13. from functools import reduce
  14. from operator import attrgetter
  15. import pytest
  16. import six
  17. import yaml
  18. from docker import errors
  19. from .. import mock
  20. from ..helpers import BUSYBOX_IMAGE_WITH_TAG
  21. from ..helpers import create_host_file
  22. from compose.cli.command import get_project
  23. from compose.config.errors import DuplicateOverrideFileFound
  24. from compose.container import Container
  25. from compose.project import OneOffFilter
  26. from compose.utils import nanoseconds_from_time_seconds
  27. from tests.integration.testcases import DockerClientTestCase
  28. from tests.integration.testcases import get_links
  29. from tests.integration.testcases import is_cluster
  30. from tests.integration.testcases import no_cluster
  31. from tests.integration.testcases import pull_busybox
  32. from tests.integration.testcases import SWARM_SKIP_RM_VOLUMES
  33. from tests.integration.testcases import v2_1_only
  34. from tests.integration.testcases import v2_2_only
  35. from tests.integration.testcases import v2_only
  36. from tests.integration.testcases import v3_only
  37. ProcessResult = namedtuple('ProcessResult', 'stdout stderr')
  38. BUILD_CACHE_TEXT = 'Using cache'
  39. BUILD_PULL_TEXT = 'Status: Image is up to date for busybox:1.27.2'
  40. def start_process(base_dir, options):
  41. proc = subprocess.Popen(
  42. ['docker-compose'] + options,
  43. stdout=subprocess.PIPE,
  44. stderr=subprocess.PIPE,
  45. cwd=base_dir)
  46. print("Running process: %s" % proc.pid)
  47. return proc
  48. def wait_on_process(proc, returncode=0):
  49. stdout, stderr = proc.communicate()
  50. if proc.returncode != returncode:
  51. print("Stderr: {}".format(stderr))
  52. print("Stdout: {}".format(stdout))
  53. assert proc.returncode == returncode
  54. return ProcessResult(stdout.decode('utf-8'), stderr.decode('utf-8'))
  55. def dispatch(base_dir, options, project_options=None, returncode=0):
  56. project_options = project_options or []
  57. proc = start_process(base_dir, project_options + options)
  58. return wait_on_process(proc, returncode=returncode)
  59. def wait_on_condition(condition, delay=0.1, timeout=40):
  60. start_time = time.time()
  61. while not condition():
  62. if time.time() - start_time > timeout:
  63. raise AssertionError("Timeout: %s" % condition)
  64. time.sleep(delay)
  65. def kill_service(service):
  66. for container in service.containers():
  67. if container.is_running:
  68. container.kill()
  69. class ContainerCountCondition(object):
  70. def __init__(self, project, expected):
  71. self.project = project
  72. self.expected = expected
  73. def __call__(self):
  74. return len([c for c in self.project.containers() if c.is_running]) == self.expected
  75. def __str__(self):
  76. return "waiting for counter count == %s" % self.expected
  77. class ContainerStateCondition(object):
  78. def __init__(self, client, name, status):
  79. self.client = client
  80. self.name = name
  81. self.status = status
  82. def __call__(self):
  83. try:
  84. if self.name.endswith('*'):
  85. ctnrs = self.client.containers(all=True, filters={'name': self.name[:-1]})
  86. if len(ctnrs) > 0:
  87. container = self.client.inspect_container(ctnrs[0]['Id'])
  88. else:
  89. return False
  90. else:
  91. container = self.client.inspect_container(self.name)
  92. return container['State']['Status'] == self.status
  93. except errors.APIError:
  94. return False
  95. def __str__(self):
  96. return "waiting for container to be %s" % self.status
  97. class CLITestCase(DockerClientTestCase):
  98. def setUp(self):
  99. super(CLITestCase, self).setUp()
  100. self.base_dir = 'tests/fixtures/simple-composefile'
  101. self.override_dir = None
  102. def tearDown(self):
  103. if self.base_dir:
  104. self.project.kill()
  105. self.project.down(None, True)
  106. for container in self.project.containers(stopped=True, one_off=OneOffFilter.only):
  107. container.remove(force=True)
  108. networks = self.client.networks()
  109. for n in networks:
  110. if n['Name'].split('/')[-1].startswith('{}_'.format(self.project.name)):
  111. self.client.remove_network(n['Name'])
  112. volumes = self.client.volumes().get('Volumes') or []
  113. for v in volumes:
  114. if v['Name'].split('/')[-1].startswith('{}_'.format(self.project.name)):
  115. self.client.remove_volume(v['Name'])
  116. if hasattr(self, '_project'):
  117. del self._project
  118. super(CLITestCase, self).tearDown()
  119. @property
  120. def project(self):
  121. # Hack: allow project to be overridden
  122. if not hasattr(self, '_project'):
  123. self._project = get_project(self.base_dir, override_dir=self.override_dir)
  124. return self._project
  125. def dispatch(self, options, project_options=None, returncode=0):
  126. return dispatch(self.base_dir, options, project_options, returncode)
  127. def execute(self, container, cmd):
  128. # Remove once Hijack and CloseNotifier sign a peace treaty
  129. self.client.close()
  130. exc = self.client.exec_create(container.id, cmd)
  131. self.client.exec_start(exc)
  132. return self.client.exec_inspect(exc)['ExitCode']
  133. def lookup(self, container, hostname):
  134. return self.execute(container, ["nslookup", hostname]) == 0
  135. def test_help(self):
  136. self.base_dir = 'tests/fixtures/no-composefile'
  137. result = self.dispatch(['help', 'up'], returncode=0)
  138. assert 'Usage: up [options] [--scale SERVICE=NUM...] [SERVICE...]' in result.stdout
  139. # Prevent tearDown from trying to create a project
  140. self.base_dir = None
  141. def test_quiet_build(self):
  142. self.base_dir = 'tests/fixtures/build-args'
  143. result = self.dispatch(['build'], None)
  144. quietResult = self.dispatch(['build', '-q'], None)
  145. assert result.stdout != ""
  146. assert quietResult.stdout == ""
  147. def test_help_nonexistent(self):
  148. self.base_dir = 'tests/fixtures/no-composefile'
  149. result = self.dispatch(['help', 'foobar'], returncode=1)
  150. assert 'No such command' in result.stderr
  151. self.base_dir = None
  152. def test_shorthand_host_opt(self):
  153. self.dispatch(
  154. ['-H={0}'.format(os.environ.get('DOCKER_HOST', 'unix://')),
  155. 'up', '-d'],
  156. returncode=0
  157. )
  158. def test_shorthand_host_opt_interactive(self):
  159. self.dispatch(
  160. ['-H={0}'.format(os.environ.get('DOCKER_HOST', 'unix://')),
  161. 'run', 'another', 'ls'],
  162. returncode=0
  163. )
  164. def test_host_not_reachable(self):
  165. result = self.dispatch(['-H=tcp://doesnotexist:8000', 'ps'], returncode=1)
  166. assert "Couldn't connect to Docker daemon" in result.stderr
  167. def test_host_not_reachable_volumes_from_container(self):
  168. self.base_dir = 'tests/fixtures/volumes-from-container'
  169. container = self.client.create_container(
  170. 'busybox', 'true', name='composetest_data_container',
  171. host_config={}
  172. )
  173. self.addCleanup(self.client.remove_container, container)
  174. result = self.dispatch(['-H=tcp://doesnotexist:8000', 'ps'], returncode=1)
  175. assert "Couldn't connect to Docker daemon" in result.stderr
  176. def test_config_list_services(self):
  177. self.base_dir = 'tests/fixtures/v2-full'
  178. result = self.dispatch(['config', '--services'])
  179. assert set(result.stdout.rstrip().split('\n')) == {'web', 'other'}
  180. def test_config_list_volumes(self):
  181. self.base_dir = 'tests/fixtures/v2-full'
  182. result = self.dispatch(['config', '--volumes'])
  183. assert set(result.stdout.rstrip().split('\n')) == {'data'}
  184. def test_config_quiet_with_error(self):
  185. self.base_dir = None
  186. result = self.dispatch([
  187. '-f', 'tests/fixtures/invalid-composefile/invalid.yml',
  188. 'config', '--quiet'
  189. ], returncode=1)
  190. assert "'notaservice' must be a mapping" in result.stderr
  191. def test_config_quiet(self):
  192. self.base_dir = 'tests/fixtures/v2-full'
  193. assert self.dispatch(['config', '--quiet']).stdout == ''
  194. def test_config_with_hash_option(self):
  195. self.base_dir = 'tests/fixtures/v2-full'
  196. result = self.dispatch(['config', '--hash=*'])
  197. for service in self.project.get_services():
  198. assert '{} {}\n'.format(service.name, service.config_hash) in result.stdout
  199. svc = self.project.get_service('other')
  200. result = self.dispatch(['config', '--hash=other'])
  201. assert result.stdout == '{} {}\n'.format(svc.name, svc.config_hash)
  202. def test_config_default(self):
  203. self.base_dir = 'tests/fixtures/v2-full'
  204. result = self.dispatch(['config'])
  205. # assert there are no python objects encoded in the output
  206. assert '!!' not in result.stdout
  207. output = yaml.load(result.stdout)
  208. expected = {
  209. 'version': '2.0',
  210. 'volumes': {'data': {'driver': 'local'}},
  211. 'networks': {'front': {}},
  212. 'services': {
  213. 'web': {
  214. 'build': {
  215. 'context': os.path.abspath(self.base_dir),
  216. },
  217. 'networks': {'front': None, 'default': None},
  218. 'volumes_from': ['service:other:rw'],
  219. },
  220. 'other': {
  221. 'image': BUSYBOX_IMAGE_WITH_TAG,
  222. 'command': 'top',
  223. 'volumes': ['/data'],
  224. },
  225. },
  226. }
  227. assert output == expected
  228. def test_config_restart(self):
  229. self.base_dir = 'tests/fixtures/restart'
  230. result = self.dispatch(['config'])
  231. assert yaml.load(result.stdout) == {
  232. 'version': '2.0',
  233. 'services': {
  234. 'never': {
  235. 'image': 'busybox',
  236. 'restart': 'no',
  237. },
  238. 'always': {
  239. 'image': 'busybox',
  240. 'restart': 'always',
  241. },
  242. 'on-failure': {
  243. 'image': 'busybox',
  244. 'restart': 'on-failure',
  245. },
  246. 'on-failure-5': {
  247. 'image': 'busybox',
  248. 'restart': 'on-failure:5',
  249. },
  250. 'restart-null': {
  251. 'image': 'busybox',
  252. 'restart': ''
  253. },
  254. },
  255. }
  256. def test_config_external_network(self):
  257. self.base_dir = 'tests/fixtures/networks'
  258. result = self.dispatch(['-f', 'external-networks.yml', 'config'])
  259. json_result = yaml.load(result.stdout)
  260. assert 'networks' in json_result
  261. assert json_result['networks'] == {
  262. 'networks_foo': {
  263. 'external': True # {'name': 'networks_foo'}
  264. },
  265. 'bar': {
  266. 'external': {'name': 'networks_bar'}
  267. }
  268. }
  269. def test_config_with_dot_env(self):
  270. self.base_dir = 'tests/fixtures/default-env-file'
  271. result = self.dispatch(['config'])
  272. json_result = yaml.load(result.stdout)
  273. assert json_result == {
  274. 'services': {
  275. 'web': {
  276. 'command': 'true',
  277. 'image': 'alpine:latest',
  278. 'ports': ['5643/tcp', '9999/tcp']
  279. }
  280. },
  281. 'version': '2.4'
  282. }
  283. def test_config_with_env_file(self):
  284. self.base_dir = 'tests/fixtures/default-env-file'
  285. result = self.dispatch(['--env-file', '.env2', 'config'])
  286. json_result = yaml.load(result.stdout)
  287. assert json_result == {
  288. 'services': {
  289. 'web': {
  290. 'command': 'false',
  291. 'image': 'alpine:latest',
  292. 'ports': ['5644/tcp', '9998/tcp']
  293. }
  294. },
  295. 'version': '2.4'
  296. }
  297. def test_config_with_dot_env_and_override_dir(self):
  298. self.base_dir = 'tests/fixtures/default-env-file'
  299. result = self.dispatch(['--project-directory', 'alt/', 'config'])
  300. json_result = yaml.load(result.stdout)
  301. assert json_result == {
  302. 'services': {
  303. 'web': {
  304. 'command': 'echo uwu',
  305. 'image': 'alpine:3.4',
  306. 'ports': ['3341/tcp', '4449/tcp']
  307. }
  308. },
  309. 'version': '2.4'
  310. }
  311. def test_config_external_volume_v2(self):
  312. self.base_dir = 'tests/fixtures/volumes'
  313. result = self.dispatch(['-f', 'external-volumes-v2.yml', 'config'])
  314. json_result = yaml.load(result.stdout)
  315. assert 'volumes' in json_result
  316. assert json_result['volumes'] == {
  317. 'foo': {
  318. 'external': True,
  319. },
  320. 'bar': {
  321. 'external': {
  322. 'name': 'some_bar',
  323. },
  324. }
  325. }
  326. def test_config_external_volume_v2_x(self):
  327. self.base_dir = 'tests/fixtures/volumes'
  328. result = self.dispatch(['-f', 'external-volumes-v2-x.yml', 'config'])
  329. json_result = yaml.load(result.stdout)
  330. assert 'volumes' in json_result
  331. assert json_result['volumes'] == {
  332. 'foo': {
  333. 'external': True,
  334. 'name': 'some_foo',
  335. },
  336. 'bar': {
  337. 'external': True,
  338. 'name': 'some_bar',
  339. }
  340. }
  341. def test_config_external_volume_v3_x(self):
  342. self.base_dir = 'tests/fixtures/volumes'
  343. result = self.dispatch(['-f', 'external-volumes-v3-x.yml', 'config'])
  344. json_result = yaml.load(result.stdout)
  345. assert 'volumes' in json_result
  346. assert json_result['volumes'] == {
  347. 'foo': {
  348. 'external': True,
  349. },
  350. 'bar': {
  351. 'external': {
  352. 'name': 'some_bar',
  353. },
  354. }
  355. }
  356. def test_config_external_volume_v3_4(self):
  357. self.base_dir = 'tests/fixtures/volumes'
  358. result = self.dispatch(['-f', 'external-volumes-v3-4.yml', 'config'])
  359. json_result = yaml.load(result.stdout)
  360. assert 'volumes' in json_result
  361. assert json_result['volumes'] == {
  362. 'foo': {
  363. 'external': True,
  364. 'name': 'some_foo',
  365. },
  366. 'bar': {
  367. 'external': True,
  368. 'name': 'some_bar',
  369. }
  370. }
  371. def test_config_external_network_v3_5(self):
  372. self.base_dir = 'tests/fixtures/networks'
  373. result = self.dispatch(['-f', 'external-networks-v3-5.yml', 'config'])
  374. json_result = yaml.load(result.stdout)
  375. assert 'networks' in json_result
  376. assert json_result['networks'] == {
  377. 'foo': {
  378. 'external': True,
  379. 'name': 'some_foo',
  380. },
  381. 'bar': {
  382. 'external': True,
  383. 'name': 'some_bar',
  384. },
  385. }
  386. def test_config_v1(self):
  387. self.base_dir = 'tests/fixtures/v1-config'
  388. result = self.dispatch(['config'])
  389. assert yaml.load(result.stdout) == {
  390. 'version': '2.1',
  391. 'services': {
  392. 'net': {
  393. 'image': 'busybox',
  394. 'network_mode': 'bridge',
  395. },
  396. 'volume': {
  397. 'image': 'busybox',
  398. 'volumes': ['/data'],
  399. 'network_mode': 'bridge',
  400. },
  401. 'app': {
  402. 'image': 'busybox',
  403. 'volumes_from': ['service:volume:rw'],
  404. 'network_mode': 'service:net',
  405. },
  406. },
  407. }
  408. @v3_only()
  409. def test_config_v3(self):
  410. self.base_dir = 'tests/fixtures/v3-full'
  411. result = self.dispatch(['config'])
  412. assert yaml.load(result.stdout) == {
  413. 'version': '3.5',
  414. 'volumes': {
  415. 'foobar': {
  416. 'labels': {
  417. 'com.docker.compose.test': 'true',
  418. },
  419. },
  420. },
  421. 'services': {
  422. 'web': {
  423. 'image': 'busybox',
  424. 'deploy': {
  425. 'mode': 'replicated',
  426. 'replicas': 6,
  427. 'labels': ['FOO=BAR'],
  428. 'update_config': {
  429. 'parallelism': 3,
  430. 'delay': '10s',
  431. 'failure_action': 'continue',
  432. 'monitor': '60s',
  433. 'max_failure_ratio': 0.3,
  434. },
  435. 'resources': {
  436. 'limits': {
  437. 'cpus': '0.05',
  438. 'memory': '50M',
  439. },
  440. 'reservations': {
  441. 'cpus': '0.01',
  442. 'memory': '20M',
  443. },
  444. },
  445. 'restart_policy': {
  446. 'condition': 'on-failure',
  447. 'delay': '5s',
  448. 'max_attempts': 3,
  449. 'window': '120s',
  450. },
  451. 'placement': {
  452. 'constraints': [
  453. 'node.hostname==foo', 'node.role != manager'
  454. ],
  455. 'preferences': [{'spread': 'node.labels.datacenter'}]
  456. },
  457. },
  458. 'healthcheck': {
  459. 'test': 'cat /etc/passwd',
  460. 'interval': '10s',
  461. 'timeout': '1s',
  462. 'retries': 5,
  463. },
  464. 'volumes': [{
  465. 'read_only': True,
  466. 'source': '/host/path',
  467. 'target': '/container/path',
  468. 'type': 'bind'
  469. }, {
  470. 'source': 'foobar', 'target': '/container/volumepath', 'type': 'volume'
  471. }, {
  472. 'target': '/anonymous', 'type': 'volume'
  473. }, {
  474. 'source': 'foobar',
  475. 'target': '/container/volumepath2',
  476. 'type': 'volume',
  477. 'volume': {'nocopy': True}
  478. }],
  479. 'stop_grace_period': '20s',
  480. },
  481. },
  482. }
  483. def test_config_compatibility_mode(self):
  484. self.base_dir = 'tests/fixtures/compatibility-mode'
  485. result = self.dispatch(['--compatibility', 'config'])
  486. assert yaml.load(result.stdout) == {
  487. 'version': '2.3',
  488. 'volumes': {'foo': {'driver': 'default'}},
  489. 'networks': {'bar': {}},
  490. 'services': {
  491. 'foo': {
  492. 'command': '/bin/true',
  493. 'image': 'alpine:3.7',
  494. 'scale': 3,
  495. 'restart': 'always:7',
  496. 'mem_limit': '300M',
  497. 'mem_reservation': '100M',
  498. 'cpus': 0.7,
  499. 'volumes': ['foo:/bar:rw'],
  500. 'networks': {'bar': None},
  501. }
  502. },
  503. }
  504. def test_ps(self):
  505. self.project.get_service('simple').create_container()
  506. result = self.dispatch(['ps'])
  507. assert 'simple-composefile_simple_1' in result.stdout
  508. def test_ps_default_composefile(self):
  509. self.base_dir = 'tests/fixtures/multiple-composefiles'
  510. self.dispatch(['up', '-d'])
  511. result = self.dispatch(['ps'])
  512. assert 'multiple-composefiles_simple_1' in result.stdout
  513. assert 'multiple-composefiles_another_1' in result.stdout
  514. assert 'multiple-composefiles_yetanother_1' not in result.stdout
  515. def test_ps_alternate_composefile(self):
  516. config_path = os.path.abspath(
  517. 'tests/fixtures/multiple-composefiles/compose2.yml')
  518. self._project = get_project(self.base_dir, [config_path])
  519. self.base_dir = 'tests/fixtures/multiple-composefiles'
  520. self.dispatch(['-f', 'compose2.yml', 'up', '-d'])
  521. result = self.dispatch(['-f', 'compose2.yml', 'ps'])
  522. assert 'multiple-composefiles_simple_1' not in result.stdout
  523. assert 'multiple-composefiles_another_1' not in result.stdout
  524. assert 'multiple-composefiles_yetanother_1' in result.stdout
  525. def test_ps_services_filter_option(self):
  526. self.base_dir = 'tests/fixtures/ps-services-filter'
  527. image = self.dispatch(['ps', '--services', '--filter', 'source=image'])
  528. build = self.dispatch(['ps', '--services', '--filter', 'source=build'])
  529. all_services = self.dispatch(['ps', '--services'])
  530. assert 'with_build' in all_services.stdout
  531. assert 'with_image' in all_services.stdout
  532. assert 'with_build' in build.stdout
  533. assert 'with_build' not in image.stdout
  534. assert 'with_image' in image.stdout
  535. assert 'with_image' not in build.stdout
  536. def test_ps_services_filter_status(self):
  537. self.base_dir = 'tests/fixtures/ps-services-filter'
  538. self.dispatch(['up', '-d'])
  539. self.dispatch(['pause', 'with_image'])
  540. paused = self.dispatch(['ps', '--services', '--filter', 'status=paused'])
  541. stopped = self.dispatch(['ps', '--services', '--filter', 'status=stopped'])
  542. running = self.dispatch(['ps', '--services', '--filter', 'status=running'])
  543. assert 'with_build' not in stopped.stdout
  544. assert 'with_image' not in stopped.stdout
  545. assert 'with_build' not in paused.stdout
  546. assert 'with_image' in paused.stdout
  547. assert 'with_build' in running.stdout
  548. assert 'with_image' in running.stdout
  549. def test_ps_all(self):
  550. self.project.get_service('simple').create_container(one_off='blahblah')
  551. result = self.dispatch(['ps'])
  552. assert 'simple-composefile_simple_run_' not in result.stdout
  553. result2 = self.dispatch(['ps', '--all'])
  554. assert 'simple-composefile_simple_run_' in result2.stdout
  555. def test_pull(self):
  556. result = self.dispatch(['pull'])
  557. assert 'Pulling simple' in result.stderr
  558. assert 'Pulling another' in result.stderr
  559. assert 'done' in result.stderr
  560. assert 'failed' not in result.stderr
  561. def test_pull_with_digest(self):
  562. result = self.dispatch(['-f', 'digest.yml', 'pull', '--no-parallel'])
  563. assert 'Pulling simple ({})...'.format(BUSYBOX_IMAGE_WITH_TAG) in result.stderr
  564. assert ('Pulling digest (busybox@'
  565. 'sha256:38a203e1986cf79639cfb9b2e1d6e773de84002feea2d4eb006b520'
  566. '04ee8502d)...') in result.stderr
  567. def test_pull_with_ignore_pull_failures(self):
  568. result = self.dispatch([
  569. '-f', 'ignore-pull-failures.yml',
  570. 'pull', '--ignore-pull-failures', '--no-parallel']
  571. )
  572. assert 'Pulling simple ({})...'.format(BUSYBOX_IMAGE_WITH_TAG) in result.stderr
  573. assert 'Pulling another (nonexisting-image:latest)...' in result.stderr
  574. assert ('repository nonexisting-image not found' in result.stderr or
  575. 'image library/nonexisting-image:latest not found' in result.stderr or
  576. 'pull access denied for nonexisting-image' in result.stderr)
  577. def test_pull_with_build(self):
  578. result = self.dispatch(['-f', 'pull-with-build.yml', 'pull'])
  579. assert 'Pulling simple' not in result.stderr
  580. assert 'Pulling from_simple' not in result.stderr
  581. assert 'Pulling another ...' in result.stderr
  582. def test_pull_with_quiet(self):
  583. assert self.dispatch(['pull', '--quiet']).stderr == ''
  584. assert self.dispatch(['pull', '--quiet']).stdout == ''
  585. def test_pull_with_parallel_failure(self):
  586. result = self.dispatch([
  587. '-f', 'ignore-pull-failures.yml', 'pull'],
  588. returncode=1
  589. )
  590. assert re.search(re.compile('^Pulling simple', re.MULTILINE), result.stderr)
  591. assert re.search(re.compile('^Pulling another', re.MULTILINE), result.stderr)
  592. assert re.search(
  593. re.compile('^ERROR: for another .*does not exist.*', re.MULTILINE),
  594. result.stderr
  595. )
  596. assert re.search(
  597. re.compile('''^(ERROR: )?(b')?.* nonexisting-image''', re.MULTILINE),
  598. result.stderr
  599. )
  600. def test_pull_with_no_deps(self):
  601. self.base_dir = 'tests/fixtures/links-composefile'
  602. result = self.dispatch(['pull', '--no-parallel', 'web'])
  603. assert sorted(result.stderr.split('\n'))[1:] == [
  604. 'Pulling web (busybox:1.27.2)...',
  605. ]
  606. def test_pull_with_include_deps(self):
  607. self.base_dir = 'tests/fixtures/links-composefile'
  608. result = self.dispatch(['pull', '--no-parallel', '--include-deps', 'web'])
  609. assert sorted(result.stderr.split('\n'))[1:] == [
  610. 'Pulling db (busybox:1.27.2)...',
  611. 'Pulling web (busybox:1.27.2)...',
  612. ]
  613. def test_build_plain(self):
  614. self.base_dir = 'tests/fixtures/simple-dockerfile'
  615. self.dispatch(['build', 'simple'])
  616. result = self.dispatch(['build', 'simple'])
  617. assert BUILD_PULL_TEXT not in result.stdout
  618. def test_build_no_cache(self):
  619. self.base_dir = 'tests/fixtures/simple-dockerfile'
  620. self.dispatch(['build', 'simple'])
  621. result = self.dispatch(['build', '--no-cache', 'simple'])
  622. assert BUILD_CACHE_TEXT not in result.stdout
  623. assert BUILD_PULL_TEXT not in result.stdout
  624. def test_build_pull(self):
  625. # Make sure we have the latest busybox already
  626. pull_busybox(self.client)
  627. self.base_dir = 'tests/fixtures/simple-dockerfile'
  628. self.dispatch(['build', 'simple'], None)
  629. result = self.dispatch(['build', '--pull', 'simple'])
  630. if not is_cluster(self.client):
  631. # If previous build happened on another node, cache won't be available
  632. assert BUILD_CACHE_TEXT in result.stdout
  633. assert BUILD_PULL_TEXT in result.stdout
  634. def test_build_no_cache_pull(self):
  635. # Make sure we have the latest busybox already
  636. pull_busybox(self.client)
  637. self.base_dir = 'tests/fixtures/simple-dockerfile'
  638. self.dispatch(['build', 'simple'])
  639. result = self.dispatch(['build', '--no-cache', '--pull', 'simple'])
  640. assert BUILD_CACHE_TEXT not in result.stdout
  641. assert BUILD_PULL_TEXT in result.stdout
  642. def test_build_log_level(self):
  643. self.base_dir = 'tests/fixtures/simple-dockerfile'
  644. result = self.dispatch(['--log-level', 'warning', 'build', 'simple'])
  645. assert result.stderr == ''
  646. result = self.dispatch(['--log-level', 'debug', 'build', 'simple'])
  647. assert 'Building simple' in result.stderr
  648. assert 'Using configuration file' in result.stderr
  649. self.base_dir = 'tests/fixtures/simple-failing-dockerfile'
  650. result = self.dispatch(['--log-level', 'critical', 'build', 'simple'], returncode=1)
  651. assert result.stderr == ''
  652. result = self.dispatch(['--log-level', 'debug', 'build', 'simple'], returncode=1)
  653. assert 'Building simple' in result.stderr
  654. assert 'non-zero code' in result.stderr
  655. def test_build_failed(self):
  656. self.base_dir = 'tests/fixtures/simple-failing-dockerfile'
  657. self.dispatch(['build', 'simple'], returncode=1)
  658. labels = ["com.docker.compose.test_failing_image=true"]
  659. containers = [
  660. Container.from_ps(self.project.client, c)
  661. for c in self.project.client.containers(
  662. all=True,
  663. filters={"label": labels})
  664. ]
  665. assert len(containers) == 1
  666. def test_build_failed_forcerm(self):
  667. self.base_dir = 'tests/fixtures/simple-failing-dockerfile'
  668. self.dispatch(['build', '--force-rm', 'simple'], returncode=1)
  669. labels = ["com.docker.compose.test_failing_image=true"]
  670. containers = [
  671. Container.from_ps(self.project.client, c)
  672. for c in self.project.client.containers(
  673. all=True,
  674. filters={"label": labels})
  675. ]
  676. assert not containers
  677. @pytest.mark.xfail(True, reason='Flaky on local')
  678. def test_build_rm(self):
  679. containers = [
  680. Container.from_ps(self.project.client, c)
  681. for c in self.project.client.containers(all=True)
  682. ]
  683. assert not containers
  684. self.base_dir = 'tests/fixtures/simple-dockerfile'
  685. self.dispatch(['build', '--no-rm', 'simple'], returncode=0)
  686. containers = [
  687. Container.from_ps(self.project.client, c)
  688. for c in self.project.client.containers(all=True)
  689. ]
  690. assert containers
  691. for c in self.project.client.containers(all=True):
  692. self.addCleanup(self.project.client.remove_container, c, force=True)
  693. def test_build_shm_size_build_option(self):
  694. pull_busybox(self.client)
  695. self.base_dir = 'tests/fixtures/build-shm-size'
  696. result = self.dispatch(['build', '--no-cache'], None)
  697. assert 'shm_size: 96' in result.stdout
  698. def test_build_memory_build_option(self):
  699. pull_busybox(self.client)
  700. self.base_dir = 'tests/fixtures/build-memory'
  701. result = self.dispatch(['build', '--no-cache', '--memory', '96m', 'service'], None)
  702. assert 'memory: 100663296' in result.stdout # 96 * 1024 * 1024
  703. def test_build_with_buildarg_from_compose_file(self):
  704. pull_busybox(self.client)
  705. self.base_dir = 'tests/fixtures/build-args'
  706. result = self.dispatch(['build'], None)
  707. assert 'Favorite Touhou Character: mariya.kirisame' in result.stdout
  708. def test_build_with_buildarg_cli_override(self):
  709. pull_busybox(self.client)
  710. self.base_dir = 'tests/fixtures/build-args'
  711. result = self.dispatch(['build', '--build-arg', 'favorite_th_character=sakuya.izayoi'], None)
  712. assert 'Favorite Touhou Character: sakuya.izayoi' in result.stdout
  713. @mock.patch.dict(os.environ)
  714. def test_build_with_buildarg_old_api_version(self):
  715. pull_busybox(self.client)
  716. self.base_dir = 'tests/fixtures/build-args'
  717. os.environ['COMPOSE_API_VERSION'] = '1.24'
  718. result = self.dispatch(
  719. ['build', '--build-arg', 'favorite_th_character=reimu.hakurei'], None, returncode=1
  720. )
  721. assert '--build-arg is only supported when services are specified' in result.stderr
  722. result = self.dispatch(
  723. ['build', '--build-arg', 'favorite_th_character=hong.meiling', 'web'], None
  724. )
  725. assert 'Favorite Touhou Character: hong.meiling' in result.stdout
  726. def test_bundle_with_digests(self):
  727. self.base_dir = 'tests/fixtures/bundle-with-digests/'
  728. tmpdir = pytest.ensuretemp('cli_test_bundle')
  729. self.addCleanup(tmpdir.remove)
  730. filename = str(tmpdir.join('example.dab'))
  731. self.dispatch(['bundle', '--output', filename])
  732. with open(filename, 'r') as fh:
  733. bundle = json.load(fh)
  734. assert bundle == {
  735. 'Version': '0.1',
  736. 'Services': {
  737. 'web': {
  738. 'Image': ('dockercloud/hello-world@sha256:fe79a2cfbd17eefc3'
  739. '44fb8419420808df95a1e22d93b7f621a7399fd1e9dca1d'),
  740. 'Networks': ['default'],
  741. },
  742. 'redis': {
  743. 'Image': ('redis@sha256:a84cb8f53a70e19f61ff2e1d5e73fb7ae62d'
  744. '374b2b7392de1e7d77be26ef8f7b'),
  745. 'Networks': ['default'],
  746. }
  747. },
  748. }
  749. def test_build_override_dir(self):
  750. self.base_dir = 'tests/fixtures/build-path-override-dir'
  751. self.override_dir = os.path.abspath('tests/fixtures')
  752. result = self.dispatch([
  753. '--project-directory', self.override_dir,
  754. 'build'])
  755. assert 'Successfully built' in result.stdout
  756. def test_build_override_dir_invalid_path(self):
  757. config_path = os.path.abspath('tests/fixtures/build-path-override-dir/docker-compose.yml')
  758. result = self.dispatch([
  759. '-f', config_path,
  760. 'build'], returncode=1)
  761. assert 'does not exist, is not accessible, or is not a valid URL' in result.stderr
  762. def test_build_parallel(self):
  763. self.base_dir = 'tests/fixtures/build-multiple-composefile'
  764. result = self.dispatch(['build', '--parallel'])
  765. assert 'Successfully tagged build-multiple-composefile_a:latest' in result.stdout
  766. assert 'Successfully tagged build-multiple-composefile_b:latest' in result.stdout
  767. assert 'Successfully built' in result.stdout
  768. def test_create(self):
  769. self.dispatch(['create'])
  770. service = self.project.get_service('simple')
  771. another = self.project.get_service('another')
  772. service_containers = service.containers(stopped=True)
  773. another_containers = another.containers(stopped=True)
  774. assert len(service_containers) == 1
  775. assert len(another_containers) == 1
  776. assert not service_containers[0].is_running
  777. assert not another_containers[0].is_running
  778. def test_create_with_force_recreate(self):
  779. self.dispatch(['create'], None)
  780. service = self.project.get_service('simple')
  781. service_containers = service.containers(stopped=True)
  782. assert len(service_containers) == 1
  783. assert not service_containers[0].is_running
  784. old_ids = [c.id for c in service.containers(stopped=True)]
  785. self.dispatch(['create', '--force-recreate'], None)
  786. service_containers = service.containers(stopped=True)
  787. assert len(service_containers) == 1
  788. assert not service_containers[0].is_running
  789. new_ids = [c.id for c in service_containers]
  790. assert old_ids != new_ids
  791. def test_create_with_no_recreate(self):
  792. self.dispatch(['create'], None)
  793. service = self.project.get_service('simple')
  794. service_containers = service.containers(stopped=True)
  795. assert len(service_containers) == 1
  796. assert not service_containers[0].is_running
  797. old_ids = [c.id for c in service.containers(stopped=True)]
  798. self.dispatch(['create', '--no-recreate'], None)
  799. service_containers = service.containers(stopped=True)
  800. assert len(service_containers) == 1
  801. assert not service_containers[0].is_running
  802. new_ids = [c.id for c in service_containers]
  803. assert old_ids == new_ids
  804. def test_run_one_off_with_volume(self):
  805. self.base_dir = 'tests/fixtures/simple-composefile-volume-ready'
  806. volume_path = os.path.abspath(os.path.join(os.getcwd(), self.base_dir, 'files'))
  807. node = create_host_file(self.client, os.path.join(volume_path, 'example.txt'))
  808. self.dispatch([
  809. 'run',
  810. '-v', '{}:/data'.format(volume_path),
  811. '-e', 'constraint:node=={}'.format(node if node is not None else '*'),
  812. 'simple',
  813. 'test', '-f', '/data/example.txt'
  814. ], returncode=0)
  815. service = self.project.get_service('simple')
  816. container_data = service.containers(one_off=OneOffFilter.only, stopped=True)[0]
  817. mount = container_data.get('Mounts')[0]
  818. assert mount['Source'] == volume_path
  819. assert mount['Destination'] == '/data'
  820. assert mount['Type'] == 'bind'
  821. def test_run_one_off_with_multiple_volumes(self):
  822. self.base_dir = 'tests/fixtures/simple-composefile-volume-ready'
  823. volume_path = os.path.abspath(os.path.join(os.getcwd(), self.base_dir, 'files'))
  824. node = create_host_file(self.client, os.path.join(volume_path, 'example.txt'))
  825. self.dispatch([
  826. 'run',
  827. '-v', '{}:/data'.format(volume_path),
  828. '-v', '{}:/data1'.format(volume_path),
  829. '-e', 'constraint:node=={}'.format(node if node is not None else '*'),
  830. 'simple',
  831. 'test', '-f', '/data/example.txt'
  832. ], returncode=0)
  833. self.dispatch([
  834. 'run',
  835. '-v', '{}:/data'.format(volume_path),
  836. '-v', '{}:/data1'.format(volume_path),
  837. '-e', 'constraint:node=={}'.format(node if node is not None else '*'),
  838. 'simple',
  839. 'test', '-f' '/data1/example.txt'
  840. ], returncode=0)
  841. def test_run_one_off_with_volume_merge(self):
  842. self.base_dir = 'tests/fixtures/simple-composefile-volume-ready'
  843. volume_path = os.path.abspath(os.path.join(os.getcwd(), self.base_dir, 'files'))
  844. node = create_host_file(self.client, os.path.join(volume_path, 'example.txt'))
  845. self.dispatch([
  846. '-f', 'docker-compose.merge.yml',
  847. 'run',
  848. '-v', '{}:/data'.format(volume_path),
  849. '-e', 'constraint:node=={}'.format(node if node is not None else '*'),
  850. 'simple',
  851. 'test', '-f', '/data/example.txt'
  852. ], returncode=0)
  853. service = self.project.get_service('simple')
  854. container_data = service.containers(one_off=OneOffFilter.only, stopped=True)[0]
  855. mounts = container_data.get('Mounts')
  856. assert len(mounts) == 2
  857. config_mount = [m for m in mounts if m['Destination'] == '/data1'][0]
  858. override_mount = [m for m in mounts if m['Destination'] == '/data'][0]
  859. assert config_mount['Type'] == 'volume'
  860. assert override_mount['Source'] == volume_path
  861. assert override_mount['Type'] == 'bind'
  862. def test_create_with_force_recreate_and_no_recreate(self):
  863. self.dispatch(
  864. ['create', '--force-recreate', '--no-recreate'],
  865. returncode=1)
  866. def test_down_invalid_rmi_flag(self):
  867. result = self.dispatch(['down', '--rmi', 'bogus'], returncode=1)
  868. assert '--rmi flag must be' in result.stderr
  869. @v2_only()
  870. def test_down(self):
  871. self.base_dir = 'tests/fixtures/v2-full'
  872. self.dispatch(['up', '-d'])
  873. wait_on_condition(ContainerCountCondition(self.project, 2))
  874. self.dispatch(['run', 'web', 'true'])
  875. self.dispatch(['run', '-d', 'web', 'tail', '-f', '/dev/null'])
  876. assert len(self.project.containers(one_off=OneOffFilter.only, stopped=True)) == 2
  877. result = self.dispatch(['down', '--rmi=local', '--volumes'])
  878. assert 'Stopping v2-full_web_1' in result.stderr
  879. assert 'Stopping v2-full_other_1' in result.stderr
  880. assert 'Stopping v2-full_web_run_' in result.stderr
  881. assert 'Removing v2-full_web_1' in result.stderr
  882. assert 'Removing v2-full_other_1' in result.stderr
  883. assert 'Removing v2-full_web_run_' in result.stderr
  884. assert 'Removing v2-full_web_run_' in result.stderr
  885. assert 'Removing volume v2-full_data' in result.stderr
  886. assert 'Removing image v2-full_web' in result.stderr
  887. assert 'Removing image busybox' not in result.stderr
  888. assert 'Removing network v2-full_default' in result.stderr
  889. assert 'Removing network v2-full_front' in result.stderr
  890. def test_down_timeout(self):
  891. self.dispatch(['up', '-d'], None)
  892. service = self.project.get_service('simple')
  893. assert len(service.containers()) == 1
  894. assert service.containers()[0].is_running
  895. ""
  896. self.dispatch(['down', '-t', '1'], None)
  897. assert len(service.containers(stopped=True)) == 0
  898. def test_down_signal(self):
  899. self.base_dir = 'tests/fixtures/stop-signal-composefile'
  900. self.dispatch(['up', '-d'], None)
  901. service = self.project.get_service('simple')
  902. assert len(service.containers()) == 1
  903. assert service.containers()[0].is_running
  904. self.dispatch(['down', '-t', '1'], None)
  905. assert len(service.containers(stopped=True)) == 0
  906. def test_up_detached(self):
  907. self.dispatch(['up', '-d'])
  908. service = self.project.get_service('simple')
  909. another = self.project.get_service('another')
  910. assert len(service.containers()) == 1
  911. assert len(another.containers()) == 1
  912. # Ensure containers don't have stdin and stdout connected in -d mode
  913. container, = service.containers()
  914. assert not container.get('Config.AttachStderr')
  915. assert not container.get('Config.AttachStdout')
  916. assert not container.get('Config.AttachStdin')
  917. def test_up_detached_long_form(self):
  918. self.dispatch(['up', '--detach'])
  919. service = self.project.get_service('simple')
  920. another = self.project.get_service('another')
  921. assert len(service.containers()) == 1
  922. assert len(another.containers()) == 1
  923. # Ensure containers don't have stdin and stdout connected in -d mode
  924. container, = service.containers()
  925. assert not container.get('Config.AttachStderr')
  926. assert not container.get('Config.AttachStdout')
  927. assert not container.get('Config.AttachStdin')
  928. def test_up_attached(self):
  929. self.base_dir = 'tests/fixtures/echo-services'
  930. result = self.dispatch(['up', '--no-color'])
  931. simple_name = self.project.get_service('simple').containers(stopped=True)[0].name_without_project
  932. another_name = self.project.get_service('another').containers(
  933. stopped=True
  934. )[0].name_without_project
  935. assert '{} | simple'.format(simple_name) in result.stdout
  936. assert '{} | another'.format(another_name) in result.stdout
  937. assert '{} exited with code 0'.format(simple_name) in result.stdout
  938. assert '{} exited with code 0'.format(another_name) in result.stdout
  939. @v2_only()
  940. def test_up(self):
  941. self.base_dir = 'tests/fixtures/v2-simple'
  942. self.dispatch(['up', '-d'], None)
  943. services = self.project.get_services()
  944. network_name = self.project.networks.networks['default'].full_name
  945. networks = self.client.networks(names=[network_name])
  946. assert len(networks) == 1
  947. assert networks[0]['Driver'] == 'bridge' if not is_cluster(self.client) else 'overlay'
  948. assert 'com.docker.network.bridge.enable_icc' not in networks[0]['Options']
  949. network = self.client.inspect_network(networks[0]['Id'])
  950. for service in services:
  951. containers = service.containers()
  952. assert len(containers) == 1
  953. container = containers[0]
  954. assert container.id in network['Containers']
  955. networks = container.get('NetworkSettings.Networks')
  956. assert list(networks) == [network['Name']]
  957. assert sorted(networks[network['Name']]['Aliases']) == sorted(
  958. [service.name, container.short_id]
  959. )
  960. for service in services:
  961. assert self.lookup(container, service.name)
  962. @v2_only()
  963. def test_up_no_start(self):
  964. self.base_dir = 'tests/fixtures/v2-full'
  965. self.dispatch(['up', '--no-start'], None)
  966. services = self.project.get_services()
  967. default_network = self.project.networks.networks['default'].full_name
  968. front_network = self.project.networks.networks['front'].full_name
  969. networks = self.client.networks(names=[default_network, front_network])
  970. assert len(networks) == 2
  971. for service in services:
  972. containers = service.containers(stopped=True)
  973. assert len(containers) == 1
  974. container = containers[0]
  975. assert not container.is_running
  976. assert container.get('State.Status') == 'created'
  977. volumes = self.project.volumes.volumes
  978. assert 'data' in volumes
  979. volume = volumes['data']
  980. # The code below is a Swarm-compatible equivalent to volume.exists()
  981. remote_volumes = [
  982. v for v in self.client.volumes().get('Volumes', [])
  983. if v['Name'].split('/')[-1] == volume.full_name
  984. ]
  985. assert len(remote_volumes) > 0
  986. @v2_only()
  987. def test_up_no_start_remove_orphans(self):
  988. self.base_dir = 'tests/fixtures/v2-simple'
  989. self.dispatch(['up', '--no-start'], None)
  990. services = self.project.get_services()
  991. stopped = reduce((lambda prev, next: prev.containers(
  992. stopped=True) + next.containers(stopped=True)), services)
  993. assert len(stopped) == 2
  994. self.dispatch(['-f', 'one-container.yml', 'up', '--no-start', '--remove-orphans'], None)
  995. stopped2 = reduce((lambda prev, next: prev.containers(
  996. stopped=True) + next.containers(stopped=True)), services)
  997. assert len(stopped2) == 1
  998. @v2_only()
  999. def test_up_no_ansi(self):
  1000. self.base_dir = 'tests/fixtures/v2-simple'
  1001. result = self.dispatch(['--no-ansi', 'up', '-d'], None)
  1002. assert "%c[2K\r" % 27 not in result.stderr
  1003. assert "%c[1A" % 27 not in result.stderr
  1004. assert "%c[1B" % 27 not in result.stderr
  1005. @v2_only()
  1006. def test_up_with_default_network_config(self):
  1007. filename = 'default-network-config.yml'
  1008. self.base_dir = 'tests/fixtures/networks'
  1009. self._project = get_project(self.base_dir, [filename])
  1010. self.dispatch(['-f', filename, 'up', '-d'], None)
  1011. network_name = self.project.networks.networks['default'].full_name
  1012. networks = self.client.networks(names=[network_name])
  1013. assert networks[0]['Options']['com.docker.network.bridge.enable_icc'] == 'false'
  1014. @v2_only()
  1015. def test_up_with_network_aliases(self):
  1016. filename = 'network-aliases.yml'
  1017. self.base_dir = 'tests/fixtures/networks'
  1018. self.dispatch(['-f', filename, 'up', '-d'], None)
  1019. back_name = '{}_back'.format(self.project.name)
  1020. front_name = '{}_front'.format(self.project.name)
  1021. networks = [
  1022. n for n in self.client.networks()
  1023. if n['Name'].split('/')[-1].startswith('{}_'.format(self.project.name))
  1024. ]
  1025. # Two networks were created: back and front
  1026. assert sorted(n['Name'].split('/')[-1] for n in networks) == [back_name, front_name]
  1027. web_container = self.project.get_service('web').containers()[0]
  1028. back_aliases = web_container.get(
  1029. 'NetworkSettings.Networks.{}.Aliases'.format(back_name)
  1030. )
  1031. assert 'web' in back_aliases
  1032. front_aliases = web_container.get(
  1033. 'NetworkSettings.Networks.{}.Aliases'.format(front_name)
  1034. )
  1035. assert 'web' in front_aliases
  1036. assert 'forward_facing' in front_aliases
  1037. assert 'ahead' in front_aliases
  1038. @v2_only()
  1039. def test_up_with_network_internal(self):
  1040. self.require_api_version('1.23')
  1041. filename = 'network-internal.yml'
  1042. self.base_dir = 'tests/fixtures/networks'
  1043. self.dispatch(['-f', filename, 'up', '-d'], None)
  1044. internal_net = '{}_internal'.format(self.project.name)
  1045. networks = [
  1046. n for n in self.client.networks()
  1047. if n['Name'].split('/')[-1].startswith('{}_'.format(self.project.name))
  1048. ]
  1049. # One network was created: internal
  1050. assert sorted(n['Name'].split('/')[-1] for n in networks) == [internal_net]
  1051. assert networks[0]['Internal'] is True
  1052. @v2_only()
  1053. def test_up_with_network_static_addresses(self):
  1054. filename = 'network-static-addresses.yml'
  1055. ipv4_address = '172.16.100.100'
  1056. ipv6_address = 'fe80::1001:100'
  1057. self.base_dir = 'tests/fixtures/networks'
  1058. self.dispatch(['-f', filename, 'up', '-d'], None)
  1059. static_net = '{}_static_test'.format(self.project.name)
  1060. networks = [
  1061. n for n in self.client.networks()
  1062. if n['Name'].split('/')[-1].startswith('{}_'.format(self.project.name))
  1063. ]
  1064. # One networks was created: front
  1065. assert sorted(n['Name'].split('/')[-1] for n in networks) == [static_net]
  1066. web_container = self.project.get_service('web').containers()[0]
  1067. ipam_config = web_container.get(
  1068. 'NetworkSettings.Networks.{}.IPAMConfig'.format(static_net)
  1069. )
  1070. assert ipv4_address in ipam_config.values()
  1071. assert ipv6_address in ipam_config.values()
  1072. @v2_only()
  1073. def test_up_with_networks(self):
  1074. self.base_dir = 'tests/fixtures/networks'
  1075. self.dispatch(['up', '-d'], None)
  1076. back_name = '{}_back'.format(self.project.name)
  1077. front_name = '{}_front'.format(self.project.name)
  1078. networks = [
  1079. n for n in self.client.networks()
  1080. if n['Name'].split('/')[-1].startswith('{}_'.format(self.project.name))
  1081. ]
  1082. # Two networks were created: back and front
  1083. assert sorted(n['Name'].split('/')[-1] for n in networks) == [back_name, front_name]
  1084. # lookup by ID instead of name in case of duplicates
  1085. back_network = self.client.inspect_network(
  1086. [n for n in networks if n['Name'] == back_name][0]['Id']
  1087. )
  1088. front_network = self.client.inspect_network(
  1089. [n for n in networks if n['Name'] == front_name][0]['Id']
  1090. )
  1091. web_container = self.project.get_service('web').containers()[0]
  1092. app_container = self.project.get_service('app').containers()[0]
  1093. db_container = self.project.get_service('db').containers()[0]
  1094. for net_name in [front_name, back_name]:
  1095. links = app_container.get('NetworkSettings.Networks.{}.Links'.format(net_name))
  1096. assert '{}:database'.format(db_container.name) in links
  1097. # db and app joined the back network
  1098. assert sorted(back_network['Containers']) == sorted([db_container.id, app_container.id])
  1099. # web and app joined the front network
  1100. assert sorted(front_network['Containers']) == sorted([web_container.id, app_container.id])
  1101. # web can see app but not db
  1102. assert self.lookup(web_container, "app")
  1103. assert not self.lookup(web_container, "db")
  1104. # app can see db
  1105. assert self.lookup(app_container, "db")
  1106. # app has aliased db to "database"
  1107. assert self.lookup(app_container, "database")
  1108. @v2_only()
  1109. def test_up_missing_network(self):
  1110. self.base_dir = 'tests/fixtures/networks'
  1111. result = self.dispatch(
  1112. ['-f', 'missing-network.yml', 'up', '-d'],
  1113. returncode=1)
  1114. assert 'Service "web" uses an undefined network "foo"' in result.stderr
  1115. @v2_only()
  1116. @no_cluster('container networks not supported in Swarm')
  1117. def test_up_with_network_mode(self):
  1118. c = self.client.create_container(
  1119. 'busybox', 'top', name='composetest_network_mode_container',
  1120. host_config={}
  1121. )
  1122. self.addCleanup(self.client.remove_container, c, force=True)
  1123. self.client.start(c)
  1124. container_mode_source = 'container:{}'.format(c['Id'])
  1125. filename = 'network-mode.yml'
  1126. self.base_dir = 'tests/fixtures/networks'
  1127. self._project = get_project(self.base_dir, [filename])
  1128. self.dispatch(['-f', filename, 'up', '-d'], None)
  1129. networks = [
  1130. n for n in self.client.networks()
  1131. if n['Name'].split('/')[-1].startswith('{}_'.format(self.project.name))
  1132. ]
  1133. assert not networks
  1134. for name in ['bridge', 'host', 'none']:
  1135. container = self.project.get_service(name).containers()[0]
  1136. assert list(container.get('NetworkSettings.Networks')) == [name]
  1137. assert container.get('HostConfig.NetworkMode') == name
  1138. service_mode_source = 'container:{}'.format(
  1139. self.project.get_service('bridge').containers()[0].id)
  1140. service_mode_container = self.project.get_service('service').containers()[0]
  1141. assert not service_mode_container.get('NetworkSettings.Networks')
  1142. assert service_mode_container.get('HostConfig.NetworkMode') == service_mode_source
  1143. container_mode_container = self.project.get_service('container').containers()[0]
  1144. assert not container_mode_container.get('NetworkSettings.Networks')
  1145. assert container_mode_container.get('HostConfig.NetworkMode') == container_mode_source
  1146. @v2_only()
  1147. def test_up_external_networks(self):
  1148. filename = 'external-networks.yml'
  1149. self.base_dir = 'tests/fixtures/networks'
  1150. self._project = get_project(self.base_dir, [filename])
  1151. result = self.dispatch(['-f', filename, 'up', '-d'], returncode=1)
  1152. assert 'declared as external, but could not be found' in result.stderr
  1153. networks = [
  1154. n['Name'] for n in self.client.networks()
  1155. if n['Name'].startswith('{}_'.format(self.project.name))
  1156. ]
  1157. assert not networks
  1158. network_names = ['{}_{}'.format(self.project.name, n) for n in ['foo', 'bar']]
  1159. for name in network_names:
  1160. self.client.create_network(name, attachable=True)
  1161. self.dispatch(['-f', filename, 'up', '-d'])
  1162. container = self.project.containers()[0]
  1163. assert sorted(list(container.get('NetworkSettings.Networks'))) == sorted(network_names)
  1164. @v2_only()
  1165. def test_up_with_external_default_network(self):
  1166. filename = 'external-default.yml'
  1167. self.base_dir = 'tests/fixtures/networks'
  1168. self._project = get_project(self.base_dir, [filename])
  1169. result = self.dispatch(['-f', filename, 'up', '-d'], returncode=1)
  1170. assert 'declared as external, but could not be found' in result.stderr
  1171. networks = [
  1172. n['Name'] for n in self.client.networks()
  1173. if n['Name'].split('/')[-1].startswith('{}_'.format(self.project.name))
  1174. ]
  1175. assert not networks
  1176. network_name = 'composetest_external_network'
  1177. self.client.create_network(network_name, attachable=True)
  1178. self.dispatch(['-f', filename, 'up', '-d'])
  1179. container = self.project.containers()[0]
  1180. assert list(container.get('NetworkSettings.Networks')) == [network_name]
  1181. @v2_1_only()
  1182. def test_up_with_network_labels(self):
  1183. filename = 'network-label.yml'
  1184. self.base_dir = 'tests/fixtures/networks'
  1185. self._project = get_project(self.base_dir, [filename])
  1186. self.dispatch(['-f', filename, 'up', '-d'], returncode=0)
  1187. network_with_label = '{}_network_with_label'.format(self.project.name)
  1188. networks = [
  1189. n for n in self.client.networks()
  1190. if n['Name'].split('/')[-1].startswith('{}_'.format(self.project.name))
  1191. ]
  1192. assert [n['Name'].split('/')[-1] for n in networks] == [network_with_label]
  1193. assert 'label_key' in networks[0]['Labels']
  1194. assert networks[0]['Labels']['label_key'] == 'label_val'
  1195. @v2_1_only()
  1196. def test_up_with_volume_labels(self):
  1197. filename = 'volume-label.yml'
  1198. self.base_dir = 'tests/fixtures/volumes'
  1199. self._project = get_project(self.base_dir, [filename])
  1200. self.dispatch(['-f', filename, 'up', '-d'], returncode=0)
  1201. volume_with_label = '{}_volume_with_label'.format(self.project.name)
  1202. volumes = [
  1203. v for v in self.client.volumes().get('Volumes', [])
  1204. if v['Name'].split('/')[-1].startswith('{}_'.format(self.project.name))
  1205. ]
  1206. assert set([v['Name'].split('/')[-1] for v in volumes]) == {volume_with_label}
  1207. assert 'label_key' in volumes[0]['Labels']
  1208. assert volumes[0]['Labels']['label_key'] == 'label_val'
  1209. @v2_only()
  1210. def test_up_no_services(self):
  1211. self.base_dir = 'tests/fixtures/no-services'
  1212. self.dispatch(['up', '-d'], None)
  1213. network_names = [
  1214. n['Name'] for n in self.client.networks()
  1215. if n['Name'].split('/')[-1].startswith('{}_'.format(self.project.name))
  1216. ]
  1217. assert network_names == []
  1218. def test_up_with_links_v1(self):
  1219. self.base_dir = 'tests/fixtures/links-composefile'
  1220. self.dispatch(['up', '-d', 'web'], None)
  1221. # No network was created
  1222. network_name = self.project.networks.networks['default'].full_name
  1223. networks = self.client.networks(names=[network_name])
  1224. assert networks == []
  1225. web = self.project.get_service('web')
  1226. db = self.project.get_service('db')
  1227. console = self.project.get_service('console')
  1228. # console was not started
  1229. assert len(web.containers()) == 1
  1230. assert len(db.containers()) == 1
  1231. assert len(console.containers()) == 0
  1232. # web has links
  1233. web_container = web.containers()[0]
  1234. assert web_container.get('HostConfig.Links')
  1235. def test_up_with_net_is_invalid(self):
  1236. self.base_dir = 'tests/fixtures/net-container'
  1237. result = self.dispatch(
  1238. ['-f', 'v2-invalid.yml', 'up', '-d'],
  1239. returncode=1)
  1240. assert "Unsupported config option for services.bar: 'net'" in result.stderr
  1241. @no_cluster("Legacy networking not supported on Swarm")
  1242. def test_up_with_net_v1(self):
  1243. self.base_dir = 'tests/fixtures/net-container'
  1244. self.dispatch(['up', '-d'], None)
  1245. bar = self.project.get_service('bar')
  1246. bar_container = bar.containers()[0]
  1247. foo = self.project.get_service('foo')
  1248. foo_container = foo.containers()[0]
  1249. assert foo_container.get('HostConfig.NetworkMode') == 'container:{}'.format(
  1250. bar_container.id
  1251. )
  1252. @v3_only()
  1253. def test_up_with_healthcheck(self):
  1254. def wait_on_health_status(container, status):
  1255. def condition():
  1256. container.inspect()
  1257. return container.get('State.Health.Status') == status
  1258. return wait_on_condition(condition, delay=0.5)
  1259. self.base_dir = 'tests/fixtures/healthcheck'
  1260. self.dispatch(['up', '-d'], None)
  1261. passes = self.project.get_service('passes')
  1262. passes_container = passes.containers()[0]
  1263. assert passes_container.get('Config.Healthcheck') == {
  1264. "Test": ["CMD-SHELL", "/bin/true"],
  1265. "Interval": nanoseconds_from_time_seconds(1),
  1266. "Timeout": nanoseconds_from_time_seconds(30 * 60),
  1267. "Retries": 1,
  1268. }
  1269. wait_on_health_status(passes_container, 'healthy')
  1270. fails = self.project.get_service('fails')
  1271. fails_container = fails.containers()[0]
  1272. assert fails_container.get('Config.Healthcheck') == {
  1273. "Test": ["CMD", "/bin/false"],
  1274. "Interval": nanoseconds_from_time_seconds(2.5),
  1275. "Retries": 2,
  1276. }
  1277. wait_on_health_status(fails_container, 'unhealthy')
  1278. disabled = self.project.get_service('disabled')
  1279. disabled_container = disabled.containers()[0]
  1280. assert disabled_container.get('Config.Healthcheck') == {
  1281. "Test": ["NONE"],
  1282. }
  1283. assert 'Health' not in disabled_container.get('State')
  1284. def test_up_with_no_deps(self):
  1285. self.base_dir = 'tests/fixtures/links-composefile'
  1286. self.dispatch(['up', '-d', '--no-deps', 'web'], None)
  1287. web = self.project.get_service('web')
  1288. db = self.project.get_service('db')
  1289. console = self.project.get_service('console')
  1290. assert len(web.containers()) == 1
  1291. assert len(db.containers()) == 0
  1292. assert len(console.containers()) == 0
  1293. def test_up_with_force_recreate(self):
  1294. self.dispatch(['up', '-d'], None)
  1295. service = self.project.get_service('simple')
  1296. assert len(service.containers()) == 1
  1297. old_ids = [c.id for c in service.containers()]
  1298. self.dispatch(['up', '-d', '--force-recreate'], None)
  1299. assert len(service.containers()) == 1
  1300. new_ids = [c.id for c in service.containers()]
  1301. assert old_ids != new_ids
  1302. def test_up_with_no_recreate(self):
  1303. self.dispatch(['up', '-d'], None)
  1304. service = self.project.get_service('simple')
  1305. assert len(service.containers()) == 1
  1306. old_ids = [c.id for c in service.containers()]
  1307. self.dispatch(['up', '-d', '--no-recreate'], None)
  1308. assert len(service.containers()) == 1
  1309. new_ids = [c.id for c in service.containers()]
  1310. assert old_ids == new_ids
  1311. def test_up_with_force_recreate_and_no_recreate(self):
  1312. self.dispatch(
  1313. ['up', '-d', '--force-recreate', '--no-recreate'],
  1314. returncode=1)
  1315. def test_up_with_timeout(self):
  1316. self.dispatch(['up', '-d', '-t', '1'])
  1317. service = self.project.get_service('simple')
  1318. another = self.project.get_service('another')
  1319. assert len(service.containers()) == 1
  1320. assert len(another.containers()) == 1
  1321. @mock.patch.dict(os.environ)
  1322. def test_up_with_ignore_remove_orphans(self):
  1323. os.environ["COMPOSE_IGNORE_ORPHANS"] = "True"
  1324. result = self.dispatch(['up', '-d', '--remove-orphans'], returncode=1)
  1325. assert "COMPOSE_IGNORE_ORPHANS and --remove-orphans cannot be combined." in result.stderr
  1326. def test_up_handles_sigint(self):
  1327. proc = start_process(self.base_dir, ['up', '-t', '2'])
  1328. wait_on_condition(ContainerCountCondition(self.project, 2))
  1329. os.kill(proc.pid, signal.SIGINT)
  1330. wait_on_condition(ContainerCountCondition(self.project, 0))
  1331. def test_up_handles_sigterm(self):
  1332. proc = start_process(self.base_dir, ['up', '-t', '2'])
  1333. wait_on_condition(ContainerCountCondition(self.project, 2))
  1334. os.kill(proc.pid, signal.SIGTERM)
  1335. wait_on_condition(ContainerCountCondition(self.project, 0))
  1336. @v2_only()
  1337. def test_up_handles_force_shutdown(self):
  1338. self.base_dir = 'tests/fixtures/sleeps-composefile'
  1339. proc = start_process(self.base_dir, ['up', '-t', '200'])
  1340. wait_on_condition(ContainerCountCondition(self.project, 2))
  1341. os.kill(proc.pid, signal.SIGTERM)
  1342. time.sleep(0.1)
  1343. os.kill(proc.pid, signal.SIGTERM)
  1344. wait_on_condition(ContainerCountCondition(self.project, 0))
  1345. def test_up_handles_abort_on_container_exit(self):
  1346. self.base_dir = 'tests/fixtures/abort-on-container-exit-0'
  1347. proc = start_process(self.base_dir, ['up', '--abort-on-container-exit'])
  1348. wait_on_condition(ContainerCountCondition(self.project, 0))
  1349. proc.wait()
  1350. assert proc.returncode == 0
  1351. def test_up_handles_abort_on_container_exit_code(self):
  1352. self.base_dir = 'tests/fixtures/abort-on-container-exit-1'
  1353. proc = start_process(self.base_dir, ['up', '--abort-on-container-exit'])
  1354. wait_on_condition(ContainerCountCondition(self.project, 0))
  1355. proc.wait()
  1356. assert proc.returncode == 1
  1357. @v2_only()
  1358. @no_cluster('Container PID mode does not work across clusters')
  1359. def test_up_with_pid_mode(self):
  1360. c = self.client.create_container(
  1361. 'busybox', 'top', name='composetest_pid_mode_container',
  1362. host_config={}
  1363. )
  1364. self.addCleanup(self.client.remove_container, c, force=True)
  1365. self.client.start(c)
  1366. container_mode_source = 'container:{}'.format(c['Id'])
  1367. self.base_dir = 'tests/fixtures/pid-mode'
  1368. self.dispatch(['up', '-d'], None)
  1369. service_mode_source = 'container:{}'.format(
  1370. self.project.get_service('container').containers()[0].id)
  1371. service_mode_container = self.project.get_service('service').containers()[0]
  1372. assert service_mode_container.get('HostConfig.PidMode') == service_mode_source
  1373. container_mode_container = self.project.get_service('container').containers()[0]
  1374. assert container_mode_container.get('HostConfig.PidMode') == container_mode_source
  1375. host_mode_container = self.project.get_service('host').containers()[0]
  1376. assert host_mode_container.get('HostConfig.PidMode') == 'host'
  1377. def test_exec_without_tty(self):
  1378. self.base_dir = 'tests/fixtures/links-composefile'
  1379. self.dispatch(['up', '-d', 'console'])
  1380. assert len(self.project.containers()) == 1
  1381. stdout, stderr = self.dispatch(['exec', '-T', 'console', 'ls', '-1d', '/'])
  1382. assert stderr == ""
  1383. assert stdout == "/\n"
  1384. def test_exec_detach_long_form(self):
  1385. self.base_dir = 'tests/fixtures/links-composefile'
  1386. self.dispatch(['up', '--detach', 'console'])
  1387. assert len(self.project.containers()) == 1
  1388. stdout, stderr = self.dispatch(['exec', '-T', 'console', 'ls', '-1d', '/'])
  1389. assert stderr == ""
  1390. assert stdout == "/\n"
  1391. def test_exec_custom_user(self):
  1392. self.base_dir = 'tests/fixtures/links-composefile'
  1393. self.dispatch(['up', '-d', 'console'])
  1394. assert len(self.project.containers()) == 1
  1395. stdout, stderr = self.dispatch(['exec', '-T', '--user=operator', 'console', 'whoami'])
  1396. assert stdout == "operator\n"
  1397. assert stderr == ""
  1398. @v3_only()
  1399. def test_exec_workdir(self):
  1400. self.base_dir = 'tests/fixtures/links-composefile'
  1401. os.environ['COMPOSE_API_VERSION'] = '1.35'
  1402. self.dispatch(['up', '-d', 'console'])
  1403. assert len(self.project.containers()) == 1
  1404. stdout, stderr = self.dispatch(['exec', '-T', '--workdir', '/etc', 'console', 'ls'])
  1405. assert 'passwd' in stdout
  1406. @v2_2_only()
  1407. def test_exec_service_with_environment_overridden(self):
  1408. name = 'service'
  1409. self.base_dir = 'tests/fixtures/environment-exec'
  1410. self.dispatch(['up', '-d'])
  1411. assert len(self.project.containers()) == 1
  1412. stdout, stderr = self.dispatch([
  1413. 'exec',
  1414. '-T',
  1415. '-e', 'foo=notbar',
  1416. '--env', 'alpha=beta',
  1417. name,
  1418. 'env',
  1419. ])
  1420. # env overridden
  1421. assert 'foo=notbar' in stdout
  1422. # keep environment from yaml
  1423. assert 'hello=world' in stdout
  1424. # added option from command line
  1425. assert 'alpha=beta' in stdout
  1426. assert stderr == ''
  1427. def test_run_service_without_links(self):
  1428. self.base_dir = 'tests/fixtures/links-composefile'
  1429. self.dispatch(['run', 'console', '/bin/true'])
  1430. assert len(self.project.containers()) == 0
  1431. # Ensure stdin/out was open
  1432. container = self.project.containers(stopped=True, one_off=OneOffFilter.only)[0]
  1433. config = container.inspect()['Config']
  1434. assert config['AttachStderr']
  1435. assert config['AttachStdout']
  1436. assert config['AttachStdin']
  1437. def test_run_service_with_links(self):
  1438. self.base_dir = 'tests/fixtures/links-composefile'
  1439. self.dispatch(['run', 'web', '/bin/true'], None)
  1440. db = self.project.get_service('db')
  1441. console = self.project.get_service('console')
  1442. assert len(db.containers()) == 1
  1443. assert len(console.containers()) == 0
  1444. @v2_only()
  1445. def test_run_service_with_dependencies(self):
  1446. self.base_dir = 'tests/fixtures/v2-dependencies'
  1447. self.dispatch(['run', 'web', '/bin/true'], None)
  1448. db = self.project.get_service('db')
  1449. console = self.project.get_service('console')
  1450. assert len(db.containers()) == 1
  1451. assert len(console.containers()) == 0
  1452. def test_run_service_with_scaled_dependencies(self):
  1453. self.base_dir = 'tests/fixtures/v2-dependencies'
  1454. self.dispatch(['up', '-d', '--scale', 'db=2', '--scale', 'console=0'])
  1455. db = self.project.get_service('db')
  1456. console = self.project.get_service('console')
  1457. assert len(db.containers()) == 2
  1458. assert len(console.containers()) == 0
  1459. self.dispatch(['run', 'web', '/bin/true'], None)
  1460. assert len(db.containers()) == 2
  1461. assert len(console.containers()) == 0
  1462. def test_run_with_no_deps(self):
  1463. self.base_dir = 'tests/fixtures/links-composefile'
  1464. self.dispatch(['run', '--no-deps', 'web', '/bin/true'])
  1465. db = self.project.get_service('db')
  1466. assert len(db.containers()) == 0
  1467. def test_run_does_not_recreate_linked_containers(self):
  1468. self.base_dir = 'tests/fixtures/links-composefile'
  1469. self.dispatch(['up', '-d', 'db'])
  1470. db = self.project.get_service('db')
  1471. assert len(db.containers()) == 1
  1472. old_ids = [c.id for c in db.containers()]
  1473. self.dispatch(['run', 'web', '/bin/true'], None)
  1474. assert len(db.containers()) == 1
  1475. new_ids = [c.id for c in db.containers()]
  1476. assert old_ids == new_ids
  1477. def test_run_without_command(self):
  1478. self.base_dir = 'tests/fixtures/commands-composefile'
  1479. self.check_build('tests/fixtures/simple-dockerfile', tag='composetest_test')
  1480. self.dispatch(['run', 'implicit'])
  1481. service = self.project.get_service('implicit')
  1482. containers = service.containers(stopped=True, one_off=OneOffFilter.only)
  1483. assert [c.human_readable_command for c in containers] == [u'/bin/sh -c echo "success"']
  1484. self.dispatch(['run', 'explicit'])
  1485. service = self.project.get_service('explicit')
  1486. containers = service.containers(stopped=True, one_off=OneOffFilter.only)
  1487. assert [c.human_readable_command for c in containers] == [u'/bin/true']
  1488. @pytest.mark.skipif(SWARM_SKIP_RM_VOLUMES, reason='Swarm DELETE /containers/<id> bug')
  1489. def test_run_rm(self):
  1490. self.base_dir = 'tests/fixtures/volume'
  1491. proc = start_process(self.base_dir, ['run', '--rm', 'test'])
  1492. service = self.project.get_service('test')
  1493. wait_on_condition(ContainerStateCondition(
  1494. self.project.client,
  1495. 'volume_test_run_*',
  1496. 'running')
  1497. )
  1498. containers = service.containers(one_off=OneOffFilter.only)
  1499. assert len(containers) == 1
  1500. mounts = containers[0].get('Mounts')
  1501. for mount in mounts:
  1502. if mount['Destination'] == '/container-path':
  1503. anonymous_name = mount['Name']
  1504. break
  1505. os.kill(proc.pid, signal.SIGINT)
  1506. wait_on_process(proc, 1)
  1507. assert len(service.containers(stopped=True, one_off=OneOffFilter.only)) == 0
  1508. volumes = self.client.volumes()['Volumes']
  1509. assert volumes is not None
  1510. for volume in service.options.get('volumes'):
  1511. if volume.internal == '/container-named-path':
  1512. name = volume.external
  1513. break
  1514. volume_names = [v['Name'].split('/')[-1] for v in volumes]
  1515. assert name in volume_names
  1516. assert anonymous_name not in volume_names
  1517. def test_run_service_with_dockerfile_entrypoint(self):
  1518. self.base_dir = 'tests/fixtures/entrypoint-dockerfile'
  1519. self.dispatch(['run', 'test'])
  1520. container = self.project.containers(stopped=True, one_off=OneOffFilter.only)[0]
  1521. assert container.get('Config.Entrypoint') == ['printf']
  1522. assert container.get('Config.Cmd') == ['default', 'args']
  1523. def test_run_service_with_unset_entrypoint(self):
  1524. self.base_dir = 'tests/fixtures/entrypoint-dockerfile'
  1525. self.dispatch(['run', '--entrypoint=""', 'test', 'true'])
  1526. container = self.project.containers(stopped=True, one_off=OneOffFilter.only)[0]
  1527. assert container.get('Config.Entrypoint') is None
  1528. assert container.get('Config.Cmd') == ['true']
  1529. self.dispatch(['run', '--entrypoint', '""', 'test', 'true'])
  1530. container = self.project.containers(stopped=True, one_off=OneOffFilter.only)[0]
  1531. assert container.get('Config.Entrypoint') is None
  1532. assert container.get('Config.Cmd') == ['true']
  1533. def test_run_service_with_dockerfile_entrypoint_overridden(self):
  1534. self.base_dir = 'tests/fixtures/entrypoint-dockerfile'
  1535. self.dispatch(['run', '--entrypoint', 'echo', 'test'])
  1536. container = self.project.containers(stopped=True, one_off=OneOffFilter.only)[0]
  1537. assert container.get('Config.Entrypoint') == ['echo']
  1538. assert not container.get('Config.Cmd')
  1539. def test_run_service_with_dockerfile_entrypoint_and_command_overridden(self):
  1540. self.base_dir = 'tests/fixtures/entrypoint-dockerfile'
  1541. self.dispatch(['run', '--entrypoint', 'echo', 'test', 'foo'])
  1542. container = self.project.containers(stopped=True, one_off=OneOffFilter.only)[0]
  1543. assert container.get('Config.Entrypoint') == ['echo']
  1544. assert container.get('Config.Cmd') == ['foo']
  1545. def test_run_service_with_compose_file_entrypoint(self):
  1546. self.base_dir = 'tests/fixtures/entrypoint-composefile'
  1547. self.dispatch(['run', 'test'])
  1548. container = self.project.containers(stopped=True, one_off=OneOffFilter.only)[0]
  1549. assert container.get('Config.Entrypoint') == ['printf']
  1550. assert container.get('Config.Cmd') == ['default', 'args']
  1551. def test_run_service_with_compose_file_entrypoint_overridden(self):
  1552. self.base_dir = 'tests/fixtures/entrypoint-composefile'
  1553. self.dispatch(['run', '--entrypoint', 'echo', 'test'])
  1554. container = self.project.containers(stopped=True, one_off=OneOffFilter.only)[0]
  1555. assert container.get('Config.Entrypoint') == ['echo']
  1556. assert not container.get('Config.Cmd')
  1557. def test_run_service_with_compose_file_entrypoint_and_command_overridden(self):
  1558. self.base_dir = 'tests/fixtures/entrypoint-composefile'
  1559. self.dispatch(['run', '--entrypoint', 'echo', 'test', 'foo'])
  1560. container = self.project.containers(stopped=True, one_off=OneOffFilter.only)[0]
  1561. assert container.get('Config.Entrypoint') == ['echo']
  1562. assert container.get('Config.Cmd') == ['foo']
  1563. def test_run_service_with_compose_file_entrypoint_and_empty_string_command(self):
  1564. self.base_dir = 'tests/fixtures/entrypoint-composefile'
  1565. self.dispatch(['run', '--entrypoint', 'echo', 'test', ''])
  1566. container = self.project.containers(stopped=True, one_off=OneOffFilter.only)[0]
  1567. assert container.get('Config.Entrypoint') == ['echo']
  1568. assert container.get('Config.Cmd') == ['']
  1569. def test_run_service_with_user_overridden(self):
  1570. self.base_dir = 'tests/fixtures/user-composefile'
  1571. name = 'service'
  1572. user = 'sshd'
  1573. self.dispatch(['run', '--user={user}'.format(user=user), name], returncode=1)
  1574. service = self.project.get_service(name)
  1575. container = service.containers(stopped=True, one_off=OneOffFilter.only)[0]
  1576. assert user == container.get('Config.User')
  1577. def test_run_service_with_user_overridden_short_form(self):
  1578. self.base_dir = 'tests/fixtures/user-composefile'
  1579. name = 'service'
  1580. user = 'sshd'
  1581. self.dispatch(['run', '-u', user, name], returncode=1)
  1582. service = self.project.get_service(name)
  1583. container = service.containers(stopped=True, one_off=OneOffFilter.only)[0]
  1584. assert user == container.get('Config.User')
  1585. def test_run_service_with_environment_overridden(self):
  1586. name = 'service'
  1587. self.base_dir = 'tests/fixtures/environment-composefile'
  1588. self.dispatch([
  1589. 'run', '-e', 'foo=notbar',
  1590. '-e', 'allo=moto=bobo',
  1591. '-e', 'alpha=beta',
  1592. name,
  1593. '/bin/true',
  1594. ])
  1595. service = self.project.get_service(name)
  1596. container = service.containers(stopped=True, one_off=OneOffFilter.only)[0]
  1597. # env overridden
  1598. assert 'notbar' == container.environment['foo']
  1599. # keep environment from yaml
  1600. assert 'world' == container.environment['hello']
  1601. # added option from command line
  1602. assert 'beta' == container.environment['alpha']
  1603. # make sure a value with a = don't crash out
  1604. assert 'moto=bobo' == container.environment['allo']
  1605. def test_run_service_without_map_ports(self):
  1606. # create one off container
  1607. self.base_dir = 'tests/fixtures/ports-composefile'
  1608. self.dispatch(['run', '-d', 'simple'])
  1609. container = self.project.get_service('simple').containers(one_off=OneOffFilter.only)[0]
  1610. # get port information
  1611. port_random = container.get_local_port(3000)
  1612. port_assigned = container.get_local_port(3001)
  1613. # close all one off containers we just created
  1614. container.stop()
  1615. # check the ports
  1616. assert port_random is None
  1617. assert port_assigned is None
  1618. def test_run_service_with_map_ports(self):
  1619. # create one off container
  1620. self.base_dir = 'tests/fixtures/ports-composefile'
  1621. self.dispatch(['run', '-d', '--service-ports', 'simple'])
  1622. container = self.project.get_service('simple').containers(one_off=OneOffFilter.only)[0]
  1623. # get port information
  1624. port_random = container.get_local_port(3000)
  1625. port_assigned = container.get_local_port(3001)
  1626. port_range = container.get_local_port(3002), container.get_local_port(3003)
  1627. # close all one off containers we just created
  1628. container.stop()
  1629. # check the ports
  1630. assert port_random is not None
  1631. assert port_assigned.endswith(':49152')
  1632. assert port_range[0].endswith(':49153')
  1633. assert port_range[1].endswith(':49154')
  1634. def test_run_service_with_explicitly_mapped_ports(self):
  1635. # create one off container
  1636. self.base_dir = 'tests/fixtures/ports-composefile'
  1637. self.dispatch(['run', '-d', '-p', '30000:3000', '--publish', '30001:3001', 'simple'])
  1638. container = self.project.get_service('simple').containers(one_off=OneOffFilter.only)[0]
  1639. # get port information
  1640. port_short = container.get_local_port(3000)
  1641. port_full = container.get_local_port(3001)
  1642. # close all one off containers we just created
  1643. container.stop()
  1644. # check the ports
  1645. assert port_short.endswith(':30000')
  1646. assert port_full.endswith(':30001')
  1647. def test_run_service_with_explicitly_mapped_ip_ports(self):
  1648. # create one off container
  1649. self.base_dir = 'tests/fixtures/ports-composefile'
  1650. self.dispatch([
  1651. 'run', '-d',
  1652. '-p', '127.0.0.1:30000:3000',
  1653. '--publish', '127.0.0.1:30001:3001',
  1654. 'simple'
  1655. ])
  1656. container = self.project.get_service('simple').containers(one_off=OneOffFilter.only)[0]
  1657. # get port information
  1658. port_short = container.get_local_port(3000)
  1659. port_full = container.get_local_port(3001)
  1660. # close all one off containers we just created
  1661. container.stop()
  1662. # check the ports
  1663. assert port_short == "127.0.0.1:30000"
  1664. assert port_full == "127.0.0.1:30001"
  1665. def test_run_with_expose_ports(self):
  1666. # create one off container
  1667. self.base_dir = 'tests/fixtures/expose-composefile'
  1668. self.dispatch(['run', '-d', '--service-ports', 'simple'])
  1669. container = self.project.get_service('simple').containers(one_off=OneOffFilter.only)[0]
  1670. ports = container.ports
  1671. assert len(ports) == 9
  1672. # exposed ports are not mapped to host ports
  1673. assert ports['3000/tcp'] is None
  1674. assert ports['3001/tcp'] is None
  1675. assert ports['3001/udp'] is None
  1676. assert ports['3002/tcp'] is None
  1677. assert ports['3003/tcp'] is None
  1678. assert ports['3004/tcp'] is None
  1679. assert ports['3005/tcp'] is None
  1680. assert ports['3006/udp'] is None
  1681. assert ports['3007/udp'] is None
  1682. # close all one off containers we just created
  1683. container.stop()
  1684. def test_run_with_custom_name(self):
  1685. self.base_dir = 'tests/fixtures/environment-composefile'
  1686. name = 'the-container-name'
  1687. self.dispatch(['run', '--name', name, 'service', '/bin/true'])
  1688. service = self.project.get_service('service')
  1689. container, = service.containers(stopped=True, one_off=OneOffFilter.only)
  1690. assert container.name == name
  1691. def test_run_service_with_workdir_overridden(self):
  1692. self.base_dir = 'tests/fixtures/run-workdir'
  1693. name = 'service'
  1694. workdir = '/var'
  1695. self.dispatch(['run', '--workdir={workdir}'.format(workdir=workdir), name])
  1696. service = self.project.get_service(name)
  1697. container = service.containers(stopped=True, one_off=True)[0]
  1698. assert workdir == container.get('Config.WorkingDir')
  1699. def test_run_service_with_workdir_overridden_short_form(self):
  1700. self.base_dir = 'tests/fixtures/run-workdir'
  1701. name = 'service'
  1702. workdir = '/var'
  1703. self.dispatch(['run', '-w', workdir, name])
  1704. service = self.project.get_service(name)
  1705. container = service.containers(stopped=True, one_off=True)[0]
  1706. assert workdir == container.get('Config.WorkingDir')
  1707. @v2_only()
  1708. def test_run_service_with_use_aliases(self):
  1709. filename = 'network-aliases.yml'
  1710. self.base_dir = 'tests/fixtures/networks'
  1711. self.dispatch(['-f', filename, 'run', '-d', '--use-aliases', 'web', 'top'])
  1712. back_name = '{}_back'.format(self.project.name)
  1713. front_name = '{}_front'.format(self.project.name)
  1714. web_container = self.project.get_service('web').containers(one_off=OneOffFilter.only)[0]
  1715. back_aliases = web_container.get(
  1716. 'NetworkSettings.Networks.{}.Aliases'.format(back_name)
  1717. )
  1718. assert 'web' in back_aliases
  1719. front_aliases = web_container.get(
  1720. 'NetworkSettings.Networks.{}.Aliases'.format(front_name)
  1721. )
  1722. assert 'web' in front_aliases
  1723. assert 'forward_facing' in front_aliases
  1724. assert 'ahead' in front_aliases
  1725. @v2_only()
  1726. def test_run_interactive_connects_to_network(self):
  1727. self.base_dir = 'tests/fixtures/networks'
  1728. self.dispatch(['up', '-d'])
  1729. self.dispatch(['run', 'app', 'nslookup', 'app'])
  1730. self.dispatch(['run', 'app', 'nslookup', 'db'])
  1731. containers = self.project.get_service('app').containers(
  1732. stopped=True, one_off=OneOffFilter.only)
  1733. assert len(containers) == 2
  1734. for container in containers:
  1735. networks = container.get('NetworkSettings.Networks')
  1736. assert sorted(list(networks)) == [
  1737. '{}_{}'.format(self.project.name, name)
  1738. for name in ['back', 'front']
  1739. ]
  1740. for _, config in networks.items():
  1741. # TODO: once we drop support for API <1.24, this can be changed to:
  1742. # assert config['Aliases'] == [container.short_id]
  1743. aliases = set(config['Aliases'] or []) - {container.short_id}
  1744. assert not aliases
  1745. @v2_only()
  1746. def test_run_detached_connects_to_network(self):
  1747. self.base_dir = 'tests/fixtures/networks'
  1748. self.dispatch(['up', '-d'])
  1749. self.dispatch(['run', '-d', 'app', 'top'])
  1750. container = self.project.get_service('app').containers(one_off=OneOffFilter.only)[0]
  1751. networks = container.get('NetworkSettings.Networks')
  1752. assert sorted(list(networks)) == [
  1753. '{}_{}'.format(self.project.name, name)
  1754. for name in ['back', 'front']
  1755. ]
  1756. for _, config in networks.items():
  1757. # TODO: once we drop support for API <1.24, this can be changed to:
  1758. # assert config['Aliases'] == [container.short_id]
  1759. aliases = set(config['Aliases'] or []) - {container.short_id}
  1760. assert not aliases
  1761. assert self.lookup(container, 'app')
  1762. assert self.lookup(container, 'db')
  1763. def test_run_handles_sigint(self):
  1764. proc = start_process(self.base_dir, ['run', '-T', 'simple', 'top'])
  1765. wait_on_condition(ContainerStateCondition(
  1766. self.project.client,
  1767. 'simple-composefile_simple_run_*',
  1768. 'running'))
  1769. os.kill(proc.pid, signal.SIGINT)
  1770. wait_on_condition(ContainerStateCondition(
  1771. self.project.client,
  1772. 'simple-composefile_simple_run_*',
  1773. 'exited'))
  1774. def test_run_handles_sigterm(self):
  1775. proc = start_process(self.base_dir, ['run', '-T', 'simple', 'top'])
  1776. wait_on_condition(ContainerStateCondition(
  1777. self.project.client,
  1778. 'simple-composefile_simple_run_*',
  1779. 'running'))
  1780. os.kill(proc.pid, signal.SIGTERM)
  1781. wait_on_condition(ContainerStateCondition(
  1782. self.project.client,
  1783. 'simple-composefile_simple_run_*',
  1784. 'exited'))
  1785. def test_run_handles_sighup(self):
  1786. proc = start_process(self.base_dir, ['run', '-T', 'simple', 'top'])
  1787. wait_on_condition(ContainerStateCondition(
  1788. self.project.client,
  1789. 'simple-composefile_simple_run_*',
  1790. 'running'))
  1791. os.kill(proc.pid, signal.SIGHUP)
  1792. wait_on_condition(ContainerStateCondition(
  1793. self.project.client,
  1794. 'simple-composefile_simple_run_*',
  1795. 'exited'))
  1796. @mock.patch.dict(os.environ)
  1797. def test_run_unicode_env_values_from_system(self):
  1798. value = 'ą, ć, ę, ł, ń, ó, ś, ź, ż'
  1799. if six.PY2: # os.environ doesn't support unicode values in Py2
  1800. os.environ['BAR'] = value.encode('utf-8')
  1801. else: # ... and doesn't support byte values in Py3
  1802. os.environ['BAR'] = value
  1803. self.base_dir = 'tests/fixtures/unicode-environment'
  1804. result = self.dispatch(['run', 'simple'])
  1805. if six.PY2: # Can't retrieve output on Py3. See issue #3670
  1806. assert value in result.stdout.strip()
  1807. container = self.project.containers(one_off=OneOffFilter.only, stopped=True)[0]
  1808. environment = container.get('Config.Env')
  1809. assert 'FOO={}'.format(value) in environment
  1810. @mock.patch.dict(os.environ)
  1811. def test_run_env_values_from_system(self):
  1812. os.environ['FOO'] = 'bar'
  1813. os.environ['BAR'] = 'baz'
  1814. self.dispatch(['run', '-e', 'FOO', 'simple', 'true'], None)
  1815. container = self.project.containers(one_off=OneOffFilter.only, stopped=True)[0]
  1816. environment = container.get('Config.Env')
  1817. assert 'FOO=bar' in environment
  1818. assert 'BAR=baz' not in environment
  1819. def test_run_label_flag(self):
  1820. self.base_dir = 'tests/fixtures/run-labels'
  1821. name = 'service'
  1822. self.dispatch(['run', '-l', 'default', '--label', 'foo=baz', name, '/bin/true'])
  1823. service = self.project.get_service(name)
  1824. container, = service.containers(stopped=True, one_off=OneOffFilter.only)
  1825. labels = container.labels
  1826. assert labels['default'] == ''
  1827. assert labels['foo'] == 'baz'
  1828. assert labels['hello'] == 'world'
  1829. def test_rm(self):
  1830. service = self.project.get_service('simple')
  1831. service.create_container()
  1832. kill_service(service)
  1833. assert len(service.containers(stopped=True)) == 1
  1834. self.dispatch(['rm', '--force'], None)
  1835. assert len(service.containers(stopped=True)) == 0
  1836. service = self.project.get_service('simple')
  1837. service.create_container()
  1838. kill_service(service)
  1839. assert len(service.containers(stopped=True)) == 1
  1840. self.dispatch(['rm', '-f'], None)
  1841. assert len(service.containers(stopped=True)) == 0
  1842. service = self.project.get_service('simple')
  1843. service.create_container()
  1844. self.dispatch(['rm', '-fs'], None)
  1845. assert len(service.containers(stopped=True)) == 0
  1846. def test_rm_stop(self):
  1847. self.dispatch(['up', '-d'], None)
  1848. simple = self.project.get_service('simple')
  1849. another = self.project.get_service('another')
  1850. assert len(simple.containers()) == 1
  1851. assert len(another.containers()) == 1
  1852. self.dispatch(['rm', '-fs'], None)
  1853. assert len(simple.containers(stopped=True)) == 0
  1854. assert len(another.containers(stopped=True)) == 0
  1855. self.dispatch(['up', '-d'], None)
  1856. assert len(simple.containers()) == 1
  1857. assert len(another.containers()) == 1
  1858. self.dispatch(['rm', '-fs', 'another'], None)
  1859. assert len(simple.containers()) == 1
  1860. assert len(another.containers(stopped=True)) == 0
  1861. def test_rm_all(self):
  1862. service = self.project.get_service('simple')
  1863. service.create_container(one_off=False)
  1864. service.create_container(one_off=True)
  1865. kill_service(service)
  1866. assert len(service.containers(stopped=True)) == 1
  1867. assert len(service.containers(stopped=True, one_off=OneOffFilter.only)) == 1
  1868. self.dispatch(['rm', '-f'], None)
  1869. assert len(service.containers(stopped=True)) == 0
  1870. assert len(service.containers(stopped=True, one_off=OneOffFilter.only)) == 0
  1871. service.create_container(one_off=False)
  1872. service.create_container(one_off=True)
  1873. kill_service(service)
  1874. assert len(service.containers(stopped=True)) == 1
  1875. assert len(service.containers(stopped=True, one_off=OneOffFilter.only)) == 1
  1876. self.dispatch(['rm', '-f', '--all'], None)
  1877. assert len(service.containers(stopped=True)) == 0
  1878. assert len(service.containers(stopped=True, one_off=OneOffFilter.only)) == 0
  1879. def test_stop(self):
  1880. self.dispatch(['up', '-d'], None)
  1881. service = self.project.get_service('simple')
  1882. assert len(service.containers()) == 1
  1883. assert service.containers()[0].is_running
  1884. self.dispatch(['stop', '-t', '1'], None)
  1885. assert len(service.containers(stopped=True)) == 1
  1886. assert not service.containers(stopped=True)[0].is_running
  1887. def test_stop_signal(self):
  1888. self.base_dir = 'tests/fixtures/stop-signal-composefile'
  1889. self.dispatch(['up', '-d'], None)
  1890. service = self.project.get_service('simple')
  1891. assert len(service.containers()) == 1
  1892. assert service.containers()[0].is_running
  1893. self.dispatch(['stop', '-t', '1'], None)
  1894. assert len(service.containers(stopped=True)) == 1
  1895. assert not service.containers(stopped=True)[0].is_running
  1896. assert service.containers(stopped=True)[0].exit_code == 0
  1897. def test_start_no_containers(self):
  1898. result = self.dispatch(['start'], returncode=1)
  1899. assert 'failed' in result.stderr
  1900. assert 'No containers to start' in result.stderr
  1901. @v2_only()
  1902. def test_up_logging(self):
  1903. self.base_dir = 'tests/fixtures/logging-composefile'
  1904. self.dispatch(['up', '-d'])
  1905. simple = self.project.get_service('simple').containers()[0]
  1906. log_config = simple.get('HostConfig.LogConfig')
  1907. assert log_config
  1908. assert log_config.get('Type') == 'none'
  1909. another = self.project.get_service('another').containers()[0]
  1910. log_config = another.get('HostConfig.LogConfig')
  1911. assert log_config
  1912. assert log_config.get('Type') == 'json-file'
  1913. assert log_config.get('Config')['max-size'] == '10m'
  1914. def test_up_logging_legacy(self):
  1915. self.base_dir = 'tests/fixtures/logging-composefile-legacy'
  1916. self.dispatch(['up', '-d'])
  1917. simple = self.project.get_service('simple').containers()[0]
  1918. log_config = simple.get('HostConfig.LogConfig')
  1919. assert log_config
  1920. assert log_config.get('Type') == 'none'
  1921. another = self.project.get_service('another').containers()[0]
  1922. log_config = another.get('HostConfig.LogConfig')
  1923. assert log_config
  1924. assert log_config.get('Type') == 'json-file'
  1925. assert log_config.get('Config')['max-size'] == '10m'
  1926. def test_pause_unpause(self):
  1927. self.dispatch(['up', '-d'], None)
  1928. service = self.project.get_service('simple')
  1929. assert not service.containers()[0].is_paused
  1930. self.dispatch(['pause'], None)
  1931. assert service.containers()[0].is_paused
  1932. self.dispatch(['unpause'], None)
  1933. assert not service.containers()[0].is_paused
  1934. def test_pause_no_containers(self):
  1935. result = self.dispatch(['pause'], returncode=1)
  1936. assert 'No containers to pause' in result.stderr
  1937. def test_unpause_no_containers(self):
  1938. result = self.dispatch(['unpause'], returncode=1)
  1939. assert 'No containers to unpause' in result.stderr
  1940. def test_logs_invalid_service_name(self):
  1941. self.dispatch(['logs', 'madeupname'], returncode=1)
  1942. def test_logs_follow(self):
  1943. self.base_dir = 'tests/fixtures/echo-services'
  1944. self.dispatch(['up', '-d'])
  1945. result = self.dispatch(['logs', '-f'])
  1946. if not is_cluster(self.client):
  1947. assert result.stdout.count('\n') == 5
  1948. else:
  1949. # Sometimes logs are picked up from old containers that haven't yet
  1950. # been removed (removal in Swarm is async)
  1951. assert result.stdout.count('\n') >= 5
  1952. assert 'simple' in result.stdout
  1953. assert 'another' in result.stdout
  1954. assert 'exited with code 0' in result.stdout
  1955. @pytest.mark.skip(reason="race condition between up and logs")
  1956. def test_logs_follow_logs_from_new_containers(self):
  1957. self.base_dir = 'tests/fixtures/logs-composefile'
  1958. self.dispatch(['up', '-d', 'simple'])
  1959. proc = start_process(self.base_dir, ['logs', '-f'])
  1960. self.dispatch(['up', '-d', 'another'])
  1961. another_name = self.project.get_service('another').get_container().name_without_project
  1962. wait_on_condition(
  1963. ContainerStateCondition(
  1964. self.project.client,
  1965. 'logs-composefile_another_*',
  1966. 'exited'
  1967. )
  1968. )
  1969. simple_name = self.project.get_service('simple').get_container().name_without_project
  1970. self.dispatch(['kill', 'simple'])
  1971. result = wait_on_process(proc)
  1972. assert 'hello' in result.stdout
  1973. assert 'test' in result.stdout
  1974. assert '{} exited with code 0'.format(another_name) in result.stdout
  1975. assert '{} exited with code 137'.format(simple_name) in result.stdout
  1976. @pytest.mark.skip(reason="race condition between up and logs")
  1977. def test_logs_follow_logs_from_restarted_containers(self):
  1978. self.base_dir = 'tests/fixtures/logs-restart-composefile'
  1979. proc = start_process(self.base_dir, ['up'])
  1980. wait_on_condition(
  1981. ContainerStateCondition(
  1982. self.project.client,
  1983. 'logs-restart-composefile_another_*',
  1984. 'exited'
  1985. )
  1986. )
  1987. self.dispatch(['kill', 'simple'])
  1988. result = wait_on_process(proc)
  1989. assert result.stdout.count(
  1990. r'logs-restart-composefile_another_1 exited with code 1'
  1991. ) == 3
  1992. assert result.stdout.count('world') == 3
  1993. @pytest.mark.skip(reason="race condition between up and logs")
  1994. def test_logs_default(self):
  1995. self.base_dir = 'tests/fixtures/logs-composefile'
  1996. self.dispatch(['up', '-d'])
  1997. result = self.dispatch(['logs'])
  1998. assert 'hello' in result.stdout
  1999. assert 'test' in result.stdout
  2000. assert 'exited with' not in result.stdout
  2001. def test_logs_on_stopped_containers_exits(self):
  2002. self.base_dir = 'tests/fixtures/echo-services'
  2003. self.dispatch(['up'])
  2004. result = self.dispatch(['logs'])
  2005. assert 'simple' in result.stdout
  2006. assert 'another' in result.stdout
  2007. assert 'exited with' not in result.stdout
  2008. def test_logs_timestamps(self):
  2009. self.base_dir = 'tests/fixtures/echo-services'
  2010. self.dispatch(['up', '-d'])
  2011. result = self.dispatch(['logs', '-f', '-t'])
  2012. assert re.search(r'(\d{4})-(\d{2})-(\d{2})T(\d{2})\:(\d{2})\:(\d{2})', result.stdout)
  2013. def test_logs_tail(self):
  2014. self.base_dir = 'tests/fixtures/logs-tail-composefile'
  2015. self.dispatch(['up'])
  2016. result = self.dispatch(['logs', '--tail', '2'])
  2017. assert 'y\n' in result.stdout
  2018. assert 'z\n' in result.stdout
  2019. assert 'w\n' not in result.stdout
  2020. assert 'x\n' not in result.stdout
  2021. def test_kill(self):
  2022. self.dispatch(['up', '-d'], None)
  2023. service = self.project.get_service('simple')
  2024. assert len(service.containers()) == 1
  2025. assert service.containers()[0].is_running
  2026. self.dispatch(['kill'], None)
  2027. assert len(service.containers(stopped=True)) == 1
  2028. assert not service.containers(stopped=True)[0].is_running
  2029. def test_kill_signal_sigstop(self):
  2030. self.dispatch(['up', '-d'], None)
  2031. service = self.project.get_service('simple')
  2032. assert len(service.containers()) == 1
  2033. assert service.containers()[0].is_running
  2034. self.dispatch(['kill', '-s', 'SIGSTOP'], None)
  2035. assert len(service.containers()) == 1
  2036. # The container is still running. It has only been paused
  2037. assert service.containers()[0].is_running
  2038. def test_kill_stopped_service(self):
  2039. self.dispatch(['up', '-d'], None)
  2040. service = self.project.get_service('simple')
  2041. self.dispatch(['kill', '-s', 'SIGSTOP'], None)
  2042. assert service.containers()[0].is_running
  2043. self.dispatch(['kill', '-s', 'SIGKILL'], None)
  2044. assert len(service.containers(stopped=True)) == 1
  2045. assert not service.containers(stopped=True)[0].is_running
  2046. def test_restart(self):
  2047. service = self.project.get_service('simple')
  2048. container = service.create_container()
  2049. service.start_container(container)
  2050. started_at = container.dictionary['State']['StartedAt']
  2051. self.dispatch(['restart', '-t', '1'], None)
  2052. container.inspect()
  2053. assert container.dictionary['State']['FinishedAt'] != '0001-01-01T00:00:00Z'
  2054. assert container.dictionary['State']['StartedAt'] != started_at
  2055. def test_restart_stopped_container(self):
  2056. service = self.project.get_service('simple')
  2057. container = service.create_container()
  2058. container.start()
  2059. container.kill()
  2060. assert len(service.containers(stopped=True)) == 1
  2061. self.dispatch(['restart', '-t', '1'], None)
  2062. assert len(service.containers(stopped=False)) == 1
  2063. def test_restart_no_containers(self):
  2064. result = self.dispatch(['restart'], returncode=1)
  2065. assert 'No containers to restart' in result.stderr
  2066. def test_scale(self):
  2067. project = self.project
  2068. self.dispatch(['scale', 'simple=1'])
  2069. assert len(project.get_service('simple').containers()) == 1
  2070. self.dispatch(['scale', 'simple=3', 'another=2'])
  2071. assert len(project.get_service('simple').containers()) == 3
  2072. assert len(project.get_service('another').containers()) == 2
  2073. self.dispatch(['scale', 'simple=1', 'another=1'])
  2074. assert len(project.get_service('simple').containers()) == 1
  2075. assert len(project.get_service('another').containers()) == 1
  2076. self.dispatch(['scale', 'simple=1', 'another=1'])
  2077. assert len(project.get_service('simple').containers()) == 1
  2078. assert len(project.get_service('another').containers()) == 1
  2079. self.dispatch(['scale', 'simple=0', 'another=0'])
  2080. assert len(project.get_service('simple').containers()) == 0
  2081. assert len(project.get_service('another').containers()) == 0
  2082. def test_scale_v2_2(self):
  2083. self.base_dir = 'tests/fixtures/scale'
  2084. result = self.dispatch(['scale', 'web=1'], returncode=1)
  2085. assert 'incompatible with the v2.2 format' in result.stderr
  2086. def test_up_scale_scale_up(self):
  2087. self.base_dir = 'tests/fixtures/scale'
  2088. project = self.project
  2089. self.dispatch(['up', '-d'])
  2090. assert len(project.get_service('web').containers()) == 2
  2091. assert len(project.get_service('db').containers()) == 1
  2092. assert len(project.get_service('worker').containers()) == 0
  2093. self.dispatch(['up', '-d', '--scale', 'web=3', '--scale', 'worker=1'])
  2094. assert len(project.get_service('web').containers()) == 3
  2095. assert len(project.get_service('db').containers()) == 1
  2096. assert len(project.get_service('worker').containers()) == 1
  2097. def test_up_scale_scale_down(self):
  2098. self.base_dir = 'tests/fixtures/scale'
  2099. project = self.project
  2100. self.dispatch(['up', '-d'])
  2101. assert len(project.get_service('web').containers()) == 2
  2102. assert len(project.get_service('db').containers()) == 1
  2103. assert len(project.get_service('worker').containers()) == 0
  2104. self.dispatch(['up', '-d', '--scale', 'web=1'])
  2105. assert len(project.get_service('web').containers()) == 1
  2106. assert len(project.get_service('db').containers()) == 1
  2107. assert len(project.get_service('worker').containers()) == 0
  2108. def test_up_scale_reset(self):
  2109. self.base_dir = 'tests/fixtures/scale'
  2110. project = self.project
  2111. self.dispatch(['up', '-d', '--scale', 'web=3', '--scale', 'db=3', '--scale', 'worker=3'])
  2112. assert len(project.get_service('web').containers()) == 3
  2113. assert len(project.get_service('db').containers()) == 3
  2114. assert len(project.get_service('worker').containers()) == 3
  2115. self.dispatch(['up', '-d'])
  2116. assert len(project.get_service('web').containers()) == 2
  2117. assert len(project.get_service('db').containers()) == 1
  2118. assert len(project.get_service('worker').containers()) == 0
  2119. def test_up_scale_to_zero(self):
  2120. self.base_dir = 'tests/fixtures/scale'
  2121. project = self.project
  2122. self.dispatch(['up', '-d'])
  2123. assert len(project.get_service('web').containers()) == 2
  2124. assert len(project.get_service('db').containers()) == 1
  2125. assert len(project.get_service('worker').containers()) == 0
  2126. self.dispatch(['up', '-d', '--scale', 'web=0', '--scale', 'db=0', '--scale', 'worker=0'])
  2127. assert len(project.get_service('web').containers()) == 0
  2128. assert len(project.get_service('db').containers()) == 0
  2129. assert len(project.get_service('worker').containers()) == 0
  2130. def test_port(self):
  2131. self.base_dir = 'tests/fixtures/ports-composefile'
  2132. self.dispatch(['up', '-d'], None)
  2133. container = self.project.get_service('simple').get_container()
  2134. def get_port(number):
  2135. result = self.dispatch(['port', 'simple', str(number)])
  2136. return result.stdout.rstrip()
  2137. assert get_port(3000) == container.get_local_port(3000)
  2138. assert ':49152' in get_port(3001)
  2139. assert ':49153' in get_port(3002)
  2140. def test_expanded_port(self):
  2141. self.base_dir = 'tests/fixtures/ports-composefile'
  2142. self.dispatch(['-f', 'expanded-notation.yml', 'up', '-d'])
  2143. container = self.project.get_service('simple').get_container()
  2144. def get_port(number):
  2145. result = self.dispatch(['port', 'simple', str(number)])
  2146. return result.stdout.rstrip()
  2147. assert get_port(3000) == container.get_local_port(3000)
  2148. assert ':53222' in get_port(3001)
  2149. assert ':53223' in get_port(3002)
  2150. def test_port_with_scale(self):
  2151. self.base_dir = 'tests/fixtures/ports-composefile-scale'
  2152. self.dispatch(['scale', 'simple=2'], None)
  2153. containers = sorted(
  2154. self.project.containers(service_names=['simple']),
  2155. key=attrgetter('name'))
  2156. def get_port(number, index=None):
  2157. if index is None:
  2158. result = self.dispatch(['port', 'simple', str(number)])
  2159. else:
  2160. result = self.dispatch(['port', '--index=' + str(index), 'simple', str(number)])
  2161. return result.stdout.rstrip()
  2162. assert get_port(3000) in (containers[0].get_local_port(3000), containers[1].get_local_port(3000))
  2163. assert get_port(3000, index=containers[0].number) == containers[0].get_local_port(3000)
  2164. assert get_port(3000, index=containers[1].number) == containers[1].get_local_port(3000)
  2165. assert get_port(3002) == ""
  2166. def test_events_json(self):
  2167. events_proc = start_process(self.base_dir, ['events', '--json'])
  2168. self.dispatch(['up', '-d'])
  2169. wait_on_condition(ContainerCountCondition(self.project, 2))
  2170. os.kill(events_proc.pid, signal.SIGINT)
  2171. result = wait_on_process(events_proc, returncode=1)
  2172. lines = [json.loads(line) for line in result.stdout.rstrip().split('\n')]
  2173. assert Counter(e['action'] for e in lines) == {'create': 2, 'start': 2}
  2174. def test_events_human_readable(self):
  2175. def has_timestamp(string):
  2176. str_iso_date, str_iso_time, container_info = string.split(' ', 2)
  2177. try:
  2178. return isinstance(datetime.datetime.strptime(
  2179. '%s %s' % (str_iso_date, str_iso_time),
  2180. '%Y-%m-%d %H:%M:%S.%f'),
  2181. datetime.datetime)
  2182. except ValueError:
  2183. return False
  2184. events_proc = start_process(self.base_dir, ['events'])
  2185. self.dispatch(['up', '-d', 'simple'])
  2186. wait_on_condition(ContainerCountCondition(self.project, 1))
  2187. os.kill(events_proc.pid, signal.SIGINT)
  2188. result = wait_on_process(events_proc, returncode=1)
  2189. lines = result.stdout.rstrip().split('\n')
  2190. assert len(lines) == 2
  2191. container, = self.project.containers()
  2192. expected_template = ' container {} {}'
  2193. expected_meta_info = ['image=busybox:1.27.2', 'name=simple-composefile_simple_']
  2194. assert expected_template.format('create', container.id) in lines[0]
  2195. assert expected_template.format('start', container.id) in lines[1]
  2196. for line in lines:
  2197. for info in expected_meta_info:
  2198. assert info in line
  2199. assert has_timestamp(lines[0])
  2200. def test_env_file_relative_to_compose_file(self):
  2201. config_path = os.path.abspath('tests/fixtures/env-file/docker-compose.yml')
  2202. self.dispatch(['-f', config_path, 'up', '-d'], None)
  2203. self._project = get_project(self.base_dir, [config_path])
  2204. containers = self.project.containers(stopped=True)
  2205. assert len(containers) == 1
  2206. assert "FOO=1" in containers[0].get('Config.Env')
  2207. @mock.patch.dict(os.environ)
  2208. def test_home_and_env_var_in_volume_path(self):
  2209. os.environ['VOLUME_NAME'] = 'my-volume'
  2210. os.environ['HOME'] = '/tmp/home-dir'
  2211. self.base_dir = 'tests/fixtures/volume-path-interpolation'
  2212. self.dispatch(['up', '-d'], None)
  2213. container = self.project.containers(stopped=True)[0]
  2214. actual_host_path = container.get_mount('/container-path')['Source']
  2215. components = actual_host_path.split('/')
  2216. assert components[-2:] == ['home-dir', 'my-volume']
  2217. def test_up_with_default_override_file(self):
  2218. self.base_dir = 'tests/fixtures/override-files'
  2219. self.dispatch(['up', '-d'], None)
  2220. containers = self.project.containers()
  2221. assert len(containers) == 2
  2222. web, db = containers
  2223. assert web.human_readable_command == 'top'
  2224. assert db.human_readable_command == 'top'
  2225. def test_up_with_multiple_files(self):
  2226. self.base_dir = 'tests/fixtures/override-files'
  2227. config_paths = [
  2228. 'docker-compose.yml',
  2229. 'docker-compose.override.yml',
  2230. 'extra.yml',
  2231. ]
  2232. self._project = get_project(self.base_dir, config_paths)
  2233. self.dispatch(
  2234. [
  2235. '-f', config_paths[0],
  2236. '-f', config_paths[1],
  2237. '-f', config_paths[2],
  2238. 'up', '-d',
  2239. ],
  2240. None)
  2241. containers = self.project.containers()
  2242. assert len(containers) == 3
  2243. web, other, db = containers
  2244. assert web.human_readable_command == 'top'
  2245. assert db.human_readable_command == 'top'
  2246. assert other.human_readable_command == 'top'
  2247. def test_up_with_extends(self):
  2248. self.base_dir = 'tests/fixtures/extends'
  2249. self.dispatch(['up', '-d'], None)
  2250. assert set([s.name for s in self.project.services]) == {'mydb', 'myweb'}
  2251. # Sort by name so we get [db, web]
  2252. containers = sorted(
  2253. self.project.containers(stopped=True),
  2254. key=lambda c: c.name,
  2255. )
  2256. assert len(containers) == 2
  2257. web = containers[1]
  2258. db_name = containers[0].name_without_project
  2259. assert set(get_links(web)) == {'db', db_name, 'extends_{}'.format(db_name)}
  2260. expected_env = {"FOO=1", "BAR=2", "BAZ=2"}
  2261. assert expected_env <= set(web.get('Config.Env'))
  2262. def test_top_services_not_running(self):
  2263. self.base_dir = 'tests/fixtures/top'
  2264. result = self.dispatch(['top'])
  2265. assert len(result.stdout) == 0
  2266. def test_top_services_running(self):
  2267. self.base_dir = 'tests/fixtures/top'
  2268. self.dispatch(['up', '-d'])
  2269. result = self.dispatch(['top'])
  2270. assert 'top_service_a' in result.stdout
  2271. assert 'top_service_b' in result.stdout
  2272. assert 'top_not_a_service' not in result.stdout
  2273. def test_top_processes_running(self):
  2274. self.base_dir = 'tests/fixtures/top'
  2275. self.dispatch(['up', '-d'])
  2276. result = self.dispatch(['top'])
  2277. assert result.stdout.count("top") == 4
  2278. def test_forward_exitval(self):
  2279. self.base_dir = 'tests/fixtures/exit-code-from'
  2280. proc = start_process(
  2281. self.base_dir,
  2282. ['up', '--abort-on-container-exit', '--exit-code-from', 'another']
  2283. )
  2284. result = wait_on_process(proc, returncode=1)
  2285. assert 'exit-code-from_another_1 exited with code 1' in result.stdout
  2286. def test_exit_code_from_signal_stop(self):
  2287. self.base_dir = 'tests/fixtures/exit-code-from'
  2288. proc = start_process(
  2289. self.base_dir,
  2290. ['up', '--abort-on-container-exit', '--exit-code-from', 'simple']
  2291. )
  2292. result = wait_on_process(proc, returncode=137) # SIGKILL
  2293. name = self.project.get_service('another').containers(stopped=True)[0].name_without_project
  2294. assert '{} exited with code 1'.format(name) in result.stdout
  2295. def test_images(self):
  2296. self.project.get_service('simple').create_container()
  2297. result = self.dispatch(['images'])
  2298. assert 'busybox' in result.stdout
  2299. assert 'simple-composefile_simple_' in result.stdout
  2300. def test_images_default_composefile(self):
  2301. self.base_dir = 'tests/fixtures/multiple-composefiles'
  2302. self.dispatch(['up', '-d'])
  2303. result = self.dispatch(['images'])
  2304. assert 'busybox' in result.stdout
  2305. assert 'multiple-composefiles_another_1' in result.stdout
  2306. assert 'multiple-composefiles_simple_1' in result.stdout
  2307. @mock.patch.dict(os.environ)
  2308. def test_images_tagless_image(self):
  2309. self.base_dir = 'tests/fixtures/tagless-image'
  2310. stream = self.client.build(self.base_dir, decode=True)
  2311. img_id = None
  2312. for data in stream:
  2313. if 'aux' in data:
  2314. img_id = data['aux']['ID']
  2315. break
  2316. if 'stream' in data and 'Successfully built' in data['stream']:
  2317. img_id = self.client.inspect_image(data['stream'].split(' ')[2].strip())['Id']
  2318. assert img_id
  2319. os.environ['IMAGE_ID'] = img_id
  2320. self.project.get_service('foo').create_container()
  2321. result = self.dispatch(['images'])
  2322. assert '<none>' in result.stdout
  2323. assert 'tagless-image_foo_1' in result.stdout
  2324. def test_up_with_override_yaml(self):
  2325. self.base_dir = 'tests/fixtures/override-yaml-files'
  2326. self._project = get_project(self.base_dir, [])
  2327. self.dispatch(['up', '-d'], None)
  2328. containers = self.project.containers()
  2329. assert len(containers) == 2
  2330. web, db = containers
  2331. assert web.human_readable_command == 'sleep 100'
  2332. assert db.human_readable_command == 'top'
  2333. def test_up_with_duplicate_override_yaml_files(self):
  2334. self.base_dir = 'tests/fixtures/duplicate-override-yaml-files'
  2335. with pytest.raises(DuplicateOverrideFileFound):
  2336. get_project(self.base_dir, [])
  2337. self.base_dir = None
  2338. def test_images_use_service_tag(self):
  2339. pull_busybox(self.client)
  2340. self.base_dir = 'tests/fixtures/images-service-tag'
  2341. self.dispatch(['up', '-d', '--build'])
  2342. result = self.dispatch(['images'])
  2343. assert re.search(r'foo1.+test[ \t]+dev', result.stdout) is not None
  2344. assert re.search(r'foo2.+test[ \t]+prod', result.stdout) is not None
  2345. assert re.search(r'foo3.+_foo3[ \t]+latest', result.stdout) is not None