Wildfly基础URL配置镜像

镜像概述

本镜像专为Wildfly应用服务器设计，提供基础URL（Uniform Resource Locator）配置能力，帮助用户在部署Wildfly应用时统一设置应用的基础访问路径，解决不同环境下因URL路径差异导致的访问问题，简化Wildfly应用的网络访问配置流程。

核心功能与特性

• 基础URL路径配置：支持通过环境变量或配置文件设置Wildfly应用的基础访问路径（如/app、/service等），统一应用的上下文路径。
• Wildfly无缝集成：与Wildfly应用服务器原生配置兼容，无需修改应用代码即可生效，适配Wildfly 10+版本。
• 轻量级设计：基于***Wildfly镜像构建，仅添加必要的URL配置逻辑，镜像体积小，部署效率高。
• 环境变量动态配置：支持通过环境变量动态调整基础URL参数，无需重新构建镜像即可适配不同部署环境。

使用场景与适用范围

• 多环境部署：在开发、测试、生产等不同环境中，通过统一基础URL路径，确保应用访问地址一致性。
• 微服务架构：在微服务集群中，为不同Wildfly应用实例设置独立基础URL，配合API网关实现应用路由与访问控制。
• 统一上下文路径：需要将多个Wildfly应用部署在同一服务器/集群时，通过基础URL区分不同应用，避免路径冲突。
• 容器化部署：适用于Docker、Kubernetes等容器化环境，简化Wildfly应用的网络配置，提升部署自动化程度。

使用方法与配置说明

前提条件

• 已安装Docker引擎（20.10+版本）。
• 了解Wildfly应用服务器基本配置（如 standalone.xml 中的上下文路径设置）。

获取镜像

通过Docker Hub拉取最新版本镜像（假设镜像名为wildfly-base-url）：

bash
docker pull wildfly-base-url:latest

核心环境变量

部署示例

1. 基础部署（docker run）

通过docker run命令启动容器，设置基础URL路径为/myapp：

bash
docker run -d \
  --name wildfly-app \
  -p 8080:8080 \
  -e BASE_URL_PATH="/myapp" \
  wildfly-base-url:latest

启动后，应用可通过 http://<容器IP>:8080/myapp 访问。

2. 启用HTTPS的部署

设置基础URL路径为/service并启用HTTPS（需确保Wildfly已配置HTTPS证书）：

bash
docker run -d \
  --name wildfly-https-app \
  -p 8443:8443 \
  -e BASE_URL_PATH="/service" \
  -e ENABLE_HTTPS="true" \
  -v /path/to/ssl/certs:/opt/wildfly/standalone/configuration/ssl \
  wildfly-base-url:latest

启动后，应用可通过 https://<容器IP>:8443/service 访问。

3. Docker Compose配置

创建docker-compose.yml文件，配置多环境变量：

yaml
version: '3.8'
services:
  wildfly-app:
    image: wildfly-base-url:latest
    container_name: wildfly-app
    ports:
      - "8080:8080"
    environment:
      - BASE_URL_PATH="/api/v1"
      - WILDFLY_HOME="/opt/wildfly"
    volumes:
      - ./wildfly-deployments:/opt/wildfly/standalone/deployments
    restart: unless-stopped

启动命令：

bash
docker-compose up -d

自定义配置

若需进一步自定义Wildfly配置（如修改端口、添加模块等），可通过挂载配置文件实现：

bash
docker run -d \
  --name wildfly-custom \
  -p 8080:8080 \
  -e BASE_URL_PATH="/custom" \
  -v ./standalone.xml:/opt/wildfly/standalone/configuration/standalone.xml \
  wildfly-base-url:latest

注：挂载自定义 standalone.xml 时，需确保文件中已包含与基础URL相关的配置（如 <web-context>${BASE_URL_PATH}</web-context>）。

注意事项

• 本镜像依赖***Wildfly镜像，使用前需确认目标Wildfly版本兼容性（推荐10+版本）。
• 若修改 BASE_URL_PATH，需确保应用内部资源引用（如CSS、JS、API调用）使用相对路径，避免因基础URL变更导致资源访问失败。
• 生产环境中建议结合Docker Secrets或Kubernetes ConfigMaps管理敏感配置（如HTTPS证书路径）。