:faasutilを使う

faasutilを使用する場合は、次の項目に注意してください。

• faasutilコマンドを実行するには、次の方法を使用します。. /faasutil [コマンド].

• faasutilコマンドとそのパラメータは大文字と小文字を区別します。

  たとえば、コマンドを実行するとエラーが発生します。. /faasutil Create_Image-オブジェクト=faasutiltest-forcompiling.tar.gz-シェル=f30010-FPGAType=xilinx-Name=faasutiltest-imageコマンドを実行します。 コマンドとそのパラメータのスペルは、定義されているのと同じ方法で指定する必要があります。

• パラメーター名、等号 (=) 、およびパラメーター値の各ペアの間にスペースがないことを確認します。

  たとえば、コマンドを実行するとエラーが発生します。. /faasutil create_image -- object=faasutiltest-forcompiling.tar.gz-シェル=f30010-fpgatype=xilinx-name=faasutiltest-imageコマンドを実行します。 shellパラメーターの横にある等号 (=) の前後のスペースを削除する必要があります。

• 通常のユーザーとして操作する場合は、管理者に連絡して /dev/virtio-ports/FaaS.agentディレクトリを使用する権限を申請してください。

faasutilが提供するコマンドを実行して、ヘルプ情報の取得、環境の設定、FPGAイメージの管理を行うことができます。 次の表に操作を示します。

コマンド構文

• faasutil -- ヘルプ

• faasutil -h

サンプルコード

[user1 @ i **** ~]# 。/faasutil -h
faasutil [コマンド] [optons]...
  説明
    faasutilはfpgaイメージ管理ツールです。
    バージョン: 2.0.3a
    日付: 2020-07-08-11:04
  コマンドリスト (詳細は "faasutil [command] -- help" を使用してください):
    config設定faasutil環境。
    list_instancesインスタンスベース情報を印刷します。
    fpga_statusポイントされたfpgaステータスを確認します。
    auth指定したossバケットの読み取りをFAASに許可します。
    list_objects指定したバケットのオブジェクトを一覧表示します。
    put_objectローカルファイルをバケットオブジェクトに配置すると、FAASはossからダウンロードする必要があります。
    get_object ossバケットからオブジェクトを取得します。
    list_policy FAASへのossポリシー権限に関する詳細情報を一覧表示します。
    delete_policy ossポリシー権限をFAASに削除します。
    list_images fpgaイメージを一覧表示する
    create_image fpgaイメージを作成します。
    modify_image fpgaイメージを変更します。
    delete_image fpgaイメージを削除します。
    bind_image FPGAイメージをECSイメージにバインドします。
    download_image FPGAイメージをfaasインスタンスにダウンロードします。
    download_statusイメージのダウンロード操作のステータス。
    copy_fpga_imageリージョン間で画像をコピーします。
    query_logコンパイラログを取得します。

コマンド構文

• faasutil [コマンド名] -- help

• faasutil [コマンド名] -h

サンプルコード

[user1 @ i **** ~]# 。/faasutil config -- help
  コマンド
    config
  SYNOPSIS
    config -- id=[accessid] -- key=[accesskey] -- token=[sts-token] -- bucket=[bucket] -- regionId=[regionId] -- ossEndpoint=[ossEndpoint] -- popEndpoint=[popEndpoint]
  説明
    設定faasutil環境。
    /* 設定を使用してこれらのフォローオプションの値を保存します。* /
    /* これらのオプションの値は、指定する必要のあるコマンドに従って設定することもできます。* /
  OPTIONS
    required
    -- id
        設定を使用してこの情報を保存するユーザーアクセスid。
    -- キー
        設定を使用してこの情報を保存するユーザーアクセスキー。
    optional
    -- token
        設定を使用してこの情報を保存するユーザーstoken。
    -- bucket
        画像のアップロードに使用されるバケット。
    -- regionId
        popエンドポイントとossエンドポイントのリージョン。
        パブリックネットワークのecs地域を使用するデフォルト。
    -- ossEndpoint
        Ossエンドポイント情報。
        異なるリージョンまたはvpcネットワークでファイルを取得 /配置する場合は、ossエンドポイントを指定します。
    -- popEndpoint
        ポップエンドポイント情報。
    -- instanceId
        ECS インスタンスの ID
        デフォルトでは、ローカルECS IDを使用します。
    -- ecsImageId
        ECSイメージID。
        デフォルトでは、ローカルECS IDのイメージIDを使用します。
    -- シェル
        使用したシェルバージョンを指定します。
        デフォルトでは、ECS fpgaカードのシェルバージョンを使用します。
    -- fpgatype
        FPGAデバイスタイプを指定します。
        FPGAデバイスタイプを使用するデフォルトは、ローカルECSに属します。

ユーザー情報をデフォルトの構成ファイルに書き込みます。 ユーザー情報を設定するためのパラメーターを次の表に示します。

コマンド構文

faasutil config -- id=[accessid] -- key=[accesskey] -- token=[sts-token] -- bucket=[bucket] -- regionId=[regionId] -- ossEndpoint=[ossEndpoint] -- popEndpoint=[popEndpoint]

次の表に、コマンド構文のパラメーターを示します。

サンプルコード

[user1 @ i **** ~]# 。/faasutil config -- id=L **** -- key=v **** -- bucket=yk ****
設定は /home/user1/.faascredentialsに保存されます。
1.057経過 

コマンド構文

faasutil auth

サンプルコード

[user1 @ i **** ~]# 。/faasutil auth
{
  "Statement": [
    {
      "Action": [
        "oss：GetObject"、
        "oss:GetObjectMeta" 、
        "oss:ListObjects"
      ],
      "Effect": "Allow",
      "Principal": [
        "26143530338319 ****"
      ],
      "Resource": [
        "acs:oss:*:*:yk ****/*"
      ]
    }
  ],
  "バージョン": "1"
}

0.223経過 

コマンド構文

faasutil list_policy

サンプルコード

[user1 @ i **** ~]# 。/faasutil list_policy
ポリシーテキストを取得する:
{
  "Statement": [
    {
      "Action": [
        "oss：GetObject"、
        "oss:GetObjectMeta" 、
        "oss:ListObjects"
      ],
      "Effect": "Allow",
      "Principal": [
        "26143530338319 ****"
      ],
      "Resource": [
        "acs:oss:*:*:yk ****/*"
      ]
    }
  ],
  "バージョン": "1"
}
0.203経過 

コマンド構文

faasutil delete_ポリシー

サンプルコード

[user1 @ i **** ~]# 。/faasutil delete_policy
0.210経過 

コマンド構文

faasutil list_instances

サンプルコード

この例では、2つのFPGAデバイスがFPGAアクセラレーションインスタンスに接続されています。 fpgaデバイスのFPGA bdfパラメーターは、それぞれ00:09.0と00:08.0に設定されます。

[user1 @ i **** ~]# 。/faasutil list_instances
instance_id : i-uf616ov8zzwmiijb ****
image_id : centos_7_8_x64_20G_alibase_20200914.vhd
regionId : cn-shanghai
fpga bdf : ['00:09.0 ', '00:08.0']
シェルバージョン: f30010
requestId : x-7762368991973 ****
fpgaタイプ: xilinx
1.054経過 

コマンド構文

faasutil fpga_status -- bdf=[bdf]

サンプルコード

次のサンプルコードは、bdf値が00:09.0に設定されているFPGAデバイスのステータスを照会する方法の例を示しています。

imageuuidパラメーターは、指定されたFPGAイメージのUUIDを示します。 新しく購入したFPGAアクセラレーションインスタンスの場合、imageuuidパラメーターの値はNULLです。

[user1 @ i **** ~]# 。/faasutil fpga_status -- bdf=00:09.0
clock0 : 240
clock1 : 189
fpgaStatus: 有効
requestId : x-1093970844245 ****
shellUUID : f30010
imageuuid : NULL
ファイアウォール: ['mgmt : GOOD', 'user : GOOD', 'xdma : GOOD', 'dma : GOOD']
ddr : ['ddr0 : online', 'ddr1 : online', 'ddr2 : online', 'ddr3 : online']
message : FPGAは動作しています。
1.025経過 

コマンド構文

faasutil put_object -- bucket=[bucket_name] -- object=[object_name] -- file=[file_name]

次の表に、コマンド構文のパラメーターを示します。

• [bucket_name]: OSSバケットの名前。

  説明

  configコマンドを実行して、デフォルトの設定ファイルでOSSバケットを指定した場合、bucketパラメーターを指定する必要はありません。

• [file_name]: アップロードするファイルの名前。

• [object_name]: OSSバケット内のアップロードされたファイルの表示名。

サンプルコード

[user1 @ i **** ~]# 。/faasutil put_object -- object=faasutiltest-forcompiling.tar.gz -- file=faasutiltest.tar.gz
100%

539.171経過 

コマンド構文

faasutil list_objects

サンプルコード

[user1 @ i **** ~]# 。/faasutil list_objects
faasutiltest-forcompiling.tar.gz
0.288経過 

コマンド構文

faasutil get_object -- bucket=[bucket_name] -- object=[object_name] -- file=[file_name]

次の表に、コマンド構文のパラメーターを示します。

• [bucket_name]: OSSバケットの名前。

  説明

  configコマンドを実行して、デフォルトの設定ファイルでOSSバケットを指定した場合、bucketパラメーターを指定する必要はありません。

• [file_name]: ダウンロードするファイルの名前。

• [object_name]: FPGAアクセラレーションインスタンスでダウンロードしたファイルの表示名。

サンプルコード

[user1 @ i **** ~]# 。/faasutil get_object -- object=faasutiltest-forcompiling.tar.gz -- file=faasutiltest-fordeveloping.tar.gz
100%

179.909経過 

rawファイルを使用してFPGAイメージをコンパイルおよび生成します。

コマンド構文

faasutil create_image -- object=[object_name] -- shell=[shell_ver] -- fpgatype=[fpga_type]

次の表に、コマンド構文のパラメーターを示します。

• [object_name]: コンパイルに使用される生のファイルの名前。 rawファイルがOSSバケットにアップロードされていることを確認します。

• [shell_ver]: FPGAデバイスのシェルバージョン。 fpga_statusコマンドを実行して、FPGAデバイスのシェルバージョンを表示できます。 詳細については、このトピックの「FPGAデバイスのステータスの照会」をご参照ください。

• [fpga_type]: FPGAデバイスのタイプ。 ザイリンクスFPGA (Xilinx) とIntel FPGA (intel) がサポートされています。 FPGAデバイスのタイプに基づいてこのパラメーターを指定します。

サンプルコード

[user1 @ i **** ~]# 。/faasutil create_image -- object=faasutiltest-forcompiling.tar.gz-シェル=f30010-fpgatype=xilinx-name=faasutiltest-image
{
  "CreateTime": "2020-12-04 14:48:13" 、
  "Description": "",
  "FpgaImageUniqueId": "xilinxb80832c9-1cd1-49a2-a7b4-7d3a5a4b ****" 、
  "名前": "faasutiltest-image" 、
  "RequestId": "2E996CE5-F550-43E7-8016-DAF0D32A96BF" 、
  "ShellUniqueId": "f30010" 、
  "状態": "キューイング"
}
0.555経過 

コマンド構文

faasutil query_log -- fpgaImageUniqueId=[fpgaImageUniqueId]

サンプルコード

[user1 @ i **** ~]# 。/faasutil query_log -- fpgaImageUniqueId=xilinxb80832c9-1cd1-49a2-a7b4-7d3a5a4b ****
{
  "ログ": " http://aliyun-faas-images-cn-shanghai.oss-cn-shanghai-internal.aliyuncs.com/27095692903785 **** % 2Fxilinxb80832c9-1cd1-49a2-a7b4-7d3a5a4b ****_ログ? 有効期限=160706 ****&OSSAccessKeyId=L ****&署名=1 ****" 、
  "RequestId": "07A744F5-422D-49AA-B69B-1AD898BBD1D8"
}
0.194経過 

この例では、コマンド出力にURLが表示されます。 URLにアクセスしてログを取得できます。 サンプルURL: http:// aliyun-faas-images ****-internal.aliyuncs ****&Signature=1 ****

コマンド構文

faasutil list_images -- owneralias=[owner]

サンプルコード

[user1 @ i **** ~]# 。/faasutil list_images
{
  "FpgaImages": [
    {
      "CreateTime": "2020-12-04 14:48:14" 、
      "説明": "faasutilテストラウンド1" 、
      "暗号化": false、
      "FpgaImageUniqueId": "xilinxb80832c9-1cd1-49a2-a7b4-7d3a5a4b ****" 、
      "名前": "faasutiltest-image" 、
      "OwnerId": "27095692903785 ****" 、
      "ShellUniqueId": "f30010" 、
      "状態": "成功" 、
      "タグ": "" 、
      "UpdateTime": "2020-12-04 15:02:05"
    }
  ],
  "RequestId": "C85DD548-9B3D-463E-BE25-316FF7288CEB"
}
0.087経過 

コマンド構文

faasutil modify_image -- fpgaImageUniqueId=[fpgaImageUniqueId] -- name=[name] -- description=[description] -- tags=[tags]

サンプルコード

[user1 @ i **** ~]# 。/faasutil modify_image -- fpgaImageUniqueId=xilinxb80832c9-1cd1-49a2-a7b4-7d3a5a4b *** -- name="faasutiltest-image" -- description="faasutil test round 2"
{
  "説明": "faasutilテストラウンド2" 、
  "FpgaImageUniqueId": "xilinxb80832c9-1cd1-49a2-a7b4-7d3a5a4b ****" 、
  "名前": "faasutiltest-image" 、
  "RequestId": "AED50829-B84A-42F9-9891-E1EE9821DA33" 、
  "タグ": ""
} 

変更された情報を表示する

[user1 @ i **** ~]# 。/faasutil list_images
{
  "FpgaImages": [
    {
      "CreateTime": "2020-12-04 14:48:14" 、
      "説明": "faasutilテストラウンド2" 、
      "暗号化": false、
      "FpgaImageUniqueId": "xilinxb80832c9-1cd1-49a2-a7b4-7d3a5a4b ****" 、
      "名前": "faasutiltest-image" 、
      "OwnerId": "27095692903785 ****" 、
      "ShellUniqueId": "f30010" 、
      "状態": "成功" 、
      "タグ": "" 、
      "UpdateTime": "2020-12-04 15:02:05"
    }
  ],
  "RequestId": "C85DD548-9B3D-463E-BE25-316FF7288CEB"
}
0.087経過 

コマンド構文

faasutil bind_image -- fpgaImageUniqueId=[fpgaImageUniqueId] -- ecsImageId=[ecsImageId]

• [fpgaImageUniqueId]: FPGAイメージのUUID。

• [ecsImageId]: ECSイメージのID。 デフォルトでは、現在のFPGAアクセラレーションインスタンスのECSイメージのIDが使用されます。

サンプルコード

[user1 @ i **** ~]# 。/faasutil bind_image -- fpgaImageUniqueId=xilinx5395ad11-edb9-4d93-964d-12c59a07 ****
{
  "FpgaImageUniqueId": "xilinx5395ad11-edb9-4d93-964d-12c59a07 ****" 、
  "ImageId": "" 、
  "メッセージ": "publish success!" 、
  "RequestId": "966883DD-6A6F-456A-8894-8FB7FA8A321C"
}
0.119経過 

コマンド構文

faasutil copy_fpga_image -- fpgaImageUniqueId=[fpgaImageUniqueId] -- targetRegion=[target region id]

サンプルコード

[user1 @ i **** ~]# 。/faasutil copy_fpga_image -- fpgaImageUniqueId=xilinx5395ad11-edb9-4d93-964d-12c59a07 **** -- targetRegion=cn-hangzhou
{
  "CreateTime": "2020-12-04 17:46:04" 、
  "Description": "",
  "FpgaImageUniqueId": "xilinx5395ad11-edb9-4d93-964d-12c59a07 ****" 、
  "名前": "faasutiltest-image" 、
  "RequestId": "3AAEC35C-2FB2-4DBA-A982-7A8219055D60" 、
  "ShellUniqueId": "f30010" 、
  "状態": "コミット"
}
0.309経過 

コマンド構文

faasutil download_image -- bdf=[bdf] -- fpgaImageUniqueId=[fpgaImageUniqueId] -- instanceId=[instanceId] -- owneralias=[owner]

サンプルコード

[user1 @ i **** ~]# 。/faasutil download_image -- bdf=00:09.0 -- fpgaImageUniqueId=xilinx5395ad11-edb9-4d93-964d-12c59a07 ****
{"TaskId":45331、"RequestId":"073431C2-857A-470D-9543-D1D89FC10D54" 、"FpgaImageUniqueId":"xilinx5395ad11-edb9-4d93-964d-12c59a07 ****" 、"InstanceId":"i-uf616ov8zzwmiijb ****" 、"BDFInECS":"" 、"TaskStatus":"committed"}
status : operating
info: ダウンロードタスクは動作しています
requestId : x-84128618168241720
1.165経過 

コマンド構文

faasutil download_status -- bdf=[bdf] -- fpgaImageUniqueId=[fpgaImageUniqueId] -- owneralias=[owner]

サンプルコード

[user1 @ iZ **** ~]# 。/faasutil download_status -- bdf=00:09.0 -- fpgaImageUniqueId=xilinx5395ad11-edb9-4d93-964d-12c59a07 ****
status: 完了
info: ダウンロードタスク仕上げ
requestId : x-42850294908763910
時間: 2020-12-04 17:50:48
1.026経過 

不要になったFPGAイメージを削除します。

コマンド構文

faasutil delete_image -- fpgaImageUniqueId=[fpgaImageUniqueId] -- owneralias=[owner]

サンプルコード

[user1 @ i **** ~]# 。/faasutil delete_image -- fpgaImageUniqueId=xilinxe27832a0-7c1c-4d6d-80b8-435253e9 ****
{
  "FpgaImageUniqueId": "xilinxe27832a0-7c1c-4d6d-80b8-435253e9 ****" 、
  "RequestId": "F2F481F5-B0E3-4009-9AF4-CF4BFC00458A"
}
0.157経過 

削除結果の表示

[user1 @ i **** ~]# 。/faasutil list_images
{
  "FpgaImages": [] 、
  "RequestId": "30B73A5B-99FC-4920-8B90-4BA08A075040"
}
0.049経過