Megosztás a következőn keresztül:

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>6.0.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 a hitelesítő adatok alkalmazáskonfigurációs adatolvasói szerepkör hozzárendeléséhez. 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. Ezután hozzon létre egy AppConfigCredential.java nevű új fájlt, és adja hozzá a következő sorokat:

    import org.springframework.stereotype.Component;

import com.azure.data.appconfiguration.ConfigurationClientBuilder;
import com.azure.identity.DefaultAzureCredentialBuilder;
import com.azure.spring.cloud.appconfiguration.config.ConfigurationClientCustomizer;

@Component
public class AppConfigCredential implements ConfigurationClientCustomizer {

    @Override
    public void customize(ConfigurationClientBuilder builder, String endpoint) {
        builder.credential(new DefaultAzureCredentialBuilder().build());
    }
}

    Megjegyzés:

    Emellett a Spring Cloud Azure-hitelesítést is használhatja a hitelesítési adatok megadásához. Az Azure Spring-konfigurációval végzett hitelesítés lehetővé teszi ugyanazt a hitelesítést az összes Azure Spring-kódtárhoz.

  2. Ezután hozzon létre egy konfigurációs bootstrap-konfigurációt úgy, hogy létrehoz spring.factories egy fájlt a címtárban resources/META-INF , és hozzáadja a következő sorokat, és frissít com.example.MyApplication az alkalmazás nevével és csomagjával:

    org.springframework.cloud.bootstrap.BootstrapConfiguration=\
com.example.MyApplication

  3. 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= ${APP_CONFIGURATION_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ítést, hogy letiltsa Azure-alkalmazás konfigurációt, vagy 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 APP_CONFIGURATION_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 APP_CONFIGURATION_ENDPOINT "<endpoint-of-your-app-configuration-store>"

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

    $Env:APP_CONFIGURATION_ENDPOINT = "<endpoint-of-your-app-configuration-store>"

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

    export APP_CONFIGURATION_ENDPOINT='<endpoint-of-your-app-configuration-store>'

  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áskonfigurációs áruházban megadott üzenet jelenik meg.

Az erőforrások eltávolí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 rövid útmutatóban létrehozott egy új alkalmazáskonfigurációs áruházat, amelyet egy Java Spring-alkalmazással használt. 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