Merge pull request #289 from KatharaFramework/develop

Kathará v3.7.5

.github/ISSUE_TEMPLATE/bug_report.yml

@@ -22,7 +22,7 @@ body:
     attributes:
       label: Kathará Version
       description: "Please provide the Kathará version you are using (`kathara -v`)."
-      placeholder: "3.7.4"
+      placeholder: "3.7.5"
     validations:
       required: true
   - type: textarea

SECURITY.md

@@ -6,7 +6,7 @@ We release patches for security vulnerabilities only for the last version:
 
 | Version | Supported Versions |
 |---------|--------------------|
-| 3.7.4   | :white_check_mark: |
+| 3.7.5   | :white_check_mark: |
 
 ## Reporting a Vulnerability
 

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "kathara"
-version = "3.7.4"
+version = "3.7.5"
 description = "A lightweight container-based network emulation tool."
 readme = "README.md"
 requires-python = ">=3.9"

scripts/Linux-Deb/Makefile

@@ -1,13 +1,13 @@
 #!/usr/bin/make -f
 
-VERSION=3.7.4
+VERSION=3.7.5
 DEBIAN_PACKAGE_VERSION=1
 LAUNCHPAD_NAME=user
 NO_BINARY_PACKAGES=pyroute2|pyuv|deepdiff
 
 .PHONY: allSigned docker-build-image prepare-deb-source unpack-deb-source clean-output-folder copy-debian-folder download-pip build-man build-deb-unsigned build-deb-signed ppa clean venv autocompletion
 
-allSigned: clean prepare-deb-source docker-signed_focal docker-signed_jammy
+allSigned: clean prepare-deb-source docker-signed_focal docker-signed_jammy docker-signed_noble
 
 docker-unsigned_%: clean prepare-deb-source docker-build-image_%
 	docker run -ti --rm -v `pwd`/../../:/opt/kathara kathara/linux-build-deb:$* /bin/bash -c \

scripts/Linux-Deb/debian/changelog

@@ -1,7 +1,7 @@
 kathara (__VERSION__-__DEBIAN_PACKAGE_VERSION____UBUNTU_VERSION__) __UBUNTU_VERSION__; urgency=low
 
-    * (Docker) Fix "rp_filter" on "eth0" that was causing startup errors on some distributions
-    * (Megalos) Fix watch methods while starting/stopping devices that were causing "lstart"/"lclean" to hang indefinitely
+    * (Docker) Fix "rp_filter" issue on all platforms and Docker versions
+    * (Docker) Fix Docker API objects reloading
     * Minor fixes
 
  -- Kathara Team <[email protected]>  __DATE__

scripts/Linux-Pkg/Makefile

@@ -1,6 +1,6 @@
 #!/usr/bin/make -f
 
-VERSION=3.7.4
+VERSION=3.7.5
 PACKAGE_VERSION=1
 AUR_NAME=user
 AUR_MAIL[email protected]

scripts/Linux-Pkg/pkginfo/kathara.changelog

@@ -1,6 +1,6 @@
 __DATE__ Kathara Team <******@kathara.org>
 
 * Release v__VERSION__
-    * (Docker) Fix "rp_filter" on "eth0" that was causing startup errors on some distributions
-    * (Megalos) Fix watch methods while starting/stopping devices that were causing "lstart"/"lclean" to hang indefinitely
+    * (Docker) Fix "rp_filter" issue on all platforms and Docker versions
+    * (Docker) Fix Docker API objects reloading
     * Minor fixes

scripts/Linux-Rpm/Makefile

@@ -1,6 +1,6 @@
 #!/usr/bin/make -f
 
-VERSION=3.7.4
+VERSION=3.7.5
 PACKAGE_VERSION=1
 
 .PHONY: all clean docker-build-image prepare-source prepare-man-pages prepare-bash-completion pack-source build

scripts/Linux-Rpm/rpm/kathara.spec

@@ -68,6 +68,6 @@ chmod g+s %{_libdir}/kathara/kathara
 
 %changelog
 *  __DATE__ Kathara Team <******@kathara.org> - __VERSION__-__PACKAGE_VERSION__
-- (Docker) Fix "rp_filter" on "eth0" that was causing startup errors on some distributions
-- (Megalos) Fix watch methods while starting/stopping devices that were causing "lstart"/"lclean" to hang indefinitely
+- (Docker) Fix "rp_filter" issue on all platforms and Docker versions
+- (Docker) Fix Docker API objects reloading
 - Minor fixes

scripts/OSX/Makefile

@@ -1,7 +1,7 @@
 #!/usr/bin/make -s
 
 PRODUCT=Kathara
-VERSION=3.7.4
+VERSION=3.7.5
 TARGET_DIRECTORY=Output
 APPLE_DEVELOPER_CERTIFICATE_ID=FakeID
 ROFF_DIR=../../docs/Roff

scripts/Windows/installer.iss

@@ -2,7 +2,7 @@
 ; SEE THE DOCUMENTATION FOR DETAILS ON CREATING INNO SETUP SCRIPT FILES!
 
 #define MyAppName "Kathara"
-#define MyAppVersion "3.7.4"
+#define MyAppVersion "3.7.5"
 #define MyAppPublisher "Kathara Team"
 #define MyAppURL "https://www.kathara.org"
 #define MyAppExeName "kathara.exe"

setup.cfg

@@ -1,6 +1,6 @@
 [metadata]
 name = kathara
-version = 3.7.4
+version = 3.7.5
 author = Kathara Framework
 author_email = [email protected]
 description = A lightweight container-based network emulation tool.

setup.py

@@ -7,13 +7,13 @@
     package_dir={'': 'src'},
     packages=find_packages('src'),
     py_modules=['kathara'],
-    version='3.7.4',
+    version='3.7.5',
     license='gpl-3.0',
     description='A lightweight container-based network emulation tool.',
     author='Kathara Framework',
     author_email='[email protected]',
     url='https://www.kathara.org',
-    download_url='https://github.com/KatharaFramework/Kathara/archive/refs/tags/3.7.4.tar.gz',
+    download_url='https://github.com/KatharaFramework/Kathara/archive/refs/tags/3.7.5.tar.gz',
     keywords=['NETWORK-EMULATION', 'CONTAINERS', 'NFV'],
     install_requires=[
         "binaryornot>=0.4.4",

src/Kathara/manager/docker/DockerMachine.py

@@ -11,6 +11,7 @@
 import docker.models.containers
 from docker import DockerClient
 from docker.errors import APIError
+from docker.utils import version_lt
 
 from .DockerImage import DockerImage
 from .stats.DockerMachineStats import DockerMachineStats
@@ -101,11 +102,11 @@
 
 class DockerMachine(object):
     """The class responsible for deploying Kathara devices as Docker container and interact with them."""
-    __slots__ = ['client', 'docker_image']
+    __slots__ = ['client', '_engine_version', 'docker_image']
 
     def __init__(self, client: DockerClient, docker_image: DockerImage) -> None:
         self.client: DockerClient = client
-
+        self._engine_version: str = client.version()['Version']
         self.docker_image: DockerImage = docker_image
 
     def deploy_machines(self, lab: Lab, selected_machines: Set[str] = None) -> None:
@@ -242,15 +243,8 @@ def create(self, machine: Machine) -> None:
 
         sysctl_first_interface = {}
         if first_machine_iface:
-            def sysctl_linux():
-                if utils.is_wsl_platform():
-                    return {RP_FILTER_NAMESPACE % "eth0": 0}
-                return {}
-
-            def sysctl_windows():
-                return {RP_FILTER_NAMESPACE % "eth0": 0}
-
-            sysctl_first_interface = utils.exec_by_platform(sysctl_linux, sysctl_windows, lambda: {})
+            if version_lt(self._engine_version, "26.0.0"):
+                sysctl_first_interface = {RP_FILTER_NAMESPACE % "eth0": 0}
 
         if machine.is_ipv6_enabled():
             sysctl_parameters["net.ipv6.conf.all.forwarding"] = 1
@@ -345,7 +339,6 @@ def connect_interface(machine: Machine, interface: Interface) -> None:
             DockerPluginError: If Kathara has been left in an inconsistent state.
             APIError: If the Docker APIs return an error.
         """
-        machine.api_object.reload()
         attached_networks = machine.api_object.attrs["NetworkSettings"]["Networks"]
 
         if interface.link.api_object.name not in attached_networks:
@@ -375,7 +368,6 @@ def disconnect_from_link(machine: Machine, link: Link) -> None:
         Returns:
             None
         """
-        machine.api_object.reload()
         attached_networks = machine.api_object.attrs["NetworkSettings"]["Networks"]
 
         if link.api_object.name in attached_networks:
@@ -472,6 +464,8 @@ def start(self, machine: Machine) -> None:
                             f"Please specify a valid shell for this device."
                             )
 
+        machine.api_object.reload()
+
     def undeploy(self, lab_hash: str, selected_machines: Set[str] = None) -> None:
         """Undeploy the devices contained in the network scenario defined by the lab_hash.
 

src/Kathara/manager/docker/DockerManager.py

@@ -155,7 +155,7 @@ def deploy_lab(self, lab: Lab, selected_machines: Set[str] = None) -> None:
 
     @privileged
     def connect_machine_to_link(self, machine: Machine, link: Link, mac_address: Optional[str] = None) -> None:
-        """Create a new interface and connect a Kathara device to a collision domain.
+        """Create a new interface on a running Kathara device and connect it to a collision domain.
 
         Args:
             machine (Kathara.model.Machine): A Kathara machine object.
@@ -174,7 +174,11 @@ def connect_machine_to_link(self, machine: Machine, link: Link, mac_address: Opt
         if not machine.lab:
             raise LabNotFoundError("Device `%s` is not associated to a network scenario." % machine.name)
 
-        if not machine.api_object or machine.api_object.status != "running":
+        if not machine.api_object:
+            raise MachineNotRunningError(machine.name)
+
+        machine.api_object.reload()
+        if machine.api_object.status != "running":
             raise MachineNotRunningError(machine.name)
 
         if not link.lab:
@@ -192,23 +196,31 @@ def connect_machine_to_link(self, machine: Machine, link: Link, mac_address: Opt
 
     @privileged
     def disconnect_machine_from_link(self, machine: Machine, link: Link) -> None:
-        """Disconnect a Kathara device from a collision domain.
+        """Disconnect a running Kathara device from a collision domain.
 
         Args:
             machine (Kathara.model.Machine): A Kathara machine object.
-            link (Kathara.model.Link): The Kathara collision domain from which disconnect the device.
+            link (Kathara.model.Link): The Kathara collision domain from which disconnect the running device.
 
         Returns:
             None
 
         Raises:
             LabNotFoundError: If the device specified is not associated to any network scenario.
+            MachineNotRunningError: If the specified device is not running.
             LabNotFoundError: If the collision domain is not associated to any network scenario.
             MachineCollisionDomainConflictError: If the device is not connected to the collision domain.
         """
         if not machine.lab:
             raise LabNotFoundError(f"Device `{machine.name}` is not associated to a network scenario.")
 
+        if not machine.api_object:
+            raise MachineNotRunningError(machine.name)
+
+        machine.api_object.reload()
+        if machine.api_object.status != "running":
+            raise MachineNotRunningError(machine.name)
+
         if not link.lab:
             raise LabNotFoundError(f"Collision domain `{link.name}` is not associated to a network scenario.")
 

src/Kathara/version.py

@@ -1,6 +1,6 @@
 from typing import Tuple
 
-CURRENT_VERSION = "3.7.4"
+CURRENT_VERSION = "3.7.5"
 
 
 def parse(version: str) -> Tuple: