Add support for tmpfs

docker/api/container.py

@@ -99,7 +99,7 @@ def create_container(self, image, command=None, hostname=None, user=None,
                          cpu_shares=None, working_dir=None, domainname=None,
                          memswap_limit=None, cpuset=None, host_config=None,
                          mac_address=None, labels=None, volume_driver=None,
-                         stop_signal=None, networking_config=None):
+                         stop_signal=None, networking_config=None, tmpfs=None):
 
         if isinstance(volumes, six.string_types):
             volumes = [volumes, ]
@@ -114,7 +114,7 @@ def create_container(self, image, command=None, hostname=None, user=None,
             tty, mem_limit, ports, environment, dns, volumes, volumes_from,
             network_disabled, entrypoint, cpu_shares, working_dir, domainname,
             memswap_limit, cpuset, host_config, mac_address, labels,
-            volume_driver, stop_signal, networking_config,
+            volume_driver, stop_signal, networking_config, tmpfs
         )
         return self.create_container_from_config(config, name)
 

docker/utils/utils.py

@@ -832,6 +832,7 @@ def create_container_config(
     entrypoint=None, cpu_shares=None, working_dir=None, domainname=None,
     memswap_limit=None, cpuset=None, host_config=None, mac_address=None,
     labels=None, volume_driver=None, stop_signal=None, networking_config=None,
+    tmpfs=None
 ):
     if isinstance(command, six.string_types):
         command = split_command(command)
@@ -852,6 +853,11 @@ def create_container_config(
             'stop_signal was only introduced in API version 1.21'
         )
 
+    if tmpfs is not None and compare_version('1.22', version) < 0:
+        raise errors.InvalidVersion(
+            'tmpfs was only introduced in API version 1.22'
+        )
+
     if compare_version('1.19', version) < 0:
         if volume_driver is not None:
             raise errors.InvalidVersion(
@@ -900,6 +906,15 @@ def create_container_config(
             volumes_dict[vol] = {}
         volumes = volumes_dict
 
+    if isinstance(tmpfs, six.string_types):
+        tmpfs = [tmpfs, ]
+
+    if isinstance(tmpfs, list):
+        tmpfs_dict = {}
+        for tmpdir in tmpfs:
+            tmpfs_dict[tmpdir] = ''
+        tmpfs = tmpfs_dict
+
     if volumes_from:
         if not isinstance(volumes_from, six.string_types):
             volumes_from = ','.join(volumes_from)
@@ -958,5 +973,6 @@ def create_container_config(
         'MacAddress': mac_address,
         'Labels': labels,
         'VolumeDriver': volume_driver,
-        'StopSignal': stop_signal
+        'StopSignal': stop_signal,
+        'Tmpfs': tmpfs
     }

docs/api.md

@@ -222,6 +222,7 @@ following format `["PASSWORD=xxx"]` or `{"PASSWORD": "xxx"}`.
 * volumes (str or list):
 * volumes_from (str or list): List of container names or Ids to get volumes
 from. Optionally a single string joining container id's with commas
+* tmpfs (str or list): Paths to mount tmpfs filesystems
 * network_disabled (bool): Disable networking
 * name (str): A name for the container
 * entrypoint (str or list): An entrypoint

tests/unit/container_test.py

@@ -225,6 +225,28 @@ def test_create_container_with_volume_string(self):
         self.assertEqual(args[1]['headers'],
                          {'Content-Type': 'application/json'})
 
+    @requires_api_version('1.22')
+    def test_create_container_with_tmpfs(self):
+        tmpfs_dest = '/tmpdir'
+
+        self.client.create_container('busybox', ['ls', tmpfs_dest],
+                                     tmpfs=tmpfs_dest)
+
+        args = fake_request.call_args
+        self.assertEqual(args[0][1],
+                         url_prefix + 'containers/create')
+        self.assertEqual(json.loads(args[1]['data']),
+                         json.loads('''
+                            {"Tty": false, "Image": "busybox",
+                             "Cmd": ["ls", "/tmpdir"], "AttachStdin": false,
+                             "Tmpfs": {"/tmpdir": ""},
+                             "AttachStderr": true,
+                             "AttachStdout": true, "OpenStdin": false,
+                             "StdinOnce": false,
+                             "NetworkDisabled": false}'''))
+        self.assertEqual(args[1]['headers'],
+                         {'Content-Type': 'application/json'})
+
     def test_create_container_with_ports(self):
         self.client.create_container('busybox', 'ls',
                                      ports=[1111, (2222, 'udp'), (3333,)])