6.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. size と checksum を使用して、リクエストのアップロード ID を返すアップロードリクエストを作成します。

   要求例:

   $ curl -H 'Content-Type: application/json' -X POST -k \
   -u My_User_Name:My_Password \
   -d "{\"size\": \"$size\", \"checksum\":\"$checksum\"}" \
   https://satellite.example.com/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 へのリクエストに application/json MIME タイプを使用します。アップロード ID、MIME タイプ、その他のパラメーターを組み合わせてコンテンツをアップロードします。

   要求例:

   $ curl -u My_User_Name:My_Password -H Accept:application/json -H \
   Content-Type:multipart/form-data --request PUT --data-urlencode size=$size --data-urlencode offset=0 \
   --data-urlencode content@${path} \
   https://satellite.example.com/katello/api/v2/repositories/76/content_uploads/$upload_id

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

   要求例:

   $ curl -H "Content-Type:application/json" -X PUT -u \
   My_User_Name:My_Password -k -d \
   "{\"uploads\":[{\"id\": \"$upload_id\", \"name\": \"$name\", \
   \"checksum\": \"$checksum\" }]}" \
   https://satellite.example.com/katello/api/v2/repositories/76/import_uploads

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

   要求例:

   $ curl -H 'Content-Type: application/json' -X DELETE -k \
   -u My_User_Name:My_Password -d "{}" \
   https://satellite.example.com/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. 以下のコマンドは、新しいアップロード要求を作成し、size と checksum を使用して要求のアップロード ID を返します。

   要求例:

   $ curl -H 'Content-Type: application/json' -X POST -k \
   -u My_User_Name:My_Password -d "{\"size\": \"$size\", \
   \"checksum\":\"$checksum\"}" \
   https://satellite.example.com/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 My_User_Name:My_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://satellite.example.com/katello/api/v2/repositories/76/content_uploads/$upload_id
   
   $ curl -u My_User_Name:My_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://satellite.example.com/katello/api/v2/repositories/76/content_uploads/$upload_id
   
   $ curl -u My_User_Name:My_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://satellite.example.com/katello/api/v2/repositories/76/content_uploads/$upload_id
   
   $curl -u My_User_Name:My_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://satellite.example.com/katello/api/v2/repositories/76/content_uploads/$upload_id
   
   $ curl -u My_User_Name:My_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://satellite.example.com/katello/api/v2/repositories/76/content_uploads/$upload_id

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

   $ curl -H "Content-Type:application/json" -X PUT -u \
   My_User_Name:My_Password -k -d \
   "{\"uploads\":[{\"id\": \"$upload_id\", \
   \"name\": \"$name\", \"checksum\": \"$checksum\" }]}" \
   https://satellite.example.com/katello/api/v2/repositories/76/import_uploads

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

    $ curl -H 'Content-Type: application/json' -X DELETE -k \
    -u My_User_Name:My_Password -d "{}" \
    https://satellite.example.com/katello/api/v2/repositories/76/content_uploads/$upload_id