Intershop渐进式Web应用的nginx Docker镜像

镜像概述和主要用途

本镜像为Intershop渐进式Web应用（PWA）提供nginx部署支持，该PWA是基于Angular框架开发的B2B商务商店前端。通过此nginx镜像可实现PWA服务的反向代理、多渠道配置及环境变量自定义，适用于B2B商务场景下的PWA部署需求。

核心功能和特性

• 多渠道配置：通过multi-channel.yaml文件定义不同域名对应的渠道、语言、主题及特性
• 环境变量控制：支持通过环境变量配置上游PWA服务地址（UPSTREAM_PWA）和缓存策略（CACHE）
• 自动化部署：提供简洁的Docker构建及运行命令，支持容器自动重启和端口映射

使用场景和适用范围

适用于需要部署Intershop PWA的B2B商务环境，尤其适合需配置多渠道访问（如不同语言、主题、特性集）的场景，可用于开发、测试及生产环境的PWA服务部署。

使用方法和配置说明

前提条件

• 已安装Docker环境
• 具备Intershop PWA项目文件（包含nginx目录）

详细配置步骤

1. 编辑多渠道配置文件

编辑项目中的nginx/multi-channel.yaml文件，配置不同域名对应的渠道参数：

yaml
.+\.net:
  channel: inSPIRED-inTRONICS-Site
  lang: en_US
  theme: 'b2c'
.+\.de:
  channel: inSPIRED-inTRONICS-Site
  lang: de_DE
  theme: 'b2c'
.+\.com:
  channel: inSPIRED-inTRONICS_Business-Site
  features: quoting,businessCustomerRegistration
.+\.fr:
  channel: inSPIRED-inTRONICS-Site
  lang: fr_FR
  application: smb-responsive
  features: quoting

配置项说明：

• 键（如.+\.net）：域名匹配模式，用于识别渠道
• channel：渠道名称（必填）
• lang：语言代码（如en_US）
• theme：主题名称（如b2c）
• application：应用标识（如smb-responsive）
• features：启用特性列表（多特性用逗号分隔）

2. 构建并运行Docker容器

构建镜像

从项目根目录执行以下命令构建镜像：

bash
docker build -t my_awesome_nginx nginx

运行容器

执行以下命令启动容器，配置反向代理及运行参数：

bash
docker run -d --name "my-awesome-nginx" \
        --restart always \
        -p 4199:80 \
        -e UPSTREAM_PWA=[***] \
        -e CACHE=off \
        my_awesome_nginx

参数说明：

• --name：容器名称（自定义）
• --restart always：容器退出后自动重启
• -p 4199:80：端口映射（宿主机端口:容器端口）
• -e UPSTREAM_PWA：PWA服务上游地址（必填，如PWA应用的访问URL）
• -e CACHE：缓存控制（on启用缓存，off禁用缓存）

3. 访问PWA应用

通过以下URL访问部署的PWA：

http://<你的全限定机器名>:4199

DNS配置补充说明

若DNS配置不正确导致多渠道访问异常，需使用DNS代理工具：

• Linux：dnsmasq
• Windows：Acrylic DNS Proxy 或联系本地网络管理员配置DNS。

扩展配置参考

有关更多配置选项，详见文档。