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 đặtmôimôi trường chạy project -
Cấu
hìnhhình biếnmôimôi trường -
Khởi động project Spring Boot
-
Kiểm tra project chạy
thànhthànhcôngcông
2. YêuYêu cầu hệ thống
2.1. Phần mềm cần càicài đặt
| Java JDK | 17 |
| Maven | 3.8+ |
| Git | Mới nhất |
| IDE | IntelliJ IDEA 2023+ |
| PostgreSQL | 14 hoặc 15 |
| DB Tool | DBeaver / PgAdmin |
2.2. Kiểm tra càicài đặt
Mở terminal:
Kết quả mong muốn:
Kiểm tra Maven:
3. Clone source code
4. Cấu hìnhhình biến môimôi trường
Project sử dụng file:
4.1. CácCác biến môimôi trường cơ bản
VíVí dụ file:
#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
VíVí dụ đổi DB:
CáchCách 2: DùngDùng biến môimôi trường hệ điều hànhhành
VíVí dụ trong application.properties:
TrênTrên Windows (PowerShell)
TrênTrên Linux/Mac
5. Chọn profile chạy
Spring Boot thường dùngdùng profile:
VíVí 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:
Linux/Mac:
CáchCách 2: Trong IDE
VM options:
6. Build project
Trong thư mục project:
Nếu build thànhthành côngcông sẽ thấy:
7. Start project
Chạy trong IDE
Trong IntelliJ:
-
Mở project
-
Mở file:
-
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:
Mở trìnhtrình duyệt:
Hoặc gọi API: