Rövid útmutató: Java Spring-alkalmazás létrehozása Azure-alkalmazás konfigurációval

Ebben a rövid útmutatóban Azure-alkalmazás Konfigurációt egy Java Spring-alkalmazásba építi be, hogy központosítsa az alkalmazásbeállítások tárolását és kezelését a kódtól elkülönítve.

Előfeltételek

Kulcs-érték hozzáadása

Adja hozzá a következő kulcsértéket az Alkalmazáskonfigurációs áruházhoz, és hagyja meg a címke és a tartalomtípus alapértelmezett értékeit. Ha többet szeretne tudni arról, hogyan adhat hozzá kulcsértékeket egy áruházhoz az Azure Portal vagy a parancssori felület használatával, lépjen a Kulcs-érték létrehozása elemre.

Kulcs Érték
/application/config.message Üdvözöljük

Csatlakozás alkalmazáskonfigurációs áruházhoz

Most, hogy már rendelkezik alkalmazáskonfigurációs tárral, használhatja a Spring Cloud Azure Config startert, hogy az alkalmazás kommunikáljon a létrehozott Alkalmazáskonfigurációs tárral.

A Spring Cloud Azure Config kezdőmodul telepítéséhez adja hozzá a következő függőséget a pom.xml fájlhoz:

<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>

  1. Alapértelmezés szerint a kódtár felügyelt identitással csatlakozik az Alkalmazáskonfigurációs áruházhoz. Kövesse az utasításokat, hogy a hitelesítő adataihoz hozzárendelje az "Alkalmazás-konfiguráció adatolvasó" szerepkört. Győződjön meg arról, hogy elegendő időt hagy az engedély propagálására az alkalmazás futtatása előtt.

    Megjegyzés:

    Emellett a Spring Cloud Azure-hitelesítést is használhatja a hitelesítési adatok megadásához.

  2. Hozzon létre egy application.properties nevű új fájlt az alkalmazás erőforráskönyvtárában, és adja hozzá a következő sort a fájlhoz.

    spring.config.import=azureAppConfiguration
spring.cloud.azure.appconfiguration.stores[0].endpoint=${AZURE_APPCONFIG_ENDPOINT}

Alkalmazás konfigurációs tárolóból olvasni

Ha a Spring Cloud Azure Config starter használatával szeretné, hogy az alkalmazás kommunikáljon a létrehozott Alkalmazáskonfigurációs tárral, az alábbi lépések végrehajtásával konfigurálja az alkalmazást.

  1. Hozzon létre egy MyProperties.java nevű új Java-fájlt, és adja hozzá a következő sorokat:

    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;
    }
}

  2. Hozzon létre egy új Java-fájlt HelloController.java néven, és adja hozzá a következő sorokat:

    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();
    }
}

  3. Nyissa meg az automatikusan létrehozott egységtesztet, és frissítse azt, hogy letiltsa az Azure App Configuration-t, különben megpróbál betöltődni a szolgáltatásból az egységtesztek futtatásakor.

    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() {
    }

}

Az alkalmazás helyi létrehozása és futtatása

  1. Állítson be egy AZURE_APPCONFIG_ENDPOINT nevű környezeti változót, és állítsa be az App Configuration Store hozzáférési kulcsára. Futtassa a következő parancsot a parancssorban, és indítsa újra a parancssort a módosítás érvénybe lépésének engedélyezéséhez:

    setx AZURE_APPCONFIG_ENDPOINT "<AppConfigurationEndpoint>"

    Windows PowerShell használata esetén futtassa a következő parancsot:

    $Env:AZURE_APPCONFIG_ENDPOINT = "<AppConfigurationEndpoint>"

    MacOS vagy Linux használata esetén futtassa a következő parancsot:

    export AZURE_APPCONFIG_ENDPOINT='<AppConfigurationEndpoint>'

  2. Nyissa meg a parancssort a gyökérkönyvtárban, és futtassa az alábbi parancsokat a Spring Boot-alkalmazás Mavennel való létrehozásához és futtatásához.

    mvn clean package
mvn spring-boot:run

  3. Az alkalmazás futtatása után a curl használatával tesztelheti az alkalmazást, például:

    curl -X GET http://localhost:8080/

    Az alkalmazás konfigurációs tárában megadott üzenetet láthatja.

Erőforrások takarítása

Ha nem szeretné folytatni a cikkben létrehozott erőforrások használatát, törölje az itt létrehozott erőforráscsoportot a díjak elkerülése érdekében.

Fontos

Az erőforráscsoport törlése nem vonható vissza. Az erőforráscsoport és a benne lévő összes erőforrás véglegesen törlődik. Győződjön meg arról, hogy nem véletlenül törli a rossz erőforráscsoportot vagy erőforrásokat. Ha a cikk erőforrásait olyan erőforráscsoporton belül hozta létre, amely más megtartani kívánt erőforrásokat tartalmaz, törölje az egyes erőforrásokat a megfelelő panelről az erőforráscsoport törlése helyett.

  1. Jelentkezzen be az Azure Portalra, és válassza ki az Erőforráscsoportokat.
  2. A Szűrés név szerint mezőbe írja be az erőforráscsoport nevét.
  3. Az eredménylistában válassza ki az erőforráscsoport nevét az áttekintés megtekintéséhez.
  4. Válassza az Erőforráscsoport törlése elemet.
  5. A rendszer az erőforráscsoport törlésének megerősítését kéri. Adja meg a megerősítéshez az erőforráscsoport nevét, és válassza a Törlés lehetőséget.

Néhány pillanat múlva az erőforráscsoport és annak összes erőforrása törlődik.

Következő lépések

Ebben a gyorsútmutatóban létrehoztunk egy új alkalmazáskonfigurációs áruházat, és egy Java Spring alkalmazással használtuk. További információ: Spring on Azure. További kérdésekért tekintse meg a referenciadokumentációt, amely tartalmazza a Spring Cloud Azure-alkalmazás Konfigurációs kódtár működésével kapcsolatos összes részletet. Ha szeretné megtudni, hogyan engedélyezheti a Java Spring-alkalmazást a konfigurációs beállítások dinamikus frissítéséhez, folytassa a következő oktatóanyagban.

Dinamikus konfiguráció engedélyezése

  • Last updated on