在EKS环境中持久化修改WSO2 APIM的Registry.xml.j2文件

针对EKS环境下WSO2 APIM Pod重启后配置丢失的问题，以下是两种可靠的持久化方案，优先推荐自定义Docker镜像方案：

方案一：自定义WSO2 APIM Docker镜像（最优） #

这种方案将修改后的模板文件直接打包进镜像，从根本上避免Pod重启后配置丢失，同时便于版本管理和批量部署。

1. 准备修改后的registry.xml.j2文件
   本地编辑好添加正则表达式属性的registry.xml.j2文件。

2. 编写Dockerfile
   基于官方WSO2 APIM镜像构建自定义镜像，示例如下（替换镜像版本和路径为你的实际版本）：

   FROM wso2/wso2am:4.2.0
   # 将本地修改后的文件复制到镜像内对应路径
   COPY ./registry.xml.j2 /usr/lib/wso2/wso2am/4.2.0/repository/resources/conf/templates/repository/conf/registry.xml.j2
   

   注：可通过kubectl exec -it <your-wso2-pod> -- pwd确认镜像内的APIM_HOME实际路径。

3. 构建并推送镜像
   将镜像推送到你的私有镜像仓库（如AWS ECR）：

   # 构建镜像
   docker build -t your-ecr-repo-uri/wso2am-custom:4.2.0 .
   # 推送镜像
   docker push your-ecr-repo-uri/wso2am-custom:4.2.0
   

4. 更新EKS Deployment
   修改你的WSO2 APIM Deployment YAML，将image字段替换为自定义镜像地址，然后应用配置：

   kubectl apply -f your-wso2am-deployment.yaml
   

方案二：使用Kubernetes ConfigMap挂载替换 #

如果不想重新构建镜像，可通过ConfigMap将修改后的文件挂载到Pod内，覆盖原模板文件。

1. 创建ConfigMap
   基于本地修改后的registry.xml.j2创建ConfigMap：

   kubectl create configmap wso2am-registry-template --from-file=registry.xml.j2
   

2. 修改Deployment配置
   在Deployment的容器配置中添加卷挂载，将ConfigMap中的文件挂载到目标路径：

   spec:
     containers:
     - name: wso2am
       image: wso2/wso2am:4.2.0
       volumeMounts:
       - name: registry-template
         mountPath: /usr/lib/wso2/wso2am/4.2.0/repository/resources/conf/templates/repository/conf/registry.xml.j2
         subPath: registry.xml.j2 # 避免覆盖整个目录，仅替换单个文件
     volumes:
     - name: registry-template
       configMap:
         name: wso2am-registry-template
         items:
         - key: registry.xml.j2
           path: registry.xml.j2
   

3. 更新Deployment

   kubectl apply -f your-wso2am-deployment.yaml
   

注意事项 #

• 无论哪种方案，修改模板文件后都需要重启Pod才能生效，因为WSO2 APIM在启动时会基于模板生成实际配置文件。
• 使用ConfigMap时，需确保挂载路径和文件名完全匹配，避免错误覆盖其他文件；同时注意ConfigMap的大小限制（最大1MB），该模板文件远低于此限制，无需担心。
• 自定义镜像方案更适合长期维护，便于跟踪配置变更，而ConfigMap方案适合临时快速修改。

内容的提问来源于stack exchange，提问作者Akash Mishra