Icon

Executor Image Manager

<p><strong><em>For Executor/AP 5.5.3 and above, Business Hub 1.16.0 and above</em></strong></p><p>This workflow helps <strong>KNIME Administrators</strong> manage the <strong>Executor Image List</strong> on <strong>KNIME Business Hub</strong>.<br>It supports adding, modifying, deleting, and building custom executor images through an integrated guided process.</p><p>This workflow simplifies the creation and management of executor images by using the <strong>image builder</strong> and <strong>deletion services</strong> included with <strong>KNIME Business Hub 1.16</strong>.</p><p><strong><em>Define Action</em></strong></p><p>Select the action you want to perform to manage your execution images. You can:</p><ul><li><p><strong>Add or Modify Images:</strong><br>Add new or existing executor images from official KNIME releases.</p></li><li><p><strong>Delete Images:</strong><br>Remove images from the internal registry to free up disk space, or from the list of available images if they are not part of the internal registry.</p></li><li><p><strong>Build a Custom Image:</strong><br>Start from a standard KNIME image or upload your own custom Dockerfile.</p></li></ul><p>You can also define a <strong>custom set of properties</strong> for your executor, depending on the selected action.</p><p>When adding existing images, they are retrieved from the <strong>official KNIME public registry</strong> and added to your list of available images.<br>If these images require additional extensions not included in the standard versions, you should <strong>build your own custom image</strong> and store it in the internal or external registry.</p><p><strong><em>Build Custom Executor Images (previously Executor Image Builder)</em></strong><br>The guided process consists of five steps:</p><ol><li><p><strong>Setup Executor Version and Advanced Settings</strong><br>Define the base version and advanced properties of your new executor image.</p></li><li><p><strong>Extension Selection</strong><br>Scan spaces on your KNIME Business Hub instance to automatically identify and include the extensions required by your workflows.<br>Alternatively, manually select the extensions you wish to install.</p></li><li><p><strong>Integration Configuration</strong><br>Configure Python and R scripting environments and specify the required packages to include in the image.</p></li><li><p><strong>Preview and Download Dockerfile</strong><br>Review the generated Dockerfile and make manual adjustments before sending it to the image builder service.</p></li><li><p><strong>Build the Image</strong><br>The image builder service compiles the image, pushes it to the container registry, and returns the <strong>final image URL</strong>, which can be used to set up a new execution context.</p></li></ol><p><strong>Permissions:</strong></p><ul><li><p>Only <strong>Global Admins</strong> can add, modify, delete, build and publish images.</p></li></ul>

Executor Image Manager

Compatible with

• Business Hub 1.16 and above with Executor Versions 5.5.3 and above

• Analytics Platform Versions 5.5.3 and above with connection to a Business Hub 1.16 and above

2. Define Action

Define the action you want to perform to manage your execution images. You can:

  • Add/Modify new or existing images from official KNIME releases

  • Delete images from the registry to free up disk space

  • Build a custom image starting from a Standard KNIME Image or upload your own custom Dockerfile

You can also define a custom set of properties for your executor, depending on the selected action.

4a. Customize Standard KNIME Image

This section retrieves extensions from the available update sites that are not included in the selected KNIME Analytics Platform version and makes them available for installation. Optionally, it can scan spaces on your KNIME Business Hub instance to identify extensions required to run workflows within the selected spaces—these necessary extensions are then automatically added. You can also manually select which extensions to install.

4.2 Review Dockerfile

Review the final Dockerfile and do manual changes to ensure completeness before proceeding to download the Dockerfile.

4.3. Build executor Image

Those components starts the build and check the results.

4a.1 Integration Configuration

Configure the scripting languages Python and R and include the required packages to enhance your execution context.

1. Connection to the KNIME Hub

Only the global admin can build executor images, others can only generate Executor Image Dockerfiles and need to do the building step themselves. These Configuration Nodes allow you to create a data app deployment with a global admin application password that you can share with non-global-admins to use this data app. The application password cannot be retrieved from the deployment.

The default is "Use current Hub", which will authenticate the user that executes the data app against the KNIME Hub. A warning is shown, if this is not a global admin.

Maximum waiting time for building is defined here.

Default: 3 hours. Please adjust if you expect builds that take longer.

4b. Jump to the Direct Build

If you selected the option to build directly, the app will skip the previous steps and start from the review section.

5. Recursive execution

Endless loop to keep the app iterating

top: no extensions detectorbottom: extensions detector
CASE Switch Start
Hub URLdefault: "Current"
String Configuration
Initially empty feedback
Table Creator
Start the Build of the Executor
Send the feedback back
Recursive Loop End
If a Dockerfile is uploadedthe process starts from here
CASE Switch End
Zip Aware
Read update sites
Application Passworddefault: "Current"
Credentials Configuration
Recursive Loop Start
Merge Variables
extensions that come with the image
'Is Installed' flag
Configure Executor Image
extensions selected
HiLite Row Splitter
CASE Switch End
Poll until complete
Unpack xml
selected and detectedextensions
Concatenate
displaysany errors
Update Site Result
Configure Python and R
Prepare Dockerfile
shows any errors
Detect extensions
Port 1: Add/Modify/Delete Existing Image Port 2: Custom BuildPort 3: Build a custom Dockerfile
Checks
Check the Dockerfile
Extension Detector Settings
Select Extensions
ensure an active branch
Add - Edit - Delete

Nodes

Extensions

Links