Using Containers with Eclipse*

Install Eclipse

1. Prerequisite: ensure Java* JRE 8 or 11 is installed.
2. Download the latest Eclipse IDE for C/C++ Developers.
3. Download and install the Intel® oneAPI Base Toolkit in order to easily browse samples.

Use the Samples Browser to Create an Eclipse Project

If you have installed the Intel® oneAPI Base Toolkit, you can use the Samples Browser integrated into the Eclipse IDE to create a project based on Intel® samples.

Run Eclipse and select Intel > Browse Intel oneAPI Samples…

The Sample Browser dialog window will be displayed.

Expand the sample tree and select a sample. Click Finish to create a project based on the sample.

Configure Project Properties

1. Make sure you've followed the steps described on the Using Containers page to download the Docker image.
2. Open the Project Properties by right clicking Project > Properties.
3. In Properties select C/C++ Build > Settings, and open the Container Settings tab to set the following:
   • Configuration: Default [Active]
   • Connection: unix:///var/run/docker.sock
   • Image: intel/oneapi-hpckit:latest
   
   1. Check Build Inside Docker Image.
   2. Select the docker image to use. If there are no images listed, verify that Docker is enabled for non-root users. Alternatively, you can run Eclipse with sudo.
   3. Apply and close the settings.

Compile the Application

1. Click the Build Icon .
2. Confirm that the console prints "Running in image..."

Run Application

1. Create a Run Configuration with Run > Run Configurations.
2. Create a new C/C++ Container Launcher.
   
3. Select the Container tab and make sure the Image is set to the correct Docker image. To enable GPU in the container, add /dev/dri in the Required Host Directories and check Run in Privileged Mode.

   

4. To enable GPU in the container, select the Container tab and add /dev/dri as Required Host Directories, and check Run in Privileged Mode.
5. Click the Run icon.
6. Confirm that the console prints Running in image...