搭配 Azure Spring Apps 企業版方案使用 VMware Tanzu 應用程式加速器

  • 發行項

注意

Azure Spring Apps 是 Azure Spring Cloud 服務的新名稱。 雖然服務有新的名稱，但是您暫時還是會在某些位置看到舊的名稱。我們正在致力更新螢幕擷取畫面、影片和圖表等資產。

本文適用於：❌ 基本/標準✔️企業

本文說明如何使用 適用於 VMware Tanzu 的應用程式加速器（應用程式加速器）搭配 Azure Spring Apps 企業版計劃，以可探索且可重複的方式啟動開發應用程式。

應用程式加速器可協助您啟動程式開發應用程式，並以可探索且可重複的方式加以部署。 您可以使用應用程式加速器，根據已發佈的加速器專案來建立新的專案。 如需詳細資訊，請參閱 VMware 檔案中的 VMware Tanzu 應用程式加速器。

必要條件

啟用應用程式加速器

布建 Azure Spring Apps 企業版方案實例時，您可以啟用應用程式加速器。 如果您已經有 Azure Spring Apps 企業版方案資源，請參閱 在現有的企業方案實例 中管理應用程式加速器一節以啟用它。

您可以使用 Azure 入口網站 或 Azure CLI 來啟用應用程式加速器。

使用下列步驟，使用 Azure 入口網站 啟用應用程式加速器：

  1. 開啟 Azure 入口網站。

  2. 在 [基本] 索引標籤上，選取 [定價] 區段中的 [企業層]，並指定必要資訊。 然後選取 [下一步：VMware Tanzu 設定]。

  3. 在 [ VMware Tanzu 設定 ] 索引標籤上，選取 [ 啟用應用程式加速器]。

    顯示 VMware Tanzu 設定索引標籤的 Azure 入口網站 螢幕快照，其中醒目提示 [啟用應用程式加速器] 複選框。

  4. 指定其他設定，然後選取 [ 檢閱和建立]。

  5. 在 [檢閱建立] 索引標籤上，確定 [啟用應用程式加速器] 和 [啟用開發人員工具入口網站] 設定為 [是]。 選取 [建立 ] 以建立企業方案實例。

監視應用程式加速器

應用程式加速器可讓您從 Git 存放庫中的檔案產生新專案。 下表描述應用程式加速器的元件：

元件名稱 執行個體計數 每個實例的 vCPU 每個實例的記憶體 描述
accelerator-server 2 0.4 核心 0.5Gi 提供開發人員工具入口網站用來列出可用加速器和選項的 API。
accelerator-engine 1 單核心 3Gi 處理輸入值和檔案（從 Git 存放庫的快照集提取），並套用動態轉換來產生專案。
accelerator-controller 1 0.2 核心 0.25Gi 協調應用程式加速器資源。
source-controller 1 0.2 核心 0.25Gi 註冊控制器以協調 ImageRepositories 應用程式加速器所使用的 和 MavenArtifacts 資源。
flux-source-controller 1 0.2 核心 0.25Gi 註冊控制器以協調 GithubRepository 應用程式加速器所使用的資源。 支援管理應用程式加速器的 Git 存放庫來源。

您可以使用 Azure 入口網站和 Azure CLI 查看所有元件的執行中實例和資源使用量。

您可以在開發人員工具頁面上的 [Azure 入口網站] 中檢視應用程式加速器的狀態，如下列螢幕快照所示：

顯示開發人員工具頁面之 Azure 入口網站的螢幕快照。

設定開發工具以存取應用程式加速器

若要存取應用程式加速器，您必須設定 Tanzu Dev Tools。 如需詳細資訊，請參閱 在 Azure Spring Apps 企業方案中設定 Tanzu Dev Tools。

使用應用程式加速器啟動您的新專案

若要使用應用程式加速器啟動新專案，您必須取得管理加速器的許可權。 然後，您可以管理預先定義的加速器或您自己的加速器。

取得管理加速器的許可權

管理加速器需要下列權限：

  • 閱讀：取得 Azure Spring Apps 預先定義的加速器
  • 其他：停用 Azure Spring Apps 預先定義的加速器
  • 其他：啟用 Azure Spring Apps 預先定義的加速器
  • 撰寫：建立或更新 Microsoft Azure Spring Apps 自定義加速器
  • 閱讀：取得 Azure Spring Apps 自定義加速器

如需詳細資訊，請參閱 如何在 Azure Spring Apps 中使用許可權。

管理預先定義的加速器

您可以從數個預先定義的加速器開始，以啟動您的新專案。 您可以根據自己的喜好設定停用或啟用內建加速器。

您可以使用 Azure 入口網站 或 Azure CLI 來管理預先定義的加速器。

您可以在 [加速器] 索引卷標的 [Azure 入口網站] 中檢視內建加速器，如下列螢幕快照所示：

Azure 入口網站 的螢幕快照，其中顯示內建快捷鍵的 [快捷鍵] 索引標籤，其中已醒目提示 [停用快捷鍵] 按鈕。

管理您自己的加速器

除了使用預先定義的加速器之外，您還可以建立自己的加速器。 您可以在 Azure Devops、GitHub、GitLab 或 BitBucket 中使用任何 Git 存放庫。

使用下列步驟來建立及維護您自己的加速器：

首先，在 Git 存放庫的根目錄中建立名為 accelerator.yaml 的檔案。

您可以使用 accelerator.yaml 檔案來宣告使用者在 UI 中使用表單填入的輸入選項。 這些選項值會在範本引擎傳回壓縮的輸出檔案之前控制處理。 如果您未包含 accelerator.yaml 檔案，存放庫仍可做為加速器運作，但檔案會以未修改方式傳遞給使用者。 如需詳細資訊，請參閱 建立 accelerator.yaml 檔案。

接下來，發佈新的加速器。

建立 accelerator.yaml 檔案之後，您可以建立加速器。 然後，您可以在開發人員工具入口網站的 [Azure 入口網站] 或 [應用程式加速器] 頁面中檢視它。 您可以使用 Azure 入口網站 或 Azure CLI 來發布新的加速器。

若要建立您自己的加速器，請開啟 [加速器 ] 區段，然後選取 [自定義加速器] 區段下的 [ 新增 加速器]。

顯示 [開發人員工具] 頁面 [加速器] 索引標籤的 Azure 入口網站 螢幕快照，其中已醒目提示 [新增加速器] 按鈕。

下表描述可自定義的快速鍵欄位。

入口網站 CLI 描述 必要/選用
名稱 name 加速器的唯一名稱。 建立名稱之後無法變更。 必要
說明 display-name 加速器的較長描述。 選擇性
圖示 URL icon-url 表示UI中快捷鍵之影像的URL。 選擇性
Tags (標籤) accelerator-tags 字串數位，定義可在UI中搜尋中使用的快捷鍵屬性。 選擇性
Git URL git-url 加速器來源 Git 存放庫的存放庫 URL。 URL 可以是 HTTP/S 或 SSH 位址。 SSH 位址不支援類似 scp 的語法（例如 ）。 user@example.com:repository.git 相反地，有效的 URL 格式為 ssh://user@example.com:22/repository.git。 必要
Git 間隔 git-interval-in-seconds 檢查存放庫更新的間隔。 如果未指定，間隔預設為10分鐘。 另外還有一個重新整理間隔（目前為10秒），快捷鍵才會出現在UI中。 在UI中反映變更之前，可能會有10秒的延遲。 選擇性
Git 分支 git-branch 要簽出和監視變更的 Git 分支。 您應該只指定 Git 分支、Git 認可或 Git 標籤。 選擇性
Git 認可 git-commit 要取出的 Git 認可 SHA。您應該只指定 Git 分支、Git 認可或 Git 標籤。 選擇性
Git 標籤 git-tag 要取出的 Git 認可標記。您應該只指定 Git 分支、Git 認可或 Git 標籤。 選擇性
Git 子路徑 git-sub-path 要視為加速器或片段根目錄的 Git 存放庫內的資料夾路徑。 選擇性
驗證類型 N/A 加速器來源存放庫的驗證類型。 這個類型可以是 Public、 Basic auth或 SSH。 必要
使用者名稱 username 存取驗證類型為 Basic auth之加速器來源存放庫的用戶名稱。 當驗證類型為 Basic auth時需要 。
密碼/個人存取令牌 password 存取驗證類型為 Basic auth之加速器來源存放庫的密碼。 當驗證類型為 Basic auth時需要 。
私密金鑰 private-key 用來存取驗證類型為 SSH之加速器來源存放庫的私鑰。 僅支援 OpenSSH 私鑰。 當驗證類型為 SSH時需要 。
主機金鑰 host-key 用來存取驗證類型為 SSH之加速器來源存放庫的主機金鑰。 當驗證類型為 SSH時需要 。
主機金鑰演演算法 host-key-algorithm 存取驗證類型為 SSH的加速器來源存放庫的主機金鑰演演算法。 可以是 ecdsa-sha2-nistp256 或 ssh-rsa。 當驗證類型為 SSH時需要 。
CA 憑證名稱 ca-cert-name 使用驗證類型為 Public 或 Basic auth的自我簽署憑證，存取加速器來源存放庫的 CA 憑證名稱。 當自我簽署憑證用於 Git 存放庫 URL 時，為必要專案。
類型 type 自定義加速器的類型。 類型可以是 Accelerator 或 Fragment。 預設值是 Accelerator。 選擇性

若要檢視所有已發佈的加速器，請參閱開發人員工具頁面的應用程式加速器一節。 選取應用程式加速器 URL，以在開發人員工具入口網站中檢視已發佈的加速器：

顯示 [開發人員工具] 頁面的 Azure 入口網站 螢幕快照，其中已醒目提示 [應用程式加速器 URL]。

若要檢視新發佈的加速器，請重新整理開發人員工具入口網站。

適用於 Azure Spring Apps 應用程式加速器的 VMware Tanzu Dev Tools 頁面螢幕快照。

注意

開發人員工具入口網站可能需要幾秒鐘的時間才能重新整理目錄，並新增新加速器的專案。 當您建立加速器時，重新整理間隔會設定為 git-interval 。 變更加速器之後，開發人員工具入口網站中也需要時間反映。 最佳做法是在您將變更套用至 Git 存放庫之後，變更 git-interval 以加速進行驗證。

參考您自己的加速器中的片段

隨著新增新的加速器，撰寫和維護加速器可能會變得重複且詳細資訊。 有些人會藉由複製現有項目並進行修改來建立新專案，但此程式可能會很乏味且容易出錯。 為了簡化加速器的建立和維護，應用程式加速器支援名為 Composition 的功能，允許重複使用加速器的元件，稱為 片段。

使用下列步驟來參考加速器中的片段：

  1. 使用 Azure 入口網站 或 Azure CLI 發佈 型Fragment別的新加速器。

    若要建立片段加速器，請開啟 [加速器] 區段，選取 [自定義加速器] 區段底下的 [新增加速器]，然後選取 [片段]。

    顯示「片段」類型的自定義加速器 Azure 入口網站 螢幕快照。

  2. 變更加速器專案中的 accelerator.yaml 檔案。 imports使用 區段中的accelerator指示和 InvokeFragment 區段中的指示engine來參考加速器中的片段，如下列範例所示：

    accelerator:
    ...
  # options for the UI
  options:
    ...
  imports:
  - name: <fragment-accelerator-name>
  ...

engine:
  chain:
    ...
  - merge:
    - include: [ "**" ]
    - type: InvokeFragment
      reference: <fragment-accelerator-name>

  3. 將變更與開發人員工具入口網站同步處理。

    若要更快速地反映開發人員工具入口網站上所做的變更，您可以為自定義加速器的 Git 間隔字段提供值。 Git 間隔值指出系統檢查 Git 存放庫中更新的頻率。

  4. 使用 Azure 入口網站 或 Azure CLI，將變更與 Azure 入口網站 上的自定義加速器同步處理。

    下列清單顯示您可以同步變更的兩種方式：

    • 建立或更新您的自定義加速器。
    • 開啟 [ 加速器] 區段，然後選取 [ 同步憑證]。

如需詳細資訊，請參閱 VMware 檔案中的應用程式加速器 中使用片段。

使用加速器啟動新專案

使用下列步驟來啟動使用加速器的新專案：

  1. 在 [ 開發人員工具] 頁面上，選取 [應用程式加速器 URL] 以開啟開發人員工具入口網站。

    顯示 [開發人員工具] 頁面的 Azure 入口網站 螢幕快照，其中已醒目提示 [應用程式加速器 URL]。

  2. 在 [開發人員工具入口網站] 上，選取加速器。

  3. 在 [產生加速器] 頁面的 [設定加速器] 區段中指定輸入選項。

    顯示 [設定加速器] 區段的 VMware Tanzu Dev Tools for Azure Spring Apps 產生加速器頁面的螢幕快照。

  4. 選取 [探索檔案 ] 以檢視項目結構和原始程式碼。

    適用於 Azure Spring Apps 的 VMware Tanzu Dev Tools 探索專案窗格的螢幕快照。

  5. 選取 [ 檢閱併產生 ] 以檢閱指定的參數，然後選取 [ 產生加速器]。

    Azure Spring Apps 的 VMware Tanzu Dev Tools Generate Accelerators 頁面的螢幕快照，其中顯示 [檢閱和產生] 區段。

  6. 然後，您可以將項目檢視或下載為 zip 檔案。

    顯示 [工作活動] 窗格的 VMware Tanzu Dev Tools for Azure Spring Apps 螢幕快照。

使用自我簽署憑證設定加速器

當您設定私人 Git 存放庫並使用自我簽署憑證啟用 HTTPS 時，您應該將 CA 憑證名稱設定為加速器，以便從加速器向 Git 存放庫進行用戶端憑證驗證。

使用下列步驟來設定具有自我簽署憑證的加速器：

  1. 將憑證匯入 Azure Spring Apps。 如需詳細資訊，請參閱在 Azure Spring Apps 中使用應用程式中 TLS/SSL 憑證的匯入憑證一節。
  2. 使用 Azure 入口網站 或 Azure CLI 來設定加速器的憑證。

若要設定加速器的憑證，請開啟 [加速器] 區段，然後選取 [自定義加速器] 區段下的 [新增加速器]。 然後，從下拉式清單中選取憑證。

顯示 [新增加速器] 窗格之 Azure 入口網站 的螢幕快照。

輪換憑證

憑證到期時，您必須使用下列步驟輪替 Spring Cloud Apps 中的憑證：

  1. 從受信任的 CA 產生新的憑證。
  2. 將憑證匯入 Azure Spring Apps。 如需詳細資訊，請參閱在 Azure Spring Apps 中使用應用程式中 TLS/SSL 憑證的匯入憑證一節。
  3. 使用 Azure 入口網站 或 Azure CLI 同步處理憑證。

加速器不會自動使用最新的憑證。 您應該使用 Azure 入口網站 或 Azure CLI 來同步處理一或所有憑證。

若要同步處理所有加速器的憑證，請開啟 [加速器 ] 區段，然後選取 [同步憑證]，如下列螢幕快照所示：

顯示 [自定義加速器] 窗格的 Azure 入口網站 螢幕快照，其中已醒目提示 [同步憑證] 按鈕。

若要同步處理單一加速器的憑證，請開啟 [加速器 ] 區段，然後從快捷鍵的操作功能表中選取 [同步憑證 ]，如下列螢幕快照所示：

顯示 [自定義加速器] 窗格的螢幕快照或 Azure 入口網站，其中已醒目提示 [同步憑證操作] 功能表選項。

在現有的企業方案實例中管理應用程式加速器

您可以使用 Azure 入口網站 或 Azure CLI，在現有的 Azure Spring Apps Enterprise 方案實例下啟用應用程式加速器。

如果開發人員工具公用端點已經公開，您可以啟用應用程式加速器，然後按 Ctrl+F5 停用瀏覽器快取，以在開發人員工具入口網站上檢視它。

使用下列步驟，使用 Azure 入口網站，在現有的 Azure Spring Apps Enterprise 方案實例下啟用應用程式加速器：

  1. 流覽至您的服務資源，然後選取 [ 開發人員工具]。

  2. 選取 [ 管理工具]。

  3. 選取 [ 啟用應用程式加速器]，然後選取 [ 套用]。

    顯示 [管理工具] 窗格的 Azure 入口網站 螢幕快照，其中已醒目提示 [啟用應用程式加速器] 選項。

您可以在開發人員工具頁面上檢視應用程式加速器是否已啟用或停用。

在 VS Code 中使用應用程式加速器

您可以直接從 VS Code 中 Azure Spring Apps Enterprise 方案服務實例中的應用程式加速器啟動專案。

檢視應用程式加速器清單

使用下列步驟來檢視 Azure Spring Apps Enterprise 方案服務實例中的應用程式加速器清單：

  1. 在 Visual Studio Code 中，開啟 Azure Spring Apps 擴充功能，然後登入您的 Azure 帳戶。

  2. 展開您想要的服務實例，然後按下滑鼠右鍵以選取服務實例。

  3. 從功能表中，選取 [ 開啟應用程式加速器 ] 以開啟應用程式加速器清單。 系統會提示您 安裝未安裝 Tanzu 應用程式加速器 Visual Studio Code 擴充功能 。

    VS Code 延伸模組的螢幕快照，其中顯示服務實例的 [開啟應用程式加速器] 選項。

  4. 選取任何加速器以啟動您的專案。

    顯示應用程式加速器延伸模組清單的 VS Code 螢幕快照。

注意

使用擴充功能時，如果您遇到任何無法修正的問題，請從擴充功能註銷您的帳戶。

針對應用程式加速器問題進行疑難解答

如果您嘗試針對尚未啟用應用程式加速器或公開公用端點的服務實例開啟應用程式加速器，您會看到下列錯誤訊息： Application Accelerator of Spring Apps <instance-name> is not enabled or publically accessible。

若要啟用應用程式加速器並公開公用端點，請使用下列步驟。 如需詳細資訊，請參閱 在現有的企業方案實例 中管理應用程式加速器一節。

  1. 如果您在 Dev Tools 入口網站中啟用單一登錄，當您存取擴充功能時，會看到下列訊息：The extension 'Tanzu App Accelerator' wants to sign in using VMware Tanzu.如需詳細資訊，請參閱在 Azure Spring Apps Enterprise 方案中設定 Tanzu Dev Tools 的<設定 Dev Tools 入口網站>一節。

  2. 選取 [允許]，選取 [開啟]，然後再次選取 [開啟 ] 以開啟 VS Code 延伸模塊清單。

    顯示應用程式加速器延伸模組清單的 VS Code 螢幕快照。

有時候，您可能會收到類似下列範例的錯誤訊息： AADSTS50011: The redirect URI 'vscode://VMware.tanzu-app-accelerator' specified in the request does not match the redirect URIs configured for the application 'xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx'. Make sure the redirect URI sent in the request matches one added to your application in the Azure portal. Navigate to https://aka.ms/redirectUriMismatchError to learn more about how to fix this.

若要解決此問題，請將重新導向 URI vscode://VMware.tanzu-app-accelerator 新增至相關的識別提供者 （IdP）。 在 Microsoft Entra ID 中，移至 [ 驗證 ] 功能表，並將重新導向 URI 新增至平臺組態中的行動和桌面應用程式。

下一步