Gravitee.io Docker镜像文档

镜像概述

Gravitee.io 是一款功能全面的开源API管理解决方案，旨在简化API的全生命周期管理。该Docker镜像封装了Gravitee.io的核心组件，提供开箱即用的API管理能力，适用于各类需要对API进行统一治理、监控和安全管控的场景。

核心功能和特性

核心功能

• API全生命周期管理：支持API的设计、创建、发布、版本控制及退役的完整流程
• 安全管控：提供认证授权（OAuth2、JWT等）、流量控制、IP白名单等安全机制
• 监控与分析：实时监控API性能指标（响应时间、错误率等），生成可视化报表
• 开发者门户：内置开发者门户，支持API文档自动生成与开发者自助接入

主要特性

• 开源免费：基于Apache License 2.0开源协议，可自由使用和二次开发
• 高可扩展性：模块化架构设计，支持插件扩展与集群部署
• 多环境适配：兼容各类部署环境，包括容器化、云原生及混合架构
• 直观管理界面：提供Web管理控制台，简化API配置与运维操作

使用场景和适用范围

适用场景

• 企业级API网关建设与管理
• 微服务架构中的API统一治理
• 第三方开放平台的API接入管控
• API性能监控与安全审计

适用范围

• 中小企业API管理需求
• 大型企业分布式系统的API网关
• 开发者生态建设中的API文档与接入管理
• ***及机构的开放数据API平台

使用方法和配置说明

基本部署（Docker Run）

bash
# 启动Gravitee.io管理UI（示例端口映射）
docker run -d -p 8083:8083 --name gravitee-management-ui graviteeio/apim-management-ui

# 启动Gravitee.io网关（需配合管理API和数据库）
docker run -d -p 8082:8082 --name gravitee-gateway graviteeio/apim-gateway

Docker Compose部署（推荐）

创建docker-compose.yml文件，配置完整组件栈（管理API、管理UI、网关、数据库等）：

yaml
version: '3'
services:
  mongodb:
    image: mongo:4.4
    volumes:
      - mongodb-data:/data/db
    ports:
      - "27017:27017"

  elasticsearch:
    image: docker.elastic.co/elasticsearch/elasticsearch:7.14.0
    environment:
      - discovery.type=single-node
      - "ES_JAVA_OPTS=-Xms512m -Xmx512m"
    ports:
      - "9200:9200"

  gravitee-management-api:
    image: graviteeio/apim-management-api
    depends_on:
      - mongodb
      - elasticsearch
    environment:
      - gravitee_management_mongodb_uri=mongodb://mongodb:27017/gravitee
      - gravitee_analytics_elasticsearch_uri=[***]
    ports:
      - "8083:8083"

  gravitee-management-ui:
    image: graviteeio/apim-management-ui
    ports:
      - "80:80"
    depends_on:
      - gravitee-management-api

  gravitee-gateway:
    image: graviteeio/apim-gateway
    depends_on:
      - mongodb
      - elasticsearch
    environment:
      - gravitee_gateway_mongodb_uri=mongodb://mongodb:27017/gravitee
      - gravitee_analytics_elasticsearch_uri=[***]
    ports:
      - "8082:8082"

volumes:
  mongodb-data:

启动命令：docker-compose up -d

关键配置参数

注：完整配置参数请参考Gravitee.io***文档。

访问与使用

部署完成后，可通过以下地址访问对应组件：

• 管理UI：http://<docker-host-ip>:80（默认管理员账户：admin/admin）
• 管理API：http://<docker-host-ip>:8083/management/organizations/DEFAULT/environments/DEFAULT
• API网关：http://<docker-host-ip>:8082（用于API请求转发）

首次登录后，建议修改默认密码并根据业务需求配置API策略、限流规则及安全设置。