[PR #798/52f2cb55 backport][stable-3] Improve error message for pod disruption budget when draining a node

[patchback]

This is a backport of PR #798 as merged into main (52f2cb5).

SUMMARY

Closes #797 .

The error message "Too Many Requests" is confusing and is changed to a more meaningful message:

TASK [Drain node] *************************************************************************
Montag 25 November 2024  09:20:28 +0100 (0:00:00.014)       0:00:00.014 ******* 
fatal: [host -> localhost]: FAILED! => {"changed": false, "msg": "Failed to delete pod kube-public/draintest-6b84677b99-9jf7m due to: Cannot evict pod as it would violate the pod's disruption budget."}

The new task output would allow to deal with a pod disruption budget with the retries/until logic in a more controlled way:

---
- hosts: "{{ target }}"
  serial: 1
  gather_facts: false
  tasks:
    - name: Drain node
      kubernetes.core.k8s_drain:
        kubeconfig: "{{ kubeconfig_path }}"
        name: "{{ inventory_hostname }}"
        delete_options:
          ignore_daemonsets: true
          delete_emptydir_data: true
          wait_timeout: 100
          disable_eviction: false
          wait_sleep: 1
      delegate_to: localhost
      retries: 10
      delay: 5
      until: drain_result is success or 'disruption budget' not in drain_result.msg
      register: drain_result

ISSUE TYPE

• Feature Pull Request

COMPONENT NAME

k8s_drain

[softwarefactory-project-zuul]

Build succeeded.
https://ansible.softwarefactory-project.io/zuul/buildset/153a048ebb5240c1a76f4c83bf37e93c

✔️ ansible-galaxy-importer SUCCESS in 2m 52s
✔️ build-ansible-collection SUCCESS in 6m 04s

[softwarefactory-project-zuul]

Build succeeded (gate pipeline).
https://ansible.softwarefactory-project.io/zuul/buildset/7b54e39d2d9c423db908229e11c571f3

✔️ ansible-galaxy-importer SUCCESS in 3m 37s
✔️ build-ansible-collection SUCCESS in 5m 48s