Merge pull request #328 from KatharaFramework/develop

Kathará v3.7.8

Author: tcaiazzi

.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.7"
+      placeholder: "3.7.8"
     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.7   | :white_check_mark: |
+| 3.7.8   | :white_check_mark: |
 
 ## Reporting a Vulnerability
 

docs/kathara-lab.conf.5.ronn

@@ -74,6 +74,12 @@ If `arg` is an option name, then `device` will be launched with option `arg` set
 * `num_terms` (integer):
 	Choose the number of terminals to open for this device.
 
+* `ulimit` (string):
+	Allows change of both soft and hard limits. The syntax is ULIMIT=SOFT:HARD.
+	Use -1 for unlimited. If only a parameter is given e.g. ULIMIT=VALUE both soft and hard limit will have same value.
+	For instance, with this command is possible to set memlock soft and hard limit to unlimited: `device[ulimit]="memlock=-1:-1`.
+
+
 ## NETWORK SCENARIO META INFORMATION
 
 It is also possible to provide descriptive information about a network scenario by using one of the following special assignments:

docs/kathara-linfo.1.ronn

@@ -4,7 +4,7 @@ kathara-linfo(1) -- Show information about a Kathara network scenario
 
 ## SYNOPSIS
 
-`kathara linfo` [`-h`] [`-d` <DIRECTORY>] [`-w` \| `-c`] [`-n` <DEVICE_NAME>]
+`kathara linfo` [`-h`] [`-d` <DIRECTORY>] [`-w` \| `-c`] [`-n` <DEVICE_NAME> \| `-t`]
 
 
 ## DESCRIPTION
@@ -43,6 +43,11 @@ The following information are displayed:
     * Number of devices that make up the network scenario
     * Number of networks that make up the network scenario
 
+* `-t`, `--topology`:
+    Display a mapping of devices attached to each collision domain. 
+
+    Can be used in conjunction with `-w` to retrieve live information.
+
 * `-n` <DEVICE_NAME>, `--name` <DEVICE_NAME>:
     Show only info about a specified device.
 

docs/kathara-vstart.1.ronn

@@ -8,10 +8,10 @@ kathara-vstart(1) -- Start a new Kathara device
 [`-h`] [`--noterminals` | `--terminals` | `--privileged` | `--num_terms` <NUM_TERMS>]  
 [`--eth` <N:CD[/MAC_ADDR]> [<N:CD[/MAC_ADDR]> ...]]  
 [`-e` [<EXEC_COMMANDS> [<EXEC_COMMANDS> ...]]] [`--mem` <MEM>]  
-[`--cpus` <CPUS>] [`-i` <IMAGE>] [`--no-hosthome` \| `--hosthome`]
+[`--cpus` <CPUS>] [`-i` <IMAGE>] [`--no-hosthome` \| `--hosthome`]  
 [`--xterm` <XTERM>] [`--print`] [`--bridged`]  
-[--port <[HOST\:]GUEST[/PROTOCOL]> [<[HOST\:]GUEST[/PROTOCOL]> ...]] [--env <ENV> [<ENV> ...]] [--sysctl <SYSCTL> [<SYSCTL> ...]]
-[`--shell` <SHELL>]  
+[`--port` <[HOST\:]GUEST[/PROTOCOL]> [<[HOST\:]GUEST[/PROTOCOL]> ...]] [`--env` <ENV> [<ENV> ...]] 
+[`--sysctl` <SYSCTL> [<SYSCTL> ...]] [`--ulimit` <KEY=SOFT[\:HARD]> [<KEY=SOFT[\:HARD]> ...]] [`--shell` <SHELL>]  
 
 ## DESCRIPTION
 
@@ -109,6 +109,12 @@ Notice: unless differently stated, command line arguments (DEVICE_NAME) and opti
 * `--env` <ENV> [<ENV> ...]:
     Set an environment variable for the device. The format is: ENV_NAME=ENV_VALUE.
 
+* `--ulimit` <KEY=SOFT[\:HARD]> [<KEY=SOFT[\:HARD]> ...]:
+    Set a ulimit for the device. 
+    
+    Allows change of both SOFT and HARD limits.
+	Use -1 for unlimited. If only a parameter is given, i.e. ULIMIT=SOFT, both SOFT and HARD limit will have same value.
+
 * `--num_terms` <NUM_TERMS>:
     Choose the number of terminals to open for the device.
 

docs/kathara.conf.5.ronn

@@ -137,6 +137,15 @@ Each Manager specifies additional parameters which are used only when the Manage
 
 	Default to `IfNotPresent`.
 
+* `docker_config_json` (string):
+	Base64-encoded `config.json` JSON that is used create a Kubernetes Secret of type `kubernetes.io/dockerconfigjson`.
+
+	From the `kathara settings` menu, the user provides a filesystem path where the file is located. Kathara automatically opens and parses the file and stores the base64-encoded string into this value.
+
+	Please refer to the [official Kubernetes page](https://kubernetes.io/docs/concepts/configuration/secret/#docker-config-secrets) for further details on Kubernetes Secrets.
+
+	Default to null.
+
 ## EXAMPLE
 
         {

pyproject.toml

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

scripts/Linux-Deb/Makefile

@@ -1,6 +1,6 @@
 #!/usr/bin/make -f
 
-VERSION=3.7.7
+VERSION=3.7.8
 DEBIAN_PACKAGE_VERSION=1
 LAUNCHPAD_NAME=user
 NO_BINARY_PACKAGES=pyroute2|pyuv|deepdiff

scripts/Linux-Deb/debian/changelog

@@ -1,6 +1,14 @@
 kathara (__VERSION__-__DEBIAN_PACKAGE_VERSION____UBUNTU_VERSION__) __UBUNTU_VERSION__; urgency=low
 
-    * Properly set driver options to disable/enable IPV6
-    * Minor fixes
+    * WARNING: "ltest" command is deprecated. It will be removed in the next release! Please use the "kathara-lab-checker" tool as its replacement with enhanced functionalities.
+    * Add "--topology" argument to "kathara linfo" that displays a list of collision domains and the devices connected to each of them
+    * "kathara linfo" now displays a column with the connected interfaces of each device
+    * "kathara exec" now returns the exact exit code of the command
+    * API Improvements in the "Lab" object
+    * (Docker) Fix "rp_filter" sysctl assigment on Docker Engine >= v27.0.0
+    * (Docker) Add the possibility to specify "ulimits" in network scenario metadata (thanks to g4br-i)
+    * (Docker) Fix compatibility with docker-io version numbers
+    * (Kubernetes) Add the support to private image registries through the "docker.json" file (thanks to Giovanni Barbiero)
+    * Minor bug fixes
 
- -- Kathara Team <[email protected]>  __DATE__
+ -- Kathara Team <[email protected]>  __DATE__

scripts/Linux-Pkg/Makefile

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