Ansible wait_for — Ports Files Conditions

# Wait for service to start listening
- name: Wait for nginx
  ansible.builtin.wait_for:
    port: 80
    timeout: 30

# Wait for remote port
- name: Wait for database
  ansible.builtin.wait_for:
    host: db.internal
    port: 5432
    timeout: 60

# Wait for app to start
- name: Wait for application
  ansible.builtin.wait_for:
    port: 8080
    delay: 5        # Wait 5s before first check
    timeout: 60     # Give up after 60s

# Wait for old service to stop
- name: Wait for port 8080 to be free
  ansible.builtin.wait_for:
    port: 8080
    state: stopped
    timeout: 30

# Wait for connections to drain before stopping
- name: Wait for connections to drain
  ansible.builtin.wait_for:
    port: 80
    state: drained
    timeout: 60
    exclude_hosts: 10.0.0.1    # Exclude monitoring

# Wait for file to appear
- name: Wait for lock file to be created
  ansible.builtin.wait_for:
    path: /tmp/app.lock
    state: present
    timeout: 30

# Wait for file to be removed
- name: Wait for lock file to be released
  ansible.builtin.wait_for:
    path: /tmp/app.lock
    state: absent
    timeout: 120

# Wait for content in file
- name: Wait for app to be ready
  ansible.builtin.wait_for:
    path: /var/log/myapp/startup.log
    search_regex: "Application started"
    timeout: 60

# Wait for host to be reachable after reboot
- name: Reboot server
  ansible.builtin.reboot:
    reboot_timeout: 300

# Or manually
- name: Reboot
  ansible.builtin.command: shutdown -r now
  async: 1
  poll: 0

- name: Wait for SSH
  ansible.builtin.wait_for:
    host: "{{ ansible_host }}"
    port: 22
    delay: 30
    timeout: 300
  delegate_to: localhost

# Or use wait_for_connection
- name: Wait for connection
  ansible.builtin.wait_for_connection:
    delay: 30
    timeout: 300

- name: Stop application
  ansible.builtin.service:
    name: myapp
    state: stopped

- name: Wait for port to close
  ansible.builtin.wait_for:
    port: 8080
    state: stopped
    timeout: 30

- name: Deploy new version
  ansible.builtin.copy:
    src: "myapp-{{ version }}.jar"
    dest: /opt/myapp/myapp.jar

- name: Start application
  ansible.builtin.service:
    name: myapp
    state: started

- name: Wait for app to be ready
  ansible.builtin.wait_for:
    port: 8080
    delay: 10
    timeout: 60

- name: Verify health
  ansible.builtin.uri:
    url: http://localhost:8080/health
    status_code: 200
  retries: 5
  delay: 5

- name: Wait for database to be available
  ansible.builtin.wait_for:
    host: "{{ db_host }}"
    port: 5432
    timeout: 120

- name: Run migrations
  ansible.builtin.command: /opt/myapp/migrate.sh
  register: migration

- name: Wait for migration log completion
  ansible.builtin.wait_for:
    path: /var/log/migration.log
    search_regex: "Migration complete"
    timeout: 300

- name: Start all services
  ansible.builtin.service:
    name: "{{ item }}"
    state: started
  loop:
    - redis
    - postgresql
    - myapp

- name: Wait for all services
  ansible.builtin.wait_for:
    port: "{{ item.port }}"
    delay: 2
    timeout: 30
  loop:
    - { name: redis, port: 6379 }
    - { name: postgresql, port: 5432 }
    - { name: myapp, port: 8080 }

- wait_for:
    port: 8080
    delay: 15      # JVM needs startup time
    timeout: 120   # 2 minutes

- name: Check remote port from controller
  ansible.builtin.wait_for:
    host: "{{ inventory_hostname }}"
    port: 443
    timeout: 30
  delegate_to: localhost