Публикация приложения Spring Boot в виде контейнера Docker с помощью набора средств Azure для EclipsePublish a Spring Boot app as a Docker container by using the Azure Toolkit for Eclipse

Spring Framework — это решение с открытым исходным кодом, которое помогает разработчикам Java создавать приложения корпоративного класса.The Spring Framework is an open-source solution that helps Java developers create enterprise-level applications. Одним из самых популярных проектов, созданных на этой платформе, является проект Spring Boot. Он упрощает подход к созданию автономных приложений Java.One of the more-popular projects that is built on top of that platform is Spring Boot, which provides a simplified approach for creating standalone Java applications.

Docker — это решение с открытым исходным кодом, которое помогает разработчикам автоматизировать развертывание приложений, их масштабирование, а также управление приложениями, которые выполняются в контейнерах.Docker is an open-source solution that helps developers automate the deployment, scaling, and management of their applications that are running in containers.

В данном руководстве описывается процесс развертывания приложения Spring Boot в качестве контейнера Docker в Microsoft Azure с помощью набора средств Azure для Eclipse.This tutorial walks you through the steps to deploy a Spring Boot application as a Docker container to Microsoft Azure by using the Azure Toolkit for Eclipse.

Предварительные требованияPrerequisites

Для выполнения описанных в статье шагов необходимо установить набор средств Azure для Eclipse. Для этого требуются следующие компоненты:To complete the steps in his article, you will need to install the Azure Toolkit for Eclipse, which requires the following software components:

  • Интегрированная среда разработки Eclipse для разработчиков Java EE, версия Mars или выше.Eclipse IDE for Java EE Developers, Mars, or later. Его можно скачать с веб-сайта Eclipse.You can download it from the Eclipse website.

  • Поддерживаемая версия Java Development Kit (JDK).A supported Java Development Kit (JDK). Дополнительные сведения о версиях JDK, доступных для разработки в Azure, см. в статье https://aka.ms/azure-jdks.For more information about the JDKs available for use when developing on Azure, see https://aka.ms/azure-jdks.

  • Операционная система.An operating system. Набор средств Azure для Eclipse проверен в следующих операционных системах:The Azure Toolkit for Eclipse has been tested on the following operating systems:

    • Windows 10, Windows 8.1, Windows 8 и Windows 7;Windows 10, Windows 8.1, Windows 8, and Windows 7
    • Windows Server 2012 R2, Windows Server 2012, Windows Server 2008 R2 и Windows Server 2008;Windows Server 2012 R2, Windows Server 2012, Windows Server 2008 R2, and Windows Server 2008
    • Mac OS X версии Yosemite и выше;Mac OS X version "Yosemite" and later
    • Ubuntu Linux версии 14, 15 и 16.Ubuntu Linux version 14, 15, and 16

Примечание

На сайте Eclipse Marketplace на странице Azure Toolkit for Eclipse приведен список сборок, совместимых с набором средств.The Azure Toolkit for Eclipse page at the Eclipse Marketplace lists the builds that are compatible with the toolkit.

Клонирование репозитория по умолчанию приложения Docker Spring BootClone the default Spring Boot Docker repository

Импорт общедоступного репозиторияImport the public repository

Ниже рассмотрена процедура клонирования репозитория приложения Docker Spring Boot на локальный компьютер с помощью IntelliJ.The following steps walk you through cloning the Spring Boot Docker repository to your local computer by using IntelliJ. Процесс использования командной строки см. в разделе Развертывание приложения Spring Boot в Linux в службе контейнеров Azure.If you want to use a command line, see Deploy a Spring Boot application on Linux in Azure Container Service.

  1. Откройте Eclipse.Open Eclipse.

  2. Последовательно выберите Файл > Импортировать.Click File > Import.

    Меню "File" (Файл) > "Import" (Импортировать)

  3. Когда откроется диалоговое окно Import (Импорт), сделайте следующее.When the Import dialog box opens:

    a.a. Разверните элемент Git.Expand Git.

    b.b. Выберите Projects from Git (Проекты из Git).Select Projects from Git.

    c.c. Щелкните Далее.Click Next.

    Диалоговое окно "Import" (Импорт)

  4. На странице Select Repository Source (Выбор источника репозитория) сделайте следующее.On the Select Repository Source page:

    a.a. Выберите Клонировать URI.Select Clone URI.

    b.b. Щелкните Далее.Click Next.

    Страница "Выбор источника репозитория"

  5. На странице Source Git Repository (Исходный репозиторий Git) сделайте следующее.On the Source Git Repository page:

    a.a. В поле URI введите https://github.com/spring-guides/gs-spring-boot-docker.git.For URI, enter https://github.com/spring-guides/gs-spring-boot-docker.git. Поля Host (Узел) и Repository path (Путь к репозиторию) должны автоматически заполниться правильными значениями.This step should automatically populate the Host and Repository path fields with the correct values.

    b.b. Репозиторий Spring Boot является общедоступным, поэтому нет необходимости вводить имя пользователя и пароль Git.The Spring Boot repository is public, so you should not have to enter your Git username and password.

    c.c. Щелкните Далее.Click Next.

    Страница "Исходный репозиторий Git"

  6. На странице Branch Selection (Выбор ветви) нажмите кнопку Next (Далее).On the Branch Selection page, click Next.

    Страница "Выбор ветви"

  7. На странице Local Destination (Локальное назначение) сделайте следующее.On the Local Destination page:

    a.a. Укажите локальную папку, в которой должен находиться локальный репозиторий.Specify the local folder where you want your local repo.

    b.b. Щелкните Далее.Click Next.

    Страница "Локальное назначение"

  8. На странице Select a wizard to use for importing projects (Выбор мастера для импорта проектов) сделайте следующее.On the Select a wizard to use for importing projects page:

    a.a. Выберите Import as a general project (Импортировать как универсальный проект).Select Import as a general project.

    b.b. Щелкните Далее.Click Next.

    На страница "Выбор мастера для импорта проектов"

  9. На странице Import Projects (Импорт проектов) сделайте следующее.On the Import Projects page:

    a.a. Укажите имя проекта.Specify your project name.

    b.b. Нажмите кнопку ГотовоClick Finish.

    Страница "Импорт проектов"

  10. Если репозиторий успешно клонирован, вы увидите полный список файлов в Eclipse.When the repository is cloned successfully, you see all the files listed in Eclipse.

    Локальный репозиторий

Создание проекта Maven из локального репозиторияCreate a Maven project from your local repository

Репозиторий Docker Spring Boot содержит завершенный проект Maven, который будет использоваться в этом руководстве.The Spring Boot Docker repository contains a completed Maven project, which you will use for this tutorial.

  1. Последовательно выберите Файл > Импортировать.Click File > Import.

    Команда "Импортировать" в меню "Файл"

  2. Когда откроется диалоговое окно Import (Импорт), сделайте следующее.When the Import dialog box opens:

    a.a. Разверните элемент Maven.Expand Maven.

    b.b. Выберите Existing Maven Projects (Существующие проекты Maven).Select Existing Maven Projects.

    c.c. Щелкните Далее.Click Next.

    Диалоговое окно "Import" (Импорт)

  3. На странице Maven Projects (Проекты Maven) сделайте следующее.On the Maven Projects page:

    a.a. В поле Root Directory (Корневой каталог) укажите папку complete в локальном каталоге.For Root Directory, specify the complete folder in your local repository.

    b.b. Разверните раздел Advanced (Дополнительно) и введите пользовательское имя в поле Name template (Шаблон имени).Expand the Advanced section, and enter a custom name for Name template.

    c.c. Установите флажок для файла pom.xml в проекте.Select the box for the pom.xml file in the project.

    d.d. Нажмите кнопку ГотовоClick Finish.

    Страница "Проекты Maven"

  4. После успешного открытия проекта Maven в Eclipse появится второй проект.When the Maven project is opened successfully, you see a second project listed in Eclipse.

    Локальный проект Maven

Построение приложения Spring Boot с помощью MavenBuild your Spring Boot app by using Maven

  1. В обозревателе проектов Eclipse выберите проект Maven.In the Eclipse Project Explorer, select the Maven project.

  2. Последовательно выберите Запуск > Запуск от имени > Сборка Maven.Click Run > Run As > Maven build.

    Команды для выполнения в качестве сборки Maven

  3. После успешной сборки приложения в окне консоли отобразится состояние.When your application is successfully built, the console window shows the status.

    Успешное выполнение сборки Maven

Публикация веб-приложения в Azure с помощью контейнера DockerPublish your web app to Azure by using a Docker container

  1. В обозревателе проектов Eclipse выберите проект Maven.In the Eclipse Project Explorer, select the Maven project.

  2. Щелкните меню Azure Publish (Публикация) и выберите Publish as Docker container (Опубликовать как контейнер Docker).Click the Azure Publish menu, and then click Publish as Docker Container.

    Команда публикации в виде контейнера Docker

  3. Когда откроется диалоговое окно Deploy Docker Container on Azure (Развертывание контейнера Docker в Azure), сделайте следующее.When the Deploying Docker Container on Azure dialog box appears:

    a.a. Введите пользовательское имя образа Docker.Enter a custom Docker image name.

    b.b. В поле Artifact to deploy (Развертываемый артефакт) укажите путь к файлу gs-spring-boot-docker-0.1.0.jar, сборку которого вы только что выполнили.For Artifact to deploy, specify the path to the gs-spring-boot-docker-0.1.0.jar file you just built.

    Задание параметров Docker

    Отобразятся все существующие узлы Docker.Any existing Docker hosts are displayed.

  4. Если требуется выполнить развертывание на существующий узел, можно сразу перейти к шагу 5.If you choose to deploy to an existing host, you can skip to step 5. В противном случае, чтобы создать узел, выполните следующие действия.Otherwise, use the following steps to create a host:

    a.a. Щелкните Добавить.Click Add.

    Добавление нового узла Docker

    b.b. При появлении диалогового окна Создание узла Docker можно принять значения по умолчанию или задать пользовательские параметры для нового узла Docker.When the Create Docker Host dialog box appears, you can choose to accept the defaults, or you can specify any custom settings for your new Docker host. (Подробное описание различных параметров см. в статье Публикация веб-приложения в виде контейнера Docker с помощью набора средств Azure для IntelliJ.) Нажмите кнопку Next (Далее) после задания используемых параметров.(For detailed descriptions of the various settings, see Publish a web app as a Docker container by using the Azure Toolkit for IntelliJ.) Click Next when you have specified which settings to use.

    Задание параметров узла Docker

    c.c. Можно использовать для входа в систему существующие учетные данные, хранящиеся в Azure Key Vault, или ввести новые учетные данные для входа в Docker.You can choose to use existing login credentials from an Azure key vault, or you can choose to enter new Docker login credentials. После задания параметров нажмите кнопку Finish (Готово).Click Finish when you have specified your options.

    Задание учетных данных узла Docker

  5. Выберите узел Docker и нажмите кнопку Next (Далее).Select your Docker host, and then click Next.

    Выбор используемого узла Docker

  6. На последней странице диалогового окна Deploy Docker Container on Azure (Развертывание контейнера Docker в Azure) задайте следующие параметры.On the last page of the Deploying Docker Container on Azure dialog box, specify the following options:

    a.a. Можно указать пользовательское имя для контейнера, в котором будет размещаться контейнер Docker, или принять значение по умолчанию.You can choose to specify a custom name for the container that will host your Docker container, or you can accept the default.

    b.b. Для узла Docker укажите TCP-порты с помощью следующего синтаксиса: [внешний порт]:[внутренний порт].Enter the TCP ports for your docker host by using the following syntax: [external port]:[internal port]. Например, 80:8080 означает внешний порт "80" и внутренний порт Spring Boot по умолчанию "8080".For example, 80:8080 specifies an external port of 80 and the default internal Spring Boot port of 8080.

    После настройки внутреннего порта (например, с помощью файла application.yml) необходимо указать номер порта для обеспечения корректной маршрутизации в Azure.If you have customized your internal port (for example, by editing the application.yml file), you need to specify the port number for the correct routing to occur in Azure.

    c.c. После настройки этих параметров щелкните Finish (Готово).After you configure these options, click Finish.

    Развертывание контейнера Docker в Azure

  7. После завершения публикации набора средств Azure в журнале действий Azure будет отображаться состояние Опубликовано.When the Azure Toolkit has finished publishing, the Azure Activity Log displays Published for the status.

    Успешно развернутый узел Docker

Дополнительная информацияNext steps

Дополнительные материалы по Docker доступны на официальном веб-сайте Docker.For additional resources for Docker, see the official Docker website.

Сообщить об ошибке или запросить новые функции можно в нашем репозитории GitHub.To report bugs or request new features, create issues on our GitHub repository. Также можно задать вопросы на сайте Stack Overflow, пометив их тегом azure-java-tools.Or, ask questions on Stack Overflow with tag azure-java-tools.

Дополнительные сведения об использовании Java в Azure см. по следующим ссылкам:For more information about using Java with Azure, see the following links: