第4章 Red Hat Satellite API の使用開始

手順4.1 Satellite サーバーへのコンテンツのアップロード

1. アップロード要求を作成します。デプロイメントに適したサンプルパラメーターを変更するようにしてください。

   $ curl -H "Accept:application/json,version=2" \
          -H "Content-Type:application/json" \
          -X POST \
          -u sat_username:sat_password -k -d "{}" \
          https://satellite6.example.com/katello/api/repositories/3/content_uploads

   このコマンドは、以下のような upload_id を返します。

   {"upload_id":"0be156b1-f373-4cad-89d0-924f8f4491d2","_href":"/pulp/api/v2/content/uploads/0be156b1-f373-4cad-89d0-924f8f4491d2/"}

2. コンテンツをアップロードします。データのアップロード時には、正しい MIME タイプを使用していることを確認します。Satellite 6 に対する要求にはほぼ、「application/json」の MIME タイプが使用されます。upload_id と MIME タイプ、他のパラメーターを組み合わせてコンテンツをアップロードします。

   $ curl -H "Accept:application/json,version=2" \
          -H "Content-Type:multipart/form-data" \
          -X PUT \
          -u sat_username:sat_password \
          -k --data-urlencode "content@/home/sat6user/rpmbuild/RPMS/noarch/python-scripttest-1.1.1-1.fc21.noarch.rpm" \
          --data-urlencode offset=0 \
          https://satellite6.example.com/katello/api/repositories/3/content_uploads/0be156b1-f373-4cad-89d0-924f8f4491d2

3. Satellite サーバーにコンテンツをアップロードした後に、適切なリポジトリーにそのコンテンツをインポートする必要があります。この手順を完了するまで、Satellite サーバーではこの新しいコンテンツは認識されません。

   $ curl -H "Accept:application/json,version=2" \
          -H "Content-Type:application/json" \
          -X PUT \
          -u sat_username:sat_password \
          -k -d "{\"upload_ids\":[\"0be156b1-f373-4cad-89d0-924f8f4491d2\"]}" \
          https://satellite6.example.com/katello/api/repositories/3/import_uploads

4. コンテンツのアップロードおよびインポートが正常に完了したら、アップロード要求を削除することができます。削除することで、アップロード中に使用した一時的なディスク領域を解放することができます。

   $ curl -H "Accept:application/json,version=2" \
          -H "Content-Type:application/json" \
          -X DELETE -d "{}" \
          -u sat_username:sat_password \
          -k https://satellite6.example.com/katello/api/repositories/3/content_uploads/0be156b1-f373-4cad-89d0-924f8f4491d2

手順4.2 外部ファイルを使用したスマートクラスパラメーターの変更

1. 今回は motd という名前で Puppet クラスを検索します。

   $ curl -H "Accept:application/json,version=2" \
   -H "Content-Type:application/json" -X GET \
   -u sat_user:sat_passwd -k \
   "https://satellite6.example.com/api/smart_class_parameters?search=puppetclass_name=motd” \
   | python -m json.tool
   {
   "page": 1,
   "per_page": 20,
   "results": [
   {
   "avoid_duplicates": false,
   "created_at": "2017-02-06 12:37:48 UTC",
   "default_value": "",
   "description": "",
   "hidden_value": "*****",
   "hidden_value?": false,
   "id": 3,
   "merge_default": false,
   "merge_overrides": false,
   "override": false,
   "override_value_order": "fqdn\nhostgroup\nos\ndomain",
   "override_values_count": 0,
   "parameter": "content",
   "parameter_type": "string",
   "puppetclass_id": 3,
   "puppetclass_name": "motd",
   "required": false,
   "updated_at": "2017-02-07 13:08:42 UTC",
   "use_puppet_default": false,
   "validator_rule": null,
   "validator_type": ""
   },
   {
   "avoid_duplicates": false,
   "created_at": "2017-02-06 12:37:48 UTC",
   "default_value": true,
   "description": "",
   "hidden_value": "*****",
   "hidden_value?": false,
   "id": 1,
   "merge_default": false,
   "merge_overrides": false,
   "override": false,
   "override_value_order": "fqdn\nhostgroup\nos\ndomain",
   "override_values_count": 0,"parameter": "dynamic_motd",
   "parameter_type": "boolean",
   "puppetclass_id": 3,
   "puppetclass_name": "motd",
   "required": false,
   "updated_at": "2017-02-06 15:21:06 UTC",
   "use_puppet_default": null,
   "validator_rule": null,
   "validator_type": null
   },
   {
   "avoid_duplicates": false,
   "created_at": "2017-02-06 12:37:48 UTC",
   "default_value": "",
   "description": "",
   "hidden_value": "*****",
   "hidden_value?": false,
   "id": 2,
   "merge_default": false,
   "merge_overrides": false,
   "override": false,
   "override_value_order": "fqdn\nhostgroup\nos\ndomain",
   "override_values_count": 0,
   "parameter": "template",
   "parameter_type": "string",
   "puppetclass_id": 3,
   "puppetclass_name": "motd",
   "required": false,
   "updated_at": "2017-02-06 15:21:06 UTC",
   "use_puppet_default": null,
   "validator_rule": null,
   "validator_type": null
   }
   ],
   "search": "puppetclass_name=motd",
   "sort": {
   "by": null,
   "order": null
   },
   "subtotal": 3,
   "total": 66
   }

   スマートクラスパラメーターはそれぞれ、同じ Satellite インスタンスにおいてグローバルな ID となっています。motd クラスの content パラメーターは、この Satellite サーバーでは id=3 です。この ID は、Puppet クラス名の前に表示される Puppet クラス ID と間違わないようにしてください。
2. パラメーター ID 3 を使用して、motd パラメーター固有の情報を取得して、出力を output_file.json などのファイルにリダイレクトします。

   $ curl -H "Accept:application/json,version=2" \
   -H "Content-Type:application/json" -X GET \
   -u sat_user:sat_passwd -k \
   "https://satellite6.example.com/api/smart_class_parameters/3 \
   | python -m json.tool > output_file.json

3. 以前の手順で作成したファイルを changed_file.json という新しいファイルにコピーして編集します。エディターでファイルを開き、任意の値に変更します。以下の例では、motd モジュールのコンテンツパラメーターを変更します。この際、override オプションを false から true に変更する必要があります。

   {
   "avoid_duplicates": false,
   "created_at": "2017-02-06 12:37:48 UTC", # This line must be removed.
   "default_value": "", # A new value should be supplied here.
   "description": "",
   "hidden_value": "*****",
   "hidden_value?": false,
   "id": 3,
   "merge_default": false,
   "merge_overrides": false,
   "override": false, # The override value must be set to true.
   "override_value_order": "fqdn\nhostgroup\nos\ndomain",
   "override_values": [], # This line must be removed.
   "override_values_count": 0,
   "parameter": "content",
   "parameter_type": "string",
   "puppetclass_id": 3,
   "puppetclass_name": "motd",
   "required": false,
   "updated_at": "2017-02-07 11:56:55 UTC", # This line must be removed.
   "use_puppet_default": false,
   "validator_rule": null,
   "validator_type": ""
   }

4. ファイルの編集後に、以下のようになっていることを確認して、変更を保存します。

   {
   "avoid_duplicates": false,
   "default_value": "No Unauthorized Access Allowed",
   "description": "",
   "hidden_value": "*****",
   "hidden_value?": false,
   "id": 3,
   "merge_default": false,
   "merge_overrides": false,
   "override": true,
   "override_value_order": "fqdn\nhostgroup\nos\ndomain",
   "override_values_count": 0,
   "parameter": "content",
   "parameter_type": "string",
   "puppetclass_id": 3,
   "puppetclass_name": "motd",
   "required": false,
   "use_puppet_default": false,
   "validator_rule": null,
   "validator_type": ""
   }

5. 以下のように PUT コマンドを使用して、Satellite サーバーに変更を適用します。

   $ curl -H "Accept:application/json,version=2" \
   -H "Content-Type:application/json" \
   -X PUT -u $user:$passwd \
   -d @changed_file.json \
   -k "https://satellite6.example.com/api/smart_class_parameters/3