Version 3.5.0

docs/kathara.conf.5.ronn

@@ -83,6 +83,13 @@ Each Manager specifies additional parameters which are used only when the Manage
 
 	Default to `true`.
 
+* `image_update_policy` (string):
+    This parameter specifies the policy when a Docker image update is available for a running device.
+
+    Possible values are `Prompt`, `Always`, `Never`.
+
+    Default to `Prompt`.
+
 * `shared_cd` (boolean):
     This parameter allows to connect devices of different users to the same collision domains.
 
@@ -139,8 +146,9 @@ Each Manager specifies additional parameters which are used only when the Manage
             "last_checked": 1600087624.6843708,
             "hosthome_mount": false,
             "shared_mount": true,
+            "image_update_policy": "Prompt",
             "shared_cd": false,
-            "remote_url": "http://192.168.127.78:2375",
+            "remote_url": null,
             "cert_path": null
         }
 

src/Kathara/cli/ui/event/UpdateDockerImage.py

@@ -1,5 +1,6 @@
 from ...ui.utils import confirmation_prompt
 from ....manager.docker.DockerImage import DockerImage
+from ....setting.Setting import Setting
 
 
 class UpdateDockerImage(object):
@@ -16,8 +17,12 @@ def run(self, docker_image: DockerImage, image_name: str) -> None:
         Returns:
             None
         """
-        confirmation_prompt("A new version of image `%s` has been found on Docker Hub. "
-                            "Do you want to pull it?" % image_name,
-                            lambda: docker_image.pull(image_name),
-                            lambda: None
-                            )
+        policy = Setting.get_instance().image_update_policy
+        if policy == 'Prompt':
+            confirmation_prompt("A new version of image `%s` has been found on Docker Hub. "
+                                "Do you want to pull it?" % image_name,
+                                lambda: docker_image.pull(image_name),
+                                lambda: None
+                                )
+        elif policy == 'Always':
+            docker_image.pull(image_name)

src/Kathara/cli/ui/setting/DockerOptionsHandler.py

@@ -67,6 +67,39 @@ def add_items(self, current_menu: ConsoleMenu, menu_formatter: MenuFormatBuilder
 
         shared_item = SubmenuItem(shared_string, shared_menu, current_menu)
 
+        # Image Update Policy Option
+        image_update_policy_string = "Docker Image Update Policy"
+        image_update_policy_menu = SelectionMenu(strings=[],
+                                                 title=image_update_policy_string,
+                                                 subtitle=setting_utils.current_string("image_update_policy"),
+                                                 prologue_text="""Choose the policy when a Docker image update """
+                                                               """is available for a running device.             
+
+                                                               Default is %s.""" % DEFAULTS['image_update_policy'],
+                                                 formatter=menu_formatter
+                                                 )
+
+        image_update_policy_menu.append_item(FunctionItem(text="Prompt",
+                                                          function=setting_utils.update_setting_value,
+                                                          args=["image_update_policy", "Prompt"],
+                                                          should_exit=True
+                                                          )
+                                             )
+        image_update_policy_menu.append_item(FunctionItem(text="Always",
+                                                          function=setting_utils.update_setting_value,
+                                                          args=["image_update_policy", "Always"],
+                                                          should_exit=True
+                                                          )
+                                             )
+        image_update_policy_menu.append_item(FunctionItem(text="Never",
+                                                          function=setting_utils.update_setting_value,
+                                                          args=["image_update_policy", "Never"],
+                                                          should_exit=True
+                                                          )
+                                             )
+
+        image_update_policy_item = SubmenuItem(image_update_policy_string, image_update_policy_menu, current_menu)
+
         # Shared Links Option
         shared_cd_string = "Enable Shared Collision Domains between users"
         shared_cd_menu = SelectionMenu(strings=[],
@@ -102,7 +135,8 @@ def remote_url_unix():
                                             title=remote_url_string,
                                             subtitle=setting_utils.current_string("remote_url"),
                                             prologue_text="""You can specify a remote Docker Daemon URL.
-                                            Default is %s.""" % DEFAULTS['remote_url'],
+
+                                                          Default is %s.""" % DEFAULTS['remote_url'],
                                             formatter=menu_formatter
                                             )
 
@@ -126,8 +160,10 @@ def remote_url_unix():
             cert_path_menu = SelectionMenu(strings=[],
                                            title=cert_path_string,
                                            subtitle=setting_utils.current_string("cert_path"),
-                                           prologue_text="""When using a remote Docker Daemon, a TLS Cert could be required.
-                                           Default is %s.""" % DEFAULTS['cert_path'],
+                                           prologue_text="""When using a remote Docker Daemon, a TLS Cert could be """
+                                                         """required.
+
+                                                            Default is %s.""" % DEFAULTS['cert_path'],
                                            formatter=menu_formatter
                                            )
 
@@ -164,6 +200,7 @@ def remote_url_unix():
 
         current_menu.append_item(hosthome_item)
         current_menu.append_item(shared_item)
+        current_menu.append_item(image_update_policy_item)
         current_menu.append_item(shared_cd_item)
         if remote_url_item:
             current_menu.append_item(remote_url_item)

src/Kathara/setting/addon/DockerSettingsAddon.py

@@ -5,18 +5,20 @@
 DEFAULTS = {
     "hosthome_mount": False,
     "shared_mount": True,
+    "image_update_policy": "Prompt",
     "shared_cd": False,
     "remote_url": None,
     "cert_path": None
 }
 
 
 class DockerSettingsAddon(SettingsAddon):
-    __slots__ = ['hosthome_mount', 'shared_mount', 'shared_cd', 'remote_url', 'cert_path']
+    __slots__ = ['hosthome_mount', 'shared_mount', 'image_update_policy', 'shared_cd', 'remote_url', 'cert_path']
 
     def __init__(self) -> None:
         self.hosthome_mount: bool = False
         self.shared_mount: bool = True
+        self.image_update_policy: str = 'Prompt'
         self.shared_cd: bool = False
         self.remote_url: Optional[str] = None
         self.cert_path: Optional[str] = None
@@ -25,6 +27,7 @@ def _to_dict(self) -> Dict[str, Any]:
         return {
             'hosthome_mount': self.hosthome_mount,
             'shared_mount': self.shared_mount,
+            'image_update_policy': self.image_update_policy,
             'shared_cd': self.shared_cd,
             'remote_url': self.remote_url,
             'cert_path': self.cert_path