config_test.py 28 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836
  1. import mock
  2. import os
  3. import shutil
  4. import tempfile
  5. from .. import unittest
  6. from compose.config import config
  7. def make_service_dict(name, service_dict, working_dir):
  8. """
  9. Test helper function to contruct a ServiceLoader
  10. """
  11. return config.ServiceLoader(working_dir=working_dir).make_service_dict(name, service_dict)
  12. class ConfigTest(unittest.TestCase):
  13. def test_load(self):
  14. service_dicts = config.load(
  15. config.ConfigDetails(
  16. {
  17. 'foo': {'image': 'busybox'},
  18. 'bar': {'image': 'busybox', 'environment': ['FOO=1']},
  19. },
  20. 'tests/fixtures/extends',
  21. 'common.yml'
  22. )
  23. )
  24. self.assertEqual(
  25. sorted(service_dicts, key=lambda d: d['name']),
  26. sorted([
  27. {
  28. 'name': 'bar',
  29. 'image': 'busybox',
  30. 'environment': {'FOO': '1'},
  31. },
  32. {
  33. 'name': 'foo',
  34. 'image': 'busybox',
  35. }
  36. ], key=lambda d: d['name'])
  37. )
  38. def test_load_throws_error_when_not_dict(self):
  39. with self.assertRaises(config.ConfigurationError):
  40. config.load(
  41. config.ConfigDetails(
  42. {'web': 'busybox:latest'},
  43. 'working_dir',
  44. 'filename.yml'
  45. )
  46. )
  47. def test_config_validation(self):
  48. self.assertRaises(
  49. config.ConfigurationError,
  50. lambda: make_service_dict('foo', {'port': ['8000']}, 'tests/')
  51. )
  52. make_service_dict('foo', {'ports': ['8000']}, 'tests/')
  53. def test_config_invalid_service_names(self):
  54. with self.assertRaises(config.ConfigurationError):
  55. for invalid_name in ['?not?allowed', ' ', '', '!', '/', '\xe2']:
  56. config.load(
  57. config.ConfigDetails(
  58. {invalid_name: {'image': 'busybox'}},
  59. 'working_dir',
  60. 'filename.yml'
  61. )
  62. )
  63. def test_config_valid_service_names(self):
  64. for valid_name in ['_', '-', '.__.', '_what-up.', 'what_.up----', 'whatup']:
  65. config.load(
  66. config.ConfigDetails(
  67. {valid_name: {'image': 'busybox'}},
  68. 'tests/fixtures/extends',
  69. 'common.yml'
  70. )
  71. )
  72. def test_config_invalid_ports_format_validation(self):
  73. with self.assertRaises(config.ConfigurationError):
  74. for invalid_ports in [{"1": "8000"}, "whatport"]:
  75. config.load(
  76. config.ConfigDetails(
  77. {'web': {'image': 'busybox', 'ports': invalid_ports}},
  78. 'working_dir',
  79. 'filename.yml'
  80. )
  81. )
  82. def test_config_valid_ports_format_validation(self):
  83. valid_ports = [["8000", "9000"], "625", "8000:8050", ["8000/8050"]]
  84. for ports in valid_ports:
  85. config.load(
  86. config.ConfigDetails(
  87. {'web': {'image': 'busybox', 'ports': ports}},
  88. 'working_dir',
  89. 'filename.yml'
  90. )
  91. )
  92. class InterpolationTest(unittest.TestCase):
  93. @mock.patch.dict(os.environ)
  94. def test_config_file_with_environment_variable(self):
  95. os.environ.update(
  96. IMAGE="busybox",
  97. HOST_PORT="80",
  98. LABEL_VALUE="myvalue",
  99. )
  100. service_dicts = config.load(
  101. config.find('tests/fixtures/environment-interpolation', None),
  102. )
  103. self.assertEqual(service_dicts, [
  104. {
  105. 'name': 'web',
  106. 'image': 'busybox',
  107. 'ports': ['80:8000'],
  108. 'labels': {'mylabel': 'myvalue'},
  109. 'hostname': 'host-',
  110. 'command': '${ESCAPED}',
  111. }
  112. ])
  113. @mock.patch.dict(os.environ)
  114. def test_invalid_interpolation(self):
  115. with self.assertRaises(config.ConfigurationError) as cm:
  116. config.load(
  117. config.ConfigDetails(
  118. {'web': {'image': '${'}},
  119. 'working_dir',
  120. 'filename.yml'
  121. )
  122. )
  123. self.assertIn('Invalid', cm.exception.msg)
  124. self.assertIn('for "image" option', cm.exception.msg)
  125. self.assertIn('in service "web"', cm.exception.msg)
  126. self.assertIn('"${"', cm.exception.msg)
  127. @mock.patch.dict(os.environ)
  128. def test_volume_binding_with_environment_variable(self):
  129. os.environ['VOLUME_PATH'] = '/host/path'
  130. d = config.load(
  131. config.ConfigDetails(
  132. config={'foo': {'volumes': ['${VOLUME_PATH}:/container/path']}},
  133. working_dir='.',
  134. filename=None,
  135. )
  136. )[0]
  137. self.assertEqual(d['volumes'], ['/host/path:/container/path'])
  138. @mock.patch.dict(os.environ)
  139. def test_volume_binding_with_home(self):
  140. os.environ['HOME'] = '/home/user'
  141. d = make_service_dict('foo', {'volumes': ['~:/container/path']}, working_dir='.')
  142. self.assertEqual(d['volumes'], ['/home/user:/container/path'])
  143. def test_named_volume_with_driver_does_not_expand(self):
  144. d = make_service_dict('foo', {
  145. 'volumes': ['namedvolume:/data'],
  146. 'volume_driver': 'foodriver',
  147. }, working_dir='.')
  148. self.assertEqual(d['volumes'], ['namedvolume:/data'])
  149. @mock.patch.dict(os.environ)
  150. def test_home_directory_with_driver_does_not_expand(self):
  151. os.environ['NAME'] = 'surprise!'
  152. d = make_service_dict('foo', {
  153. 'volumes': ['~:/data'],
  154. 'volume_driver': 'foodriver',
  155. }, working_dir='.')
  156. self.assertEqual(d['volumes'], ['~:/data'])
  157. class MergePathMappingTest(object):
  158. def config_name(self):
  159. return ""
  160. def test_empty(self):
  161. service_dict = config.merge_service_dicts({}, {})
  162. self.assertNotIn(self.config_name(), service_dict)
  163. def test_no_override(self):
  164. service_dict = config.merge_service_dicts(
  165. {self.config_name(): ['/foo:/code', '/data']},
  166. {},
  167. )
  168. self.assertEqual(set(service_dict[self.config_name()]), set(['/foo:/code', '/data']))
  169. def test_no_base(self):
  170. service_dict = config.merge_service_dicts(
  171. {},
  172. {self.config_name(): ['/bar:/code']},
  173. )
  174. self.assertEqual(set(service_dict[self.config_name()]), set(['/bar:/code']))
  175. def test_override_explicit_path(self):
  176. service_dict = config.merge_service_dicts(
  177. {self.config_name(): ['/foo:/code', '/data']},
  178. {self.config_name(): ['/bar:/code']},
  179. )
  180. self.assertEqual(set(service_dict[self.config_name()]), set(['/bar:/code', '/data']))
  181. def test_add_explicit_path(self):
  182. service_dict = config.merge_service_dicts(
  183. {self.config_name(): ['/foo:/code', '/data']},
  184. {self.config_name(): ['/bar:/code', '/quux:/data']},
  185. )
  186. self.assertEqual(set(service_dict[self.config_name()]), set(['/bar:/code', '/quux:/data']))
  187. def test_remove_explicit_path(self):
  188. service_dict = config.merge_service_dicts(
  189. {self.config_name(): ['/foo:/code', '/quux:/data']},
  190. {self.config_name(): ['/bar:/code', '/data']},
  191. )
  192. self.assertEqual(set(service_dict[self.config_name()]), set(['/bar:/code', '/data']))
  193. class MergeVolumesTest(unittest.TestCase, MergePathMappingTest):
  194. def config_name(self):
  195. return 'volumes'
  196. class MergeDevicesTest(unittest.TestCase, MergePathMappingTest):
  197. def config_name(self):
  198. return 'devices'
  199. class BuildOrImageMergeTest(unittest.TestCase):
  200. def test_merge_build_or_image_no_override(self):
  201. self.assertEqual(
  202. config.merge_service_dicts({'build': '.'}, {}),
  203. {'build': '.'},
  204. )
  205. self.assertEqual(
  206. config.merge_service_dicts({'image': 'redis'}, {}),
  207. {'image': 'redis'},
  208. )
  209. def test_merge_build_or_image_override_with_same(self):
  210. self.assertEqual(
  211. config.merge_service_dicts({'build': '.'}, {'build': './web'}),
  212. {'build': './web'},
  213. )
  214. self.assertEqual(
  215. config.merge_service_dicts({'image': 'redis'}, {'image': 'postgres'}),
  216. {'image': 'postgres'},
  217. )
  218. def test_merge_build_or_image_override_with_other(self):
  219. self.assertEqual(
  220. config.merge_service_dicts({'build': '.'}, {'image': 'redis'}),
  221. {'image': 'redis'}
  222. )
  223. self.assertEqual(
  224. config.merge_service_dicts({'image': 'redis'}, {'build': '.'}),
  225. {'build': '.'}
  226. )
  227. class MergeListsTest(unittest.TestCase):
  228. def test_empty(self):
  229. service_dict = config.merge_service_dicts({}, {})
  230. self.assertNotIn('ports', service_dict)
  231. def test_no_override(self):
  232. service_dict = config.merge_service_dicts(
  233. {'ports': ['10:8000', '9000']},
  234. {},
  235. )
  236. self.assertEqual(set(service_dict['ports']), set(['10:8000', '9000']))
  237. def test_no_base(self):
  238. service_dict = config.merge_service_dicts(
  239. {},
  240. {'ports': ['10:8000', '9000']},
  241. )
  242. self.assertEqual(set(service_dict['ports']), set(['10:8000', '9000']))
  243. def test_add_item(self):
  244. service_dict = config.merge_service_dicts(
  245. {'ports': ['10:8000', '9000']},
  246. {'ports': ['20:8000']},
  247. )
  248. self.assertEqual(set(service_dict['ports']), set(['10:8000', '9000', '20:8000']))
  249. class MergeStringsOrListsTest(unittest.TestCase):
  250. def test_no_override(self):
  251. service_dict = config.merge_service_dicts(
  252. {'dns': '8.8.8.8'},
  253. {},
  254. )
  255. self.assertEqual(set(service_dict['dns']), set(['8.8.8.8']))
  256. def test_no_base(self):
  257. service_dict = config.merge_service_dicts(
  258. {},
  259. {'dns': '8.8.8.8'},
  260. )
  261. self.assertEqual(set(service_dict['dns']), set(['8.8.8.8']))
  262. def test_add_string(self):
  263. service_dict = config.merge_service_dicts(
  264. {'dns': ['8.8.8.8']},
  265. {'dns': '9.9.9.9'},
  266. )
  267. self.assertEqual(set(service_dict['dns']), set(['8.8.8.8', '9.9.9.9']))
  268. def test_add_list(self):
  269. service_dict = config.merge_service_dicts(
  270. {'dns': '8.8.8.8'},
  271. {'dns': ['9.9.9.9']},
  272. )
  273. self.assertEqual(set(service_dict['dns']), set(['8.8.8.8', '9.9.9.9']))
  274. class MergeLabelsTest(unittest.TestCase):
  275. def test_empty(self):
  276. service_dict = config.merge_service_dicts({}, {})
  277. self.assertNotIn('labels', service_dict)
  278. def test_no_override(self):
  279. service_dict = config.merge_service_dicts(
  280. make_service_dict('foo', {'labels': ['foo=1', 'bar']}, 'tests/'),
  281. make_service_dict('foo', {}, 'tests/'),
  282. )
  283. self.assertEqual(service_dict['labels'], {'foo': '1', 'bar': ''})
  284. def test_no_base(self):
  285. service_dict = config.merge_service_dicts(
  286. make_service_dict('foo', {}, 'tests/'),
  287. make_service_dict('foo', {'labels': ['foo=2']}, 'tests/'),
  288. )
  289. self.assertEqual(service_dict['labels'], {'foo': '2'})
  290. def test_override_explicit_value(self):
  291. service_dict = config.merge_service_dicts(
  292. make_service_dict('foo', {'labels': ['foo=1', 'bar']}, 'tests/'),
  293. make_service_dict('foo', {'labels': ['foo=2']}, 'tests/'),
  294. )
  295. self.assertEqual(service_dict['labels'], {'foo': '2', 'bar': ''})
  296. def test_add_explicit_value(self):
  297. service_dict = config.merge_service_dicts(
  298. make_service_dict('foo', {'labels': ['foo=1', 'bar']}, 'tests/'),
  299. make_service_dict('foo', {'labels': ['bar=2']}, 'tests/'),
  300. )
  301. self.assertEqual(service_dict['labels'], {'foo': '1', 'bar': '2'})
  302. def test_remove_explicit_value(self):
  303. service_dict = config.merge_service_dicts(
  304. make_service_dict('foo', {'labels': ['foo=1', 'bar=2']}, 'tests/'),
  305. make_service_dict('foo', {'labels': ['bar']}, 'tests/'),
  306. )
  307. self.assertEqual(service_dict['labels'], {'foo': '1', 'bar': ''})
  308. class MemoryOptionsTest(unittest.TestCase):
  309. def test_validation_fails_with_just_memswap_limit(self):
  310. """
  311. When you set a 'memswap_limit' it is invalid config unless you also set
  312. a mem_limit
  313. """
  314. with self.assertRaisesRegexp(config.ConfigurationError, "u'mem_limit' is a dependency of u'memswap_limit'"):
  315. config.load(
  316. config.ConfigDetails(
  317. {
  318. 'foo': {'image': 'busybox', 'memswap_limit': 2000000},
  319. },
  320. 'tests/fixtures/extends',
  321. 'filename.yml'
  322. )
  323. )
  324. def test_validation_with_correct_memswap_values(self):
  325. service_dict = config.load(
  326. config.ConfigDetails(
  327. {'foo': {'image': 'busybox', 'mem_limit': 1000000, 'memswap_limit': 2000000}},
  328. 'tests/fixtures/extends',
  329. 'common.yml'
  330. )
  331. )
  332. self.assertEqual(service_dict[0]['memswap_limit'], 2000000)
  333. class EnvTest(unittest.TestCase):
  334. def test_parse_environment_as_list(self):
  335. environment = [
  336. 'NORMAL=F1',
  337. 'CONTAINS_EQUALS=F=2',
  338. 'TRAILING_EQUALS=',
  339. ]
  340. self.assertEqual(
  341. config.parse_environment(environment),
  342. {'NORMAL': 'F1', 'CONTAINS_EQUALS': 'F=2', 'TRAILING_EQUALS': ''},
  343. )
  344. def test_parse_environment_as_dict(self):
  345. environment = {
  346. 'NORMAL': 'F1',
  347. 'CONTAINS_EQUALS': 'F=2',
  348. 'TRAILING_EQUALS': None,
  349. }
  350. self.assertEqual(config.parse_environment(environment), environment)
  351. def test_parse_environment_invalid(self):
  352. with self.assertRaises(config.ConfigurationError):
  353. config.parse_environment('a=b')
  354. def test_parse_environment_empty(self):
  355. self.assertEqual(config.parse_environment(None), {})
  356. @mock.patch.dict(os.environ)
  357. def test_resolve_environment(self):
  358. os.environ['FILE_DEF'] = 'E1'
  359. os.environ['FILE_DEF_EMPTY'] = 'E2'
  360. os.environ['ENV_DEF'] = 'E3'
  361. service_dict = make_service_dict(
  362. 'foo', {
  363. 'environment': {
  364. 'FILE_DEF': 'F1',
  365. 'FILE_DEF_EMPTY': '',
  366. 'ENV_DEF': None,
  367. 'NO_DEF': None
  368. },
  369. },
  370. 'tests/'
  371. )
  372. self.assertEqual(
  373. service_dict['environment'],
  374. {'FILE_DEF': 'F1', 'FILE_DEF_EMPTY': '', 'ENV_DEF': 'E3', 'NO_DEF': ''},
  375. )
  376. def test_env_from_file(self):
  377. service_dict = make_service_dict(
  378. 'foo',
  379. {'env_file': 'one.env'},
  380. 'tests/fixtures/env',
  381. )
  382. self.assertEqual(
  383. service_dict['environment'],
  384. {'ONE': '2', 'TWO': '1', 'THREE': '3', 'FOO': 'bar'},
  385. )
  386. def test_env_from_multiple_files(self):
  387. service_dict = make_service_dict(
  388. 'foo',
  389. {'env_file': ['one.env', 'two.env']},
  390. 'tests/fixtures/env',
  391. )
  392. self.assertEqual(
  393. service_dict['environment'],
  394. {'ONE': '2', 'TWO': '1', 'THREE': '3', 'FOO': 'baz', 'DOO': 'dah'},
  395. )
  396. def test_env_nonexistent_file(self):
  397. options = {'env_file': 'nonexistent.env'}
  398. self.assertRaises(
  399. config.ConfigurationError,
  400. lambda: make_service_dict('foo', options, 'tests/fixtures/env'),
  401. )
  402. @mock.patch.dict(os.environ)
  403. def test_resolve_environment_from_file(self):
  404. os.environ['FILE_DEF'] = 'E1'
  405. os.environ['FILE_DEF_EMPTY'] = 'E2'
  406. os.environ['ENV_DEF'] = 'E3'
  407. service_dict = make_service_dict(
  408. 'foo',
  409. {'env_file': 'resolve.env'},
  410. 'tests/fixtures/env',
  411. )
  412. self.assertEqual(
  413. service_dict['environment'],
  414. {'FILE_DEF': 'F1', 'FILE_DEF_EMPTY': '', 'ENV_DEF': 'E3', 'NO_DEF': ''},
  415. )
  416. @mock.patch.dict(os.environ)
  417. def test_resolve_path(self):
  418. os.environ['HOSTENV'] = '/tmp'
  419. os.environ['CONTAINERENV'] = '/host/tmp'
  420. service_dict = config.load(
  421. config.ConfigDetails(
  422. config={'foo': {'volumes': ['$HOSTENV:$CONTAINERENV']}},
  423. working_dir="tests/fixtures/env",
  424. filename=None,
  425. )
  426. )[0]
  427. self.assertEqual(set(service_dict['volumes']), set(['/tmp:/host/tmp']))
  428. service_dict = config.load(
  429. config.ConfigDetails(
  430. config={'foo': {'volumes': ['/opt${HOSTENV}:/opt${CONTAINERENV}']}},
  431. working_dir="tests/fixtures/env",
  432. filename=None,
  433. )
  434. )[0]
  435. self.assertEqual(set(service_dict['volumes']), set(['/opt/tmp:/opt/host/tmp']))
  436. def load_from_filename(filename):
  437. return config.load(config.find('.', filename))
  438. class ExtendsTest(unittest.TestCase):
  439. def test_extends(self):
  440. service_dicts = load_from_filename('tests/fixtures/extends/docker-compose.yml')
  441. service_dicts = sorted(
  442. service_dicts,
  443. key=lambda sd: sd['name'],
  444. )
  445. self.assertEqual(service_dicts, [
  446. {
  447. 'name': 'mydb',
  448. 'image': 'busybox',
  449. 'command': 'top',
  450. },
  451. {
  452. 'name': 'myweb',
  453. 'image': 'busybox',
  454. 'command': 'top',
  455. 'links': ['mydb:db'],
  456. 'environment': {
  457. "FOO": "1",
  458. "BAR": "2",
  459. "BAZ": "2",
  460. },
  461. }
  462. ])
  463. def test_nested(self):
  464. service_dicts = load_from_filename('tests/fixtures/extends/nested.yml')
  465. self.assertEqual(service_dicts, [
  466. {
  467. 'name': 'myweb',
  468. 'image': 'busybox',
  469. 'command': '/bin/true',
  470. 'environment': {
  471. "FOO": "2",
  472. "BAR": "2",
  473. },
  474. },
  475. ])
  476. def test_self_referencing_file(self):
  477. """
  478. We specify a 'file' key that is the filename we're already in.
  479. """
  480. service_dicts = load_from_filename('tests/fixtures/extends/specify-file-as-self.yml')
  481. self.assertEqual(service_dicts, [
  482. {
  483. 'environment':
  484. {
  485. 'YEP': '1', 'BAR': '1', 'BAZ': '3'
  486. },
  487. 'image': 'busybox',
  488. 'name': 'myweb'
  489. },
  490. {
  491. 'environment':
  492. {'YEP': '1'},
  493. 'image': 'busybox',
  494. 'name': 'otherweb'
  495. },
  496. {
  497. 'environment':
  498. {'YEP': '1', 'BAZ': '3'},
  499. 'image': 'busybox',
  500. 'name': 'web'
  501. }
  502. ])
  503. def test_circular(self):
  504. try:
  505. load_from_filename('tests/fixtures/extends/circle-1.yml')
  506. raise Exception("Expected config.CircularReference to be raised")
  507. except config.CircularReference as e:
  508. self.assertEqual(
  509. [(os.path.basename(filename), service_name) for (filename, service_name) in e.trail],
  510. [
  511. ('circle-1.yml', 'web'),
  512. ('circle-2.yml', 'web'),
  513. ('circle-1.yml', 'web'),
  514. ],
  515. )
  516. def test_extends_validation_empty_dictionary(self):
  517. with self.assertRaisesRegexp(config.ConfigurationError, 'service'):
  518. config.load(
  519. config.ConfigDetails(
  520. {
  521. 'web': {'image': 'busybox', 'extends': {}},
  522. },
  523. 'tests/fixtures/extends',
  524. 'filename.yml'
  525. )
  526. )
  527. def test_extends_validation_missing_service_key(self):
  528. with self.assertRaisesRegexp(config.ConfigurationError, "u'service' is a required property"):
  529. config.load(
  530. config.ConfigDetails(
  531. {
  532. 'web': {'image': 'busybox', 'extends': {'file': 'common.yml'}},
  533. },
  534. 'tests/fixtures/extends',
  535. 'filename.yml'
  536. )
  537. )
  538. def test_extends_validation_invalid_key(self):
  539. with self.assertRaisesRegexp(config.ConfigurationError, "'rogue_key' was unexpected"):
  540. config.load(
  541. config.ConfigDetails(
  542. {
  543. 'web': {
  544. 'image': 'busybox',
  545. 'extends': {
  546. 'file': 'common.yml',
  547. 'service': 'web',
  548. 'rogue_key': 'is not allowed'
  549. }
  550. },
  551. },
  552. 'tests/fixtures/extends',
  553. 'filename.yml'
  554. )
  555. )
  556. def test_extends_validation_no_file_key_no_filename_set(self):
  557. dictionary = {'extends': {'service': 'web'}}
  558. def load_config():
  559. return make_service_dict('myweb', dictionary, working_dir='tests/fixtures/extends')
  560. self.assertRaisesRegexp(config.ConfigurationError, 'file', load_config)
  561. def test_extends_validation_valid_config(self):
  562. service = config.load(
  563. config.ConfigDetails(
  564. {
  565. 'web': {'image': 'busybox', 'extends': {'service': 'web', 'file': 'common.yml'}},
  566. },
  567. 'tests/fixtures/extends',
  568. 'common.yml'
  569. )
  570. )
  571. self.assertEquals(len(service), 1)
  572. self.assertIsInstance(service[0], dict)
  573. def test_extends_file_defaults_to_self(self):
  574. """
  575. Test not specifying a file in our extends options that the
  576. config is valid and correctly extends from itself.
  577. """
  578. service_dicts = load_from_filename('tests/fixtures/extends/no-file-specified.yml')
  579. self.assertEqual(service_dicts, [
  580. {
  581. 'name': 'myweb',
  582. 'image': 'busybox',
  583. 'environment': {
  584. "BAR": "1",
  585. "BAZ": "3",
  586. }
  587. },
  588. {
  589. 'name': 'web',
  590. 'image': 'busybox',
  591. 'environment': {
  592. "BAZ": "3",
  593. }
  594. }
  595. ])
  596. def test_blacklisted_options(self):
  597. def load_config():
  598. return make_service_dict('myweb', {
  599. 'extends': {
  600. 'file': 'whatever',
  601. 'service': 'web',
  602. }
  603. }, '.')
  604. with self.assertRaisesRegexp(config.ConfigurationError, 'links'):
  605. other_config = {'web': {'links': ['db']}}
  606. with mock.patch.object(config, 'load_yaml', return_value=other_config):
  607. print load_config()
  608. with self.assertRaisesRegexp(config.ConfigurationError, 'volumes_from'):
  609. other_config = {'web': {'volumes_from': ['db']}}
  610. with mock.patch.object(config, 'load_yaml', return_value=other_config):
  611. print load_config()
  612. with self.assertRaisesRegexp(config.ConfigurationError, 'net'):
  613. other_config = {'web': {'net': 'container:db'}}
  614. with mock.patch.object(config, 'load_yaml', return_value=other_config):
  615. print load_config()
  616. other_config = {'web': {'net': 'host'}}
  617. with mock.patch.object(config, 'load_yaml', return_value=other_config):
  618. print load_config()
  619. def test_volume_path(self):
  620. dicts = load_from_filename('tests/fixtures/volume-path/docker-compose.yml')
  621. paths = [
  622. '%s:/foo' % os.path.abspath('tests/fixtures/volume-path/common/foo'),
  623. '%s:/bar' % os.path.abspath('tests/fixtures/volume-path/bar'),
  624. ]
  625. self.assertEqual(set(dicts[0]['volumes']), set(paths))
  626. def test_parent_build_path_dne(self):
  627. child = load_from_filename('tests/fixtures/extends/nonexistent-path-child.yml')
  628. self.assertEqual(child, [
  629. {
  630. 'name': 'dnechild',
  631. 'image': 'busybox',
  632. 'command': '/bin/true',
  633. 'environment': {
  634. "FOO": "1",
  635. "BAR": "2",
  636. },
  637. },
  638. ])
  639. class BuildPathTest(unittest.TestCase):
  640. def setUp(self):
  641. self.abs_context_path = os.path.join(os.getcwd(), 'tests/fixtures/build-ctx')
  642. def test_nonexistent_path(self):
  643. with self.assertRaises(config.ConfigurationError):
  644. config.load(
  645. config.ConfigDetails(
  646. {
  647. 'foo': {'build': 'nonexistent.path'},
  648. },
  649. 'working_dir',
  650. 'filename.yml'
  651. )
  652. )
  653. def test_relative_path(self):
  654. relative_build_path = '../build-ctx/'
  655. service_dict = make_service_dict(
  656. 'relpath',
  657. {'build': relative_build_path},
  658. working_dir='tests/fixtures/build-path'
  659. )
  660. self.assertEquals(service_dict['build'], self.abs_context_path)
  661. def test_absolute_path(self):
  662. service_dict = make_service_dict(
  663. 'abspath',
  664. {'build': self.abs_context_path},
  665. working_dir='tests/fixtures/build-path'
  666. )
  667. self.assertEquals(service_dict['build'], self.abs_context_path)
  668. def test_from_file(self):
  669. service_dict = load_from_filename('tests/fixtures/build-path/docker-compose.yml')
  670. self.assertEquals(service_dict, [{'name': 'foo', 'build': self.abs_context_path}])
  671. class GetConfigPathTestCase(unittest.TestCase):
  672. files = [
  673. 'docker-compose.yml',
  674. 'docker-compose.yaml',
  675. 'fig.yml',
  676. 'fig.yaml',
  677. ]
  678. def test_get_config_path_default_file_in_basedir(self):
  679. files = self.files
  680. self.assertEqual('docker-compose.yml', get_config_filename_for_files(files[0:]))
  681. self.assertEqual('docker-compose.yaml', get_config_filename_for_files(files[1:]))
  682. self.assertEqual('fig.yml', get_config_filename_for_files(files[2:]))
  683. self.assertEqual('fig.yaml', get_config_filename_for_files(files[3:]))
  684. with self.assertRaises(config.ComposeFileNotFound):
  685. get_config_filename_for_files([])
  686. def test_get_config_path_default_file_in_parent_dir(self):
  687. """Test with files placed in the subdir"""
  688. files = self.files
  689. def get_config_in_subdir(files):
  690. return get_config_filename_for_files(files, subdir=True)
  691. self.assertEqual('docker-compose.yml', get_config_in_subdir(files[0:]))
  692. self.assertEqual('docker-compose.yaml', get_config_in_subdir(files[1:]))
  693. self.assertEqual('fig.yml', get_config_in_subdir(files[2:]))
  694. self.assertEqual('fig.yaml', get_config_in_subdir(files[3:]))
  695. with self.assertRaises(config.ComposeFileNotFound):
  696. get_config_in_subdir([])
  697. def get_config_filename_for_files(filenames, subdir=None):
  698. def make_files(dirname, filenames):
  699. for fname in filenames:
  700. with open(os.path.join(dirname, fname), 'w') as f:
  701. f.write('')
  702. project_dir = tempfile.mkdtemp()
  703. try:
  704. make_files(project_dir, filenames)
  705. if subdir:
  706. base_dir = tempfile.mkdtemp(dir=project_dir)
  707. else:
  708. base_dir = project_dir
  709. return os.path.basename(config.get_config_path(base_dir))
  710. finally:
  711. shutil.rmtree(project_dir)