zcnm/backend

访客留言簿后端（Guestbook Backend）

镜像概述

这是一个轻量级的RESTful后端应用，用于实现访客留言簿功能。应用仅依赖PostgreSQL数据库，启动时会自动创建所需的数据库表结构，完成后监听5000端口提供服务。

核心功能

提供以下接口：

1. 健康检查：GET /api/health，返回200 OK表示应用正常且数据库连接有效。
2. 获取留言列表：GET /api/guests，返回所有访客留言记录，包含ID、姓名及创建时间。
3. 添加留言：POST /api/guests，接收包含firstName和lastName的JSON请求体，创建新留言。

使用场景

适用于个人网站、小型项目的访客留言功能，或作为RESTful服务开发的演示案例，可快速集成到前端页面收集用户反馈。

配置说明

配置文件

需挂载YAML格式的配置文件到容器，包含以下必填字段：

• environment：环境标识（如development/test）
• database：PostgreSQL连接URI（格式参考PostgreSQL官方文档）

示例配置：

yaml
environment: development
database: postgresql://dbuser:dbpass@postgres:5432/guestbook

环境变量

• BACKEND_CONFIG：配置文件在容器内的路径（如/etc/backend/config.yml）

Docker部署示例

Docker Run命令

bash
docker run -d \
  -v /本地路径/config.yml:/etc/backend/config.yml \
  -e BACKEND_CONFIG=/etc/backend/config.yml \
  -p 5000:5000 \
  zcnm/backend

Docker Compose示例

yaml
version: '3'
services:
  postgres:
    image: postgres:14
    environment:
      POSTGRES_USER: dbuser
      POSTGRES_PASSWORD: dbpass
      POSTGRES_DB: guestbook
    volumes:
      - postgres_data:/var/lib/postgresql/data
  backend:
    image: zcnm/backend
    depends_on: [postgres]
    environment:
      BACKEND_CONFIG: /etc/backend/config.yml
    volumes:
      - ./config.yml:/etc/backend/config.yml
    ports:
      - "5000:5000"
volumes:
  postgres_data: