mirror of https://github.com/docker/docs.git
log_driver and log_opt moved to logging key.
Signed-off-by: Dimitar Bonev <dimitar.bonev@gmail.com>
This commit is contained in:
parent
e7bba2affe
commit
ed5f7bd394
|
@ -51,8 +51,6 @@ DOCKER_CONFIG_KEYS = [
|
||||||
'ipc',
|
'ipc',
|
||||||
'labels',
|
'labels',
|
||||||
'links',
|
'links',
|
||||||
'log_driver',
|
|
||||||
'log_opt',
|
|
||||||
'mac_address',
|
'mac_address',
|
||||||
'mem_limit',
|
'mem_limit',
|
||||||
'memswap_limit',
|
'memswap_limit',
|
||||||
|
@ -78,6 +76,7 @@ ALLOWED_KEYS = DOCKER_CONFIG_KEYS + [
|
||||||
'dockerfile',
|
'dockerfile',
|
||||||
'expose',
|
'expose',
|
||||||
'external_links',
|
'external_links',
|
||||||
|
'logging',
|
||||||
]
|
]
|
||||||
|
|
||||||
DOCKER_VALID_URL_PREFIXES = (
|
DOCKER_VALID_URL_PREFIXES = (
|
||||||
|
|
|
@ -75,8 +75,15 @@
|
||||||
"labels": {"$ref": "#/definitions/list_or_dict"},
|
"labels": {"$ref": "#/definitions/list_or_dict"},
|
||||||
"links": {"type": "array", "items": {"type": "string"}, "uniqueItems": true},
|
"links": {"type": "array", "items": {"type": "string"}, "uniqueItems": true},
|
||||||
|
|
||||||
"log_driver": {"type": "string"},
|
"logging": {
|
||||||
"log_opt": {"type": "object"},
|
"type": "object",
|
||||||
|
|
||||||
|
"properties": {
|
||||||
|
"driver": {"type": "string"},
|
||||||
|
"options": {"type": "object"}
|
||||||
|
},
|
||||||
|
"additionalProperties": false
|
||||||
|
},
|
||||||
|
|
||||||
"mac_address": {"type": "string"},
|
"mac_address": {"type": "string"},
|
||||||
"mem_limit": {"type": ["number", "string"]},
|
"mem_limit": {"type": ["number", "string"]},
|
||||||
|
|
|
@ -510,6 +510,13 @@ class Service(object):
|
||||||
|
|
||||||
return volumes_from
|
return volumes_from
|
||||||
|
|
||||||
|
def get_logging_options(self):
|
||||||
|
logging_dict = self.options.get('logging', {})
|
||||||
|
return {
|
||||||
|
'log_driver': logging_dict.get('driver', ""),
|
||||||
|
'log_opt': logging_dict.get('options', None)
|
||||||
|
}
|
||||||
|
|
||||||
def _get_container_create_options(
|
def _get_container_create_options(
|
||||||
self,
|
self,
|
||||||
override_options,
|
override_options,
|
||||||
|
@ -523,6 +530,8 @@ class Service(object):
|
||||||
for k in DOCKER_CONFIG_KEYS if k in self.options)
|
for k in DOCKER_CONFIG_KEYS if k in self.options)
|
||||||
container_options.update(override_options)
|
container_options.update(override_options)
|
||||||
|
|
||||||
|
container_options.update(self.get_logging_options())
|
||||||
|
|
||||||
if self.custom_container_name() and not one_off:
|
if self.custom_container_name() and not one_off:
|
||||||
container_options['name'] = self.custom_container_name()
|
container_options['name'] = self.custom_container_name()
|
||||||
elif not container_options.get('name'):
|
elif not container_options.get('name'):
|
||||||
|
@ -590,10 +599,9 @@ class Service(object):
|
||||||
def _get_container_host_config(self, override_options, one_off=False):
|
def _get_container_host_config(self, override_options, one_off=False):
|
||||||
options = dict(self.options, **override_options)
|
options = dict(self.options, **override_options)
|
||||||
|
|
||||||
log_config = LogConfig(
|
logging_dict = options.get('logging', None)
|
||||||
type=options.get('log_driver', ""),
|
log_config = get_log_config(logging_dict)
|
||||||
config=options.get('log_opt', None)
|
|
||||||
)
|
|
||||||
return self.client.create_host_config(
|
return self.client.create_host_config(
|
||||||
links=self._get_links(link_to_self=one_off),
|
links=self._get_links(link_to_self=one_off),
|
||||||
port_bindings=build_port_bindings(options.get('ports') or []),
|
port_bindings=build_port_bindings(options.get('ports') or []),
|
||||||
|
@ -953,3 +961,12 @@ def build_ulimits(ulimit_config):
|
||||||
ulimits.append(ulimit_dict)
|
ulimits.append(ulimit_dict)
|
||||||
|
|
||||||
return ulimits
|
return ulimits
|
||||||
|
|
||||||
|
|
||||||
|
def get_log_config(logging_dict):
|
||||||
|
log_driver = logging_dict.get('driver', "") if logging_dict else ""
|
||||||
|
log_options = logging_dict.get('options', None) if logging_dict else None
|
||||||
|
return LogConfig(
|
||||||
|
type=log_driver,
|
||||||
|
config=log_options
|
||||||
|
)
|
||||||
|
|
|
@ -324,29 +324,37 @@ for this service, e.g:
|
||||||
Environment variables will also be created - see the [environment variable
|
Environment variables will also be created - see the [environment variable
|
||||||
reference](env.md) for details.
|
reference](env.md) for details.
|
||||||
|
|
||||||
### log_driver
|
### logging
|
||||||
|
|
||||||
Specify a logging driver for the service's containers, as with the ``--log-driver``
|
Logging configuration for the service. This configuration replaces the previous
|
||||||
option for docker run ([documented here](https://docs.docker.com/engine/reference/logging/overview/)).
|
`log_driver` and `log_opt` keys.
|
||||||
|
|
||||||
|
logging:
|
||||||
|
driver: log_driver
|
||||||
|
options:
|
||||||
|
syslog-address: "tcp://192.168.0.42:123"
|
||||||
|
|
||||||
|
The `driver` name specifies a logging driver for the service's
|
||||||
|
containers, as with the ``--log-driver`` option for docker run
|
||||||
|
([documented here](https://docs.docker.com/engine/reference/logging/overview/)).
|
||||||
|
|
||||||
The default value is json-file.
|
The default value is json-file.
|
||||||
|
|
||||||
log_driver: "json-file"
|
driver: "json-file"
|
||||||
log_driver: "syslog"
|
driver: "syslog"
|
||||||
log_driver: "none"
|
driver: "none"
|
||||||
|
|
||||||
> **Note:** Only the `json-file` driver makes the logs available directly from
|
> **Note:** Only the `json-file` driver makes the logs available directly from
|
||||||
> `docker-compose up` and `docker-compose logs`. Using any other driver will not
|
> `docker-compose up` and `docker-compose logs`. Using any other driver will not
|
||||||
> print any logs.
|
> print any logs.
|
||||||
|
|
||||||
### log_opt
|
Specify logging options for the logging driver with the ``options`` key, as with the ``--log-opt`` option for `docker run`.
|
||||||
|
|
||||||
Specify logging options with `log_opt` for the logging driver, as with the ``--log-opt`` option for `docker run`.
|
|
||||||
|
|
||||||
Logging options are key value pairs. An example of `syslog` options:
|
Logging options are key value pairs. An example of `syslog` options:
|
||||||
|
|
||||||
log_driver: "syslog"
|
driver: "syslog"
|
||||||
log_opt:
|
options:
|
||||||
syslog-address: "tcp://192.168.0.42:123"
|
syslog-address: "tcp://192.168.0.42:123"
|
||||||
|
|
||||||
### net
|
### net
|
||||||
|
|
|
@ -716,6 +716,43 @@ class CLITestCase(DockerClientTestCase):
|
||||||
result = self.dispatch(['start'], returncode=1)
|
result = self.dispatch(['start'], returncode=1)
|
||||||
assert 'No containers to start' in result.stderr
|
assert 'No containers to start' in result.stderr
|
||||||
|
|
||||||
|
def test_up_logging(self):
|
||||||
|
self.base_dir = 'tests/fixtures/logging-composefile'
|
||||||
|
self.dispatch(['up', '-d'])
|
||||||
|
simple = self.project.get_service('simple').containers()[0]
|
||||||
|
log_config = simple.get('HostConfig.LogConfig')
|
||||||
|
self.assertTrue(log_config)
|
||||||
|
self.assertEqual(log_config.get('Type'), 'none')
|
||||||
|
|
||||||
|
another = self.project.get_service('another').containers()[0]
|
||||||
|
log_config = another.get('HostConfig.LogConfig')
|
||||||
|
self.assertTrue(log_config)
|
||||||
|
self.assertEqual(log_config.get('Type'), 'json-file')
|
||||||
|
self.assertEqual(log_config.get('Config')['max-size'], '10m')
|
||||||
|
|
||||||
|
def test_up_logging_with_multiple_files(self):
|
||||||
|
self.base_dir = 'tests/fixtures/logging-composefile'
|
||||||
|
config_paths = [
|
||||||
|
'docker-compose.yml',
|
||||||
|
'compose2.yml',
|
||||||
|
]
|
||||||
|
self._project = get_project(self.base_dir, config_paths)
|
||||||
|
self.dispatch(
|
||||||
|
[
|
||||||
|
'-f', config_paths[0],
|
||||||
|
'-f', config_paths[1],
|
||||||
|
'up', '-d',
|
||||||
|
],
|
||||||
|
None)
|
||||||
|
|
||||||
|
containers = self.project.containers()
|
||||||
|
self.assertEqual(len(containers), 2)
|
||||||
|
|
||||||
|
another = self.project.get_service('another').containers()[0]
|
||||||
|
log_config = another.get('HostConfig.LogConfig')
|
||||||
|
self.assertTrue(log_config)
|
||||||
|
self.assertEqual(log_config.get('Type'), 'none')
|
||||||
|
|
||||||
def test_pause_unpause(self):
|
def test_pause_unpause(self):
|
||||||
self.dispatch(['up', '-d'], None)
|
self.dispatch(['up', '-d'], None)
|
||||||
service = self.project.get_service('simple')
|
service = self.project.get_service('simple')
|
||||||
|
|
|
@ -0,0 +1,3 @@
|
||||||
|
another:
|
||||||
|
logging:
|
||||||
|
driver: "none"
|
|
@ -0,0 +1,12 @@
|
||||||
|
simple:
|
||||||
|
image: busybox:latest
|
||||||
|
command: top
|
||||||
|
logging:
|
||||||
|
driver: "none"
|
||||||
|
another:
|
||||||
|
image: busybox:latest
|
||||||
|
command: top
|
||||||
|
logging:
|
||||||
|
driver: "json-file"
|
||||||
|
options:
|
||||||
|
max-size: "10m"
|
|
@ -888,7 +888,7 @@ class ServiceTest(DockerClientTestCase):
|
||||||
self.assertNotEqual(one_off_container.name, 'my-web-container')
|
self.assertNotEqual(one_off_container.name, 'my-web-container')
|
||||||
|
|
||||||
def test_log_drive_invalid(self):
|
def test_log_drive_invalid(self):
|
||||||
service = self.create_service('web', log_driver='xxx')
|
service = self.create_service('web', logging={'driver': 'xxx'})
|
||||||
expected_error_msg = "logger: no log driver named 'xxx' is registered"
|
expected_error_msg = "logger: no log driver named 'xxx' is registered"
|
||||||
|
|
||||||
with self.assertRaisesRegexp(APIError, expected_error_msg):
|
with self.assertRaisesRegexp(APIError, expected_error_msg):
|
||||||
|
@ -902,7 +902,7 @@ class ServiceTest(DockerClientTestCase):
|
||||||
self.assertFalse(log_config['Config'])
|
self.assertFalse(log_config['Config'])
|
||||||
|
|
||||||
def test_log_drive_none(self):
|
def test_log_drive_none(self):
|
||||||
service = self.create_service('web', log_driver='none')
|
service = self.create_service('web', logging={'driver': 'none'})
|
||||||
log_config = create_and_start_container(service).log_config
|
log_config = create_and_start_container(service).log_config
|
||||||
|
|
||||||
self.assertEqual('none', log_config['Type'])
|
self.assertEqual('none', log_config['Type'])
|
||||||
|
|
|
@ -156,7 +156,8 @@ class ServiceTest(unittest.TestCase):
|
||||||
self.mock_client.create_host_config.return_value = {}
|
self.mock_client.create_host_config.return_value = {}
|
||||||
|
|
||||||
log_opt = {'syslog-address': 'tcp://192.168.0.42:123'}
|
log_opt = {'syslog-address': 'tcp://192.168.0.42:123'}
|
||||||
service = Service(name='foo', image='foo', hostname='name', client=self.mock_client, log_driver='syslog', log_opt=log_opt)
|
logging = {'driver': 'syslog', 'options': log_opt}
|
||||||
|
service = Service(name='foo', image='foo', hostname='name', client=self.mock_client, logging=logging)
|
||||||
service._get_container_create_options({'some': 'overrides'}, 1)
|
service._get_container_create_options({'some': 'overrides'}, 1)
|
||||||
|
|
||||||
self.assertTrue(self.mock_client.create_host_config.called)
|
self.assertTrue(self.mock_client.create_host_config.called)
|
||||||
|
|
Loading…
Reference in New Issue