Giải quyết các vấn đề với thử nghiệm Quarkus, vùng chứa thử nghiệm và tích hợp Liquibase

Đảm bảo tích hợp thích hợp giữa Liquibase và TestContainers trong Quarkus

Giải pháp phụ trợ sử dụng Quarkus với TestContainers để quản lý quá trình di chuyển PostgreSQL và Liquibase. Tập lệnh này giải quyết các vấn đề về sai lệch vùng chứa.

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

Xác thực tích hợp ứng dụng-Liquibase bằng cách sử dụng các bài kiểm tra đơn vị

Một ví dụ thử nghiệm Quarkus dạng mô-đun và có thể tái sử dụng để xác minh kết nối cơ sở dữ liệu và thực thi tập lệnh di chuyển.

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.");
    }
}

Đảm bảo tính nhất quán về cấu hình trên các cấu hình thử nghiệm

Cấu hình hồ sơ thử nghiệm tùy chỉnh để đảm bảo sự liên kết giữa Liquibase và vùng chứa ứng dụng.

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

Mô phỏng giao diện người dùng để xác thực dữ liệu

Đoạn mã giao diện người dùng động để đảm bảo dữ liệu từ tích hợp cơ sở dữ liệu được hiển thị chính xác.

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

Kiểm tra đơn vị về tính nhất quán của phần phụ trợ và giao diện người dùng

Các tập lệnh kiểm tra mẫu để xác thực cả logic phụ trợ và tích hợp giao diện người dùng với dữ liệu kiểm tra.

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

Câu hỏi thường gặp về tích hợp Quarkus, TestContainers và Liquibase

1. Vai trò của là gì TestContainers trong các bài kiểm tra tích hợp?
2. TestContainers giúp quản lý các phiên bản cơ sở dữ liệu bị cô lập trong quá trình thử nghiệm, đảm bảo môi trường nhất quán.
3. Tại sao tôi cần withReuse(true) yêu cầu?
4. các withReuse(true) lệnh cho phép bạn sử dụng lại cùng một vùng chứa trong nhiều thử nghiệm, tiết kiệm tài nguyên và thời gian thiết lập.
5. Mục đích của việc này là gì TC_INITSCRIPT tài sản?
6. các TC_INITSCRIPT thuộc tính chỉ định tập lệnh SQL khởi tạo để tạo cơ sở dữ liệu khi khởi động vùng chứa.
7. Làm cách nào để đảm bảo việc di chuyển Liquibase được áp dụng chính xác?
8. Bằng cách cấu hình quarkus.liquibase.jdbc.url thuộc tính, bạn có thể đảm bảo Liquibase sử dụng cùng vùng chứa cơ sở dữ liệu với ứng dụng.
9. Tôi nên sử dụng cấp độ nhật ký nào để gỡ lỗi?
10. Bộ TRACE hoặc DEBUG cấp độ cho Liquibase và TestContainers để giám sát hoạt động và di chuyển cơ sở dữ liệu.
11. Làm cách nào tôi có thể kiểm tra phản hồi API bằng dữ liệu gốc?
12. Sử dụng các công cụ như RestAssured để gửi yêu cầu đến điểm cuối và xác minh dữ liệu trả về khớp với dữ liệu thử nghiệm.
13. cái gì làm @QuarkusTestResource chú thích làm gì?
14. các @QuarkusTestResource chú thích đăng ký trình quản lý vòng đời tùy chỉnh cho các phần phụ thuộc bên ngoài như cơ sở dữ liệu.
15. Tại sao tôi cần TestProfileResolver tùy chỉnh?
16. Nó đảm bảo các cấu hình chính xác được tải để thực hiện kiểm thử, căn chỉnh các biến môi trường và tài nguyên.
17. Làm cách nào để phát hiện xem có nhiều vùng chứa đang được tạo hay không?
18. Kiểm tra Docker Desktop của bạn hoặc theo dõi nhật ký bảng điều khiển để biết các phiên bản vùng chứa trùng lặp và cổng tương ứng của chúng.
19. Cách tốt nhất để dọn sạch tài nguyên thử nghiệm là gì?
20. Ghi đè stop trong trình quản lý vòng đời của bạn để dừng và xóa vùng chứa sau khi hoàn tất kiểm tra.

Những bài học chính để giải quyết xung đột trong kiểm thử

Thử nghiệm tích hợp với Quarkus, Liquibase và TestContainers yêu cầu thiết lập cẩn thận để đảm bảo việc di chuyển và tương tác cơ sở dữ liệu được căn chỉnh. Bằng cách tùy chỉnh trình quản lý tài nguyên thử nghiệm của bạn và sử dụng cấu hình hợp nhất, bạn có thể loại bỏ xung đột giữa các vùng chứa được Liquibase sử dụng và ứng dụng của bạn.

Các bước này giúp hợp lý hóa quy trình thử nghiệm của bạn, giúp việc gỡ lỗi và xác thực thử nghiệm của bạn dễ dàng hơn. Hãy nhớ sử dụng nhật ký chi tiết, chẳng hạn như bật DẤU VẾT đối với Liquibase, để theo dõi hoạt động thử nghiệm của bạn và sớm giải quyết những khác biệt. Với phương pháp này, bạn có thể tự tin xây dựng các thử nghiệm có thể mở rộng và bảo trì. 🐛