minstonehub/nacos-peer-finder-plugin

nacos/nacos-peer-finder-plugin 多架构镜像文档

镜像概述

本镜像为https://hub.docker.com/r/nacos/nacos-peer-finder-plugin%E6%8F%90%E4%BE%9B%E5%A4%9A%E6%9E%B6%E6%9E%84%E6%94%AF%E6%8C%81%EF%BC%8C%E6%98%AFNacos%E5%9C%A8Kubernetes%E7%8E%AF%E5%A2%83%E4%B8%AD%E5%AE%9E%E7%8E%B0%E8%8A%82%E7%82%B9%E8%87%AA%E5%8A%A8%E5%8F%91%E7%8E%B0%E7%9A%84%E6%A0%B8%E5%BF%83%E6%8F%92%E4%BB%B6%E3%80%82%E8%AF%A5%E9%95%9C%E5%83%8F%E9%80%82%E9%85%8D%E5%A4%9A%E7%A7%8D%E7%A1%AC%E4%BB%B6%E6%9E%B6%E6%9E%84%EF%BC%8C%E7%A1%AE%E4%BF%9DNacos%E9%9B%86%E7%BE%A4%E5%9C%A8%E4%B8%8D%E5%90%8C%E6%9E%B6%E6%9E%84%E7%9A%84Kubernetes%E7%8E%AF%E5%A2%83%E4%B8%AD%E5%9D%87%E5%8F%AF%E6%AD%A3%E5%B8%B8%E9%83%A8%E7%BD%B2%E5%92%8C%E8%BF%90%E8%A1%8C%E3%80%82Dockerfile%E6%BA%90%E7%A0%81%E6%89%98%E7%AE%A1%E4%BA%8Ehttps://github.com/nacos-group/nacos-k8s/tree/master/plugin%E3%80%82

核心功能与特性

• 多架构支持：适配主流硬件架构（如amd64、arm64等），满足跨平台部署需求
• Kubernetes集成：专为K8s环境设计，实现Nacos集群节点的自动发现与动态管理
• 轻量级设计：最小化镜像体积，降低资源占用
• 版本同步：与nacos-peer-finder-plugin官方版本同步更新，确保功能一致性

使用场景与适用范围

适用于在Kubernetes集群中部署Nacos服务的场景，尤其是需要：

• 在多架构环境（如x86_64和ARM混合集群）中部署Nacos
• 实现Nacos集群节点的自动发现与动态扩缩容
• 简化Nacos在K8s环境中的部署配置流程

使用方法与配置说明

镜像拉取

通过Docker命令直接拉取最新版本：

bash
docker pull nacos/nacos-peer-finder-plugin:latest

如需指定架构，可通过Docker manifest查询并拉取对应架构镜像：

bash
# 查看镜像支持的架构
docker manifest inspect nacos/nacos-peer-finder-plugin:latest

# 拉取特定架构镜像（以arm64为例）
docker pull --platform linux/arm64 nacos/nacos-peer-finder-plugin:latest

Kubernetes部署示例

在Nacos的Kubernetes部署中，通常通过StatefulSet资源配置使用该插件。以下为简化配置示例：

yaml
apiVersion: apps/v1
kind: StatefulSet
metadata:
  name: nacos
spec:
  serviceName: nacos-headless
  replicas: 3
  template:
    spec:
      containers:
      - name: nacos
        image: nacos/nacos-server:latest
        volumeMounts:
        - name: peer-finder-plugin
          mountPath: /home/nacos/plugins/peer-finder
  volumes:
  - name: peer-finder-plugin
    emptyDir: {}
  initContainers:
  - name: init-peer-finder
    image: nacos/nacos-peer-finder-plugin:latest
    command: ["sh", "-c", "cp -r /plugin/* /peer-finder/"]
    volumeMounts:
    - name: peer-finder-plugin
      mountPath: /peer-finder

配置说明

插件的具体配置需结合Nacos在K8s环境中的部署参数，主要通过以下方式进行：

1. 环境变量：通过K8s Pod的环境变量配置插件行为（如NACOS_SERVICE_NAME、NACOS_NAMESPACE等）
2. 配置文件：通过ConfigMap挂载插件配置文件到容器指定路径
3. 启动参数：在Nacos启动命令中指定插件相关参数

详细配置参数可参考https://github.com/nacos-group/nacos-k8s%E5%8F%8A%E6%8F%92%E4%BB%B6%E6%BA%90%E7%A0%81%E4%BB%93%E5%BA%93%E8%AF%B4%E6%98%8E%E3%80%82

镜像构建与源码

Dockerfile及构建脚本位于https://github.com/nacos-group/nacos-k8s/tree/master/plugin%EF%BC%8C%E5%8F%AF%E9%80%9A%E8%BF%87%E8%AF%A5%E4%BB%93%E5%BA%93%E8%8E%B7%E5%8F%96%E6%9C%80%E6%96%B0%E6%9E%84%E5%BB%BA%E4%BF%A1%E6%81%AF%E5%92%8C%E8%87%AA%E5%AE%9A%E4%B9%89%E6%9E%84%E5%BB%BA%E6%8C%87%E5%8D%97%E3%80%82