Configuring Your Environment

aiSSEMBLE™ Tooling

The tools and configurations below are required to run aiSSEMBLE.

Build/Local Deployment Configurations

  • Java: JDK 17 (see the following discussion to choose between different JDKs)

  • Python: Python 3.11.4+ (we recommend using pyenv)

  • Build Process: Maven (see the Maven configuration page for detailed instructions)

  • Docker and Kubernetes:

    • Rancher Desktop supports both Docker and Kubernetes

    • It conveniently allows a Docker repository to be used for both, which saves time and disk space locally

  • Continuous Deployment: Tilt for local development

  • Source Code Management: git

Maven Build Cache

aiSSEMBLE supports use of the Maven Build Cache to accelerate your project’s development. Newly created aiSSEMBLE based projects are automatically configured to use the build cache.

Windows (WSL) Compatibility

Using aiSSEMBLE on Windows is only supported through Windows Subsystem for Linux (WSL). The following sections will guide you through configuring WSL.

Installing Ubuntu via Windows Subsystem for Linux v2

  1. Install Ubuntu via the Windows Subsystem for Linux v2

    • Utilizing PowerShell, execute the following commands:

      • wsl --install -d Ubuntu

      • wsl --set-version Ubuntu 2

Installing and Configuring Rancher Desktop

  1. Install Rancher Desktop.

  2. Run Rancher Desktop

  3. Select the newest stable version of Kubernetes.

  4. Choose dockerd (moby).

  5. In Rancher Desktop, select:

    1. File → Preferences → WSL

    2. Select the Ubuntu instance installed in the previous step.

Your WSL environment should be prepared now.

  • NOTE: you can access your Windows files in WSL at /mnt/<drive-letter>/<path>/<on>/<windows>

    • Example: /mnt/c/Users/MyUser/Downloads