Ubuntu Environment Setup Guide for Apache Kogito¶

This guide provides step-by-step instructions for setting up your development environment for Apache Kogito on Ubuntu. The setup includes Docker, Java 17, Maven, and Visual Studio Code.

Docker Installation¶

1. Remove Conflicting Packages¶

First, remove any old or conflicting Docker installations to ensure a clean setup:

sudo apt remove docker docker-engine docker.io containerd runc

2. Install Prerequisites¶

Install necessary packages to allow apt to use repositories over HTTPS:

sudo apt install -y \
 apt-transport-https \
 ca-certificates \
 curl \
 gnupg \
 lsb-release

3. Set Up Docker Repository¶

Add Docker's official GPG key to ensure package authenticity:

curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg

Add the stable Docker repository to APT sources:

echo \
 "deb [arch=amd64 signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/ubuntu \
 $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

4. Install Docker Engine¶

Update package index and install the latest version of Docker Engine and containerd:

sudo apt update
sudo apt install -y docker-ce docker-ce-cli containerd.io

5. Configure Docker User Permissions¶

Add your user to the docker group to run Docker commands without sudo:

sudo usermod -aG docker $USER

6. Configure Docker Service¶

Start and enable the Docker service to run on system startup:

sudo systemctl start docker
sudo systemctl enable docker

Docker Compose Installation¶

1. Install Docker Compose¶

Download and install the latest stable version of Docker Compose:

sudo curl -L "https://github.com/docker/compose/releases/download/v2.24.5/docker-compose-linux-x86_64" -o /usr/local/bin/docker-compose

Make the binary executable:

sudo chmod +x /usr/local/bin/docker-compose

Verify the installation:

docker-compose --version

Visual Studio Code Installation¶

Install Visual Studio Code, a powerful IDE with excellent Docker and Java support. This benefit is only grown more within the Apache KIE Community with provided plugins to add to the power of the tool!

wget -qO- https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor > packages.microsoft.gpg
sudo install -D -o root -g root -m 644 packages.microsoft.gpg /etc/apt/keyrings/packages.microsoft.gpg
sudo sh -c 'echo "deb [arch=amd64,arm64,armhf signed-by=/etc/apt/keyrings/packages.microsoft.gpg] https://packages.microsoft.com/repos/code stable main" > /etc/apt/sources.list.d/vscode.list'
rm -f packages.microsoft.gpg
sudo apt update
sudo apt install -y code

Java Development Environment¶

1. Install OpenJDK 17¶

Install the Java Development Kit version 17:

sudo apt install -y openjdk-17-jdk
java --version

2. Install and Configure Maven¶

Download and install Apache Maven 3.9.7:

wget https://dlcdn.apache.org/maven/maven-3/3.9.7/binaries/apache-maven-3.9.7-bin.tar.gz

Extract Maven to the /opt directory:

sudo tar xf apache-maven-3.9.7-bin.tar.gz -C /opt

Create a symbolic link for easier version management:

sudo ln -s /opt/apache-maven-3.9.7 /opt/maven

Confirm the Java that you're using with:

sudo update-alternatives --list java

/usr/lib/jvm/java-17-openjdk-amd64/bin/java

Configure environment variables for Java and Maven in your ~/.bashrc:

export M2_HOME=/opt/maven
export PATH=${M2_HOME}/bin:${PATH}
export JAVA_HOME=/usr/lib/jvm/java-17-openjdk-amd64
export PATH=$JAVA_HOME/bin:$PATH

Load the new environment variables:

source ~/.bashrc

Verify Maven installation:

mvn -version

Next Steps¶

After completing this setup:

1. Log out and log back in for group changes to take effect
2. Test Docker installation by running: docker run hello-world
3. Install recommended VS Code extensions for Java and Docker development
4. Configure Maven settings if working with private repositories

Troubleshooting Tips¶

• If Docker commands fail, ensure your user is properly added to the docker group
• If Maven isn't recognized, verify the environment variables are properly set
• For VS Code extensions, ensure Java Extension Pack is installed for full Java support