您可以通過本主題瞭解faascmd命令的用法。
前提條件
使用faascmd工具之前,您需要先 配置faascmd 。
文法說明
-
faascmd工具提供的所有命令和參數都嚴格區分大小寫。
-
faascmd命令中各參數“=”前後不能有多餘空格。
授權
faascmd auth
命令用於授權faas admin訪問使用者的OSS bucket。
前提條件
-
為FaaS建立一個OSSbucket,用於上傳原始編譯的DCP檔案。
-
在該FaaSOSSbucket中,建立一個名為compiling_logs的檔案夾。
命令格式
faascmd auth --bucket=<yourFaasOSSBucketName>
查看授權策略
faascmd list_policy
命令用來查看指定的OSS bucket是否已添加到相應的授權策略(faasPolicy)裡。
命令格式
faascmd list_policy
刪除授權策略
faascmd delete_policy
命令用於刪除授權策略(faasPolicy)。
命令格式
faascmd delete_policy
查看OSS Bucket下所有的objects
faascmd list_objects
命令用於查看使用者OSS Bucket下所有的objects。
命令格式
faascmd list_objects
faascmd list_objects | grep "xxx"
。
上傳原始編譯檔案
faascmd upload_object
命令用於將本地編譯的原始檔案上傳到使用者指定的OSS bucket中。
命令格式
faascmd upload_object --object=<newFileNameinOSSBucket> --file= <your_file_path>/fileNameYouWantToUpload
-
如果需上傳的檔案在目前的目錄下,則無需提供路徑。
-
intel fpga的本地編譯原始檔案為.gbs格式;xilinx fpga的本地編譯原始檔案為指令碼處理後得到的tar包。
下載OSS Bucket中的object
faascmd get_object
命令用來下載OSS Bucket中指定的object。
命令格式
faascmd get_object --obejct=<yourObjectName> --file=<your_local_path>/<yourFileName>
建立fpga鏡像
faascmd create_image
命令用來提交製作fpga鏡像的請求。請求成功時,返回fpga imageuuid。
命令格式
faascmd create_image --object=<yourObjectName>
--fpgatype=<intel/xilinx> --encrypted=<true/false>
--kmskey=<key/如果encrypted為true,必須;否則可選>
--shell=<Shell Version/必選> --name=<name/可選>
--description=<description/可選> --tags=<tags/可選>
查看fpga鏡像
faascmd list_images
命令用於查看使用者製作的所有fpga鏡像的資訊。
命令格式
faascmd list_images
範例程式碼刪除fpga鏡像
faascmd delete_image
命令用於刪除fpga鏡像。
命令格式
faascmd delete_image --imageuuid=<yourImageuuid>
下載fpga鏡像
faascmd download_image
命令用於提交下載fpga鏡像的請求。
命令格式
faascmd download_image --instanceId=<yourInstanceId>
--fpgauuid=<yourfpgauuid> --fpgatype=<intel/xilinx>
--imageuuid=<yourImageuuid> --imagetype=<afu>
--shell=<yourImageShellVersion>
範例程式碼
faascmd download_image --instanceId=XXXXX --fpgauuid=XXXX --fpgatype=intel --imageuuid=XXXX
查看fpga鏡像下載狀態
faascmd fpga_status
命令用於查看當前fpga板卡狀態或fpga鏡像的下載進度。
命令格式
faascmd fpga_status --fpgauuid=<fpgauuid> --instanceId=<instanceId>
發布fpga鏡像
faascmd publish_image
命令用來提交發布fpga鏡像的請求。
命令格式
faascmd publish_image --imageuuid=<yourImageuuid> --imageid=<yourFPGAImageid>
- imageuuid 是您要發布到雲市場的鏡像id。您可以通過
faascmd list_images
命令查看。 - imageid 是fpga鏡像id。您可以通過ECS控制台的執行個體詳情頁查看。
查看fpga執行個體的資訊
faascmd list_instances
命令用於擷取fpga執行個體的基本資料,包括執行個體id、fpga板卡資訊和shell版本。
命令格式
faascmd list_instances --instanceId=<yourInstanceId>