curl を Ansible に変換

uri モジュールは、プレイブック内で HTTP リクエストを行うための Ansible 組み込みモジュールです。JSON ボディのサポート、認証、ステータスコードの検証を備えた GET、POST、PUT、DELETE を処理します。追加のコレクションは不要で、ansible.builtin の一部です。curl2code は、uri モジュールを使用した Ansible タスクの YAML を生成します。

uri モジュールは API 呼び出し用です。解析された JSON を返し、ステータスを検証します。get_url はファイルをディスクにダウンロードするためのものです。command: curl はアンチパターンであり、べき等性とエラー処理が失われます。HTTP API とのやり取りには常に uri を優先してください。Python による自動化については、curl to Python を参照してください。

Bearer 認証の場合：headers: { Authorization: "Bearer {{ token }}" }。Basic 認証の場合：url_username および url_password パラメータを使用します。シークレットは Ansible Vault で保存します：ansible-vault encrypt_string。uri モジュールは、プリエンプティブ認証のために force_basic_auth: yes もサポートしています。

JSON ボディの場合：body: {{ data | to_json }} を指定して body_format: json。form-urlencoded の場合：body_format: form-urlencoded を指定して body: key=value&key2=value2。マルチパートのファイルアップロードには community.general.uri モジュールまたはカスタムスクリプトが必要です。curl2code は -F の変換を処理します。

カスタムの失敗条件には、register: result と failed_when: result.status != 200 を使用します。失敗しても続行するには ignore_errors: yes を使用します。uri モジュールはデフォルトで 2xx 以外で失敗します。複数のステータスコードを許可するには status_code: [200, 201, 404] で上書きします。

uri モジュールは return_content: yes が設定されている場合、JSON を自動的に解析します。result.json 経由でアクセスしてください。Jinja2 フィルタを使用します：result.json.users | selectattr('active') | list。複雑な変換には、フィルタを備えた set_fact を使用します。結果を登録して、後続のタスクで使用します。

リクエストのタイムアウト（秒）には、uri タスクに timeout: 30 を設定します。リトライには、retries: 3、delay: 5、および until: result.status == 200 を使用します。これは Ansible 組み込みのリトライループパターンであり、カスタムスクリプトは不要です。uri だけでなく、どのモジュールでも機能します。

タスクに環境を設定します：environment: { http_proxy: "http://proxy:8080", https_proxy: "http://proxy:8080" }。または ansible.cfg や group_vars でグローバルに設定します。uri モジュールは標準的なプロキシ環境変数を尊重します。プロキシを除外するには：no_proxy: "localhost,.internal"。

curl2codeを使用して、curl -X POST -H "Content-Type: application/json" -d '{"key":"value"}' URLのようなcurlのPOSTコマンドをAnsibleに変換します。生成されたコードではansible.builtin.uri: url: '{'{ url }'}' method: POST body_format: json body: '{'{ data }'}'を使用します。curl2codeはJSONコンテンツを含む-d/--dataフラグを自動的に検出し、uriモジュールのコードに適切なContent-Typeヘッダーを設定します。

curl -H "Authorization: Bearer YOUR_TOKEN" URLをcurl2codeに渡すと、認証ヘッダーheaders: Authorization: 'Bearer YOUR_TOKEN'を含むuriモジュールのコードが生成されます。curl2codeは-H "Authorization: Bearer ..."と--oauth2-bearerフラグの両方からBearerトークンを検出します。Basic authの場合は、-u user:passを使用してください。

curl2codeはcurl -H "Content-Type: application/json" URLを、適切なヘッダーbody_format: jsonを含むuriモジュールのコードに変換します。-dデータの場合、curlはデフォルトでapplication/x-www-form-urlencodedを使用し、-Fフォームアップロードの場合はmultipart/form-dataを使用します。curl2codeはそれぞれを正しいuriモジュール APIにマッピングします。