Nhảy đến nội dung chính

Hướng dẫn setup môi trường và start project

1. Mục tiêutiêu

Hướng dẫn developer:

  • CàiCài đặt môimôi trường chạy project

  • Cấu hìnhhình biến môimôi trường

  • Khởi động project Spring Boot

  • Kiểm tra project chạy thànhthành côngcông


2. YêuYêu cầu hệ thống

2.1. Phần mềm cần càicài đặt

CôngCông cụ PhiênPhiên bản khuyến nghị
Java JDK 17 hoặc(bắt 21buộc)
Maven 3.8+
Git Mới nhất
IDE IntelliJ IDEA 2023+
PostgreSQL14 hoặc 15
DB ToolDBeaver / PgAdmin

2.2. Kiểm tra càicài đặt

Mở terminal:


java -version

Kết quả mong muốn:


java version "17.0.x"

Kiểm tra Maven:


mvn -v

3. Clone source code


4. Cấu hìnhhình biến môimôi trường

Project sử dụng file:

application.properties

4.1. CácCác biến môimôi trường cơ bản

dụ file:


application.properties

server: port: 8080 spring: datasource: url: jdbc:postgresql://localhost:5432/lifetex username: lifetex pass

#spring.application.name=demo
#server.port=8080
#
## ===== Oracle datasource =====
#spring.datasource.url=jdbc:oracle:thin:@//192.168.0.111:1111/ORCLPDB1
#spring.datasource.username=test
#spring.datasource.password=test
#spring.datasource.driver-class-name=oracle.jdbc.OracleDriver
#
## ===== JPA =====
#spring.jpa.hibernate.ddl-auto=none
#spring.jpa.show-sql=true
#spring.jpa.properties.hibernate.format_sql=true
#spring.jpa.database-platform=org.hibernate.dialect.OracleDialect
#
## ===== Hikari pool (optional) =====
#spring.datasource.hikari.maximum-pool-size=10
#spring.datasource.hikari.minimum-idle=2
#spring.datasource.hikari.connection-timeout=30000
#
#management.endpoints.web.exposure.include=health,info

4.2. CáchCách chỉnh sửa biến môimôi trường

CáchCách 1: Sửa trực tiếp trong file application.properties

dụ đổi DB:


spring: datasource: url: jdbc:postgresql://localhost:5432/test_db username: test password: test123

CáchCách 2: DùngDùng biến môimôi trường hệ điều hànhhành

dụ trong application.properties:


spring: datasource: url: ${DB_URL} username: ${DB_USER} password: ${DB_PASS}

TrênTrên Windows (PowerShell)


$env:DB_URL="jdbc:postgresql://localhost:5432/lifetex" $env:DB_USER="lifetex" $env:DB_PASS="123456"

TrênTrên Linux/Mac


export DB_URL=jdbc:postgresql://localhost:5432/lifetex export DB_USER=lifetex export DB_PASS=123456

5. Chọn profile chạy

Spring Boot thường dùngdùng profile:


dev staging prod

dụ chạy với profile dev.


CáchCách cấu hìnhhình profile

CáchCách 1: Trong biến môimôi trường

Windows:


$env:SPRING_PROFILES_ACTIVE="dev"

Linux/Mac:


export SPRING_PROFILES_ACTIVE=dev

CáchCách 2: Trong IDE

VM options:


-Dspring.profiles.active=dev

6. Build project

Trong thư mục project:


mvn clean install

Nếu build thànhthành côngcông sẽ thấy:

BUILD SUCCESS

7. Start project

Chạy trong IDE

Trong IntelliJ:

  1. Mở project

  2. Mở file:

  1. Nhấn nútnút Run


8. Kiểm tra project chạy thànhthành côngcông

Sau khi start, kiểm tra log:

Started DemoApplication in 5.123 seconds

Mở trìnhtrình duyệt:


http://localhost:8080

Hoặc gọi API:


http://localhost:8080/api/v1/health