Convertește curl în Ansible

Modulul uri este modulul încorporat în Ansible pentru a efectua cereri HTTP în cadrul playbook-urilor. Gestionează GET, POST, PUT, DELETE cu suport pentru corp JSON, autentificare și validarea codului de stare. Nu este necesară nicio colecție suplimentară — face parte din ansible.builtin. curl2code generează YAML pentru sarcini Ansible folosind modulul uri.

Modulul uri este pentru apeluri API — returnează JSON parsat și validează starea. get_url este pentru descărcarea fișierelor pe disc. command: curl este un anti-pattern — se pierde idempotența și gestionarea erorilor. Preferați întotdeauna uri pentru interacțiunile cu API-uri HTTP. Pentru automatizare Python, consultați curl către Python.

Pentru Bearer: headers: { Authorization: "Bearer {{ token }}" }. Pentru autentificarea Basic: folosiți parametrii url_username și url_password. Stocați secretele în Ansible Vault: ansible-vault encrypt_string. Modulul uri suportă, de asemenea, force_basic_auth: yes pentru autentificare preemptivă.

Pentru corpuri JSON: body: {{ data | to_json }} cu body_format: json. Pentru form-urlencoded: body_format: form-urlencoded cu body: key=value&key2=value2. Încărcările de fișiere multipart necesită modulul community.general.uri sau un script personalizat. curl2code gestionează conversiile -F.

Folosiți register: result cu failed_when: result.status != 200 pentru condiții de eșec personalizate. Folosiți ignore_errors: yes pentru a continua în caz de eșec. Modulul uri eșuează la răspunsurile non-2xx în mod implicit — suprascrieți cu status_code: [200, 201, 404] pentru a accepta mai multe coduri de stare.

Modulul uri parsează automat JSON când return_content: yes este setat — accesați prin result.json. Folosiți filtre Jinja2: result.json.users | selectattr('active') | list. Pentru transformări complexe, folosiți set_fact cu filtre. Înregistrați rezultatele pentru a fi utilizate în sarcinile ulterioare.

Setați timeout: 30 pe sarcina uri pentru timeout-ul cererii în secunde. Pentru reîncercări: folosiți retries: 3 cu delay: 5 și until: result.status == 200. Acesta este modelul de buclă de reîncercare încorporat în Ansible — nu este nevoie de scripting personalizat. Funcționează cu orice modul, nu doar cu uri.

Setați mediul pe sarcină: environment: { http_proxy: "http://proxy:8080", https_proxy: "http://proxy:8080" }. Sau setați global în ansible.cfg sau group_vars. Modulul uri respectă variabilele de mediu standard pentru proxy. Pentru excepții no-proxy: no_proxy: "localhost,.internal".

Convertește o comandă curl POST precum curl -X POST -H "Content-Type: application/json" -d '{"key":"value"}' URL în Ansible folosind curl2code. Codul generat utilizează ansible.builtin.uri: url: '{'{ url }'}' method: POST body_format: json body: '{'{ data }'}'. curl2code detectează automat flag-urile -d/--data cu conținut JSON și setează antetul Content-Type corespunzător în codul modulului uri.

Introdu curl -H "Authorization: Bearer YOUR_TOKEN" URL în curl2code și acesta va genera cod pentru modulul uri cu antetul de autentificare: headers: Authorization: 'Bearer YOUR_TOKEN'. curl2code detectează Bearer tokens atât din flag-urile -H "Authorization: Bearer ...", cât și din --oauth2-bearer. Pentru Basic auth, utilizează -u user:pass.

curl2code convertește curl -H "Content-Type: application/json" URL în cod pentru modulul uri cu antetul corect: body_format: json. Pentru datele -d, curl folosește implicit application/x-www-form-urlencoded; pentru încărcările de formulare -F, folosește multipart/form-data. curl2code mapează fiecare opțiune către API-ul modulului uri corect.