Menyelesaikan Masalah dengan Tes Quarkus, Kontainer Tes, dan Integrasi Liquibase

Memastikan Integrasi yang Tepat Antara Liquibase dan TestContainers di Quarkus

Solusi backend menggunakan Quarkus dengan TestContainers untuk mengelola migrasi PostgreSQL dan Liquibase. Skrip ini menyelesaikan masalah ketidakselarasan kontainer.

import org.testcontainers.containers.PostgreSQLContainer;
import org.testcontainers.utility.DockerImageName;
import java.util.HashMap;
import java.util.Map;
public class PostgreSQLTestResource implements QuarkusTestResourceLifecycleManager {
    private static PostgreSQLContainer<?> postgreSQLContainer;
    @Override
    public Map<String, String> start() {
        postgreSQLContainer = new PostgreSQLContainer<>(DockerImageName.parse("postgres:alpine"))
            .withDatabaseName("test")
            .withUsername("postgres")
            .withPassword("password")
            .withReuse(true);
        postgreSQLContainer.start();
        Map<String, String> config = new HashMap<>();
        config.put("quarkus.datasource.jdbc.url", postgreSQLContainer.getJdbcUrl());
        config.put("quarkus.datasource.username", postgreSQLContainer.getUsername());
        config.put("quarkus.datasource.password", postgreSQLContainer.getPassword());
        return config;
    }
    @Override
    public void stop() {
        if (postgreSQLContainer != null) {
            postgreSQLContainer.stop();
        }
    }
}

Memvalidasi Integrasi Aplikasi-Liquibase Menggunakan Tes Unit

Contoh pengujian Quarkus yang modular dan dapat digunakan kembali yang memverifikasi koneksi database dan eksekusi skrip migrasi.

import org.junit.jupiter.api.Test;
import io.quarkus.test.junit.QuarkusTest;
import io.quarkus.test.junit.TestProfile;
@QuarkusTest
@TestProfile(TestProfileResolver.class)
public class XServiceTest {
    @Inject
    XTypeVersionService xTypeVersionService;
    @Test
    public void getXTypeVersion() {
        List<XTypeVersionEntity> entities = xTypeVersionService.get();
        assertFalse(entities.isEmpty(), "The entity list should not be empty.");
    }
}

Memastikan Konsistensi Konfigurasi di Seluruh Profil Pengujian

Konfigurasi profil pengujian khusus untuk menjamin keselarasan antara Liquibase dan kontainer aplikasi.

public class TestProfileResolver implements QuarkusTestProfile {
    @Override
    public String getConfigProfile() {
        return "test";
    }
    @Override
    public Map<String, String> getConfigOverrides() {
        return Map.of("quarkus.config.locations", "src/test/resources/application.yaml");
    }
}

Simulasi Front-End untuk Validasi Data

Cuplikan kode front-end dinamis untuk memastikan data dari integrasi database ditampilkan dengan benar.

fetch('/api/xTypeVersion')
    .then(response => response.json())
    .then(data => {
        const list = document.getElementById('entity-list');
        data.forEach(entity => {
            const item = document.createElement('li');
            item.textContent = entity.name;
            list.appendChild(item);
        });
    })
    .catch(error => console.error('Error fetching data:', error));

Tes Unit untuk Konsistensi Backend dan Front-End

Contoh skrip pengujian untuk memvalidasi logika backend dan integrasi front-end dengan data pengujian.

import org.junit.jupiter.api.Test;
public class FrontEndValidationTest {
    @Test
    public void fetchData() {
        given().when().get("/api/xTypeVersion")
            .then().statusCode(200)
            .body("size()", greaterThan(0));
    }
}

FAQ Tentang Integrasi Quarkus, TestContainers, dan Liquibase

1. Apa perannya TestContainers dalam tes integrasi?
2. TestContainers membantu mengelola instance database yang terisolasi selama pengujian, memastikan lingkungan yang konsisten.
3. Mengapa saya memerlukannya withReuse(true) memerintah?
4. Itu withReuse(true) perintah memungkinkan Anda menggunakan kembali wadah yang sama di beberapa pengujian, menghemat sumber daya dan waktu penyiapan.
5. Apa tujuan dari TC_INITSCRIPT milik?
6. Itu TC_INITSCRIPT properti menentukan inisialisasi skrip SQL untuk menyemai database pada permulaan kontainer.
7. Bagaimana cara memastikan migrasi Liquibase diterapkan dengan benar?
8. Dengan mengkonfigurasi quarkus.liquibase.jdbc.url properti, Anda dapat memastikan Liquibase menggunakan wadah database yang sama dengan aplikasi.
9. Level log apa yang harus saya gunakan untuk debugging?
10. Mengatur TRACE atau DEBUG level untuk Liquibase dan TestContainers untuk memantau operasi dan migrasi database.
11. Bagaimana cara menguji respons API dengan data unggulan?
12. Gunakan alat seperti RestAssured untuk mengirim permintaan ke titik akhir dan memverifikasi data yang dikembalikan cocok dengan data pengujian.
13. Apa artinya @QuarkusTestResource anotasi lakukan?
14. Itu @QuarkusTestResource anotasi mendaftarkan manajer siklus hidup khusus untuk dependensi eksternal seperti database.
15. Mengapa saya memerlukan TestProfileResolver khusus?
16. Ini memastikan konfigurasi yang benar dimuat untuk eksekusi pengujian, menyelaraskan variabel lingkungan dan sumber daya.
17. Bagaimana cara mendeteksi jika beberapa penampung sedang dibuat?
18. Periksa Docker Desktop Anda atau pantau log konsol untuk duplikat instance container dan portnya masing-masing.
19. Apa cara terbaik untuk membersihkan sumber daya pengujian?
20. Ganti stop metode di manajer siklus hidup Anda untuk menghentikan dan menghapus kontainer setelah pengujian selesai.

Poin Penting untuk Menyelesaikan Konflik Pengujian

Pengujian integrasi dengan Quarkus, Liquibase, dan TestContainers memerlukan pengaturan yang cermat untuk memastikan migrasi dan interaksi database selaras. Dengan menyesuaikan manajer sumber daya pengujian dan menggunakan konfigurasi terpadu, Anda dapat menghilangkan konflik antara kontainer yang digunakan oleh Liquibase dan aplikasi Anda.

Langkah-langkah ini membantu menyederhanakan proses pengujian Anda, sehingga memudahkan proses debug dan memvalidasi pengujian Anda. Ingatlah untuk menggunakan log terperinci, seperti mengaktifkan JEJAK untuk Liquibase, untuk memantau perilaku pengujian Anda dan menyelesaikan perbedaan sejak dini. Dengan pendekatan ini, Anda dapat dengan percaya diri membuat pengujian yang skalabel dan dapat dikelola. 🐛