Chuyển đổi curl sang Ansible

Module uri là module tích hợp sẵn của Ansible để thực hiện các yêu cầu HTTP trong playbook. Nó xử lý GET, POST, PUT, DELETE với hỗ trợ body JSON, xác thực và xác thực mã trạng thái. Không cần bộ sưu tập bổ sung — nó là một phần của ansible.builtin. curl2code tạo các tác vụ Ansible YAML bằng module uri.

Module uri dành cho các lệnh gọi API — nó trả về JSON đã được phân tích và xác thực trạng thái. get_url dùng để tải tệp xuống đĩa. command: curl là một anti-pattern — làm mất tính lũy đẳng (idempotency) và khả năng xử lý lỗi. Luôn ưu tiên uri cho các tương tác HTTP API. Đối với tự động hóa Python, hãy xem curl sang Python.

Đối với Bearer: headers: { Authorization: "Bearer {{ token }}" }. Đối với Basic auth: sử dụng các tham số url_username và url_password. Lưu trữ các bí mật trong Ansible Vault: ansible-vault encrypt_string. Module uri cũng hỗ trợ force_basic_auth: yes để xác thực phủ đầu.

Đối với body JSON: body: {{ data | to_json }} với body_format: json. Đối với form-urlencoded: body_format: form-urlencoded với body: key=value&key2=value2. Tải lên tệp multipart yêu cầu module community.general.uri hoặc một script tùy chỉnh. curl2code xử lý các chuyển đổi -F.

Sử dụng register: result với failed_when: result.status != 200 cho các điều kiện thất bại tùy chỉnh. Sử dụng ignore_errors: yes để tiếp tục khi thất bại. Module uri mặc định thất bại khi không phải 2xx — ghi đè bằng status_code: [200, 201, 404] để chấp nhận nhiều mã trạng thái.

Module uri tự động phân tích JSON khi return_content: yes được thiết lập — truy cập qua result.json. Sử dụng các bộ lọc Jinja2: result.json.users | selectattr('active') | list. Đối với các biến đổi phức tạp, sử dụng set_fact với các bộ lọc. Đăng ký kết quả để sử dụng trong các tác vụ tiếp theo.

Thiết lập timeout: 30 trên tác vụ uri cho timeout yêu cầu tính bằng giây. Để thử lại: sử dụng retries: 3 với delay: 5 và until: result.status == 200. Đây là mô hình vòng lặp thử lại tích hợp sẵn của Ansible — không cần script tùy chỉnh. Hoạt động với bất kỳ module nào, không chỉ uri.

Thiết lập môi trường trên tác vụ: environment: { http_proxy: "http://proxy:8080", https_proxy: "http://proxy:8080" }. Hoặc thiết lập toàn cục trong ansible.cfg hoặc group_vars. Module uri tuân thủ các biến môi trường proxy tiêu chuẩn. Đối với các ngoại lệ không dùng proxy: no_proxy: "localhost,.internal".

Chuyển đổi một lệnh curl POST như curl -X POST -H "Content-Type: application/json" -d '{"key":"value"}' URL sang Ansible bằng cách sử dụng curl2code. Mã được tạo sử dụng ansible.builtin.uri: url: '{'{ url }'}' method: POST body_format: json body: '{'{ data }'}'. curl2code tự động phát hiện các cờ -d/--data với nội dung JSON và thiết lập header Content-Type phù hợp trong mã module uri.

Cung cấp curl -H "Authorization: Bearer YOUR_TOKEN" URL cho curl2code và nó sẽ tạo mã module uri với header xác thực: headers: Authorization: 'Bearer YOUR_TOKEN'. curl2code phát hiện Bearer tokens từ cả hai cờ -H "Authorization: Bearer ..." và --oauth2-bearer. Đối với Basic auth, hãy sử dụng -u user:pass.

curl2code chuyển đổi curl -H "Content-Type: application/json" URL sang mã module uri với header chính xác: body_format: json. Đối với dữ liệu -d, curl mặc định là application/x-www-form-urlencoded; đối với tải lên biểu mẫu -F, nó sử dụng multipart/form-data. curl2code ánh xạ từng loại tới module uri API chính xác.