Getting started: Codewind for Eclipse

Codewind for Eclipse enables you to develop and debug your containerized projects from within Eclipse (debug is only supported for Microprofile/Java EE, Spring, and Node.js projects).

Complete the following steps to install Codewind for Eclipse:

  1. Download and install the latest Eclipse IDE for Java EE Developers or use an existing installation. The earliest supported version of the Eclipse IDE is Version 2019-03 (4.11).
  2. Install Codewind from Eclipse Marketplace.
    • Drag to your running Eclipse workspace. Drag this install button to your running Eclipse workspace. Note: You need to have the Eclipse Marketplace Client.
    • Or, if you want to install from the Eclipse IDE, complete the following steps:
      1. Open the Eclipse IDE and navigate to Help > Eclipse Marketplace.
      2. Search for Codewind.
      3. Click the Install button.
      4. Finish the wizard and accept licenses as needed.
      5. When the installation is complete, restart Eclipse.
  3. Open the Codewind view. Navigate to Window > Show View > Other… > Codewind > Codewind Explorer
  4. Codewind requires the installation of additional Docker images to run. Double-click on the Codewind item in the Codewind Explorer view to complete the installation. The installation may take a few minutes to complete.
  5. Codewind creates a folder called codewind-workspace within your home directory (C:\codewind-workspace on Windows) to contain your projects.

You are now ready to use the tools. You can use the Codewind Explorer view to create new projects or add existing ones. Right-click an element in the Codewind Explorer to look at the features available.

  1. Create a new project or work with an existing project.
    • To create a new Codewind project, right-click the Local Projects item and select New Project. If you create a new project from within Eclipse, the new project is imported into the Eclipse workspace for you.
      Create a new project
    • To work with an existing project, right-click the Local Projects item and select Add Existing Project. Note that the project must already exist within the codewind-workspace folder, and have been added to the Eclipse workspace.
      Import your project
  2. Work with your project from within Eclipse including:
    • Editing
    • Debugging
    • Opening the application in a browser
    • Viewing the logs
    • Opening a shell into the application container
    • And more
      Work with your project