Nacos 封装与 Docker 部署实践

Nacos 封装与 Docker 部署指南

0 准备工作

核心概念​

命名空间：用于隔离不同环境（如 dev、test、prod）或业务线，默认命名空间为public。​
数据 ID：配置集的唯一标识，命名规则推荐为{服务名}-{profile}.{扩展名}（如user-service-dev.yaml）。​
分组：用于区分同一命名空间下的不同配置集，默认分组为DEFAULT_GROUP。

在pom.xml中添加：

<dependency><groupId>com.alibaba.cloud</groupId><artifactId>spring-cloud-starter-alibaba-nacos-config</artifactId><version>2.2.7.RELEASE</version> <!-- 与Spring Cloud版本匹配 -->
</dependency>

1.封装代码

@SpringBootApplication(scanBasePackages = "com.alibaba.nacos")
@ServletComponentScan
@EnableScheduling
public class SpringNacosApplication {// 建议将这些配置移到application.properties中@Value("${nacos.standalone}")private String standalone;@Value("${nacos.core.auth.enabled}") private String authEnabled;public static void main(String[] args) {SpringApplication.run(JeecgNacosApplication.class, args);}// 添加配置类@Configurationpublic static class NacosConfig {@Beanpublic ConfigurableEnvironment environment(ConfigurableEnvironment env) {Map<String, Object> config = new HashMap<>();config.put("nacos.standalone", standalone);config.put("nacos.core.auth.enabled", authEnabled);config.put("server.tomcat.basedir", "logs");config.put("server.port", "8848");env.getPropertySources().addFirst(new MapPropertySource("nacos-config", config));return env;}}
}

在 application.properties 中添加以下配置:

# Nacos 配置
nacos.standalone=true
nacos.core.auth.enabled=false# 服务器配置
server.port=8848
server.tomcat.basedir=logs

对于生产环境，建议:

• 使用集群模式而非单机模式
• 启用鉴权功能
• 配置持久化到数据库
• 设置合适的 JVM 参数

2. 部署前提​​

在部署 Nacos 前，需确保环境满足以下条件：​

• JDK 版本：至少 JDK 1.8（推荐 1.8+），需配置JAVA_HOME环境变量。​
• -MySQL（可选）：集群模式需使用 MySQL 存储配置（推荐 5.7 + 或 8.0），单机模式可使用默认嵌入式数据库（Derby），但生产环境建议用 MySQL。​
• 端口占用：Nacos 默认使用 3 个端口，需确保未被占用：​
  8848：主端口（控制台与 API 通信）；​
  9848：客户端与服务端通信的 gRPC 端口；​
  9849：服务端间通信的 gRPC 端口。。​

3 Docker 部署配置

Dockerfile

FROM openjdk:8-jdk-alpine
VOLUME /tmp
ARG JAR_FILE=target/*.jar
COPY ${JAR_FILE} app.jar
ENTRYPOINT ["java","-Djava.security.egd=file:/dev/./urandom","-jar","/app.jar"]

4. 端口配置

4.1. 防火墙和安全组配置

确保以下端口在服务器/开发机上开放：
8848 - Nacos 服务端口
9848 - Nacos 集群通信端口(如果是集群模式)
7848 - Nacos 集群选举端口(如果是集群模式)

4.2 容器化部署端口映射

ports:

• “8848:8848” # 主机端口:容器端口
• “9848:9848” # 集群通信端口
  dockers部署 这个很重要

4.3 启动容器

docker run -d \--name nacos-standalone \-p 8848:8848 \-p 9848:9848 \-p 9849:9849 \-e MODE=standalone \  # 指定单机模式-e JVM_XMS=512m \     # 初始堆内存-e JVM_XMX=512m \     # 最大堆内存nacos/nacos:2.2.3

参数说明：

• -p：映射容器端口到宿主机（必须包含 8848、9849、9848）；
• MODE=standalone：强制单机模式（默认集群模式）；
• JVM_*：调整 JVM 参数，避免内存占用过高。

通用注意事项：
集群部署时，所有节点需处于同一网络，确保 9848/9849 端口可互通（gRPC 通信）；
启动前检查端口占用，避免与其他服务冲突（可通过netstat -tunlp | grep 8848排查）。

5. 微服务连接配置

其他微服务连接 Nacos 时，确保配置正确的地址和端口：

spring:cloud:nacos:discovery:server-addr: 127.0.0.1:8848config:server-addr: 127.0.0.1:8848

6、常见问题与注意事项​

• 启动失败：检查端口是否被占用（netstat -tunlp | grep 8848）、JDK 环境是否正确、数据库连接是否正常。​
• 集群数据不一致：确保所有节点cluster.conf配置一致，且连接同一 MySQL。​
• 配置不生效：检查bootstrap.yml中的server-addr、namespace（需用 ID）、dataId命名是否正确。​
• 安全加固：生产环境需开启 Nacos 认证（application.properties中设置nacos.core.auth.enabled=true），并修改默认用户名密码。​
  通过以上步骤，可完成 Nacos 的部署与配置管理。Nacos 的高可用设计和动态配置能力，能有效简化微服务架构中的服务治理与配置维护工作。​