Apache SkyWalking Docker Compose 部署指南

概述

Apache SkyWalking 是一款开源的分布式系统监控和追踪工具，主要用于微服务架构下的性能监控和问题诊断。本文将通过技术专家的视角，详细解析 SkyWalking 的 Docker Compose 部署方案，帮助开发者快速搭建完整的监控环境。

核心组件解析

1. 存储服务选项

SkyWalking 提供了两种存储后端选择，通过 Docker Compose 的 profiles 机制实现灵活切换：

Elasticsearch 存储

• 使用官方 Elasticsearch OSS 镜像（7.4.2版本）
• 配置为单节点模式（discovery.type=single-node）
• 内存锁定设置（bootstrap.memory_lock=true）
• 健康检查通过集群健康API验证

BanyanDB 存储

• SkyWalking 自研的时序数据库
• 暴露17912（gRPC）和17913（HTTP）端口
• 数据存储路径配置在/tmp目录下
• 健康检查通过端口检测实现

2. OAP 服务

OAP（Observability Analysis Platform）是 SkyWalking 的核心分析平台：

• 基础配置使用 YAML 锚点（&oap-base）实现复用
• 默认分配2GB堆内存（JAVA_OPTS）
• 暴露11800（gRPC）和12800（HTTP）端口
• 健康检查通过内部接口验证
• 根据存储类型自动配置对应环境变量

3. UI 服务

Web 界面提供可视化监控：

• 默认连接OAP服务（SW_OAP_ADDRESS）
• 同时支持Zipkin数据展示（SW_ZIPKIN_ADDRESS）
• 映射8080端口供外部访问

部署实践指南

环境准备

1. 确保已安装 Docker 和 Docker Compose
2. 建议系统内存不小于4GB（Elasticsearch+OAP组合）

启动命令

# 使用Elasticsearch存储
docker-compose --profile elasticsearch up -d

# 使用BanyanDB存储
docker-compose --profile banyandb up -d

配置自定义

可通过环境变量覆盖默认镜像：

# 自定义镜像示例
export OAP_IMAGE=my-registry/skywalking-oap:custom
export UI_IMAGE=my-registry/skywalking-ui:custom
docker-compose --profile elasticsearch up -d

技术细节解析

1. 网络配置：所有服务位于"demo"自定义网络，实现服务间自动DNS解析

2. 健康检查机制：

   • Elasticsearch：30秒间隔检查集群健康状态
   • BanyanDB：5秒间隔检查端口可用性
   • OAP：30秒间隔检查内部接口

3. 资源限制：

   • Elasticsearch限制512MB堆内存
   • OAP服务限制2GB堆内存
   • 内存锁定配置确保关键服务稳定性

常见问题排查

1. 端口冲突：检查9200（ES）、8080（UI）等端口是否被占用
2. 启动超时：适当增加健康检查的timeout和retries参数
3. 内存不足：调整JAVA_OPTS中的-Xms和-Xmx参数

最佳实践建议

1. 生产环境建议使用外部Elasticsearch集群
2. 长期运行应配置持久化存储卷
3. 监控OAP服务的12800/metrics端点获取自身指标
4. 根据业务规模调整OAP堆内存大小

通过本文的详细解析，开发者可以深入理解SkyWalking的Docker部署架构，并根据实际需求灵活调整配置。这种容器化部署方式特别适合开发测试环境快速搭建，也为生产环境部署提供了参考模板。