基础设施即代码 / 系统课时

等待端口与服务就绪

等待端口与服务就绪

部署任务返回成功,不代表应用已经能接流量。本课把“服务已启动”拆成端口可连接、健康检查通过两层条件,并用 wait_for 与 until 把等待动作写进 Playbook,让后续变更只在依赖真正就绪后继续。

学习目标

  • 使用 ansible.builtin.wait_for 等待 TCP 端口进入可用状态
  • 使用 until、retries 与 delay 重试应用层健康检查
  • 区分“进程启动”“端口开放”和“业务就绪”三种状态

把启动结果变成就绪条件

服务管理模块只能确认启动动作是否成功;应用可能还在加载配置、连接数据库或预热缓存。部署编排应把可继续条件写成显式检查:先确认端口能建立连接,再确认健康接口返回期望状态,最后才执行注册负载均衡、迁移流量等后续任务。

从服务启动到业务就绪的等待与重试流程

wait_for 适合等待端口、文件或连接状态。下面假设目标主机上已有 myapp.service,应用监听本机 8080,并在 /health 就绪时返回 HTTP 200。

yaml
---
- 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 掩盖启动失败。等待上限应该覆盖正常启动时间并留出余量,同时让失败足够快地暴露;这样批量部署遇到异常节点时,不会把整批变更长期卡在不可恢复的等待上。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

等待端口与服务就绪

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通