AWS App Runner 不再開放給新客戶。現有客戶可以繼續正常使用該服務。如需詳細資訊，請參閱[AWS App Runner 可用性變更](https://docs.aws.amazon.com/apprunner/latest/dg/apprunner-availability-change.html)。 本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。 # 以原始程式碼為基礎的 App Runner 服務 您可以使用 根據兩種基本不同的服務來源類型 AWS App Runner 來建立和管理服務：*來源碼*和*來源映像*。無論來源類型為何，App Runner 都會負責啟動、執行、擴展和負載平衡您的服務。您可以使用 App Runner 的 CI/CD 功能來追蹤來源映像或程式碼的變更。當 App Runner 發現變更時，它會自動建置 （適用於原始程式碼） 並將新版本部署到您的 App Runner 服務。 本章討論以來源碼為基礎的 服務。如需以來源映像為基礎的服務資訊，請參閱 [以來源映像為基礎的 App Runner 服務](service-source-image.md)。 原始程式碼是 App Runner 為您建置和部署的應用程式程式碼。您可以將 App Runner 指向程式碼儲存庫中的[來源目錄](#service-source-code.source-directory)，然後選擇對應於程式設計平台版本的合適*執行時間*。App Runner 會根據執行時間的基礎映像和您的應用程式程式碼來建置映像。然後，它會啟動根據此映像執行容器的服務。 App Runner 提供便利的平台特定*受管執行時間*。這些執行時間中的每一個都會從您的原始程式碼建置容器映像，並將語言執行時間相依性新增至映像。您不需要提供容器組態和建置指示，例如 Dockerfile。 本章的子主題討論 App Runner 支援的各種平台：為不同的程式設計環境和版本提供受管執行期的*受管平台*。 **Topics** + [原始程式碼儲存庫提供者](#service-source-code.providers) + [來源目錄](#service-source-code.source-directory) + [App Runner 受管平台](#service-source-code.managed-platforms) + [受管執行時間版本的終止支援](#service-source-code.managed-platforms.eos) + [受管執行期版本和 App Runner 組建](#service-source-code.build-detail) + [使用 Python 平台](service-source-code-python.md) + [使用 Node.js 平台](service-source-code-nodejs.md) + [使用 Java 平台](service-source-code-java.md) + [使用 .NET 平台](service-source-code-net6.md) + [使用 PHP 平台](service-source-code-php.md) + [使用 Ruby 平台](service-source-code-ruby.md) + [使用 Go 平台](service-source-code-go1.md) ## 原始程式碼儲存庫提供者 App Runner 透過從原始程式碼儲存庫讀取原始程式碼來部署原始程式碼。App Runner 支援兩個原始程式碼儲存庫提供者：[GitHub](https://github.com/) 和 [Bitbucket](https://bitbucket.org/)。 ### 從原始碼儲存庫供應商部署 若要從原始碼儲存庫將原始碼部署至 App Runner 服務，App Runner 會建立與其的連線。當您使用 App Runner 主控台[建立服務](manage-create.md)時，您會提供連線詳細資訊和來源目錄，讓 App Runner 部署您的原始程式碼。 **連線** 您可以在服務建立程序中提供連線詳細資訊。當您使用 App Runner API 或 時 AWS CLI，連線是個別的資源。首先，您可以使用 [CreateConnection](https://docs.aws.amazon.com/apprunner/latest/api/API_CreateConnection.html) API 動作建立連線。然後，您可以使用 [CreateService](https://docs.aws.amazon.com/apprunner/latest/api/API_CreateService.html) API 動作在建立服務期間提供連線的 ARN。 **來源目錄** 當您建立服務時，您也會提供來源目錄。根據預設，App Runner 會使用儲存庫的根目錄做為來源目錄。來源目錄是原始碼儲存庫中存放應用程式原始碼和組態檔案的位置。建置和啟動命令也會從來源目錄執行。當您使用 App Runner API 或 AWS CLI 來建立或更新服務時，您會在 [CreateService](https://docs.aws.amazon.com/apprunner/latest/api/API_CreateService.html) 和 [UpdateService](https://docs.aws.amazon.com/apprunner/latest/api/API_UpdateService.html) API 動作中提供來源目錄。如需詳細資訊，請參閱下面的[來源目錄](#service-source-code.source-directory)章節。 如需建立 App Runner 服務的詳細資訊，請參閱 [建立 App Runner 服務](manage-create.md)。如需 App Runner 連線的詳細資訊，請參閱 [管理 App Runner 連線](manage-connections.md)。 ## 來源目錄 當您建立 App Runner 服務時，您可以提供來源目錄，以及儲存庫和分支。將**來源目錄**欄位的值設定為儲存應用程式的原始碼和組態檔案的儲存庫目錄路徑。App Runner 會從您提供的來源目錄路徑執行建置和啟動命令。 輸入來源目錄路徑的值做為根儲存庫目錄的絕對值。如果您未指定值，它會預設為儲存庫頂層目錄，也稱為儲存庫根目錄。 除了頂層儲存庫目錄之外，您還可以選擇提供不同的來源目錄路徑。這支援單儲存庫架構，這表示多個應用程式的原始碼存放在一個儲存庫中。若要從單一單一儲存庫建立和支援多個 App Runner 服務，請在建立每個服務時指定不同的來源目錄。 **注意** 如果您為多個 App Runner 服務指定相同的來源目錄，這兩個服務都會個別部署和操作。 如果您選擇使用`apprunner.yaml`組態檔案來定義您的服務參數，請將它放在儲存庫的來源目錄資料夾中。 如果**部署觸發**選項設定為**自動**，則您在來源目錄中遞交的變更將觸發自動部署。*只有來源目錄路徑中的變更*才會觸發自動部署。請務必了解來源目錄的位置如何影響自動部署的範圍。如需詳細資訊，請參閱 中的*自動化部署*[部署方法](manage-deploy.md#manage-deploy.methods)。 **注意** 如果您的 App Runner 服務使用 PHP 受管執行期，而且您想要指定預設根儲存庫以外的來源目錄，請務必使用正確的 PHP 執行期版本。如需詳細資訊，請參閱[使用 PHP 平台](service-source-code-php.md)。 ## App Runner 受管平台 App Runner 受管平台為各種程式設計環境提供受管執行期。每個受管執行期都可讓您根據程式設計語言或執行期環境的版本輕鬆建置和執行容器。當您使用受管執行期時，App Runner 會從受管執行期映像開始。此映像以 [Amazon Linux Docker 映像](https://hub.docker.com/_/amazonlinux)為基礎，並包含語言執行期套件，以及一些工具和熱門的相依性套件。App Runner 使用此受管執行期映像做為基礎映像，並新增您的應用程式程式碼來建置 Docker 映像。然後，它會部署此映像，以在容器中執行您的 Web 服務。 當您使用 App Runner 主控台或 [CreateService](https://docs.aws.amazon.com/apprunner/latest/api/API_CreateService.html) API 操作[建立服務時，](manage-create.md)您可以指定 App Runner 服務的執行時間。您也可以指定執行時間做為原始程式碼的一部分。在程式碼儲存庫中包含的 [App Runner 組態檔案中](config-file.md)使用 `runtime`關鍵字。受管執行時間的命名慣例為 {{}}。 App Runner 會在每次部署或服務更新時，將服務的執行時間更新為最新版本。如果您的應用程式需要特定版本的受管執行時間，您可以使用 [App Runner 組態檔案中](config-file.md)的 `runtime-version`關鍵字來指定它。您可以鎖定任何層級的版本，包括主要或次要版本。App Runner 只會對服務的執行時間進行較低層級的更新。 ## 受管執行時間版本的終止支援 當受管語言執行時間的官方提供者或社群正式宣告版本為生命週期結束 (EOL) 時，App Runner 會接著宣告版本狀態為*終止支援*。如果您的服務在已達到終止支援的受管語言執行時間版本上執行，則適用下列政策和建議。 **語言執行時間版本的終止支援：** + **現有的服務**將繼續執行並為流量提供服務，即使他們使用的執行時間已達到終止支援。不過，它們將在不再接收更新、安全修補程式或技術支援的不支援執行時間上執行。 + 仍然允許更新使用終止支援執行時間的**現有服務**，但不建議繼續為服務使用終止支援執行時間。 + 無法使用已達終止支援日期的執行時間**建立新服務**。 **具有終止支援狀態的語言版本所需的動作：** + 如果您的服務是以**來源映像為基礎**，則不需要對該服務採取進一步的動作。 + 如果您的服務是以**原始程式碼為基礎**，請更新您的服務組態以使用支援的執行時間版本。若要這樣做，請在 [App Runner 主控台](https://console.aws.amazon.com/apprunner)中選取支援的執行時間版本、更新 [apprunner.yaml](config-file.md) 組態檔案中`runtime`的欄位，或使用 [CreateService](https://docs.aws.amazon.com/apprunner/latest/api/API_CreateService.html)/[UpdateService](https://docs.aws.amazon.com/apprunner/latest/api/API_UpdateService.html) API 操作或 IaC 工具來設定 `runtime` 參數。如需支援的執行時間清單，請參閱本章中任何特定執行時間的*版本資訊*頁面。 + 或者，您可以切換到 App Runner 的**容器映像來源**選項。如需詳細資訊，請參閱[影像型服務](service-source-image.md)。 **注意** 如果您要從 Node.js 12、14 或 16 移至 **Node.js 22**，或從 Python 3.7 或 3.8 移至 **Python 3.11**，請注意 Node.js 22 和 Python 3.11 會使用修訂過的 App Runner 建置程序，以提供更快且更有效率的建置。若要在升級之前確保相容性，建議您檢閱下一節中的[建置程序指引](#service-source-code.build-detail)。 下表列出具有指定終止支援日期的 App Runner 受管執行期版本。 | **執行時間版本** | **App Runner 終止支援日期** | | --- | --- | | Python 3.8 [支援的執行時間](service-source-code-python-releases.md) | 2025 年 12 月 1 日 | | Python 3.7 [支援的執行時間](service-source-code-python-releases.md) | 2025 年 12 月 1 日 | | Node.js 18 [支援的執行時間](service-source-code-nodejs-releases.md) | 2025 年 12 月 1 日 | | Node.js 16 [支援的執行時間](service-source-code-nodejs-releases.md) | 2025 年 12 月 1 日 | | Node.js 14 [支援的執行時間](service-source-code-nodejs-releases.md) | 2025 年 12 月 1 日 | | Node.js 12 [支援的執行時間](service-source-code-nodejs-releases.md) | 2025 年 12 月 1 日 | | .NET 6 \* | 2025 年 12 月 1 日 | | PHP 8.1 \* | 2025 年 12 月 31 日 | | Ruby 3.1 \* | 2025 年 12 月 1 日 | | Go 1 \* | 2025 年 12 月 1 日 | **\*** App Runner 不會為標示星號 (\*) 的執行時間發行任何新語言版本。這些執行時間如下：.NET、PHP、Ruby 和 Go。如果您為這些執行時間設定了程式碼型服務，我們建議您執行下列其中一個動作： + 如果適用，請將您的服務組態切換到不同的受支援受管執行時間。 + 或者，使用您偏好的執行時間版本建置自訂容器映像，並使用 App Runner [影像型服務](service-source-image.md)的選項進行部署。您可以在 Amazon ECR 中託管映像。 ## 受管執行期版本和 App Runner 組建 App Runner 為在較近期主要版本執行時間上執行的應用程式提供更新的建置程序。此修訂後的建置程序更快速且更有效率。它也會建立佔用空間較小的最終映像，只包含執行應用程式所需的原始程式碼、建置成品和執行時間。 我們將較新的建置程序稱為*修訂後的 App Runner 組建*，並將原始建置程序稱為*原始 App Runner 組建*。為了避免破壞舊版執行時間平台的變更，App Runner 只會將修訂後的組建套用至特定執行時間版本，通常是新發行的主要版本。 我們已將新元件引入 `apprunner.yaml`組態檔案，讓修訂後的組建與非常特定的使用案例回溯相容，並提供更多彈性來設定應用程式的組建。這是選用[`pre-run`](config-file-ref.md#config-file-ref.run)參數。我們會說明何時使用此參數，以及以下各節中有關組建的其他實用資訊。 下表說明哪些版本的 App Runner 組建適用於特定的受管執行時間版本。我們會繼續更新本文件，讓您隨時了解我們目前的執行時間。 - ** Python – [版本資訊](service-source-code-python-releases.md) ** - ****執行時間版本**:** Python 3.11 (！) / ****建置程序**:** 已修訂 / ****App Runner 終止支援日期**:** - ****執行時間版本**:** Python 3.8 / ****建置程序**:** 原始的 / ****App Runner 終止支援日期**:** 2025 年 12 月 1 日 - ****執行時間版本**:** Python 3.7 / ****建置程序**:** 原始的 / ****App Runner 終止支援日期**:** 2025 年 12 月 1 日 - ** Node.js – [版本資訊](service-source-code-nodejs-releases.md) ** - ****執行時間版本**:** Node.js 22 / ****建置程序**:** 已修訂 / ****App Runner 終止支援日期**:** - ****執行時間版本**:** Node.js 18 / ****建置程序**:** 已修訂 / ****App Runner 終止支援日期**:** 2025 年 12 月 1 日 - ****執行時間版本**:** Node.js 16 / ****建置程序**:** 原始的 / ****App Runner 終止支援日期**:** 2025 年 12 月 1 日 - ****執行時間版本**:** Node.js 14 / ****建置程序**:** 原始的 / ****App Runner 終止支援日期**:** 2025 年 12 月 1 日 - ****執行時間版本**:** Node.js 12 / ****建置程序**:** 原始的 / ****App Runner 終止支援日期**:** 2025 年 12 月 1 日 - ** Corretto – [版本資訊](service-source-code-java-releases.md) ** - ****執行時間版本**:** Corretto 11 / ****建置程序**:** 原始的 / ****App Runner 終止支援日期**:** - ****執行時間版本**:** Corretto 8 / ****建置程序**:** 原始的 / ****App Runner 終止支援日期**:** - ** .NET – [版本資訊](service-source-code-dotnet-releases.md) ** - ****執行時間版本**:** .NET 6 \* - ****建置程序**:** 原始的 - ****App Runner 終止支援日期**:** 2025 年 12 月 1 日 - ** PHP – [版本資訊](service-source-code-php-releases.md) ** - ****執行時間版本**:** PHP 8.1 \* - ****建置程序**:** 原始的 - ****App Runner 終止支援日期**:** 2025 年 12 月 31 日 - ** Ruby – [版本資訊](service-source-code-ruby-releases.md) ** - ****執行時間版本**:** Ruby 3.1 \* - ****建置程序**:** 原始的 - ****App Runner 終止支援日期**:** 2025 年 12 月 1 日 - ** Go – [版本資訊](service-source-code-go-releases.md) ** - ****執行時間版本**:** Go 1 \* - ****建置程序**:** 原始的 - ****App Runner 終止支援日期**:** 2025 年 12 月 1 日 **注意** 某些列出的執行時間包括**終止支援**日期。如需詳細資訊，請參閱[受管執行時間版本的終止支援](#service-source-code.managed-platforms.eos)。 **重要** **Python 3.11** – 對於使用 Python 3.11 受管執行時間的服務建置組態，我們提供特定建議。如需詳細資訊，請參閱 *Python 平台*主題[特定執行時間版本的呼叫](service-source-code-python.md#service-source-code-python.callouts)中的 。 ### App Runner 建置和遷移的詳細資訊 當您將應用程式遷移至使用修訂組建的較新執行期時，您可能需要稍微修改組建組態。 為了提供遷移考量的內容，我們會先說明原始 App Runner 組建和修訂組建的高階程序。接下來我們將有一個章節，說明可能需要一些組態更新之服務的特定屬性。 #### 原始 App Runner 組建 原始 App Runner 應用程式建置程序會利用 AWS CodeBuild 服務。初始步驟是根據 CodeBuild 服務所策劃的影像。以下 Docker 建置程序會使用適用的 App Runner 受管執行期映像做為基礎映像。 一般步驟如下： 1. 在 CodeBuild 策劃的映像中執行`pre-build`命令。 這些`pre-build`命令是選用的。它們只能在`apprunner.yaml`組態檔案中指定。 1. 在上一個步驟的相同映像上使用 CodeBuild 執行`build`命令。 `build` 命令是必要的。它們可以在 App Runner 主控台、App Runner API 或`apprunner.yaml`組態檔案中指定。 1. 執行 Docker 組建，根據特定平台和執行期版本的 App Runner 受管執行期映像產生映像。 1. 從我們在**步驟 2 **中產生的映像複製`/app`目錄。目的地是根據我們在**步驟 3** 中產生的 App Runner 受管執行期映像的映像。 1. 在產生的 App Runner 受管執行期映像上再次執行`build`命令。我們會再次執行組建命令，從我們在**步驟 4 **中複製的`/app`目錄中的原始程式碼產生組建成品。App Runner 稍後會部署此映像，以在容器中執行您的 Web 服務。 `build` 命令是必要的。它們可以在 App Runner 主控台、App Runner API 或`apprunner.yaml`組態檔案中指定。 1. 在**步驟 2** 的 CodeBuild 映像中執行`post-build`命令。 這些`post-build`命令是選用的。它們只能在`apprunner.yaml`組態檔案中指定。 建置完成後，App Runner 會從**步驟 5** 部署產生的 App Runner 受管執行期映像，以在容器中執行您的 Web 服務。 #### 修訂後的 App Runner 組建 修訂後的建置程序比上一節所述的原始建置程序更快且更有效率。它消除了先前版本組建中發生的組建命令的重複。它也會建立佔用空間較小的最終映像，只包含執行應用程式所需的原始程式碼、建置成品和執行時間。 此建置程序使用 Docker 多階段建置。一般程序步驟如下： 1. **建置階段** — 在 App Runner 建置映像之上啟動執行 `pre-build`和 `build`命令的 Docker 建置程序。 1. 將應用程式原始碼複製到 `/app`目錄。 **注意** 此`/app`目錄會在 Docker 組建的每個階段中指定為工作目錄。 1. 執行 `pre-build` 命令。 這些`pre-build`命令是選用的。它們只能在`apprunner.yaml`組態檔案中指定。 1. 執行`build`命令。 `build` 命令是必要的。它們可以在 App Runner 主控台、App Runner API 或`apprunner.yaml`組態檔案中指定。 1. **封裝階段** — 產生最終客戶容器映像，這也以 App Runner 執行映像為基礎。 1. 將`/app`目錄從先前的**建置階段**複製到新的執行映像。這包括您的應用程式原始程式碼和上一個階段的建置成品。 1. 執行`pre-run`命令。如果您需要使用 `build`命令修改`/app`目錄外部的執行期映像，請將相同或必要的命令新增至`apprunner.yaml`組態檔案的此區段。 這是為了支援修訂後的 App Runner 建置而引入的新參數。 這些`pre-run`命令是選用的。它們只能在`apprunner.yaml`組態檔案中指定。 **備註** `pre-run` 命令僅受修訂的組建支援。如果您的服務使用使用原始建置的執行期版本，請勿將其新增至組態檔案。 如果您不需要使用 `build`命令修改`/app`目錄外的任何內容，則不需要指定`pre-run`命令。 1. **建置後階段** — 此階段會從*建置階段*繼續並執行`post-build`命令。 1. 在 `/app`目錄中執行`post-build`命令。 這些`post-build`命令是選用的。它們只能在`apprunner.yaml`組態檔案中指定。 建置完成後，App Runner 接著會部署執行映像，以在容器中執行您的 Web 服務。 **注意** 設定建置程序`apprunner.yaml`時，請勿誤導至 執行區段中的`env`項目。即使**步驟 2(b)** 中參考的`pre-run`命令參數位於執行區段中，也請勿使用執行區段中的 `env` 參數來設定建置。這些`pre-run`命令只會參考組態檔案建置區段中定義的`env`變數。如需詳細資訊，請參閱 *App Runner 組態檔案章節*[執行區段](config-file-ref.md#config-file-ref.run)中的 。 #### 遷移考量的服務需求 如果您的應用程式環境有這兩個需求之一，則您需要透過新增`pre-run`命令來修改建置組態。 + 如果您需要使用 `build`命令修改`/app`目錄外的任何內容。 + 如果您需要執行`build`命令兩次，以建立所需的環境。這是非常不尋常的要求。絕大多數的組建都不會這樣做。 **`/app`目錄外的修改** + [修訂後的 App Runner 組建](#service-source-code.build-detail.v2)假設您的應用程式在 `/app` 目錄外沒有相依性。 + 您隨`apprunner.yaml`檔案、App Runner API 或 App Runner 主控台提供的命令必須在 `/app`目錄中產生建置成品。 + 您可以修改 `pre-build`、 `build`和 `post-build`命令，以確保所有建置成品都位於 `/app`目錄中。 + 如果您的應用程式需要 建置進一步修改服務產生的映像，您可以在 `/app` 目錄中使用新`pre-run`命令`apprunner.yaml`。如需詳細資訊，請參閱[使用組態檔案設定 App Runner 服務選項](config-file.md)。 **執行`build`命令兩次** + [原始 App Runner 組建](#service-source-code.build-detail.v1)會執行`build`命令兩次，首先在**步驟 2 **中執行，然後再次在**步驟 5 **中執行。修訂後的 App Runner 組建可修復此備援，而且只會執行`build`命令一次。如果您的應用程式應該對`build`命令執行兩次有不尋常的需求，修訂後的 App Runner 組建會提供使用 `pre-run` 參數再次指定和執行相同命令的選項。這樣做會保留相同的雙組建行為。