Install the Azure Toolkit for Eclipse

The Azure Toolkit for Eclipse provides templates and functionality that allow you to easily create, develop, test, and deploy cloud applications to Azure from the Eclipse development environment.

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

The following steps show you how to install the Azure Toolkit for Eclipse.

Prerequisites

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

  • Eclipse IDE for Java EE Developers, Mars, or later. You can download it from the Eclipse website.

  • A supported Java Development Kit (JDK). For more information about the JDKs available for use when developing on Azure, see https://aka.ms/azure-jdks.

  • An operating system. The Azure Toolkit for Eclipse has been tested on the following operating systems:

    • Windows 10, Windows 8.1, Windows 8, and Windows 7
    • Windows Server 2012 R2, Windows Server 2012, Windows Server 2008 R2, and Windows Server 2008
    • Mac OS X version "Yosemite" and later
    • Ubuntu Linux version 14, 15, and 16

Note

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

To install the Azure Toolkit for Eclipse

  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

For more information about the Azure Toolkit for Eclipse, see the following links:

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