Tiếp tục series về Go. Hôm nay mình sẽ hướng dẫn bạn cách xây dựng một RESTful API hoàn chỉnh bằng Go, kết hợp với các công cụ mạnh mẽ và phổ biến trong hệ sinh thái phát triển backend hiện đại.

Vì sao chọn Fiber + GORM + Docker?

🚀 Fiber – Web framework nhẹ, cực nhanh, lấy cảm hứng từ Express.js
🔗 GORM – ORM mạnh mẽ giúp bạn thao tác cơ sở dữ liệu dễ dàng hơn
🐳 Docker – Đóng gói và triển khai ứng dụng một cách linh hoạt, nhất quán

Cấu trúc dự án

go-fiber-api/
├── Dockerfile
├── docker-compose.yml
├── go.mod
├── main.go
├── config/
│   └── database.go
├── models/
│   └── user.go
├── handlers/
│   └── user_handler.go
├── routes/
│   └── router.go
│   └── user_route.go

Bắt đầu thôi nào. Let's go 🏃‍♂️🏃‍♂️🏃‍♂️

Tạo dự án

Bước đầu tiên chúng ta sẽ khởi tạo thư mục chứa dự án.

mkdir go-fiber-api && cd go-fiber-api
go mod init go-fiber-api

Cài đặt các thư viện cần thiết:

go get github.com/gofiber/fiber/v2
go get gorm.io/gorm
go get gorm.io/driver/postgres

Kết nối Database với GORM

Tạo file config/database.go
Ở đây mình sẽ dùng postgresql

package config

import (
    "fmt"
    "gorm.io/driver/postgres"
    "gorm.io/gorm"
)

var DB *gorm.DB

func ConnectDB() {
    dsn := "host=db user=postgres password=postgres dbname=fiber_db port=5432 sslmode=disable"
    db, err := gorm.Open(postgres.Open(dsn), &gorm.Config{})
    if err != nil {
        panic("Failed to connect to database!")
    }
    DB = db
    fmt.Println("📦 Database connected!")
}

Tạo model User

Tại file models/user.go

package models

type User struct {
    ID    uint   `json:"id" gorm:"primaryKey"`
    Name  string `json:"name"`
    Email string `json:"email"`
}

Viết Handler xử lý API

Tạo file handlers/user_handler.go

package handlers

import (
    "github.com/gofiber/fiber/v2"
    "go-fiber-api/config"
    "go-fiber-api/models"
)

func GetUsers(c *fiber.Ctx) error {
    var users []models.User
    config.DB.Find(&users)
    return c.JSON(users)
}

func CreateUser(c *fiber.Ctx) error {
    user := new(models.User)
    if err := c.BodyParser(user); err != nil {
        return c.Status(400).JSON(fiber.Map{"error": "Cannot parse JSON"})
    }
    config.DB.Create(&user)
    return c.JSON(user)
}

Định tuyến các API

Trong bài này, chúng ta sẽ thao tác với resources là users. Vì vậy chúng ta sẽ định nghĩa các REST API liên quan đến resources này trong file routes/user_route.go và import vào trong router tổng.

File: routes/user_route.go

package routes

import (
    "github.com/gofiber/fiber/v2"
    "go-fiber-api/handlers"
)

func RegisterUserRoutes(router fiber.Router) {
    user := router.Group("/users")
    user.Get("/", handlers.GetUsers)
    user.Post("/", handlers.CreateUser)
}

File: routes/router.go

package routes

import (
    "github.com/gofiber/fiber/v2"
)

func InitRoutes(app *fiber.App) {
    api := app.Group("/api")

    RegisterUserRoutes(api) // Các route từ user_route.go
}

Khởi chạy Fiber App

File: main.go

package main

import (
    "github.com/gofiber/fiber/v2"
    "go-fiber-api/config"
    "go-fiber-api/models"
    "go-fiber-api/routes"
)

func main() {
    app := fiber.New()

    config.ConnectDB()
    config.DB.AutoMigrate(&models.User{})

    routes.InitRoutes(app)

    app.Listen(":3000")
}

Cài đặt Docker vào trong app

Tạo Dockerfile

FROM golang:1.20-alpine

WORKDIR /app

COPY go.mod ./
COPY go.sum ./
RUN go mod download

COPY . .

RUN go build -o main .

EXPOSE 3000

CMD ["./main"]

Tạo docker-compose.yml

services:
  api:
    container_name: go-fiber-api
    build: .
    ports:
      - "3000:3000"
    depends_on:
      - db
    environment:
      - DB_HOST=db
      - DB_USER=postgres
      - DB_PASSWORD=postgres
      - DB_NAME=fiber_db
      - DB_PORT=5432
    volumes:
      - .:/app

  db:
    container_name: go-fiber-db
    image: postgres:14
    restart: always
    environment:
      POSTGRES_USER: postgres
      POSTGRES_PASSWORD: postgres
      POSTGRES_DB: fiber_db
    ports:
      - "5432:5432"

Sau khi bạn config xong docker như trên, bạn chỉ cần mở terminal của dự án lên và run:

docker-compose up --build

Khi bạn sẽ thấy dòng: Database connected! là đã connect và build thành công rồi đó.

API sẽ chạy tại: http://localhost:3000

Test thử với Postman hoặc curl

GET http://localhost:3000/api/users

POST http://localhost:3000/api/users

{
  "name": "Alice",
  "email": "alice@example.com"
}

Tổng kết

Vậy là chúng ta đã hoàn thành một RESTful API cơ bản với Go, Fiber, GORM và Docker. Hy vọng bài viết này sẽ giúp các bạn tiếp cận Go một cách dễ dàng và hiệu quả hơn.