Installing the Azure Toolkit for Eclipse

There are two ways to install Azure Toolkit for Eclipse:

Note

The Azure Toolkit for Eclipse is an Open Source project, whose source code is available under the MIT License from the project's site on GitHub at the following URL:

https://github.com/microsoft/azure-tools-for-java

Prerequisites

To complete the steps in this article, you will need to install the Azure Toolkit for Eclipse, which requires the following software components:

Note

The Azure Toolkit for Eclipse page at the Eclipse Marketplace lists the builds that are compatible with the toolkit.

Eclipse marketplace

  1. Drag the following button to your running Eclipse workspace.

    Drag to your running Eclipse* workspace. *Requires Eclipse Marketplace Client

  2. Otherwise, it is also possible to search and install the Azure Toolkit for Eclipse plugin at Help/Eclipse Marketplace.

    Marketplace

Install new software

  1. Start Eclipse.

  2. Click the Help menu, and then click Install New Software, as shown in the following illustration.

    Installing the Azure Toolkit for Eclipse

  3. In the Available Software dialog, within the Work with text box, type http://dl.microsoft.com/eclipse/ followed by the Enter key.

  4. In the Name pane, check Azure Toolkit for Java, and uncheck Contact all update sites during install to find required software. Your screen should appear similar to the following:

    Installing the Azure Toolkit for Eclipse

  5. If you expand Azure Toolkit for Eclipse, you will see a list of components that will be installed; for example:

    Feature Description
    Application Insights Plugin for Java Allows you to use Azure's telemetry logging and analysis services for your applications and server instances.
    Azure Common Plugin provides the common functionality needed by other toolkit components.
    Azure Container Tools for Eclipse Enables you to build and deploy a .WAR as a Docker container to a docker machine.
    Azure Containers for Eclipse Enables you to deploy a .WAR or .JAR artifact as a Docker container to an Azure virtual machine.
    Azure Explorer for Eclipse Provides an explorer-style interface for managing your Azure resources.
    Microsoft JDBC Driver 6.1 for SQL Server Provides JDBC API for SQL Server and Microsoft Azure SQL Database for Java Platform Enterprise Edition 8.
    Package for Microsoft Azure Libraries for Java Provides APIs for accessing Microsoft Azure services, such as storage, service bus, service runtime, etc.
  6. Click Next. (If you experience unusual delays when installing the toolkit, ensure that Contact all update sites during install to find required software is unchecked.)

  7. In the Install Details dialog, click Next.

    Review Installation Details

  8. In the Review Licenses dialog, review the terms of the license agreements. If you accept the terms of the license agreements, click I accept the terms of the license agreements and then click Finish. (The remaining steps assume you do accept the terms of the license agreements. If you do not accept the terms of the license agreements, exit the installation process.)

    Review Licenses

    Eclipse will download and install the requisite packages.

    Installation Progress

  9. If prompted to restart Eclipse to complete installation, click Yes.

    Restart Prompt

Next steps

To report bugs or request new features, create issues on our GitHub repository. Or, ask questions on Stack Overflow with tag azure-java-tools.

For more information about using Java with Azure, see the following links: