Apache APISIX 使用教程
项目介绍
Apache APISIX 是一个动态、实时、高性能的 API 网关,提供负载均衡、动态上游、灰度发布、服务熔断、身份认证、可观测性等丰富的流量管理功能。它基于 NGINX 和 etcd 构建,支持多种协议如 HTTP、gRPC、WebSocket、Dubbo、MQTT 等,并且可以作为 Kubernetes 的 Ingress 控制器使用。
项目快速启动
环境准备
- 安装 Docker
- 安装 Git
快速启动步骤
-
克隆项目仓库
git clone https://github.com/apache/apisix.git cd apisix
-
启动 APISIX
docker run -d -p 9080:9080 --name apisix apache/apisix:latest
-
配置 APISIX
编辑
conf/config.yaml
文件,添加你的配置。 -
重启 APISIX
docker restart apisix
-
验证 APISIX 是否启动成功
curl http://127.0.0.1:9080/apisix/admin/routes -H 'X-API-KEY: edd1c9f034335f136f87ad84b625c8f1'
应用案例和最佳实践
案例一:动态路由配置
通过 APISIX 的动态路由功能,可以实现根据请求的 Header、路径等条件动态转发请求到不同的后端服务。
routes:
- uri: /example/*
upstream:
type: roundrobin
nodes:
"192.168.1.1:80": 1
"192.168.1.2:80": 1
案例二:灰度发布
通过 APISIX 的灰度发布功能,可以实现新旧版本的平滑过渡。
routes:
- uri: /example/*
plugins:
traffic-split:
rules:
- match:
- vars:
- host: "example.com"
weighted_upstreams:
- upstream:
name: "old_service"
type: roundrobin
nodes:
"192.168.1.1:80": 1
- upstream:
name: "new_service"
type: roundrobin
nodes:
"192.168.1.2:80": 1
典型生态项目
1. Apache Skywalking
Apache Skywalking 是一个开源的分布式系统的应用程序性能监视工具,特别为微服务、云原生和容器化(Kubernetes)架构设计。
2. Grafana
Grafana 是一个开源的度量分析与可视化套件,常用于大规模指标数据的可视化展示。
3. Prometheus
Prometheus 是一个开源的系统监控和警报工具包,最初由 SoundCloud 构建。
4. etcd
etcd 是一个分布式键值存储系统,用于共享配置和服务发现。
通过这些生态项目的配合,可以构建一个完整的可观测性和服务治理体系。