Μετατροπή curl σε Ansible

Το uri module είναι το ενσωματωμένο module του Ansible για την πραγματοποίηση αιτημάτων HTTP μέσα σε playbooks. Χειρίζεται GET, POST, PUT, DELETE με υποστήριξη σώματος JSON, πιστοποίηση και επικύρωση κωδικού κατάστασης. Δεν απαιτείται πρόσθετη συλλογή — αποτελεί μέρος του ansible.builtin. Το curl2code παράγει Ansible task YAML χρησιμοποιώντας το uri module.

Το uri module είναι για κλήσεις API — επιστρέφει αναλυμένο JSON και επικυρώνει την κατάσταση. Το get_url είναι για τη λήψη αρχείων στο δίσκο. Το command: curl είναι αντι-πρότυπο (anti-pattern) — χάνει την ιδιότητα του idempotency και το χειρισμό σφαλμάτων. Προτιμάτε πάντα το uri για αλληλεπιδράσεις με HTTP APIs. Για αυτοματισμό Python, δείτε curl σε Python.

Για Bearer: headers: { Authorization: "Bearer {{ token }}" }. Για Basic auth: χρησιμοποιήστε τις παραμέτρους url_username και url_password. Αποθηκεύστε μυστικά στο Ansible Vault: ansible-vault encrypt_string. Το uri module υποστηρίζει επίσης το force_basic_auth: yes για προληπτική πιστοποίηση.

Για σώματα JSON: body: {{ data | to_json }} με body_format: json. Για form-urlencoded: body_format: form-urlencoded με body: key=value&key2=value2. Οι multipart μεταφορτώσεις αρχείων απαιτούν το module community.general.uri ή ένα προσαρμοσμένο script. Το curl2code χειρίζεται τις μετατροπές -F.

Χρησιμοποιήστε το register: result με το failed_when: result.status != 200 για προσαρμοσμένες συνθήκες αποτυχίας. Χρησιμοποιήστε το ignore_errors: yes για να συνεχίσετε σε περίπτωση αποτυχίας. Το uri module αποτυγχάνει σε αποκρίσεις που δεν είναι 2xx από προεπιλογή — παρακάμψτε το με το status_code: [200, 201, 404] για να αποδεχτείτε πολλαπλούς κωδικούς κατάστασης.

Το uri module αναλύει αυτόματα το JSON όταν έχει οριστεί το return_content: yes — πρόσβαση μέσω του result.json. Χρησιμοποιήστε φίλτρα Jinja2: result.json.users | selectattr('active') | list. Για σύνθετους μετασχηματισμούς, χρησιμοποιήστε το set_fact με φίλτρα. Καταχωρίστε τα αποτελέσματα για χρήση σε επόμενες εργασίες.

Ορίστε το timeout: 30 στην εργασία uri για το χρονικό όριο του αιτήματος σε δευτερόλεπτα. Για επαναλήψεις: χρησιμοποιήστε το retries: 3 με delay: 5 και until: result.status == 200. Αυτό είναι το ενσωματωμένο πρότυπο βρόχου επανάληψης του Ansible — δεν απαιτείται προσαρμοσμένο scripting. Λειτουργεί με οποιοδήποτε module, όχι μόνο με το uri.

Ορίστε το περιβάλλον στην εργασία: environment: { http_proxy: "http://proxy:8080", https_proxy: "http://proxy:8080" }. Ή ορίστε το καθολικά στο ansible.cfg ή στο group_vars. Το uri module σέβεται τις τυπικές μεταβλητές περιβάλλοντος proxy. Για εξαιρέσεις no-proxy: no_proxy: "localhost,.internal".

Μετατρέψτε μια curl POST εντολή όπως curl -X POST -H "Content-Type: application/json" -d '{"key":"value"}' URL σε Ansible χρησιμοποιώντας το curl2code. Ο παραγόμενος κώδικας χρησιμοποιεί ansible.builtin.uri: url: '{'{ url }'}' method: POST body_format: json body: '{'{ data }'}'. Το curl2code εντοπίζει αυτόματα τα -d/--data flags με JSON περιεχόμενο και ορίζει την κατάλληλη Content-Type κεφαλίδα στον κώδικα του uri module.

Περάστε το curl -H "Authorization: Bearer YOUR_TOKEN" URL στο curl2code και αυτό θα δημιουργήσει κώδικα uri module με την κεφαλίδα εξουσιοδότησης: headers: Authorization: 'Bearer YOUR_TOKEN'. Το curl2code εντοπίζει τα Bearer tokens τόσο από τα -H "Authorization: Bearer ..." όσο και από τα --oauth2-bearer flags. Για Basic auth, χρησιμοποιήστε το -u user:pass.

Το curl2code μετατρέπει το curl -H "Content-Type: application/json" URL σε κώδικα uri module με τη σωστή κεφαλίδα: body_format: json. Για δεδομένα -d, το curl χρησιμοποιεί από προεπιλογή το application/x-www-form-urlencoded· για μεταφορτώσεις φορμών -F, χρησιμοποιεί το multipart/form-data. Το curl2code αντιστοιχίζει το καθένα στο σωστό uri module API.