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

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

手順

1. パッケージ名を変数 名 に割り当てます。

   要求例:

   $ export name=jq-1.6-2.el7.x86_64.rpm

2. ファイルのチェックサムを変数 チェックサム に割り当てます。

   要求例:

   $ export checksum=$(sha256sum $name|cut -c 1-65)

3. ファイルサイズを変数 サイズ に割り当てます。

   要求例:

   $ export size=$(du -bs $name|cut -f 1)

4. 以下のコマンドは、新しいアップロード要求を作成し、サイズ と チェックサム を使用して要求のアップロード ID を返します。

   要求例:

   $ curl -H 'Content-Type: application/json' -X POST -k \
   -u sat_username:sat_password -d "{\"size\": \"$size\", \
   \"checksum\":\"$checksum\"}" \
   https://$(hostname -f)/katello/api/v2/repositories/76/content_uploads

   今回の場合は、76 はリポジトリー ID の例です。

   要求例:

   {"upload_id":"37eb5900-597e-4ac3-9bc5-2250c302fdc4"}

5. 変数 upload_id にアップロード ID を割り当てます。

   要求例:

   $ export upload_id=37eb5900-597e-4ac3-9bc5-2250c302fdc4

6. アップロードするパッケージのパスを変数 パス に割り当てます。

   $ export path=/root/jq/jq-1.6-2.el7.x86_64.rpm

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

   要求例:

   $ curl -u sat_username:sat_password -H Accept:application/json -H \
   Content-Type:multipart/form-data -X PUT --data-urlencode size=$size --data-urlencode offset=0 \
   --data-urlencode content@${path} \
   https://$(hostname -f)/katello/api/v2/repositories/76/content_uploads/$upload_id

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

   要求例:

   $ curl -H "Content-Type:application/json" -X PUT -u \
   sat_username:sat_password -k -d \
   "{\"uploads\":[{\"id\": \"$upload_id\", \"name\": \"$name\", \
   \"checksum\": \"$checksum\" }]}" \
   https://$(hostname -f)/katello/api/v2/repositories/76/import_uploads

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

   要求例:

   $ curl -H 'Content-Type: application/json' -X DELETE -k \
   -u sat_username:sat_password -d "{}" \
   https://$(hostname -f)/katello/api/v2/repositories/76/content_uploads/$upload_id

1. パッケージ名を変数 名 に割り当てます。

   $ export name=bpftool-3.10.0-1160.2.1.el7.centos.plus.x86_64.rpm

2. ファイルのチェックサムを変数 チェックサム に割り当てます。

   $ export  checksum=$(sha256sum $name|cut -c 1-65)

3. ファイルサイズを変数 サイズ に割り当てます。

   $ export  size=$(du -bs $name|cut -f 1)

4. 以下のコマンドは、新しいアップロード要求を作成し、サイズ と チェックサム を使用して要求のアップロード ID を返します。

   要求例:

   $ curl -H 'Content-Type: application/json' -X POST -k \
   -u sat_username:sat_password -d "{\"size\": \"$size\", \
   \"checksum\":\"$checksum\"}" \
   https://$(hostname -f)/katello/api/v2/repositories/76/content_uploads

   今回の場合は、76 はリポジトリー ID の例です。

   出力例

   {"upload_id":"37eb5900-597e-4ac3-9bc5-2250c302fdc4"}

5. 変数 upload_id にアップロード ID を割り当てます。

   $ export upload_id=37eb5900-597e-4ac3-9bc5-2250c302fdc4

6. ファイルを 2MB のチャンクに分割します。

   $ split --bytes 2MB --numeric-suffixes \
   --suffix-length=1 bpftool-3.10.0-1160.2.1.el7.centos.plus.x86_64.rpm bpftool

   出力例

   $ ls bpftool[0-9] -l
   -rw-r--r--. 1 root root 2000000 Mar 31 14:15 bpftool0
   -rw-r--r--. 1 root root 2000000 Mar 31 14:15 bpftool1
   -rw-r--r--. 1 root root 2000000 Mar 31 14:15 bpftool2
   -rw-r--r--. 1 root root 2000000 Mar 31 14:15 bpftool3
   -rw-r--r--. 1 root root  868648 Mar 31 14:15 bpftool4

7. 分割ファイルの接頭辞を変数パスに割り当てます。

   $ export path=/root/tmp/bpftool

8. ファイルのチャンクをアップロードします。オフセットは、最初のチャンクの 0 から始まり、ファイルごとに 2000000 ずつ増加します。offset パラメーターを使用して、ファイルサイズと関連付けている点に注意してください。また、インデックスはパス変数の後に使用されます (例: ${path}0、${path}1)。

   要求例:

   $ curl -u sat_username:sat_password -H Accept:application/json -H \
   Content-Type:multipart/form-data  \
   -X PUT --data-urlencode size=$size --data-urlencode offset=0 \
   --data-urlencode content@${path}0 https://$(hostname -f)/katello/api/v2/repositories/76/content_uploads/$upload_id
   
   $ curl -u sat_username:sat_password -H Accept:application/json -H \
   Content-Type:multipart/form-data \
   -X PUT --data-urlencode size=$size --data-urlencode offset=2000000 \
   --data-urlencode content@${path}1 https://$(hostname -f)/katello/api/v2/repositories/76/content_uploads/$upload_id
   
   $ curl -u sat_username:sat_password -H Accept:application/json -H \
   Content-Type:multipart/form-data \
   -X PUT --data-urlencode size=$size --data-urlencode offset=4000000 \
   --data-urlencode content@${path}2 https://$(hostname -f)/katello/api/v2/repositories/76/content_uploads/$upload_id
   
   $curl -u sat_username:sat_password -H Accept:application/json -H \
   Content-Type:multipart/form-data \
   -X PUT --data-urlencode size=$size --data-urlencode offset=6000000
   --data-urlencode content@${path}3 https://$(hostname -f)/katello/api/v2/repositories/76/content_uploads/$upload_id
   
   $ curl -u sat_username:sat_password -H Accept:application/json -H \
   Content-Type:multipart/form-data \
   -X PUT --data-urlencode size=$size --data-urlencode offset=8000000 \
   --data-urlencode content@${path}4 https://$(hostname -f)/katello/api/v2/repositories/76/content_uploads/$upload_id

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

   $ curl -H "Content-Type:application/json" -X PUT -u \
   sat_username:sat_password -k -d \
   "{\"uploads\":[{\"id\": \"$upload_id\", \
   \"name\": \"$name\", \"checksum\": \"$checksum\" }]}" \
   https://$(hostname -f)/katello/api/v2/repositories/76/import_uploads

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

    $ curl -H 'Content-Type: application/json' -X DELETE -k \
    -u sat_username:sat_password -d "{}" \
    https://$(hostname -f)/katello/api/v2/repositories/76/content_uploads/$upload_id