dearxhub/wso2am-apim

WSO2 API Manager Docker镜像说明

镜像概述

本镜像基于CentOS Linux系统构建，封装WSO2 API Manager 3.1.0，提供API从设计、发布到监控的全生命周期管理能力，助力企业实现API的高效治理与规模化部署。

核心功能

• API生命周期管理：支持RESTful API的创建、版本控制与发布流程
• 安全管控：提供OAuth2.0、API密钥等认证授权机制
• 流量治理：实现速率限制、节流等流量控制策略
• 监控分析：实时追踪API调用数据，生成多维度统计报表
• 开发者门户：为开发者提供API文档、测试工具与订阅管理功能

使用场景

• 企业级API网关：作为微服务架构入口，统一管理内部与外部API
• 跨团队协作：支持多团队共享API资源，规范API使用流程
• 云原生部署：适配容器化与Kubernetes环境，实现弹性扩展

前提条件

• Docker v17.09.0及以上版本
• Git客户端

镜像构建与运行步骤

1. 克隆仓库到本地

bash
git clone https://github.com/wso2/docker-apim.git

本地dockerfiles/centos/apim目录将被称为AM_DOCKERFILE_HOME。

2. 构建镜像

导航到<AM_DOCKERFILE_HOME>目录，执行构建命令：

bash
docker build -t wso2am:3.1.0-centos .

3. 运行容器

bash
docker run -it -p 9443:9443 wso2am:3.1.0-centos

仅映射HTTPS端口9443，可根据需求映射其他暴露端口。

4. 访问管理控制台

通过Docker主机IP访问： https://<DOCKER_HOST>:9443/carbon

<DOCKER_HOST>指容器所在主机的IP或hostname。

配置更新方法

以修改端口偏移为例：

1. 复制产品分发版中的deployment.toml（路径：<DISTRIBUTION_HOME>/repository/conf）到主机<SOURCE_CONFIGS>目录，修改[server]->offset值为1。
2. 授予文件读取权限：

bash
chmod o+r <SOURCE_CONFIGS>/deployment.toml

3. 挂载配置文件运行：

bash
docker run \
-p 9444:9444 \
--volume <SOURCE_CONFIGS>/deployment.toml:/home/wso2carbon/wso2am-3.1.0/repository/conf/deployment.toml \
wso2am:3.1.0-centos

Docker命令参考

• https://docs.docker.com/engine/reference/commandline/build/
• https://docs.docker.com/engine/reference/run/
• https://docs.docker.com/engine/reference/builder/