基础设施即代码 / 系统课时
等待端口与服务就绪
等待端口与服务就绪
部署任务返回成功,不代表应用已经能接流量。本课把“服务已启动”拆成端口可连接、健康检查通过两层条件,并用 wait_for 与 until 把等待动作写进 Playbook,让后续变更只在依赖真正就绪后继续。
学习目标
- 使用
ansible.builtin.wait_for等待 TCP 端口进入可用状态 - 使用
until、retries与delay重试应用层健康检查 - 区分“进程启动”“端口开放”和“业务就绪”三种状态
把启动结果变成就绪条件
服务管理模块只能确认启动动作是否成功;应用可能还在加载配置、连接数据库或预热缓存。部署编排应把可继续条件写成显式检查:先确认端口能建立连接,再确认健康接口返回期望状态,最后才执行注册负载均衡、迁移流量等后续任务。

wait_for 适合等待端口、文件或连接状态。下面假设目标主机上已有 myapp.service,应用监听本机 8080,并在 /health 就绪时返回 HTTP 200。
---
- name: Wait until application is ready
hosts: app
become: true
vars:
app_port: 8080
tasks:
- name: Restart application service
ansible.builtin.service:
name: myapp
state: restarted
- name: Wait until TCP port accepts connections
ansible.builtin.wait_for:
host: 127.0.0.1
port: "{{ app_port }}"
state: started
delay: 2
sleep: 2
connect_timeout: 2
timeout: 60
- name: Wait until health endpoint returns 200
ansible.builtin.uri:
url: "http://127.0.0.1:{{ app_port }}/health"
status_code: 200
return_content: false
register: health
until: health.status == 200
retries: 12
delay: 5预期结果:服务重启后,Ansible 最多等待 60 秒让 8080 端口可连接;随后健康检查失败时每 5 秒重试,直到返回 200 或重试耗尽。两层检查都通过后,Playbook 才会进入下一任务。
用 wait_for 和 until 解决不同问题
wait_for 内建了对端口和文件等状态的轮询,timeout 控制总等待上限,sleep 控制检查间隔,connect_timeout 控制单次 TCP 连接尝试的等待时间。它适合回答“端口开了吗”“文件出现了吗”这类基础条件。
until 则是任务级重试机制,可以根据注册结果判断任意业务条件。HTTP 健康接口、数据库探针或命令返回值都可以作为条件,因此它更适合回答“应用真的可以工作了吗”。
如果检查应从控制节点而不是目标主机发起,需要明确改变执行位置。例如验证负载均衡入口时,可把检查任务 delegate_to: localhost;否则 wait_for 默认是在当前受管主机的执行上下文中观察网络。
失败时按检查层级定位
端口等待超时,先在目标主机确认服务状态、监听地址、防火墙和实际端口。若端口已经开放但 uri 持续失败,则重点检查应用日志、健康接口路径、返回码以及数据库、缓存等下游依赖。
不要用很大的 timeout 掩盖启动失败。等待上限应该覆盖正常启动时间并留出余量,同时让失败足够快地暴露;这样批量部署遇到异常节点时,不会把整批变更长期卡在不可恢复的等待上。