您可以通過本主題瞭解faascmd命令的用法。

前提條件

使用faascmd工具之前,您需要先 配置faascmd

文法說明

  • faascmd工具提供的所有命令和參數都嚴格區分大小寫。

  • faascmd命令中各參數“=”前後不能有多餘空格。

授權

faascmd auth 命令用於授權faas admin訪問使用者的OSS bucket。

前提條件

  1. 為FaaS建立一個OSSbucket,用於上傳原始編譯的DCP檔案。

  2. 在該FaaSOSSbucket中,建立一個名為compiling_logs的檔案夾。

命令格式

faascmd auth --bucket=<yourFaasOSSBucketName>
範例程式碼

说明 如果同一主賬戶下有多個子賬戶,建議子賬戶間共用一個OSS bucket,以避免重複修改或覆蓋授權策略。

查看授權策略

faascmd list_policy 命令用來查看指定的OSS bucket是否已添加到相應的授權策略(faasPolicy)裡。

命令格式

faascmd list_policy
範例程式碼

说明 請關注您的OSS Bucket和OSS Bucket/compiling_logs是否出現在列出的策略資訊中。

刪除授權策略

faascmd delete_policy 命令用於刪除授權策略(faasPolicy)。

命令格式

faascmd delete_policy
範例程式碼

说明 如果同一主賬戶下有多個子賬戶,建議您去RAM控制台操作,以避免誤刪授權策略。

查看OSS Bucket下所有的objects

faascmd list_objects 命令用於查看使用者OSS Bucket下所有的objects。

命令格式

faascmd list_objects
範例程式碼

说明 您可以配合grep命令篩選出您想要的檔案。例如: 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
範例程式碼

说明 每個子賬戶最多允許保留10個fpga鏡像。

刪除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>
範例程式碼