Chuyển tới nội dung chính

Cài đặt & tích hợp

Có hai cách tích hợp Govex Cloud vào một service Maven, tuỳ theo việc ứng dụng đã có parent riêng hay chưa.

Cách 1 — Dùng parent govex-cloud-parent​

Đặt govex-cloud-parent làm parent của ứng dụng. Parent này kế thừa BOM vn.govex.cloud:dependencies nên quản lý sẵn toàn bộ version dependency/plugin, đồng thời cung cấp pluginManagement và các thư viện test scope dùng chung (JUnit Jupiter, Mockito, AssertJ).

<parent>
    <groupId>vn.govex.cloud</groupId>
    <artifactId>govex-cloud-parent</artifactId>
    <version>1.0.0-SNAPSHOT</version>
    <relativePath/>
</parent>

<relativePath/> giúp Maven luôn resolve parent từ Maven repository thay vì tìm trong thư mục cục bộ.

Cách 2 — Import BOM khi ứng dụng đã có parent riêng​

Nếu ứng dụng đã dùng parent khác (ví dụ spring-boot-starter-parent), import BOM vào dependencyManagement:

<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>vn.govex.cloud</groupId>
            <artifactId>dependencies</artifactId>
            <version>1.0.0-SNAPSHOT</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
    </dependencies>
</dependencyManagement>

BOM dependencies kế thừa spring-boot-starter-parent 3.5.7 và import sẵn spring-boot-dependencies, spring-cloud-dependencies, nên ứng dụng nhận được quản lý version đầy đủ cho cả Spring Boot lẫn Spring Cloud.

Thêm dependency vào ứng dụng​

Sau khi đã có parent hoặc BOM, thêm dependency cần dùng — không cần khai version:

<dependencies>
    <dependency>
        <groupId>vn.govex.cloud</groupId>
        <artifactId>govex-cloud-common</artifactId>
    </dependency>
    <dependency>
        <groupId>vn.govex.cloud</groupId>
        <artifactId>govex-cloud-core</artifactId>
    </dependency>
</dependencies>

Maven repository​

Artifact Govex Cloud được phát hành qua Maven repository nội bộ. Khai báo repository theo hạ tầng của bạn trong pom.xml (hoặc settings.xml):

<repositories>
    <repository>
        <id>govex-cloud</id>
        <url>https://your-maven-repo.example.com/repository/maven-public/</url>
        <snapshots>
            <enabled>true</enabled>
        </snapshots>
    </repository>
</repositories>

Lưu ý:

  • Bản hiện tại là 1.0.0-SNAPSHOT, cần bật snapshot cho repository.
  • Tên, URL và cơ chế xác thực repository phụ thuộc hạ tầng triển khai — tham khảo quản trị viên hệ thống.