Ansible端口就绪等待异常排查及超时时长延长方法咨询

Let's break down your questions one by one, starting with the most straightforward solution first.

2. How to wait longer than 300 seconds for a port (database) to be ready? #

The simplest and most idiomatic way to extend the wait time is to use the timeout parameter built directly into the wait_for module—no need for an until loop unless you need custom retry logic. This parameter lets you set the total number of seconds Ansible will wait for the port to become available.

Here's a clean example tailored for a database:

- name: Wait for database port to accept connections
  ansible.builtin.wait_for:
    host: "{{ database_host }}"
    port: "{{ database_port }}"
    state: started  # Ensures the port is open and accepting connections
    timeout: 600  # Wait up to 10 minutes (adjust as needed)
    delay: 10  # Optional: Wait 10 seconds before starting checks to avoid false negatives on fresh service starts
    connect_timeout: 5  # Optional: Shorten the time per connection attempt to speed up retries

This handles the entire wait process in a single task, no extra loops required.

1. Is this an Ansible bug, or did I use until incorrectly? #

This is almost certainly a usage error, not an Ansible bug. Let's walk through why your until loop was failing:

Common mistakes with until + wait_for: #

1. Missing retries and delay parameters: The until loop requires these two parameters to function—retries sets how many times to repeat the task, and delay sets the pause between attempts. Without them, Ansible doesn't know how to loop and will throw an error.

2. Not handling wait_for failures: By default, if wait_for hits its timeout (default 300s), it will fail the task immediately, which stops the until loop before it can run. You need to add ignore_errors: yes to let the task continue even if the port isn't ready yet, so the until condition can evaluate the result.

3. Using the wrong condition: Instead of checking port8080.failed == false, it's more reliable to use Ansible's built-in success test: port8080 is succeeded.

Here's the corrected until loop approach if you prefer it over the direct timeout parameter:

- name: Wait for database port with custom retry logic
  ansible.builtin.wait_for:
    host: "{{ database_host }}"
    port: "{{ database_port }}"
    state: started
    timeout: 10  # Short timeout per check (so we can retry quickly)
  register: port_check
  ignore_errors: yes
  until: port_check is succeeded
  retries: 60  # 60 retries × 10s timeout = 600s total wait (adjust as needed)
  delay: 5  # Wait 5 seconds between each check attempt

Why your debug worked but until didn't: #

When you removed until and added debug, the wait_for task would fail after 300s, but since there was no loop to continue, Ansible just registered the failure and moved to the debug task. With until, you need to explicitly allow the task to fail temporarily (via ignore_errors) so the loop can retry.

内容的提问来源于stack exchange，提问作者Max Allan