Aliyun Serverless VSCode Extension外掛程式 - CloudFlow

Aliyun Serverless VSCode Extension是一款VSCode圖形化開發調試Function Compute和操作Function Compute資源的工具。本文介紹了如何通過該工具建立函數和該外掛程式的常見功能。

前提條件

如果您期望使用Aliyun Serverless VSCode Extension的所有功能，那麼您需要確保系統中有以下組件：

VSCode：可以在 Visual Studio Code官網中下載安裝。
Docker：可以在Funcraft中根據教程安裝配置Docker。

背景資訊

Aliyun Serverless VSCode Extension是Function Compute提供的VSCode外掛程式，該外掛程式結合了Function Compute命令列工具Fun和Function ComputeSDK的功能，是基於VSCode的開發、調試、部署工具。通過該外掛程式，您可以：

快速地在本地初始化專案、建立函數。
運行、調試本地函數，和部署服務函數至雲端。
拉取雲端的服務函數列表、查看服務函數配置資訊、調用雲端函數。
獲得模版檔案的文法提示：自動補全、Schema校正、懸浮提示。

安裝外掛程式

開啟VSCode並進入外掛程式市場。
在外掛程式市場中搜尋Aliyun Serverless，查看詳情並安裝。
重啟VSCode，左側導覽列中會展示已安裝的Aliyun Serverless VSCode Extension外掛程式表徵圖。

快速入門

綁定阿里雲賬戶。
1. 在左側導覽列，單擊Aliyun Serverless VSCode Extension表徵圖，然後單擊Bind New Account。
2. 依次輸入阿里雲Account ID、阿里雲AccessKey ID、阿里雲AccessKey Secret、賬戶別名（即賬戶本地名稱）。
  綁定完成後，可以看到所綁定的阿里雲賬戶的雲端服務與函數列表。
  您還可以在Remote Resources面板中，單擊右上方的更多資訊表徵圖，在下拉式功能表中，選擇FC: Switch Region來查看不同地區的服務與函數。
建立函數。
1. 通過VSCode，開啟一個空的目錄檔案。單擊LOCAL RESOURCES中的建立函數表徵圖，可以在本地初始化一個Function Compute專案。
2. 按照導航依次輸入或選擇服務名稱、函數名稱、函數運行時、函數類型。填寫完畢後，外掛程式會自動建立函數並在LOCAL RESOURCES面板中會展示建立的本地服務與函數。
  您也可以直接單擊LOCAL RESOURCES中服務名右側的建立函數表徵圖，來為該服務建立函數。按照導航依次輸入或選擇函數名稱、函數運行時、函數類型即可。
部署服務和函數。
1. 單擊LOCAL RESOURCES面板中的部署表徵圖，可以將本地的服務與函數部署到雲端。
  部署完成後，單擊REMOTE RESOURCES面板中的重新整理表徵圖，可以查看部署到雲端的服務與函數。

其餘功能介紹

本地調用函數
在LOCAL RESOURCES面板中，單擊函數名稱右側的執行表徵圖或Handler檔案中的執行連結，可以在本地調用該函數。
函數的日誌和結果會輸出在TERMINAL中。
外掛程式會為您在函數入口檔案同目錄下建立event.dat檔案，您可以通過修改該檔案設定每次調用函數時觸發的事件資訊。
本地調試函數
重要
- 若您想要調試Python 2.7或Python 3 runtime的函數，需要事先在外掛程式安裝Python外掛程式。
- 若您想調試PHP runtime的函數，需要事先在外掛程式安裝PHP Debug外掛程式。
在LOCAL RESOURCES面板中，單擊函數名稱右側的調試表徵圖或Handler檔案中的調試連結，可以在本地調試該函數。
在代碼檔案中插入斷點，啟動調試後即可看到調試資訊。
外掛程式會為您在函數入口檔案同目錄下建立event.dat檔案，您可以通過修改該檔案設定每次調試函數時觸發的事件資訊。
執行雲端函數
單擊REMOTE RESOURCES面板中函數右側的執行表徵圖，可以執行雲端函數。
函數的日誌和結果會輸出在TERMINAL中。
外掛程式會為您在專案根目錄下建立event.dat檔案，您可以通過修改該檔案設定每次調用雲端函數時觸發的事件資訊。
跳轉到模版檔案定義
Function ComputeFun工具通過YAML格式的模板檔案來描述Serverless應用。通過Aliyun Serverless VSCode Extension建立函數時，會使用預設值自動填滿模版檔案。若您想修改本地服務或函數的配置，可以通過單擊LOCAL RESOURCES面板中的服務或函數名，跳轉到模版檔案中的相關描述，所選擇資源在模板檔案中的相關描述塊會高亮並逐漸褪去。
模版檔案填充提示
- 自動補全
  支援模版檔案template.yml內所有資源配置屬性的自動補全。自動補全會依據縮排層級給出精準的提示選項。
- 錯誤校正
  支援模版檔案template.yml內所有資源配置資訊的校正。在template.yml中會檢測資源的配置資訊是否符合規格說明。
- 懸浮提示
  提供模版檔案template.yml內所有資源配置的上下文協助。在template.yml中，將滑鼠懸浮在相關資源的鍵名上，會出現關於該鍵下可配置欄位的懸浮資訊展示（欄位名、欄位類型、文檔地址）。

反饋

如果您在使用中遇到問題，聯絡我們或在github中反饋。