Installing the Azure Toolkit for Eclipse

The Azure Toolkit for Eclipse provides templates and functionality that allow you to easily create, develop, test, and deploy Azure applications using the Eclipse development environment. The Azure Toolkit for Eclipse is an Open Source project. The source code is available under the MIT License from https://github.com/microsoft/azure-tools-for-java.

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

Prerequisites

The Azure Toolkit for Eclipse requires the following software components:

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

  • A Java Developer Kit (JDK), version 1.8 or later.

  • 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

For more information, see the Azure Toolkit for Eclipse page at the Eclipse Marketplace.

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 Eclipse, 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 the Azure Toolkit for Eclipse, you will see a list of items like following example:

    • Application Insights Plugin for Java: This component allows you to use Azure's telemetry logging and analysis services for your applications and server instances.
    • Azure Access Control Services Filter: This component provides support for authenticating application users with Azure ACS, enabling single sign-on scenarios and externalizing identity logic from the application.
    • Azure Common Plugin: This component provides the common functionality needed by other toolkit components.
    • Azure Explorer for Eclipse: This component provides the common functionality needed by other toolkit components.
    • Azure Plugin for Eclipse with Java: This component provides support for developing projects that help build, test and deploy Java applications for the Microsoft Azure cloud in Eclipse and via command line.
    • Azure Web Apps Plugin with Java: This component provides support for deploying Java web applications to Microsoft Azure Web App containers.
    • Microsoft JDBC Driver 4.2 for SQL Server: This component provides JDBC API for SQL Server and Microsoft Azure SQL Database for Java Platform Enterprise Edition 8.
    • Package for Apache Qpid Client Libraries for JMS: This component provides the JMS client component from the Apache Qpid project to enable your application to use AMQP messaging in Microsoft Azure.
    • Package for Microsoft Azure Libraries for Java: This component 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 toolkits for Java IDEs, see the following links:

For more information about using Java with Azure, see the Azure Java Developer Center and the Java Tools for Visual Studio Team Services.