Microclimate Developer Tools for Eclipse

• Marketplace
• Documentation
• Slack

You can use Microclimate Developer Tools for Eclipse to develop your Microclimate projects from within Eclipse. Use the tools to access Microclimate features in the comfort of your IDE.

How to install

Complete the following steps to install Microclimate Developer Tools 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 for Microclimate Developer Tools for Eclipse is 4.8 (Photon).
2. Install and start a local instance of Microclimate version 18.12 or later.
3. Install the Microclimate Developer Tools from Eclipse Marketplace.

How to use

• Create a new connection to Microclimate:
  • From the File menu select New > Other > Microclimate > New Microclimate Connection
  • Fill in the host (only localhost is supported) and port (usually 9090)
  • Click the Test Connection and then click Finish
• This should open the Microclimate Explorer view with the connection expanded to show your projects. If it does not open the view then open it manually:
  • From the Window menu select Show View > Other > Microclimate > Microclimate Explorer
  • Click Open
• Right click on the connection to see the available actions for connections
• Right click on a project to see the available actions for projects

Features

• View all Microclimate projects for a connection including the application and build status
• Import your Microclimate project into the Eclipse workspace
• Debug Microprofile/Java EE and Spring applications
• View application and build logs in the Console view
• Integrate Microclimate validation errors into the Markers view
• Open a shell session into a Microclimate application container
• Toggle the project auto build setting and manually initiate project builds
• Open your application and the application monitor in a browser

For more information see the documentation

Contributing

We welcome issues and contributions. For more information, see CONTRIBUTING.md.

Enabling Debug Logs

1. Create a file called .options in your Eclipse install directory (the same directory with the eclipse executable) with the following content:

com.ibm.microclimate.core/debug/info=true

2. Launch eclipse with the -debug flag.
3. The logs are written to the Eclipse workspace directory, to .metadata/.log.

Building

1. Clone the repository to your system.

   git clone https://github.com/microclimate-dev2ops/microclimate-eclipse-tools

2. [Optional] Copy 'microclimate-eclipse-tools' folder to 'build' to get a test build. This will keep your source folder intact.

3. Run a gradle build.

   cd build/dev

   ./gradlew

4. Test the driver built from Step. 3

   build/dev/ant_build/artifacts/microclimate-eclipse-tools-[Version].vYYYYMMDD_hhmm.zip

Builds

• Nightly builds
• Release builds

License

EPL 2.0

Dependencies

Dependency	License
socket.io-client-1.0.0.jar	MIT
engine.io-client-1.0.0.jar	MIT
json-20090211.jar	The JSON License
okhttp-3.8.1.jar	Apache 2.0
okio-1.13.0.jar	Apache 2.0