wuyfeedocker/nacos-ci

nacos-docker-test 镜像文档

镜像概述

nacos-docker-test是基于官方Nacos构建的Docker镜像，专为测试环境设计，简化了Nacos在开发和测试阶段的部署流程。该镜像保留了Nacos核心功能，同时针对测试场景优化了默认配置，支持快速启动和功能验证，适合开发人员本地测试及CI/CD流程中的自动化测试环境搭建。

核心功能与特性

• 动态服务发现：支持服务注册、发现及负载均衡，测试环境下默认启用简化的服务注册机制
• 配置管理：提供配置的发布、获取、更新和删除功能，支持多环境配置隔离，默认包含测试配置示例
• 服务健康检查：内置基础服务健康检查机制，可快速验证服务可用性
• 测试友好配置：默认启用单机模式（standalone），集成嵌入式数据库（Derby），无需额外数据库依赖
• 轻量化部署：优化镜像体积，启动速度快，适合资源受限的测试环境

使用场景

• 开发环境中微服务的本地服务注册与发现测试
• Nacos配置管理功能的功能验证与接口测试
• 微服务架构下多服务协同的集成测试
• CI/CD流程中自动化测试环境的Nacos服务搭建
• 新手学习Nacos核心功能的本地实验环境

使用方法

基本部署（Docker Run）

通过以下命令快速启动单机测试实例：

bash
docker run -d \
  -p 8848:8848 \
  --name nacos-test \
  --restart=always \
  nacos-docker-test

• -p 8848:8848：映射Nacos默认端口（8848为服务端口）
• --name nacos-test：指定容器名称，便于管理
• --restart=always：测试环境可选，确保容器重启后自动启动

环境变量配置

支持通过环境变量自定义测试参数，常用配置如下：

示例：启用认证的测试实例

bash
docker run -d \
  -p 8848:8848 \
  -e NACOS_AUTH_ENABLE=true \
  -e NACOS_AUTH_TOKEN=testToken123 \
  --name nacos-test-auth \
  nacos-docker-test

Docker Compose 配置

适用于多服务协同测试的docker-compose.yml示例：

yaml
version: '3'
services:
  nacos:
    image: nacos-docker-test
    container_name: nacos-test
    ports:
      - "8848:8848"
    environment:
      - MODE=standalone
      - NACOS_SERVER_PORT=8848
    volumes:
      - ./nacos-data:/home/nacos/data  # 可选：本地数据持久化（测试用）
    restart: on-failure

启动命令：docker-compose up -d

访问与验证

服务启动后，通过以下方式验证：

1. 访问Web控制台：http://localhost:8848/nacos（默认无认证，用户名/密码：nacos/nacos，若启用认证需使用配置的token）
2. 服务注册测试：通过Nacos API注册测试服务

   bash
   curl -X POST "http://localhost:8848/nacos/v1/ns/instance?serviceName=test-service&ip=127.0.0.1&port=8080"
   

3. 配置发布测试：发布测试配置

   bash
   curl -X POST "http://localhost:8848/nacos/v1/cs/configs?dataId=test-config&group=TEST_GROUP&content=testValue"
   

注意事项

• 该镜像仅用于测试环境，生产环境请使用官方Nacos镜像并配置生产级参数
• 嵌入式数据库（Derby）不支持高并发，请勿用于性能测试
• 测试数据默认存储在容器内，如需持久化请挂载数据卷（如上述docker-compose示例）