快速入門：將組建成品檔案部署至 Azure 容器應用程式 (預覽)
在本快速入門中，您會了解從預先建置的成品檔案部署容器應用程式。 本文中的範例會使用 JAR 檔案來部署 JAVA 應用程式，其中包含 JAVA 特定的資訊清單檔。 您的工作是建立後端 Web API 服務，以傳回靜態音樂專輯集合。 完成本快速入門之後，您可以繼續進行微服務之間的通訊，以了解如何部署呼叫 API 的前端應用程式。
以下螢幕擷取畫面顯示您部署之專輯 API 服務的輸出。
必要條件
| 需求 | 指示 |
|---|---|
| Azure 帳戶 | 如果您沒有帳戶，可免費建立帳戶。 您需要 Azure 訂用帳戶的「參與者」或「擁有者」權限才能繼續。 如需詳細資料，請參閱使用 Azure 入口網站指派 Azure 角色。 |
| GitHub 帳戶 | 建立免費帳戶。 |
| git | 安裝 git |
| Azure CLI | 安裝 Azure CLI。 |
| Java | 安裝 JDK (建議使用 17 或更新版本) |
| Maven | 安裝 Maven。 |
設定
若要從 CLI 登入 Azure，請執行下列命令，並遵循提示來完成驗證流程。
az login
若要確定您執行的是最新版本 CLI，請執行升級命令。
az upgrade
接下來，安裝或更新 CLI 的 Azure 容器應用程式延伸模組。
如果您在 Azure CLI 中執行 az containerapp 命令或 Azure PowerShell 模組中的 Cmdlet Az.App 時收到遺漏參數的錯誤，請確定您已安裝最新版的 Azure 容器應用程式延伸模組。
az extension add --name containerapp --upgrade
注意
從 2024 年 5 月開始，Azure CLI 延伸模組預設不會再啟用預覽功能。 若要存取容器應用程式預覽功能，請使用 --allow-preview true 安裝容器應用程式延伸模組。
az extension add --name containerapp --upgrade --allow-preview true
現在已安裝目前的延伸模組或模組，請註冊 Microsoft.App 和 Microsoft.OperationalInsights 命名空間。
az provider register --namespace Microsoft.App
az provider register --namespace Microsoft.OperationalInsights
建立環境變數
現在您的 Azure CLI 設定已完成，接下來您可以定義本文中使用的環境變數了。
在您的 Bash 殼層中定義下列變數。
RESOURCE_GROUP="album-containerapps"
LOCATION="canadacentral"
ENVIRONMENT="env-album-containerapps"
API_NAME="album-api"
SUBSCRIPTION=<YOUR_SUBSCRIPTION_ID>
如有必要，您可以查詢訂用帳戶識別碼。
az account list --output table
準備 GitHub 存放庫
從複製範例存放庫開始。
使用下列 git 命令，將範例應用程式複製到 code-to-cloud 資料夾：
git clone https://github.com/azure-samples/containerapps-albumapi-java code-to-cloud
cd code-to-cloud
建置 JAR 檔案
注意
Java 範例僅支援 Maven 組建，這會產生 JAR 檔案可執行檔。 組建會使用預設設定，因為不支援傳入環境變數。
使用 Maven 建置專案。
mvn clean package -DskipTests
在本機執行專案
java -jar target\containerapps-albumapi-java-0.0.1-SNAPSHOT.jar
若要確認應用程式正在執行中，請開啟瀏覽器並移至 http://localhost:8080/albums。 頁面會傳回 JSON 物件的清單。
部署組建成品
使用 containerapp up 命令，從本機 JAR 檔案建置及部署您的第一個容器應用程式。
此命令：
- 建立資源群組
- 建立 Azure Container Registry
- 建置容器映像並將它推送至登錄
- 使用 Log Analytics 工作區建立容器應用程式環境
- 使用公用容器映像來建立及部署容器應用程式
up 命令會使用存放庫根目錄中的 Docker 檔案來建置容器映像。 Docker 檔案中的 EXPOSE 指令會定義目標連接埠。 不過，不需要 Docker 檔案來建置容器應用程式。
注意
注意：使用 containerapp up 和無 Docker 程式碼基礎映像，請使用 --location 參數以便在非美國東部以外的地點執行應用程式。
az containerapp up \
--name $API_NAME \
--resource-group $RESOURCE_GROUP \
--location $LOCATION \
--environment $ENVIRONMENT \
--artifact ./target/containerapps-albumapi-java-0.0.1-SNAPSHOT.jar \
--ingress external \
--target-port 8080 \
--subscription $SUBSCRIPTION
驗證部署
將 FQDN 複製到網頁瀏覽器。 從網頁瀏覽器，前往 FQDN 的 /albums 端點。
部署 WAR 檔案
您也可以從 WAR 檔案部署容器應用程式。
清除資源
如果您不打算繼續使用此應用程式，可以移除資源群組來刪除 Azure 容器應用程式執行個體和所有相關聯的服務。
請遵循下列步驟來移除您所建立的資源：
az group delete \
--resource-group $RESOURCE_GROUP
提示
有問題嗎？ 在 Azure 容器應用程式存放庫中提出問題，讓我們在 GitHub 上了解該問題。