华为云 ECS 上从零部署一个可观测的 FastAPI 服务:踩坑与验证清单
【摘要】 以一台 2C4G 的华为云 ECS 为例,把 FastAPI 服务从裸机到可观测(日志、指标、健康检查)完整走一遍,并记录 systemd、安全组、反向代理三个最容易踩的坑。
为什么写这篇
很多同学把「部署」理解成「能 curl 通就行」,上线后第一周就会遇到三类问题:进程莫名其妙退出、日志找不到、监控看不到。这篇把一台华为云 ECS 从裸机到可观测的完整链路写清楚,命令都可以直接复制。
一、机器与网络
规格 2C4G,系统选 Ubuntu 22.04。开服第一件事不是装环境,而是确认安全组:只放通 22 与 443,应用端口 8000 走 Nginx 反代,不对公网暴露。这一步能省掉后面 80% 的扫描噪音。
sudo ufw allow 22/tcp
sudo ufw allow 443/tcp
sudo ufw enable
二、运行环境与依赖隔离
不要用系统 python。用 venv 把依赖钉死,保证测试环境和线上一致。
python3 -m venv /opt/app/venv
/opt/app/venv/bin/pip install -U pip
/opt/app/venv/bin/pip install fastapi "uvicorn[standard]" prometheus-fastapi-instrumentator
三、systemd 托管与自动重启
直接 nohup 起进程是最常见的坑:SSH 断开、OOM、机器重启都会让服务消失。用 systemd 托管,把重启策略和日志一起解决。
[Unit]
Description=fastapi-app
After=network.target
[Service]
User=app
WorkingDirectory=/opt/app
ExecStart=/opt/app/venv/bin/uvicorn main:app --host 127.0.0.1 --port 8000 --workers 2
Restart=always
RestartSec=3
StandardOutput=journal
StandardError=journal
[Install]
WantedBy=multi-user.target
写好之后执行 systemctl daemon-reload 与 systemctl enable --now fastapi-app,再用 journalctl -u fastapi-app -f 就能实时看日志,比翻文件省事得多。
四、可观测三件套
指标用 prometheus-fastapi-instrumentator 暴露 /metrics;健康检查单独做一个 /healthz,只返回进程状态与依赖连通性,不要把内部细节吐出去;日志按 JSON 输出,方便后续采集。
from prometheus_fastapi_instrumentator import Instrumentator
Instrumentator().instrument(app).expose(app, endpoint="/metrics")
五、验证清单
- kill -9 主进程后 3 秒内自动拉起;
- 机器重启后服务自动恢复,本机 curl /healthz 返回 200;
- 外网访问 8000 端口应当超时,说明安全组生效;
- /metrics 里 http_requests_total 计数在增长;
- 日志能按 request_id 串起一次完整调用。
小结
部署不是把进程跑起来,而是让它在异常、重启、流量变化下都能被观测、被恢复。这套流程在 2C4G 的小机器上足够用,后面接云监控也只是把采集端换掉,应用侧不用改。
【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱:
cloudbbs@huaweicloud.com
- 点赞
- 收藏
- 关注作者
评论(0)