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 服務的環境變數：
+ [App Runner 主控台](#env-variable-manage.console)
+ [App Runner API 或 AWS CLI](#env-variable-manage.api)
## App Runner 主控台
當您[在 App Runner 主控台上建立服務或](manage-create.md)[更新服務時](manage-configure.md)，您可以新增環境變數。
### 新增環境變數
**新增環境變數**
1. 開啟 [App Runner 主控台](https://console.aws.amazon.com/apprunner)，然後在**區域**清單中選取您的 AWS 區域。
1. 根據您是要建立或更新服務，請執行下列其中一個步驟：
+ 如果您要建立新的服務，請選擇**建立 App Runner 服務**，然後前往**設定服務**。
+ 如果您要更新現有的服務，請選取您要更新的服務，然後前往服務的**組態**索引標籤。
1. 前往**環境變數 - 服務設定下的選用**。 ****
1. 根據您的需求選擇下列任一選項：
+ 從**環境變數來源**中選擇**純文字**，並在**環境變數名稱**和**環境變數值**下分別輸入其鍵值對。
**注意**
如果您想要參考非敏感資料，請選擇**純文字**。此資料不會加密，其他人可以在 App Runner 服務組態和應用程式日誌中看到。
+ 從**環境變數來源**中選擇 **Secrets Manager**，以參考存放在 中的秘密 AWS Secrets Manager 做為服務中的環境變數。分別在環境變數名稱和環境**變數值**下**，提供您參考之秘密的環境變數名稱**和 Amazon Resource Name (ARN)。
+ 從**環境變數來源**選擇 **SSM 參數存放**區，以參考存放在 SSM 參數存放區中的參數做為服務中的環境變數。分別在環境變數名稱和**環境變數值**下，提供您參考之參數**的環境變數名稱**和 ARN。
**注意**
您無法在建立或更新 App Runner 服務時，將 指派`PORT`為環境變數的名稱。這是 App Runner 服務的預留環境變數。
如果 SSM 參數存放區參數與您要啟動 AWS 區域 的服務位於相同位置，您可以指定完整 Amazon Resource Name (ARN) 或 參數的名稱。如果 參數位於不同的區域，您需要指定完整的 ARN。
請確定您參考的 參數與您啟動或更新的服務位於相同的 帳戶。目前，您無法跨帳戶參考 SSM 參數存放區參數。
1. 選擇**新增環境變數**以參考另一個環境變數。
1. 展開 **IAM 政策範本**，以檢視和複製為 AWS Secrets Manager 和 SSM 參數存放區提供的 IAM 政策範本。只有在您尚未使用所需的許可更新執行個體角色的 IAM 政策時，才需要執行此操作。如需詳細資訊，請參閱 [ 許可](env-variable.md#env-variable.sensitivedata.permissions)。
### 移除環境變數
刪除環境變數之前，請確定您的應用程式程式碼已更新以反映相同的程式碼。如果應用程式碼未更新，您的 App Runner 服務可能會失敗。
**移除環境變數**
1. 開啟 [App Runner 主控台](https://console.aws.amazon.com/apprunner)，然後在**區域**清單中選取您的 AWS 區域。
1. 前往您要更新之服務的**組態**索引標籤。
1. 前往**環境變數 - 服務設定下的選用**。 ****
1. 選擇您要**移除**的環境變數旁的移除。您會收到確認刪除的訊息。
1. 選擇 **刪除**。
## App Runner API 或 AWS CLI
您可以參考存放在 Secrets Manager 和 SSM 參數存放區中的敏感資料，方法是將它們新增為服務中的環境變數。
**注意**
更新執行個體角色的 IAM 政策，讓 App Runner 可以存取存放在 Secrets Manager 和 SSM 參數存放區的秘密和參數。如需詳細資訊，請參閱 [ 許可](env-variable.md#env-variable.sensitivedata.permissions)。
**參考秘密和組態做為環境變數**
1. 在 Secrets Manager 或 SSM 參數存放區中建立秘密或組態。
下列範例示範如何使用 SSM 參數存放區建立秘密和參數。
**Example 建立秘密 - 請求**
下列範例示範如何建立代表資料庫登入資料的秘密。
```
aws secretsmanager create-secret \
—name DevRdsCredentials \
—description "Rds credentials for development account." \
—secret-string "{\"user\":\"diegor\",\"password\":\"EXAMPLE-PASSWORD\"}"
```
**Example 建立秘密 - 回應**
```
arn:aws:secretsmanager:::secret:DevRdsCredentials
```
**Example 建立組態 - 請求**
下列範例示範如何建立代表 RDS 連線字串的參數。
```
aws systemsmanager put-parameter \
—name DevRdsConnectionString \
—value "mysql2://dev-mysqlcluster-rds.com:3306/diegor" \
—type "String" \
—description "Rds connection string for development account."
```
**Example 建立組態 - 回應**
```
arn:aws:ssm:::parameter/DevRdsConnectionString
```
1. 將秘密和組態新增為環境變數，以參考儲存在 Secrets Manager 和 SSM 參數存放區中的秘密和組態。您可以在建立或更新 App Runner 服務時新增環境變數。
下列範例示範如何在程式碼型和映像型 App Runner 服務上將秘密和組態參考為環境變數。
**Example 影像型 App Runner 服務的 Input.json 檔案**
```
{
"ServiceName": "example-secrets",
"SourceConfiguration": {
"ImageRepository": {
"ImageIdentifier": "",
"ImageConfiguration": {
"Port": "",
"RuntimeEnvironmentSecrets": {
"Credential1":"arn:aws:secretsmanager:::secret:XXXXXXXXXXXX",
"Credential2":"arn:aws:ssm:::parameter/"
}
},
"ImageRepositoryType": "ECR_PUBLIC"
}
},
"InstanceConfiguration": {
"Cpu": "1 vCPU",
"Memory": "3 GB",
"InstanceRoleArn": ""
}
}
```
**Example 以映像為基礎的 App Runner 服務 – 請求**
```
aws apprunner create-service \
--cli-input-json file://input.json
```
**Example 以映像為基礎的 App Runner 服務 – 回應**
```
{
...
"ImageRepository": {
"ImageIdentifier":"",
"ImageConfiguration":{
"Port": "",
"RuntimeEnvironmentSecrets":{
"Credential1": "arn:aws:secretsmanager:::secret:XXXXXXXXXXXX",
"Credential2": "arn:aws:ssm:::parameter/"
},
"ImageRepositoryType":"ECR"
}
},
"InstanceConfiguration": {
"CPU": "1 vCPU",
"Memory": "3 GB",
"InstanceRoleArn: ""
}
...
}
```
**Example 程式碼型 App Runner 服務的 Input.json 檔案**
```
{
"ServiceName": "example-secrets",
"SourceConfiguration": {
"AuthenticationConfiguration": {
"ConnectionArn": "arn:aws:apprunner:us-east-1:123456789012:connection/my-github-connection/XXXXXXXXXX"
},
"AutoDeploymentsEnabled": false,
"CodeRepository": {
"RepositoryUrl": "",
"SourceCodeVersion": {
"Type": "BRANCH",
"Value": "main"
},
"CodeConfiguration": {
"ConfigurationSource": "API",
"CodeConfigurationValues": {
"Runtime": "",
"BuildCommand": "",
"StartCommand": "",
"Port": "",
"RuntimeEnvironmentSecrets": {
"Credential1":"arn:aws:secretsmanager:::secret:XXXXXXXXXXXX",
"Credential2":"arn:aws:ssm:::parameter/"
}
}
}
}
},
"InstanceConfiguration": {
"Cpu": "1 vCPU",
"Memory": "3 GB",
"InstanceRoleArn": ""
}
}
```
**Example 程式碼型 App Runner 服務 – 請求**
```
aws apprunner create-service \
--cli-input-json file://input.json
```
**Example 程式碼型 App Runner 服務 – 回應**
```
{
...
"SourceConfiguration":{
"CodeRepository":{
"RepositoryUrl":"",
"SourceCodeVersion":{
"Type":"Branch",
"Value":"main"
},
"CodeConfiguration":{
"ConfigurationSource":"API",
"CodeConfigurationValues":{
"Runtime":"",
"BuildCommand":"",
"StartCommand":"",
"Port":"",
"RuntimeEnvironmentSecrets":{
"Credential1" : "arn:aws:secretsmanager:::secret:XXXXXXXX",
"Credential2" : "arn:aws:ssm:::parameter/"
}
}
}
},
"InstanceConfiguration": {
"CPU": "1 vCPU",
"Memory": "3 GB",
"InstanceRoleArn: ""
}
...
}
```
1. `apprunner.yaml` 模型會更新以反映新增的秘密。
以下是更新`apprunner.yaml`模型的範例。
**Example `apprunner.yaml`**
```
version: 1.0
runtime: python3
build:
commands:
build:
- python -m pip install flask
run:
command: python app.py
network:
port: 8080
env:
- name: MY_VAR_EXAMPLE
value: "example"
secrets:
- name: my-secret
value-from: "arn:aws:secretsmanager:::secret:XXXXXXXXXXXX"
- name: my-parameter
value-from: "arn:aws:ssm:::parameter/"
- name: my-parameter-only-name
value-from: "parameter-name"
```