AWS App Runner 自 2026 年 4 月 30 日起，不再開放給新客戶。如果您想要使用 App Runner，請在該日期之前註冊。現有客戶可以繼續正常使用該服務。如需詳細資訊，請參閱[AWS App Runner 可用性變更](https://docs.aws.amazon.com/apprunner/latest/dg/apprunner-availability-change.html)。
本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# 設定 App Runner 服務
當您[建立 AWS App Runner 服務](manage-create.md)時，您可以設定各種組態值。您可以在建立服務之後變更其中一些組態設定。其他設定只能在建立服務時套用，之後無法變更。本主題討論使用 App Runner API、App Runner 主控台和 App Runner 組態檔案的服務組態。
**Topics**
+ [使用 App Runner API 或 設定您的服務 AWS CLI](#manage-configure.api)
+ [使用 App Runner 主控台設定您的服務](#manage-configure.console)
+ [使用 App Runner 組態檔案設定您的服務](#manage-configure.file)
+ [為您的服務設定可觀測性](manage-configure-observability.md)
+ [使用可分割資源設定服務設定](manage-configure-resources.md)
+ [為您的服務設定運作狀態檢查](manage-configure-healthcheck.md)
## 使用 App Runner API 或 設定您的服務 AWS CLI
API 定義可在服務建立後變更的設定。下列清單討論相關動作、類型和限制。
+ [UpdateService](https://docs.aws.amazon.com/apprunner/latest/api/API_UpdateService.html) 動作 – 可在建立後呼叫 ，以更新一些組態設定。
+ *可以更新* – 您可以更新 `SourceConfiguration`、 `InstanceConfiguration`和 `HealthCheckConfiguration` 參數中的設定。不過，在 中`SourceConfiguration`，您無法將來源類型從程式碼切換到映像或反之亦然。您必須提供與建立服務時所提供的相同儲存庫參數。這是 `CodeRepository`或 `ImageRepository`。
您也可以更新與服務相關聯之個別組態資源的下列 ARNs：
+ `AutoScalingConfigurationArn`
+ `VpcConnectorArn`
+ *無法更新* – 您無法變更 [CreateService](https://docs.aws.amazon.com/apprunner/latest/api/API_CreateService.html) 動作中可用的 `ServiceName`和 `EncryptionConfiguration` 參數。它們建立後就無法變更。[UpdateService](https://docs.aws.amazon.com/apprunner/latest/api/API_UpdateService.html) 動作不包含這些參數。
+ *API 與 檔案* – 您可以將 [CodeConfiguration](https://docs.aws.amazon.com/apprunner/latest/api/API_CodeConfiguration.html) 類型的 `ConfigurationSource` 參數 （用於做為 的一部分的原始碼儲存庫`SourceConfiguration`) 設定為 `Repository`。在此情況下，App Runner 會忽略 中的組態設定`CodeConfigurationValues`，並從儲存庫中的[組態檔案](config-file.md)讀取這些設定。如果您將 `ConfigurationSource` 設定為 `API`，App Runner 會從 API 呼叫取得所有組態設定，並忽略組態檔案，即使組態檔案存在。
+ [TagResource](https://docs.aws.amazon.com/apprunner/latest/api/API_TagResource.html) 動作 – 可在建立服務之後呼叫，以將標籤新增至服務或更新現有標籤的值。
+ [UntagResource](https://docs.aws.amazon.com/apprunner/latest/api/API_UntagResource.html) 動作 – 可在建立服務之後呼叫，以從服務中移除標籤。
**注意**
如果您為服務建立傳出流量 VPC 連接器，接下來的服務啟動程序將經歷一次性延遲。您可以在建立新服務時或之後使用服務更新來設定此組態。如需詳細資訊，請參閱本指南*的 Networking with App Runner* 章節[一次性延遲](network-vpc.md#network-vpc.VPC-connector.latency)中的 。
## 使用 App Runner 主控台設定您的服務
主控台使用 App Runner API 來套用組態更新。API 強制執行的更新規則，如上一節所定義，決定您可以使用 主控台設定的內容。某些在服務建立期間可用的設定稍後無法進行修改。此外，如果您決定使用[組態檔案](config-file.md)，則主控台中會隱藏其他設定，而 App Runner 會從檔案讀取這些設定。
**設定您的服務**
1. 開啟 [App Runner 主控台](https://console.aws.amazon.com/apprunner)，然後在**區域**清單中選取您的 AWS 區域。
1. 在導覽窗格中，選擇**服務**，然後選擇您的 App Runner 服務。
主控台會顯示具有服務**概觀的服務**儀表板。
![\[App Runner 服務儀表板頁面顯示活動清單\]](http://docs.aws.amazon.com/zh_tw/apprunner/latest/dg/images/console-dashboard.png)
1. 在服務儀表板頁面上，選擇**組態**索引標籤。
結果：主控台會以數個區段顯示服務目前的組態設定：**來源和部署**、**設定建置**和**設定服務**。
1. 若要更新任何類別中的設定，請選擇**編輯**。
1. 在組態編輯頁面上，進行任何所需的變更，然後選擇**儲存變更**。
**注意**
如果您為服務建立傳出流量 VPC 連接器，接下來的服務啟動程序將經歷一次性延遲。您可以在建立新服務時或之後使用服務更新來設定此組態。如需詳細資訊，請參閱本指南*的 Networking with App Runner* 章節[一次性延遲](network-vpc.md#network-vpc.VPC-connector.latency)中的 。
## 使用 App Runner 組態檔案設定您的服務
當您建立或更新 App Runner 服務時，您可以指示 App Runner 從您作為來源儲存庫的一部分提供的組態檔案中讀取一些組態設定。透過這樣做，您可以在來源控制下管理與原始程式碼相關的設定，以及程式碼本身。組態檔案也提供您無法使用主控台或 API 設定的特定進階設定。如需詳細資訊，請參閱[使用組態檔案設定 App Runner 服務選項](config-file.md)。
**注意**
如果您為服務建立傳出流量 VPC 連接器，接下來的服務啟動程序將經歷一次性延遲。您可以在建立新服務時或之後使用服務更新來設定此組態。如需詳細資訊，請參閱本指南*的 Networking with App Runner* 章節[一次性延遲](network-vpc.md#network-vpc.VPC-connector.latency)中的 。
# 為您的服務設定可觀測性
AWS App Runner 與數個 AWS 服務整合，為您的 App Runner 服務提供廣泛的可觀測性工具套件。如需詳細資訊，請參閱[App Runner 服務的可觀測性](monitor.md)。
App Runner 支援啟用一些可觀測性功能，並使用稱為 *ObservabilityConfiguration* 的可分割資源來設定其行為。您可以在建立或更新服務時提供可觀測性組態資源。當您建立新的 App Runner 服務時，App Runner 主控台會為您建立一個。提供可觀測性組態是選用的。如果您未提供，App Runner 會提供預設可觀測性組態。
您可以跨多個 App Runner 服務共用單一可觀測性組態，以確保它們具有相同的可觀測性行為。如需詳細資訊，請參閱[使用可分割資源設定服務設定](manage-configure-resources.md)。
您可以使用可觀測性組態來設定下列可觀測性功能：
+ *追蹤組態* – 追蹤應用程式提供的請求及其發出的下游呼叫的設定。如需追蹤的詳細資訊，請參閱：[使用 X-Ray 追蹤 App Runner 應用程式](monitor-xray.md)。
## 管理可觀測性
使用下列其中一種方法來管理 App Runner 服務的可觀測性：
------
#### [ App Runner console ]
當您使用 App Runner 主控台[建立服務](manage-create.md)，或[稍後更新其組態](manage-configure.md)時，您可以為服務設定可觀測性功能。在主控台頁面上尋找**可觀測性**組態區段。
![\[App Runner 主控台組態頁面顯示可觀測性選項\]](http://docs.aws.amazon.com/zh_tw/apprunner/latest/dg/images/manage-configure-observability.png)
------
#### [ App Runner API or 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) App Runner API 動作時，您可以使用 `ObservabilityConfiguration` 參數物件來啟用可觀測性功能，並為您的服務指定可觀測性組態資源。
使用下列 App Runner API 動作來管理您的可觀測性組態資源。
+ [CreateObservabilityConfiguration](https://docs.aws.amazon.com/apprunner/latest/api/API_CreateObservabilityConfiguration.html) – 建立新的可觀測性組態或現有組態的修訂。
+ [ListObservabilityConfigurations](https://docs.aws.amazon.com/apprunner/latest/api/API_ListObservabilityConfigurations.html) – 傳回與您的 相關聯的可觀測性組態清單 AWS 帳戶，其中包含摘要資訊。
+ [DescribeObservabilityConfiguration](https://docs.aws.amazon.com/apprunner/latest/api/API_DescribeObservabilityConfiguration.html) – 傳回可觀測性組態的完整描述。
+ [DeleteObservabilityConfiguration](https://docs.aws.amazon.com/apprunner/latest/api/API_DeleteObservabilityConfiguration.html) – 刪除可觀測性組態。您可以刪除特定修訂或最新的作用中修訂。如果您達到 的可觀測性組態配額，您可能需要刪除不必要的可觀測性組態 AWS 帳戶。
------
# 使用可分割資源設定服務設定
對於某些功能，跨 AWS App Runner 服務共用組態是合理的。例如，您可能希望一組服務具有相同的自動擴展行為。或者，您可能想要對所有 服務進行相同的可觀測性設定。App Runner 可讓您使用個別的可分割資源來共用設定。您可以建立資源來定義功能的一組組態設定，然後將此組態資源的 Amazon Resource Name (ARN) 提供給一或多個 App Runner 服務。
App Runner 會實作下列功能的可共用組態資源：
+ [自動擴展](manage-autoscaling.md)
+ [可觀測性](manage-configure-observability.md)
+ [VPC 存取](network-vpc.md)
每個功能的文件頁面都會提供有關可用設定和管理程序的資訊。
使用個別組態資源的功能會共用一些設計特性和考量事項。
+ **修訂** – 有些組態資源可以有修訂。自動擴展和可觀測性是使用修訂的兩個組態資源的範例。在這些情況下，每個組態都有一個*名稱*和一個數值*修訂*。組態的多個修訂具有相同的名稱和不同的修訂編號。您可以針對不同的案例使用不同的組態名稱。對於每個名稱，您可以新增多個修訂，以微調特定案例的設定。
您使用名稱建立的第一個組態會取得修訂編號 1。名稱相同的後續組態會取得連續的修訂編號 （以 2 開頭）。您可以將 App Runner 服務與特定組態修訂或組態的最新修訂建立關聯。
+ **共用** – 您可以在多個 App Runner 服務之間共用單一組態資源。如果您想要在這些服務中維護相同的組態，這會很有用。特別是，如果您的資源支援修訂，您可以將多個 服務設定為使用組態的最新修訂。您可以只指定組態名稱，但不能指定修訂。當您更新服務時，您以此方式設定的任何服務都會收到組態更新。如需組態變更的詳細資訊，請參閱 [設定 App Runner 服務](manage-configure.md)。
+ **資源管理** – 您可以使用 App Runner 來建立和刪除組態。您無法直接更新組態。相反地，對於支援修訂的資源，您可以建立新的現有組態名稱修訂，以有效地更新組態。
**注意**
對於自動擴展，您可以使用 App Runner 主控台和 App Runner API 來建立組態和*多個*修訂。App Runner 主控台和 App Runner API 也可以刪除組態和修訂。如需詳細資訊，請參閱[管理 App Runner 自動擴展](manage-autoscaling.md)。
對於其他組態類型，例如可觀測性組態，您只能使用 App Runner 主控台建立具有*單一*修訂的組態。若要建立更多修訂和刪除組態，您必須使用 App Runner API。
+ **資源配額** – 您可以針對每個組態資源擁有的唯一組態名稱和修訂數量設定配額 AWS 區域。如果您達到這些配額，您必須先刪除組態名稱或至少部分修訂，才能建立更多。對於自動擴展組態修訂，您可以使用 App Runner 主控台或 App Runner API 來刪除它們。如需詳細資訊，請參閱[管理 App Runner 自動擴展](manage-autoscaling.md)。您必須使用 App Runner API 來刪除其他資源。如需配額的詳細資訊，請參閱 [App Runner 資源配額](architecture.md#architecture.quotas)。
+ **無資源成本** – 建立組態資源不會產生額外費用。您可能會產生功能本身的成本 （例如，開啟 X-Ray 追蹤時需支付正常 AWS X-Ray 成本），但不會針對設定 App Runner 服務功能的 App Runner 組態資源收取費用。
# 為您的服務設定運作狀態檢查
AWS App Runner 透過執行運作狀態檢查來監控服務的運作狀態。預設的運作狀態檢查通訊協定為 TCP。App Runner 會 Ping 指派給您服務的網域。或者，您可以將運作狀態檢查通訊協定設定為 HTTP。App Runner 會將運作狀態檢查 HTTP 請求傳送至您的 Web 應用程式。
您可以設定與運作狀態檢查相關的一些設定。下表說明運作狀態檢查設定及其預設值。
| **設定** | **描述** | **預設** |
| --- | --- | --- |
| 通訊協定 | App Runner 用來為您的服務執行運作狀態檢查的 IP 通訊協定。 如果您將通訊協定設定為 `TCP`，App Runner 會在應用程式接聽的連接埠 ping 指派給服務的預設網域。 如果您將通訊協定設定為 `HTTP`，App Runner 會將運作狀態檢查請求傳送至設定的路徑。 | `TCP` |
| 路徑 | App Runner 傳送 HTTP 運作狀態檢查請求的 URL。僅適用於 HTTP 檢查。 | `/` |
| Interval | 運作狀態檢查之間的時間間隔 (以秒為單位)。 | `5` |
| Timeout (逾時) | 在判斷運作狀態檢查回應失敗之前等待運作狀態檢查回應的時間 (以秒為單位)。 | `2` |
| 運作狀態良好的閾值 | 在 App Runner 判斷服務運作狀態良好之前，必須成功的連續檢查次數。 | `1` |
| 運作狀態不佳閾值 | 在 App Runner 判斷服務運作狀態不良之前，必須失敗的連續檢查次數。 | `5` |
## 設定運作狀態檢查
使用下列其中一種方法來設定 App Runner 服務的運作狀態檢查：
------
#### [ App Runner console ]
當您使用 App Runner 主控台建立 App Runner 服務，或稍後更新其組態時，您可以設定運作狀態檢查設定。如需完整的主控台程序，請參閱 [建立 App Runner 服務](manage-create.md)和 [設定 App Runner 服務](manage-configure.md)。在這兩種情況下，請尋找主控台頁面上**的運作狀態檢查**組態區段。
![\[App Runner 主控台組態頁面顯示運作狀態檢查選項\]](http://docs.aws.amazon.com/zh_tw/apprunner/latest/dg/images/console-health-check.png)
------
#### [ App Runner API or 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 動作時，您可以使用 `HealthCheckConfiguration` 參數來指定運作狀態檢查設定。
如需 參數結構的相關資訊，請參閱 *AWS App Runner API 參考*中的 [HealthCheckConfiguration](https://docs.aws.amazon.com/apprunner/latest/api/API_HealthCheckConfiguration.html)。
------