Быстрый старт: Создание приложения Java Spring с помощью Azure App Configuration

В этом кратком руководстве описано, как добавить службу "Конфигурация приложений Azure" в приложение Java Spring, чтобы обеспечить централизованное хранение параметров приложения и управление ими отдельно от кода.

Предварительные условия

Учетная запись Azure с активной подпиской. Создайте ее бесплатно.
Хранилище конфигурации приложений, как показано в руководстве по созданию хранилища.
Поддерживаемый пакет средств разработки Java (JDK) с версией 17.
Apache Maven версии 3.0 или более поздней.
Приложение Spring Boot. Если у вас его нет, создайте проект Maven, используя Spring Initializr. Обязательно выберите Проект Maven и в разделе "Зависимости" добавьте зависимость Spring Web , а затем выберите Java версии 17 или более поздней.

Добавьте ключ-значение

Добавьте следующее ключевое значение в хранилище Конфигурация приложений и оставьте метку и тип контента со значениями по умолчанию. Дополнительные сведения о добавлении значений ключей в хранилище с помощью портал Azure или ИНТЕРФЕЙСА командной строки см. в разделе "Создание значения ключа".

Ключ	Значение
/application/config.message	Привет

Подключение к хранилищу конфигурации приложений

Теперь, когда у вас есть хранилище App Configuration, вы можете использовать Spring Cloud Azure Config starter для интеграции вашего приложения с созданным вами хранилищем App Configuration.

Чтобы установить начальный модуль конфигурации Spring Cloud Azure, добавьте в файл pom.xml следующую зависимость:

<dependencies>
    ...
    <dependency>
        <groupId>com.azure.spring</groupId>
        <artifactId>spring-cloud-azure-appconfiguration-config-web</artifactId>
    </dependency>
</dependencies>

<dependencyManagement>
    <dependencies>
        <dependency>
        <groupId>com.azure.spring</groupId>
        <artifactId>spring-cloud-azure-dependencies</artifactId>
        <version>7.1.0</version>
        <type>pom</type>
        <scope>import</scope>
        </dependency>
    </dependencies>
</dependencyManagement>

По стандартным настройкам библиотека подключается к хранилищу конфигурации приложений, используя управляемую личность. Следуйте инструкциям, чтобы назначить вашим учетным данным роль Чтение данных конфигурации приложений. Перед запуском приложения обязательно предоставьте достаточно времени для распространения разрешения.

Замечание

Кроме того, вы можете использовать аутентификацию Spring Cloud Azure для предоставления сведений о проверке подлинности.
Создайте файл с именем application.properties в каталоге ресурсов приложения и добавьте в файл следующую строку.
```
spring.config.import=azureAppConfiguration
spring.cloud.azure.appconfiguration.stores[0].endpoint=${AZURE_APPCONFIG_ENDPOINT}
```

Чтение из хранилища настроек приложений

Чтобы использовать стартер Spring Cloud Azure Config, чтобы ваше приложение связалось с созданным хранилищем App Configuration, настройте приложение, выполните следующие действия.

Создайте файл Java с именем MyProperties.java и добавьте следующие строки:

import org.springframework.boot.context.properties.ConfigurationProperties;
import org.springframework.stereotype.Component;

@Component
@ConfigurationProperties(prefix = "config")
public class MyProperties {
    private String message;

    public String getMessage() {
        return message;
    }

    public void setMessage(String message) {
        this.message = message;
    }
}

Создайте файл Java с именем HelloController.java и добавьте следующие строки:

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;

@RestController
public class HelloController {

    @Autowired
    private MyProperties properties; 

    @GetMapping
    public String getMessage() {
        return "Message: " + properties.getMessage();
    }
}

Откройте автоматически созданный модульный тест и обновите его, чтобы отключить «Конфигурацию приложений Azure». Иначе при выполнении тестов будет происходить попытка загрузки из службы.
```
import org.junit.jupiter.api.Test;
import org.springframework.boot.test.context.SpringBootTest;

@SpringBootTest(properties = "spring.cloud.azure.appconfiguration.enabled=false")
class DemoApplicationTests {

    @Test
    void contextLoads() {
    }

}
```

Создание и запуск приложения локально

Задайте переменную среды с именем AZURE_APPCONFIG_ENDPOINT и задайте для него ключ доступа в хранилище конфигурации приложений. В командной строке выполните следующую команду и перезапустите командную строку, чтобы изменения вступили в силу:
```
setx AZURE_APPCONFIG_ENDPOINT "<endpoint-of-your-app-configuration-store>"
```
Если вы используете Windows PowerShell, выполните следующую команду:
```
$Env:AZURE_APPCONFIG_ENDPOINT = "<endpoint-of-your-app-configuration-store>"
```
Если вы используете macOS или Linux, выполните следующую команду:
```
export AZURE_APPCONFIG_ENDPOINT='<endpoint-of-your-app-configuration-store>'
```
В командной строке откройте корневой каталог и выполните следующие команды, чтобы скомпилировать приложение Spring Boot с помощью Maven и запустить его.
```
mvn clean package
mvn spring-boot:run
```
После запуска приложение можно протестировать с помощью средства curl, например:
```
curl -X GET http://localhost:8080/
```
Вы увидите сообщение, которое указали в хранилище конфигураций приложений.

Очистка ресурсов

Если вы не планируете в дальнейшем использовать ресурсы, созданные при работе с этой статьей, удалите созданную группу ресурсов, чтобы избежать расходов.

Внимание

Удаление группы ресурсов — процесс необратимый. Группа ресурсов и все содержащиеся в ней ресурсы удаляются без возможности восстановления. Будьте внимательны, чтобы случайно не удалить не те ресурсы или группу ресурсов. Если ресурсы для работы с этой статьей созданы в группе ресурсов, которая содержит другие нужные ресурсы, удалите каждый ресурс отдельно в соответствующей области ресурса, чтобы не удалять группу ресурсов.

Войдите на портал Azure и выберитеГруппы ресурсов.
Введите имя группы ресурсов в поле Фильтровать по имени.
В списке результатов выберите имя группы ресурсов, чтобы просмотреть общие сведения.
Выберите команду Удалить группу ресурсов.
Подтвердите операцию удаления группы ресурсов. Введите имя группы ресурсов, которую необходимо удалить, и нажмите Удалить.

Через некоторое время группа ресурсов и все ее ресурсы будут удалены.

Следующие шаги

В этом кратком руководстве вы создали новое хранилище конфигурации приложений и использовали его с приложением на Java Spring. Дополнительные сведения см. в статье Spring в Azure. Если возникнут дополнительные вопросы, см. справочную документацию, в ней подробно описан принцип работы библиотеки Spring Cloud для Конфигурации приложений Azure. Чтобы узнать, как включить в приложении Java Spring динамическое обновление параметров конфигурации, перейдите к следующему руководству.

Включение динамической конфигурации

Обратная связь

Были ли сведения на этой странице полезными?

Last updated on 2026-03-16