開發自訂應用程式 develop

開始開發自訂應用程式之前：

建立自訂應用程式 create-custom-application

請務必擁有 Adobe I/O CLI 本機安裝。

另請參閱 自訂應用程式範例 自訂應用程式的範例和想法。

新增認證 add-credentials

當您在建立應用程式時登入時，系統會在ENV檔案中收集大部份App Builder認證。 不過，使用開發人員工具需要其他憑證。

開發人員工具儲存憑證 developer-tool-credentials

用來測試自訂應用程式的開發人員工具，包含 Asset Compute service 需要雲端儲存容器來裝載測試檔案，以及接收和顯示應用程式產生的轉譯。

確定具有 支援的雲端儲存體容器. 如有需要，不同專案中的多位開發人員可共用此容器。

新增認證至ENV檔案 add-credentials-env-file

將開發人員工具的下列認證新增至App Builder專案根目錄中的ENV檔案：

執行應用程式 run-custom-application

使用Asset compute Developer Tool執行應用程式之前，請正確設定 認證.

若要在開發人員工具中執行應用程式，請使用 aio app run 命令。 它將動作部署至 Adobe I/O 執行階段並在本機電腦上啟動開發工具。 此工具用於在開發期間測試應用程式請求。 以下是範例轉譯請求：

"renditions": [
    {
        "worker": "https://1234_my_namespace.adobeioruntime.net/api/v1/web/example-custom-worker-master/worker",
        "name": "image.jpg"
    }
]

另請參閱 此處 如何測試和偵錯您的應用程式。 當您完成自訂應用程式的開發時， 部署您的自訂應用程式.

嘗試Adobe提供的範例應用程式 try-sample

以下是自訂應用程式的範例：

範本自訂應用程式 template-custom-application

此 worker-basic 是範本應用程式。 它只會複製來源檔案來產生轉譯。 此應用程式的內容為選擇時收到的範本 Adobe Asset Compute 建立aio應用程式時。

應用程式檔案， worker-basic.js 使用 asset-compute-sdk 若要下載來源檔案，請協調每個轉譯處理，並將產生的轉譯上傳回雲端儲存空間。

此 renditionCallback 定義在應用程式程式碼內，是執行所有應用程式處理邏輯的位置。 中的轉譯回呼 worker-basic 只需將來源檔案內容複製到轉譯檔案即可。

const { worker } = require('@adobe/asset-compute-sdk');
const fs = require('fs').promises;

exports.main = worker(async (source, rendition) => {
    // copy source to rendition to transfer 1:1
    await fs.copyFile(source.path, rendition.path);
});

呼叫外部API call-external-api

在應用程式程式碼中，您可以進行外部API呼叫，以協助處理應用程式。 以下為呼叫外部API的應用程式檔案範例。

exports.main = worker(async function (source, rendition) {

    const response = await fetch('https://adobe.com', {
        method: 'GET',
        Authorization: params.AUTH_KEY
    })
});

例如， worker-animal-pictures 會使用，從Wikimedia對靜態URL發出擷取請求 node-httptransfer 資料庫。

傳遞自訂引數 pass-custom-parameters

您可以透過轉譯物件傳遞自訂已定義的引數。 它們可在應用程式內參照，位置如下： rendition 指示. 以下是轉譯物件的範例：

"renditions": [
    {
        "worker": "https://1234_my_namespace.adobeioruntime.net/api/v1/web/example-custom-worker-master/worker",
        "name": "image.jpg",
        "my-custom-parameter": "my-custom-parameter-value"
    }
]

存取自訂引數之應用程式檔案的範例為：

exports.main = worker(async function (source, rendition) {

    const customParam = rendition.instructions['my-custom-parameter'];
    console.log('Custom paramter:', customParam);
    // should print out `Custom parameter: "my-custom-parameter-value"`
});

此 example-worker-animal-pictures 傳遞自訂引數 animal 以判斷要從Wikimedia擷取的檔案。

驗證和授權支援 authentication-authorization-support

依預設，Asset compute自訂應用程式會隨App Builder專案的授權和驗證檢查提供。 這可透過設定 require-adobe-auth 註解至 true 在 manifest.yml.

存取其他AdobeAPI access-adobe-apis

將API服務新增至 Asset Compute 在設定中建立的Console工作區。 這些服務屬於產生的JWT存取權杖的一部分 Asset Compute Service. 可在應用程式動作中存取權杖和其他認證 params 物件。

const accessToken = params.auth.accessToken; // JWT token for Technical Account with entitlements from the console workspace to the API service
const clientId = params.auth.clientId; // Technical Account client Id
const orgId = params.auth.orgId; // Experience Cloud Organization

傳遞協力廠商系統的認證 pass-credentials-for-tp

若要處理其他外部服務的認證，請將這些認證作為預設引數傳遞給動作。 傳輸中會自動加密這些檔案。 如需詳細資訊，請參閱 在執行階段開發人員指南中建立動作. 然後在部署期間使用環境變數設定它們。 這些引數可在以下位置存取： params 物件。

設定內的預設引數 inputs 在 manifest.yml：

packages:
  __APP_PACKAGE__:
    actions:
      worker:
        function: 'index.js'
        runtime: 'nodejs:10'
        web: true
        inputs:
           secretKey: $SECRET_KEY
        annotations:
          require-adobe-auth: true

此 $VAR 運算式會從名為的環境變數中讀取值 VAR.

在開發期間，可以在本機ENV檔案中將值設定為 aio 除了從叫用殼層設定的變數之外，還會自動從ENV檔案讀取環境變數。 在此範例中，ENV檔案看起來像這樣：

#...
SECRET_KEY=secret-value

對於生產部署，您可以在CI系統中設定環境變數，例如在GitHub動作中使用秘密。 最後，存取應用程式內的預設引數，如下所示：

const key = params.secretKey;

調整應用程式大小 sizing-workers

應用程式會在的容器中執行 Adobe I/O 執行階段為 限制 可透過以下方式設定： manifest.yml：

    actions:
      myworker:
        function: /actions/myworker/index.js
        limits:
          timeout: 300000
          memorySize: 512
          concurrency: 1

由於通常由Asset compute應用程式完成的更廣泛處理，因此更有可能需要調整這些限制以獲得最佳效能（足夠大以處理二進位資產）和效率（不會因未使用的容器記憶體而浪費資源）。

執行階段中動作的預設逾時為一分鐘，但可透過設定 timeout 限制（毫秒）。 如果您希望處理較大的檔案，請增加此時間。 請考慮下載來源、處理檔案及上傳轉譯所需的總時間。 如果動作逾時（即在指定的逾時限制之前未傳回啟動），執行階段會捨棄容器且不重複使用它。

asset compute應用程式本質上是網路和磁碟的輸入或輸出繫結。 必須先下載來源檔案，處理通常需要大量資源，然後才會再次上傳產生的轉譯。

動作容器可用的記憶體由指定 memorySize 以MB為單位。 目前，這也定義了容器取得的CPU存取許可權，最重要的是，這是使用執行階段成本的關鍵要素（容器越大，成本越高）。 當您的處理需要更多記憶體或CPU時，請在此處使用較大的值，但請注意不要因為容器越大，整體處理量越低而浪費資源。

此外，您也可以使用控制容器內的動作並行 concurrency 設定。 這是單一容器（相同動作）所取得的並行啟用數。 在此模型中，動作容器就像是Node.js伺服器，可接收多個並行請求，最多可達該限制。 如果未設定，執行階段中的預設值為200，這非常適合用於較小的App Builder動作，但通常對於Asset compute應用程式來說太大了，因為它們有較密集的本機處理和磁碟活動。 某些應用程式（視其實施而定）可能無法順利搭配並行活動運作。 asset computeSDK會將檔案寫入不同的唯一資料夾，藉此確保可分隔啟用作業。

測試應用程式以找出最佳數量 concurrency 和 memorySize. 較大的容器=較高的記憶體限制可能允許更多並行，但也可能對較低的流量造成浪費。