Краткое руководство. Запуск существующего приложения Azure Spring Cloud с помощью портала AzureQuickstart: Launch an existing Azure Spring Cloud application using the Azure portal

В этом кратком руководстве описано, как развернуть имеющееся приложение Spring Cloud в Azure.This quickstart shows you how to deploy an existing Spring Cloud application to Azure. Azure Spring Cloud позволяет легко выполнять приложения микрослужб Spring Cloud в Azure.Azure Spring Cloud enables you to easily run Spring Cloud based microservice applications on Azure.

Пример кода приложения, используемый в этом руководстве, можно найти в репозитории примеров GitHub.You can find the sample application code used in this tutorial in our GitHub samples repository. После завершения работы предоставленный пример приложения будет доступен в сети и готов к управлению с помощью портала Azure.When you're finished, the provided sample application will be accessible online and ready to be managed via the Azure portal.

Из этого руководства вы узнаете, как выполнить следующие задачи:Following this quickstart, you will learn how to:

  • подготовка экземпляра службы к работе;Provision a service instance
  • задание сервера конфигурации для экземпляра;Set a configuration server for an instance
  • локальное выполнение сборки приложения для микрослужб;Build a microservices application locally
  • развертывание каждой микрослужбы;Deploy each microservice
  • назначение общедоступной конечной точки для приложения.Assign public endpoint for your application

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

Примечание

Сейчас предоставляется общедоступная предварительная версия Azure Spring Cloud.Azure Spring Cloud is currently offered as a public preview. Предложения общедоступной предварительной версии позволяют клиентам экспериментировать с новыми функциями до официального выпуска.Public preview offerings allow customers to experiment with new features prior to their official release. Общедоступные предварительные версии функций и служб не предназначены для использования в рабочей среде.Public preview features and services are not meant for production use. Чтобы получить дополнительные сведения о поддержке на этапе использования предварительных версий, ознакомьтесь с разделом Вопросы и ответы или оформите запрос на поддержку.For more information about support during previews, please review our FAQ or file a Support request to learn more.

Совет

Azure Cloud Shell — это бесплатная интерактивная оболочка, с помощью которой можно выполнять действия, описанные в этой статье.The Azure Cloud Shell is a free interactive shell that you can use to run the steps in this article. Она содержит предварительно установленные общие инструменты Azure вместе с новейшими версиями Git, JDK, Maven и Azure CLI.It has common Azure tools preinstalled, including the latest versions of Git, JDK, Maven, and the Azure CLI. Если вы вошли в подписку Azure, запустите Azure Cloud Shell на сайте shell.azure.com.If you are logged in to your Azure subscription, launch your Azure Cloud Shell from shell.azure.com. Дополнительные сведения об Azure Cloud Shell см. в нашей документацииYou can learn more about Azure Cloud Shell by reading our documentation

Для работы с этим кратким руководством сделайте следующее:To complete this quickstart:

  1. установите Git;Install Git
  2. установите JDK версии 8;Install JDK 8
  3. установите Maven 3.0 или более поздней версии;Install Maven 3.0 or above
  4. установите Azure CLI (версии 2.0.67 или выше);Install the Azure CLI version 2.0.67 or higher
  5. Регистрация для получения подписки AzureSign up for an Azure subscription

Установка расширения Azure CLIInstall the Azure CLI extension

Установите расширение Azure Spring Cloud для Azure CLI с помощью следующей команды:Install the Azure Spring Cloud extension for the Azure CLI using the following command

az extension add --name spring-cloud

Подготовка экземпляра службы к работе на портале AzureProvision a service instance on the Azure portal

  1. На новой вкладке откройте портал Azure.In a new tab, open the Azure portal.

  2. В поле поиска сверху введите Azure Spring Cloud.From the top search box, search for Azure Spring Cloud.

  3. Выберите пункт Azure Spring Cloud в списке результатов.Select Azure Spring Cloud from the results.

Значок ASC

  1. На странице Azure Spring Cloud щелкните элемент + Добавить.On the Azure Spring Cloud page, click + Add.

Значок ASC

  1. Заполните форму на странице создания Azure Spring Cloud.Fill out the form on the Azure Spring Cloud Create page. Ознакомьтесь со следующими рекомендациями:Consider the following guidelines:

    • Подписка: Выберите подписку, на которую будет выставляться счет за этот ресурс.Subscription: Select the subscription you want to be billed for this resource. Убедитесь, что эта подписка добавлена в наш список разрешений для Azure Spring Cloud.Ensure that this subscription has been added to our allow-list for Azure Spring Cloud.
    • Группа ресурсов. Советуем создавать группы ресурсов для новых ресурсов.Resource group: Creating new resource groups for new resources is a best practice.
    • Сведения о службе или ее название. Укажите имя экземпляра службы.Service Details/Name: Specify the name of your service instance. Его длина должна быть от 4 до 32 знаков. Имя может содержать только строчные буквы, цифры и дефисы.The name must be between 4 and 32 characters long and can contain only lowercase letters, numbers, and hyphens. Первым символом в имени службы должна быть буква, а последним — буква или цифра.The first character of the service name must be a letter and the last character must be either a letter or a number.
    • Расположение. Выберите расположение для экземпляра службы.Location: Select the location for your service instance. В настоящее время поддерживаются следующие расположения: восточная часть США, западная часть США 2, Западная Европа и Юго-Восточная Азия.Currently supported locations include East US, West US 2, West Europe, and Southeast Asia.

    Начальная страница портала ASC

  2. Щелкните вкладку Diagnostic Setting (Параметр диагностики), чтобы открыть следующее диалоговое окно.Click the Diagnostic Setting tab to open the following dialog.

  3. Вы можете задать для параметра Включить журналы значение да или нет в соответствии со своими требованиями.You can set Enable logs to yes or no according to your requirements.

    Включение журналов

  4. Щелкните вкладку Трассировка.Click the Tracing tab.

  5. Вы можете задать для параметра Включить трассировку значение да или нет в соответствии со своими требованиями.You can set Enable tracing to yes or no according to your requirements. Если задаете для параметра Включить трассировку значение "да", также выберите существующую функцию Application Insights или создайте новую.If you set Enable tracing to yes, also select an existing application insight, or create a new one. Если не задать Application Insights, произойдет ошибка проверки.Without the Application Insights specification there will be a validation error.

    Трассировка

  6. Щелкните Проверка и создание.Click Review and create.

  7. Проверьте спецификации и щелкните Создать.Verify your specifications, and click Create.

Развертывание службы занимает около 5 минут.It takes about 5 minutes for the service to deploy. После развертывания появится страница Обзор для экземпляра службы.Once it is deployed, the Overview page for the service instance will appear.

Настройка сервера конфигурацииSet up your configuration server

  1. Перейдите на страницу Обзор службы и выберите Config Server (Сервер конфигурации).Go to the service Overview page and select Config Server.

  2. В разделе Репозиторий по умолчанию задайте для URI значение "https://github.com/Azure-Samples/piggymetrics-config".In the Default repository section, set URI to "https://github.com/Azure-Samples/piggymetrics-config".

  3. Щелкните Применить, чтобы сохранить изменения.Select Apply to save your changes.

    Снимок экрана, где отображается окно портала ASC

Создание и развертывание приложений микрослужбBuild and deploy microservice applications

  1. Откройте Azure Cloud Shell и клонируйте репозиторий с примером приложения на локальный компьютер.Open an Azure Cloud Shell and clone the sample app repository to your local machine. Перед клонированием приложения мы создадим на нем временный каталог source-code.Here, we first create a temporary directory called source-code before cloning the app.

    mkdir source-code
    cd source-code
    git clone https://github.com/Azure-Samples/piggymetrics
    
  2. Выполните сборку клонированного пакета.Build the cloned package.

    cd piggymetrics
    mvn clean package -DskipTests
    
  3. Назначьте имена группе ресурсов и службе.Assign names to your resource group and your service. Обязательно замените заполнители ниже именем группы ресурсов и именем службы, подготовленными ранее в этом учебнике.Be sure to substitute the placeholders below with the resource group name and service name that you provisioned earlier in this tutorial.

    az configure --defaults group=<resource group name>
    az configure --defaults spring-cloud=<service instance name>
    
  4. Создайте приложение gateway и выполните развертывание файла JAR.Create the gateway application and deploy the JAR file.

    az spring-cloud app create -n gateway
    az spring-cloud app deploy -n gateway --jar-path ./gateway/target/gateway.jar
    
  5. Следуя той же схеме, создайте приложения account-service и auth-service, и выполните развертывание их файлов JAR.Following the same pattern, create the account-service and auth-service applications and deploy their JAR files.

    az spring-cloud app create -n account-service
    az spring-cloud app deploy -n account-service --jar-path ./account-service/target/account-service.jar
    az spring-cloud app create -n auth-service
    az spring-cloud app deploy -n auth-service --jar-path ./auth-service/target/auth-service.jar
    
  6. Для завершения развертывания приложений потребуется несколько минут.It takes a few minutes to finish deploying the applications. Чтобы убедиться, что они развернуты, перейдите в колонку Приложения на портале Azure.To confirm that they have deployed, go to the Apps blade in the Azure portal. Вы увидите строку каждого из трех приложений.You should see a line each of the three applications.

Назначение общедоступной конечной точки шлюзуAssign a public endpoint to gateway

  1. В меню слева откройте вкладку Приложения.Open the Apps tab in the menu on the left.

  2. Выберите приложение gateway, чтобы отобразить страницу Обзор.Select the gateway application to show the Overview page.

  3. Выберите Назначить конечную точку, чтобы назначить общедоступную конечную точку шлюзу.Select Assign Endpoint to assign a public endpoint to gateway. Это может занять несколько минут.This can take a few minutes.

    Снимок экрана, где отображается окно портала ASC

  4. Введите назначенную общедоступную конечную точку (помеченный URL-адрес) в браузере, чтобы просмотреть работающее приложение.Enter the assigned public endpoint (labeled URL) into your browser to view your running application.

    Снимок экрана, где отображается окно портала ASC

Дальнейшие действияNext steps

Из этого руководства вы узнали, как выполнить следующие действия:In this quickstart, you learned how to:

  • подготовка экземпляра службы к работе;Provision a service instance
  • задание сервера конфигурации для экземпляра;Set a configuration server for an instance
  • локальное выполнение сборки приложения для микрослужб;Build a microservices application locally
  • развертывание каждой микрослужбы;Deploy each microservice
  • Назначение общедоступной конечной точки для шлюза приложенияAssign public endpoint for your application gateway

Дополнительные примеры доступны на GitHub: Примеры для Azure Spring Cloud.More samples are available on GitHub: Azure Spring Cloud Samples.