5.3. Satellite Server へのコンテンツのアップロード

以下のセクションでは、Satellite 6 API を使用して Satellite Server に大容量のファイルをアップグレードしてインポートする方法を説明します。このプロセスでは、4 つの手順が含まれます。

  1. アップロード要求を作成します。
  2. コンテンツをアップロードします。
  3. コンテンツをインポートします。
  4. アップロード要求を削除します。

アップロード可能な最大ファイルサイズは、約 2 MB です。大容量のコンテンツのアップロードに関する情報は、2 MB よりも大きいコンテンツのアップロード を参照してください。

手順

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

    要求例: 

    $ curl --header "Accept:application/json" \
--header "Content-Type:application/json" \
--request POST --insecure \
--user sat_username:sat_password  --data "{}" \
https://satellite.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/"}

    コンテンツのアップロード用に upload_id をメモします。

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

    要求例: 

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

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

    要求例: 

    $ curl --header "Accept:application/json" \
--header "Content-Type:application/json" \
--request PUT --insecure \
--user sat_username:sat_password \
--data "{\"uploads\":[\"0be156b1-f373-4cad-89d0-924f8f4491d2\"]}" \
https://satellite.example.com/katello/api/repositories/3/import_uploads

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

    要求例: 

    $ curl --header "Accept:application/json" \
--header "Content-Type:application/json" \
--request DELETE --insecure \
--user sat_username:sat_password --data "{}" \
https://satellite.example.com/katello/api/repositories/3/content_uploads/0be156b1-f373-4cad-89d0-924f8f4491d2

2 MB よりも大きいコンテンツのアップロード

以下の例では、大容量のファイルを複数のチャンクに分割して、アップロード要求の作成、個別ファイルのアップロード、Satellite へのインポートを行ってから、アップロード要求を削除する方法を説明しています。この例は、サンプルのコンテンツ、ホスト名、ユーザー名、ファイル名を使用している点に注意してください。

  1. 以下の例を使用して、ファイルを 2MB のチャンクに分割します。 

    $ split --bytes 2MB --numeric-suffixes --suffix-length=1 \
theforeman-foreman-5.0.1.tar.gz foreman_module.

  2. 結果ファイルを表示します。 

    $ ls -la theforeman-foreman-5.0.1.tar.gz foreman_module.*
-rw-r--r--. 1 root root 50000 Nov  4 04:42 foreman_module.0
-rw-r--r--. 1 root root 32928 Nov  4 04:42 foreman_module.1
-rw-r--r--. 1 root root 82928 Nov  4 04:41 theforeman-foreman-5.0.1.tar.gz

  3. アップロード要求を作成します。

    要求例: 

    $ curl --header "Accept:application/json" \
--header "Content-Type:application/json" \
--request POST --insecure --user sat_username:sat_password --data "{}" \
https://ibm-vm01.example.com/katello/api/repositories/2/content_uploads

    応答例: 

    {"upload_id":"9585528f-07ad-4bb1-9c80-ccece249b2b7","_href":"/pulp/api/v2/content/uploads/9585528f-07ad-4bb1-9c80-ccece249b2b7/"}

    コンテンツのアップロード用に upload_id をメモします。

  4. Satellite Server に、ファイルのチャンクをアップロードします。以下の例で offset パラメーターを使用して、ファイルサイズと関連付けている点に注意してください。

    要求例: 

    $ curl --header "Accept:application/json" \
--header "Content-Type:multipart/form-data" \
--request PUT --insecure --user sat_username:sat_password \
--data-urlencode "content@foreman_module.0" \
--data-urlencode offset=0 \
https://ibm-vm01.example.com/katello/api/repositories/2/content_uploads/9585528f-07ad-4bb1-9c80-ccece249b2b7

  5. 完全なアップロードをリポジトリーにインポートします。 

    $ curl --header "Accept:application/json" \
--header "Content-Type:application/json" \
--request PUT --insecure --user sat_username:sat_password \
--data "{\"upload_ids\":[\"9585528f-07ad-4bb1-9c80-ccece249b2b7\"]}" \
https://ibm-vm01.example.com/katello/api/repositories/2/import_uploads

  6. アップロード要求を削除します。 

    $ curl --header "Accept:application/json" \
--header "Content-Type:application/json" \
--request DELETE --insecure --user sat_username:sat_password --data "{}" \
https://ibm-vm01.example.com/katello/api/repositories/2/content_uploads/9585528f-07ad-4bb1-9c80-ccece249b2b7

  7. Satellite Server で、転送したファイルを確認します。 

    # ls -la /var/lib/pulp/content/puppet_module/theforeman-foreman-5.0.1.tar.gz
-rw-r--r--. 1 apache apache 82928 Nov  4 04:55 /var/lib/pulp/content/puppet_module/theforeman-foreman-5.0.1.tar.gz

  8. 元のファイルと転送したファイルを比較して、同じであることを確認します。 

    $ cmp /var/lib/pulp/content/puppet_module/theforeman-foreman-5.0.1.tar.gz \
theforeman-foreman-5.0.1.tar.gz