aerogear/unifiedpush-wildfly

AeroGear UnifiedPush服务器环境

镜像概述

本镜像提供运行https://github.com/aerogear/aerogear-unifiedpush-server/服务器所需的环境，包含必要的二进制文件，基于WildFly应用服务器构建。

核心功能

1. 支持推送服务部署，用于向移动应用等发送推送通知
2. 集成Keycloak认证服务，保障安全访问
3. 依赖PostgreSQL数据库存储推送相关数据
4. 默认启用SSL加密，支持自定义证书替换自签名证书
5. 通过环境变量灵活配置数据库和Keycloak连接信息

使用场景

适用于需要实现推送通知功能的应用开发场景，如移动应用、Web应用的消息推送服务搭建。

配置说明

前置条件

运行本镜像前需准备Keycloak服务器和PostgreSQL数据库。

部署示例

1. 启动PostgreSQL数据库

shell
$ docker run --name unifiedpushDB \
           -p 8080:8080 \
           -p 9090:9090 \
           -e POSTGRES_USER=unifiedpush \
           -e POSTGRES_PASSWORD=unifiedpush \
           -e POSTGRES_DATABASE=unifiedpush \
           -e POSTGRES_ROOT_PASSWORD=supersecret \
           -d postgres:9.6

2. 启动Keycloak服务器

替换/path/to/my/folder/containing/ups-realm为你的配置目录路径，示例配置可从https://github.com/aerogear/aerogear-unifiedpush-server/tree/master/docker-compose/keycloak-realm获取。

shell
$ docker run -d --name keycloak \
           --net=container:unifiedpushDB \
           -v /path/to/my/folder/containing/ups-realm:/keycloak-cfg \
           -e KEYCLOAK_USER=admin \
           -e KEYCLOAK_PASSWORD=admin \
           jboss/keycloak:4.0.0.Final \
           "-b 0.0.0.0 -Dkeycloak.import=/keycloak-cfg/ups-realm-sample.json"

3. 启动UnifiedPush服务器

shell
$ docker run --name ups \
           --net=container:unifiedpushDB \
           -e POSTGRES_SERVICE_HOST=localhost \
           -e POSTGRES_SERVICE_PORT=3306 \
           -e POSTGRES_DATABASE=unifiedpush \
           -e POSTGRES_USER=unifiedpush \
           -e POSTGRES_PASSWORD=unifiedpush \
           -e KEYCLOAK_SERVICE_HOST=localhost \
           -e KEYCLOAK_SERVICE_PORT=8080 \
           -dit aerogear/unifiedpush-wildfly:2.1.0 \
           "-Djboss.socket.binding.port-offset=1010"

自定义SSL证书

1. 将私钥（命名为privatekey.key）和证书（命名为certificate.crt）放入指定目录
2. 启动容器时添加卷挂载：-v <证书目录路径>:/keys，镜像将自动使用自定义证书

访问服务

• 所有HTTP请求会重定向到HTTPS
• 本地环境可通过https://localhost:9090/ag-push访问
• 默认登录信息：用户名admin，密码123

构建镜像（可选）

1. 先构建父目录的Dockerfile
2. 执行以下命令构建本镜像：

shell
docker build -t aerogear/unifiedpush-wildfly .