ApsaraVideo VOD：快速開始

快速體驗

1. 複製專案。

   git clone https://github.com/MediaBox-Demos/VodAppServer.git
   cd VodAppServer

2. 配置密鑰和地區。

   在application.yml檔案中進行如下配置：

   aliyun:
     vod:
       ak: YOUR_ACCESS_KEY_ID      # 阿里雲 AccessKey ID
       sk: YOUR_ACCESS_KEY_SECRET  # 阿里雲 AccessKey Secret
       region: cn-shanghai         # 地區標識（必須與 VOD 控制台開通地區一致）

   說明

   • AccessKey的擷取請參見建立AccessKey。

   • region地區需與點播控制台開通地區一致。

3. 啟動服務。

   mvn spring-boot:run

   啟動成功日誌如下，Region需與第2步中配置地區保持一致。

   VOD 用戶端初始化成功，Region: cn-shanghai
   Started Application in 5.234 seconds

4. 測試介面。

   # 擷取播單列表
   curl -X POST http://localhost:9000/appServer/getPlaylists \
     -H "Content-Type: application/json" \
     -d '{"pageNo":"1","pageSize":"10"}'

   測試成功完成快速體驗流程。

部署到阿里雲Function Compute

阿里雲Function Compute(FC)支援Serverless部署，無需營運，隨用隨付。

1. 構建專案。

   # 進入專案目錄
   cd VodAppServer
   
   # Maven 打包
   mvn clean package
   
   # 打包成功後，產生 target/VodAppServer-1.0-SNAPSHOT.jar

2. 準備部署套件。

   # 建立部署目錄結構
   mkdir -p deploy/VodAppServer/target
   
   # 複製 JAR 檔案
   cp target/VodAppServer-1.0-SNAPSHOT.jar deploy/VodAppServer/target/
   
   # 進入部署目錄
   cd deploy
   
   # 壓縮成 ZIP 檔案
   zip -r VodAppServer.zip VodAppServer/

   目錄結構如下；

   VodAppServer.zip
   └── VodAppServer/
       └── target/
           └── VodAppServer-1.0-SNAPSHOT.jar

3. 建立函數。

   1. 進入Function Compute（FC）控制台函數頁面，點擊建立函數。

   2. 選擇Web函數，單擊建立Web函數。其中：

      • 記憶體：建議選擇1024MB。

      • 運行環境：建議選擇自訂運行時 > Java > Java8。

      • 代碼上傳方式：建議選擇通過ZIP包上傳代碼。

      • 程式碼封裝：上傳第2步建立的VodAppServer部署套件。

      • 啟動命令：java -jar /code/VodAppServer/target/VodAppServer-1.0-SNAPSHOT.jar。

      • 環境變數：在進階配置 > 更多配置 中添加ACCESS_KEY_ID、ACCESS_KEY_SECRET和ALIYUN_VOD_REGION，分別對應AccessKey ID、AccessKey Secret和所屬地區。

      • 其他參數保持預設或根據您的實際需求變更。

   3. 確認配置無誤後，點擊建立。

4. 建立觸發器。

   1. 在函數詳情頁，點擊觸發器標籤。

   2. 點擊建立觸發器，進入編輯頁，選擇HTTP觸發器。其中，認證方式建議選擇無需認證，其他參數保持預設或根據您的實際需求變更。

   3. 確認配置無誤後，點擊確定。

5. 測試部署。

   使用產生的公網地址測試：

   # 替換為您的實際地址
   curl -X POST https://vod-app-function-xxx.cn-shanghai.fcapp.run/appServer/getPlaylists \
     -H "Content-Type: application/json" \
     -d '{"pageNo":"1","pageSize":"10"}'

常見問題

函數啟動失敗如何處理

可以通過以下步驟排查：

1. 請確認VodAppServer.zip包目錄結構正確。

2. 請確認建立函數時配置的啟動命令正確。

3. 請確認構建專案時打包JAR檔案的完整性。

環境變數未生效如何處理

請確認環境變數名稱正確，儲存後重啟函數，並在專案中通過System.getenv() 擷取。

如何更新部署代碼

需要重新打包產生VodAppServer.zip包上傳，函數將自動重啟。