edenmor1989/counter-service

counter-service 镜像文档

镜像概述

counter-service 是 Payoneer 家庭练习项目中的基础计数服务，旨在通过简单的计数功能演示服务开发、Docker 容器化及基础服务交互的实现过程。该镜像轻量简洁，适合开发者作为学习案例，了解服务部署与基本功能开发。

核心功能与特性

• 基础计数操作：支持计数数值的增加（Increment）、减少（Decrement）和重置（Reset）
• 状态管理：可维护当前计数状态，支持初始化配置（如初始计数值）
• 轻量级设计：镜像体积小，启动快速，依赖简单，适合本地开发环境
• HTTP 接口：提供标准 HTTP API 接口，便于外部调用和功能验证

使用场景

• 学习实践：供开发者练习 Docker 容器化部署、基础服务开发及 API 设计
• 教学演示：作为简单服务案例，展示服务构建、容器打包与运行流程
• 家庭练习：用于 Payoneer 家庭练习项目中，验证基础服务的实现与交互

使用方法

前提条件

• 已安装 Docker 环境（推荐 Docker Engine 20.10+）

快速启动

通过以下命令启动容器：

bash
docker run -d -p 8080:8080 --name counter-service payoneer/counter-service:latest

• -d：后台运行容器
• -p 8080:8080：端口映射（主机端口:容器端口，默认容器内端口为 8080）
• --name counter-service：指定容器名称
• payoneer/counter-service:latest：镜像名称及标签（默认 latest 标签）

服务接口调用

服务启动后，可通过 HTTP 请求调用功能（以下为标准接口示例）：

• 获取当前计数：
  curl http://localhost:8080/count
  响应示例：{"count": 0}

• 增加计数：
  curl -X POST http://localhost:8080/increment
  响应示例：{"count": 1}

• 减少计数：
  curl -X POST http://localhost:8080/decrement
  响应示例：{"count": 0}

• 重置计数：
  curl -X POST http://localhost:8080/reset
  响应示例：{"count": 0}

配置参数

支持通过环境变量调整服务行为：

• PORT：服务监听端口，默认 8080
• INITIAL_COUNT：初始计数数值，默认 0

示例（自定义端口和初始值）：

bash
docker run -d -p 8081:8081 -e PORT=8081 -e INITIAL_COUNT=5 --name counter-service payoneer/counter-service:latest

停止与清理

bash
# 停止容器
docker stop counter-service

# 移除容器
docker rm counter-service