Mulai Cepat: Membuat aplikasi Java Spring dengan Azure App Configuration

Dalam panduan mulai cepat ini, Anda memasukkan Azure App Configuration ke dalam aplikasi Java Spring untuk memusatkan penyimpanan dan pengelolaan pengaturan aplikasi yang terpisah dari kode Anda.

Prasyarat

Akun Azure dengan langganan aktif. Buat akun gratis.
Penyimpanan App Configuration, seperti yang ditunjukkan dalam tutorial untuk membuat penyimpanan.
Java Development Kit (JDK) yang didukung dengan versi 11.
Apache Maven versi 3.0 atau lebih tinggi.
Aplikasi Spring Boot. Jika Anda tidak memilikinya, buat proyek Maven dengan Spring Initializr. Pastikan untuk memilih Proyek Maven dan, di bawah Dependensi, tambahkan dependensi Spring Web , lalu pilih Java versi 8 atau yang lebih tinggi.

Menambahkan nilai kunci

Tambahkan nilai kunci berikut ke penyimpanan App Configuration dan biarkan Label dan Tipe Konten dengan nilai defaultnya. Untuk informasi selengkapnya tentang cara menambahkan nilai kunci ke penyimpanan menggunakan portal Azure atau CLI, buka Membuat nilai kunci.

Tombol	Nilai
/application/config.message	Halo

Tersambung ke Penyimpanan App Configuration

Sekarang setelah Anda memiliki penyimpanan App Configuration, Anda dapat menggunakan starter Spring Cloud Azure Config agar aplikasi Anda berkomunikasi dengan penyimpanan App Configuration yang Anda buat.

Untuk menginstal modul pemula Spring Cloud Azure Config, tambahkan dependensi berikut ke file pom.xml Anda:

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

Secara otomatis, pustaka tersambung ke penyimpanan App Configuration menggunakan Identitas Terkelola. Ikuti instruksi untuk menetapkan kredensial Anda peran Pembaca Data App Configuration. Pastikan untuk mengizinkan waktu yang memadai agar izin disebarluaskan sebelum menjalankan aplikasi Anda. Kemudian buat file baru bernama AppConfigCredential.java dan tambahkan baris berikut:
```
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());
    }
}
```
Nota

Selain itu, Anda dapat menggunakan autentikasi Spring Cloud Azure untuk memberikan informasi autentikasi. Saat mengautentikasi dengan konfigurasi Azure Spring, konfigurasi tersebut memungkinkan penggunaan autentikasi yang sama untuk semua pustaka Azure Spring.
Kemudian buat konfigurasi Konfigurasi Bootstrap, dengan membuat spring.factories file di bawah resources/META-INF direktori dan menambahkan baris berikut dan memperbarui com.example.MyApplication dengan nama dan paket aplikasi Anda:
```
org.springframework.cloud.bootstrap.BootstrapConfiguration=\
com.example.MyApplication
```

Buat file baru bernama application.properties di bawah direktori sumber daya aplikasi Anda, dan tambahkan baris berikut ke file.

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

Baca dari penyimpanan konfigurasi aplikasi

Untuk menggunakan starter Spring Cloud Azure Config agar aplikasi Anda berkomunikasi dengan penyimpanan App Configuration yang Anda buat, konfigurasikan aplikasi dengan menggunakan langkah-langkah berikut.

Buat file Java baru bernama MyProperties.java, dan tambahkan baris berikut:

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

Buat file Java baru bernama HelloController.java, dan tambahkan baris berikut:

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

Buka pengujian dan pembaruan unit yang dibuat secara otomatis untuk menonaktifkan Azure App Configuration, atau mencoba memuat dari layanan saat menjalankan pengujian unit.

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

}

Membangun dan menjalankan aplikasi secara lokal

Atur variabel lingkungan bernama APP_CONFIGURATION_ENDPOINT, dan atur ke kunci akses ke penyimpanan App Configuration Anda. Di baris perintah, jalankan perintah berikut dan hidupkan ulang perintah agar perubahan berlaku:
```
setx APP_CONFIGURATION_ENDPOINT "<endpoint-of-your-app-configuration-store>"
```
Jika Anda menggunakan PowerShell Windows, jalankan perintah berikut:
```
$Env:APP_CONFIGURATION_ENDPOINT = "<endpoint-of-your-app-configuration-store>"
```
Jika Anda menggunakan macOS atau Linux, jalankan perintah berikut:
```
export APP_CONFIGURATION_ENDPOINT='<endpoint-of-your-app-configuration-store>'
```
Buka perintah ke direktori akar dan jalankan perintah berikut untuk membangun aplikasi Spring Boot Anda dengan Maven dan menjalankannya.
```
mvn clean package
mvn spring-boot:run
```
Setelah aplikasi Anda berjalan, gunakan curl untuk menguji aplikasi Anda, misalnya:
```
curl -X GET http://localhost:8080/
```
Anda melihat pesan yang dimasukkan di penyimpanan Azure App Configuration.

Membersihkan sumber daya

Jika Anda tidak ingin terus menggunakan sumber daya yang dibuat dalam artikel ini, hapus grup sumber daya yang Anda buat di sini untuk menghindari biaya.

Penting

Penghapusan grup sumber daya tidak bisa dipulihkan. Grup sumber daya dan semua sumber daya yang ada di dalamnya akan dihapus secara permanen. Pastikan Anda tidak menghapus grup atau sumber daya yang salah secara tidak sengaja. Jika Anda membuat sumber daya untuk artikel ini dalam grup sumber daya yang ada yang berisi sumber daya lain yang ingin disimpan, hapus setiap sumber daya satu per satu dari panelnya masing-masing, bukan menghapus grup sumber daya.

Masuk ke portal Azure, lalu pilih Grup sumber daya.
Dalam kotak Filter menurut nama, masukkan nama grup sumber daya Anda.
Dalam daftar hasil, pilih nama grup sumber daya untuk melihat gambaran umum.
Pilih Hapus grup sumber daya.
Anda akan diminta untuk mengonfirmasi penghapusan grup sumber daya. Masukkan nama grup sumber daya Anda untuk mengonfirmasi, dan pilih Hapus.

Setelah beberapa saat, grup sumber daya dan semua sumber dayanya akan dihapus.

Langkah berikutnya

Dalam panduan mulai cepat ini, Anda membuat store App Configuration baru dan menggunakannya dengan aplikasi Java Spring. Untuk informasi selengkapnya, lihat Spring di Azure. Untuk pertanyaan lebih lanjut, lihat dokumentasi referensi, dokumentasi ini berisi semua detail tentang cara kerja pustaka Spring Cloud Azure App Configuration. Untuk mempelajari cara mengaktifkan aplikasi Java Spring Anda guna me-refresh pengaturan konfigurasi secara dinamis, lanjutkan ke tutorial berikutnya.

Mengaktifkan konfigurasi dinamis

Saran dan Komentar

Apakah halaman ini membantu?

Last updated on 2025-08-25