返回列表

AWS快速開戶 AWS App Runner 實戰:快速部署容器化 Web 應用

亞馬遜雲AWS / 2026-10-21 16:08:34

# AWS App Runner 實戰:快速部署容器化 Web 應用

如果你搜尋這個主題,通常不是想了解 App Runner 的概念,而是想把一個已經容器化的 Web 應用真正跑起來,並且解決部署過程中的幾個實際問題:

- 容器映像該放在哪裡
- App Runner 服務要怎麼建立
- 應用為什麼啟動失敗
- 端口、環境變量、健康檢查怎麼設定
- 怎麼做到推送映像後自動更新
- 服務能不能連接資料庫
- 出現 502、啟動超時、健康檢查失敗時怎麼查

這篇文章直接按照實際操作流程來寫,不做概念鋪墊,重點放在「能部署、能訪問、能排障」。

AWS快速開戶 ---

## 一、部署前先確認:你的應用是否適合 App Runner

在開始之前,先確認你的容器化 Web 應用符合以下條件:

1. 應用能在容器內以前台方式啟動
2. 應用監聽的是 `0.0.0.0`,不是 `127.0.0.1`
3. 應用有固定監聽端口,例如 `8080`
4. 容器啟動後不需要人工互動
5. 應用是 HTTP/HTTPS 類型服務,而不是長期依賴 TCP 自定義協議

如果你的應用是 Flask、FastAPI、Node.js、Spring Boot、Go Web、PHP 容器化服務,通常都可以直接部署。

### 常見踩坑

- **只監聽 localhost**:App Runner 會判定服務不可用
- **容器啟動後立刻退出**:通常是 CMD/ENTRYPOINT 配錯
- **端口與實際監聽不一致**:健康檢查會失敗
- **啟動時間過長**:應用初始化太慢,容易超時

---

## 二、實戰架構與本文示例

本文採用最常見的一條路徑:

**本地 Docker 建鏡像 → 推送到 Amazon ECR → 建立 App Runner 服務 → 綁定端口與環境變量 → 驗證訪問 → 查看日誌與排錯**

你需要準備:

- 一個 AWS 帳號
- 已安裝 Docker
- 已安裝並配置 AWS CLI
- 一個可正常運行的容器化 Web 應用

本文示例假設應用監聽 `8080` 端口。

---

## 三、準備容器映像

App Runner 可以從原始碼建置,也可以直接從容器映像部署。實務上,如果你已經有 Dockerfile,直接走 **ECR 映像部署** 會更可控,也更容易排查問題。

### 1. 範例 Dockerfile

以 Node.js 為例:

```dockerfile
FROM node:18-alpine
WORKDIR /app
COPY package*.json ./
RUN npm ci --only=production
COPY . .
ENV PORT=8080
EXPOSE 8080
CMD ["node", "server.js"]
```

### 2. 應用程式監聽方式要正確

例如 Express:

```javascript
const express = require('express');
const app = express();
const port = process.env.PORT || 8080;

app.get('/', (req, res) => {
res.send('App Runner deployed successfully');
});

AWS快速開戶 app.listen(port, '0.0.0.0', () => {
console.log(`Server listening on ${port}`);
});
```

這裡的重點不是語法,而是:

- 端口從環境變量讀取
- 監聽 `0.0.0.0`

如果你寫成 `127.0.0.1`,本地容器也許能測試成功,但 App Runner 無法從外部路由到這個服務。

---

## 四、本地建置與測試容器

在推送到 AWS 前,先在本地測試,能省掉很多排障時間。

### 1. 建置映像

```bash
docker build -t my-web-app:latest .
```

### 2. 本地啟動容器

```bash
docker run -p 8080:8080 my-web-app:latest
```

### 3. 驗證是否可訪問

```bash
curl http://localhost:8080/
```

如果本地都不通,不要直接上 App Runner,先檢查:

- Dockerfile 是否正確
- 啟動命令是否正確
- 應用是否有依賴漏裝
- 端口是否一致

---

## 五、建立 ECR 倉庫並推送映像

### 1. 建立 ECR Repository

可在 AWS Console 進入:

**Amazon ECR → Repositories → Create repository**

建議配置:

- Repository name:`my-web-app`
- Tag immutability:如果你想避免標籤覆蓋,可開啟
- Scan on push:建議開啟,方便發現映像漏洞

### 2. 登入 ECR

先確認 CLI 區域與 ECR 所在區域一致,例如 `ap-northeast-1`:

```bash
aws ecr get-login-password --region ap-northeast-1 | docker login --username AWS --password-stdin .dkr.ecr.ap-northeast-1.amazonaws.com
```

### 3. 為映像打標籤

```bash
docker tag my-web-app:latest .dkr.ecr.ap-northeast-1.amazonaws.com/my-web-app:latest
```

### 4. 推送映像

```bash
docker push .dkr.ecr.ap-northeast-1.amazonaws.com/my-web-app:latest
```

### 常見問題

#### 問題 1:no basic auth credentials
通常是沒有先執行 `docker login`,或登入區域錯了。

#### 問題 2:repository not found
通常是:

- 倉庫名稱拼錯
- AWS 區域不一致
- 當前 IAM 帳號沒有 ECR 權限

#### 問題 3:push denied
檢查 IAM 權限是否包含:

- `ecr:GetAuthorizationToken`
- `ecr:BatchCheckLayerAvailability`
- `ecr:InitiateLayerUpload`
- `ecr:PutImage`
- `ecr:UploadLayerPart`
- `ecr:CompleteLayerUpload`

---

## 六、在 App Runner 建立服務

接下來進入核心操作。

路徑:

**AWS Console → AWS App Runner → Create service**

### 1. 選擇來源

選擇:

AWS快速開戶 - **Container registry**
- Provider:**Amazon ECR**
- 選擇剛才的 repository 與 image tag

如果你希望每次推送新映像後自動部署,開啟:

- **Automatic deployment**

這樣之後只要同一個 tag 被更新,App Runner 就會自動拉取並發布新版本。

### 2. 設定服務基本資訊

AWS快速開戶 例如:

AWS快速開戶 - Service name:`my-web-app-service`
- Virtual CPU:`1 vCPU`
- Virtual memory:`2 GB`

#### CPU / 記憶體怎麼選

AWS快速開戶 實務建議:

- 小型 API、後台頁面:`1 vCPU / 2 GB`
- Java 應用、啟動較重服務:`2 vCPU / 4 GB`
- 如果只是測試環境,先從較低配置開始,再依監控結果調整

如果容器啟動時會做大量初始化,例如 ORM migration、大量快取預熱,記憶體太小容易啟動失敗。

### 3. 端口設定

App Runner 需要知道容器對外服務的端口。

例如你的應用跑在 `8080`,就填:

- Port:`8080`

#### 這一步最容易出錯

如果你的 Dockerfile `EXPOSE 8080`,但實際應用監聽 `3000`,那服務建立後通常會健康檢查失敗。

AWS快速開戶 記住:**以應用實際監聽端口為準,不是以你習慣填的值為準。**

---

## 七、配置環境變量與啟動參數

如果你的應用依賴資料庫連線、API 金鑰、運行環境等參數,需要在 App Runner 裡配置。

### 1. 常見環境變量

例如:

- `PORT=8080`
- `NODE_ENV=production`
- `DB_HOST=xxx`
- `DB_PORT=3306`
- `DB_NAME=appdb`
- `DB_USER=appuser`

### 2. 敏感資訊不要明文寫死

像 `DB_PASSWORD`、API Token 這類資訊,建議透過:

- AWS Secrets Manager
- AWS Systems Manager Parameter Store

再由 App Runner 綁定使用。

### 3. 配置時的實務建議

- 普通配置放環境變量
- 密碼、金鑰放 Secrets
- 所有變量命名統一大寫
- 不要把測試環境與正式環境共用同一組資料庫憑證

---

## 八、IAM 權限與存取角色設定

如果 App Runner 要從 ECR 拉取映像,或讀取 Secrets Manager,權限一定要補齊。

### 1. ECR 存取角色

建立服務時,App Runner 需要一個 **access role** 去讀 ECR 映像。

如果控制台提示你建立 IAM Role,直接依向導建立即可;如果手動建立,至少要確保具備讀取 ECR 的相關權限。

AWS快速開戶 ### 2. 應用執行角色

如果你的應用需要讀取:

- Secrets Manager
- SSM Parameter Store
- S3
- DynamoDB

建議再配置對應的 instance role / service role,避免直接把過大的管理權限綁上去。

### 常見錯誤

#### 錯誤 1:Create service 時拉不到映像
大多是 App Runner 沒有讀取 ECR 的權限。

#### 錯誤 2:應用啟動後讀不到密鑰
大多是執行角色缺少:

- `secretsmanager:GetSecretValue`
- 或 `ssm:GetParameter`

---

## 九、建立完成後驗證服務是否正常

App Runner 部署完成後,會產生一個預設網域,例如:

```text
https://xxxxx.ap-northeast-1.awsapprunner.com
```

直接打開 URL 驗證。

### 建議檢查的內容

1. 首頁是否返回 200
2. API 健康檢查路徑是否可用,例如 `/health`
3. 靜態資源是否能正常載入
4. 應用是否能正確讀取環境變量
5. 是否能連到後端資料庫

### 建議加一個健康檢查端點

例如:

- `/health`
- `/ready`

返回簡單 JSON:

AWS快速開戶 ```json
{"status":"ok"}
```

這樣後續排查健康檢查失敗會直觀很多。

---

## 十、把 App Runner 連接到資料庫時要注意什麼

很多人 Web 應用部署成功後,下一步就是連 RDS MySQL 或 PostgreSQL,但常卡在網路與安全設定。

### 1. 如果資料庫有公網訪問能力

你可以先用最簡單方式驗證連通性,但不建議正式環境長期這樣用。

要檢查:

- RDS Security Group 是否允許來源 IP 或來源網段
- 帳號密碼是否正確
- 連線字串是否正確
- 資料庫是否允許該用戶遠端連線

### 2. 如果資料庫在 VPC 私網

這種情況更常見,也更安全。你需要給 App Runner 配置 **VPC Connector**,讓服務可以進入指定子網與安全組。

操作路徑大致是:

- App Runner Service → Networking → VPC access
- 選擇 VPC
- 選擇至少兩個子網
- 綁定合適的 Security Group

### 3. Security Group 怎麼配

例如:

- App Runner Connector 綁定 `sg-apprunner`
- RDS 綁定 `sg-rds`
- 在 `sg-rds` 入站規則中放行來源 `sg-apprunner` 的 `3306`

這比直接放整個網段更容易控管。

### 常見資料庫連不上原因

- VPC Connector 沒配置
- 子網選錯,沒有路由
- Security Group 沒互相放通
- RDS 只允許本地帳號,未授權遠端主機
- 資料庫 DNS 可解析但端口被擋

---

## 十一、自動部署配置實踐

AWS快速開戶 如果你希望每次推送映像後自動發布新版本,App Runner 的 Automatic deployment 很適合測試環境與小型正式環境。

### 推薦做法

- 測試環境:使用 `latest` 或 `dev` tag,自動部署
- 正式環境:使用版本號 tag,如 `v1.0.3`,手動控制升級

### 不建議的做法

正式環境長期直接追 `latest`,因為:

- 問題版本容易覆蓋
- 回滾不直觀
- 難以對應部署版本

### 更穩妥的版本管理方式

例如:

- `my-web-app:v1.0.1`
- `my-web-app:v1.0.2`
- `my-web-app:v1.0.3`

當新版本驗證失敗時,可以快速切回上一個 tag。

---

AWS快速開戶 ## 十二、日誌查看與故障排查

AWS快速開戶 App Runner 真正好不好用,關鍵在於出問題時你能不能快速定位。

### 1. 到哪裡看日誌

路徑:

**App Runner → 你的服務 → Logs**

通常會看到應用標準輸出與錯誤輸出。

請確保你的應用把重要資訊打印到 stdout/stderr,而不是只寫到容器內部文件。

### 2. 常見故障與處理方法

#### 問題 1:服務建立成功,但打開網址返回 502
排查順序:

1. 應用是否真的啟動成功
2. 監聽端口是否與 App Runner 配置一致
3. 是否監聽 `0.0.0.0`
4. 啟動過程是否因缺少環境變量而報錯
5. 健康檢查路徑是否返回 200

#### 問題 2:部署一直卡在 Operation in progress
通常可能是:

- 映像拉取失敗
- 容器啟動超時
- 健康檢查長期不通

這時先看事件,再看應用日誌。

#### 問題 3:健康檢查失敗
典型原因:

- 端口配錯
- 啟動太慢
- 應用首頁返回 500
- 服務依賴的資料庫連不上,導致整體啟動失敗

#### 問題 4:應用本地正常,App Runner 啟動失敗
最常見是環境差異:

- 本地有 `.env`,App Runner 沒有
- 本地依賴快取存在,容器內沒有
- 容器在本地用 root 跑,在 App Runner 環境表現不同
- 本地是 x86 映像,建置時架構不一致

#### 問題 5:連接 MySQL 超時
檢查:

- 資料庫主機與端口
- VPC Connector
- Security Group
- DNS 解析
- MySQL 使用者授權主機

---

## 十三、健康檢查與啟動優化建議

如果你的應用啟動較慢,部署時很容易遇到不穩定問題。這時要從應用啟動流程做優化。

AWS快速開戶 ### 可操作建議

1. **將資料初始化與 Web 啟動解耦**
不要在應用啟動時做大量 migration 或批次任務。

2. **首頁不要依賴外部服務後才返回 200**
否則資料庫稍慢就會讓健康檢查誤判失敗。

3. **獨立 `/health` 路徑**
只做最基本檢查,避免邏輯過重。

4. **縮小容器體積**
映像太大會拖慢拉取與部署時間。

5. **多階段建置**
對 Go、Java、Node.js 專案很有幫助,可減少最終映像大小。

---

## 十四、性能與成本上的實務建議

雖然 App Runner 適合快速上線,但仍建議在部署後做基本資源檢查。

### 1. 如何選配置

如果你遇到以下現象:

- 首次請求特別慢
- 容器頻繁重啟
- CPU 長時間偏高
- 記憶體溢出

就應考慮上調 CPU/記憶體。

### 2. 如何做簡單壓測

可以用 `ab`、`hey` 或 `wrk` 做基礎測試,例如:

```bash
hey -n 1000 -c 50 https://your-service-url/
```

重點觀察:

- 平均響應時間
- 95% 響應延遲
- 錯誤率

### 3. 成本控制建議

- 測試環境不用長期開高配置
- 不要把大批次任務塞進 App Runner Web 容器
- 版本穩定後定期清理 ECR 舊映像
- 正式環境將日誌、監控和資料庫連線數納入一起評估

---

## 十五、一套可直接照著做的部署清單

如果你想快速完成一次可用部署,可以按這份清單執行:

### 部署前

- [ ] 應用已完成 Docker 化
- [ ] 應用監聽 `0.0.0.0`
- [ ] 應用端口明確,例如 `8080`
- [ ] 本地 `docker run` 可正常訪問

### 映像階段

- [ ] 建立 ECR Repository
- [ ] 使用 AWS CLI 登入 ECR
- [ ] 映像打 tag
- [ ] push 到 ECR 成功

### App Runner 建立階段

- [ ] 選對 ECR 倉庫與 tag
- [ ] 端口配置正確
- [ ] CPU / 記憶體合理
- [ ] 環境變量已補齊
- [ ] Secrets 已綁定
- [ ] IAM 角色有讀取映像與密鑰權限

### 上線驗證

- [ ] 預設網域可打開
- [ ] `/health` 返回 200
- [ ] 日誌無明顯報錯
- [ ] 能連接資料庫
- [ ] 壓測結果在可接受範圍

---

## 十六、最常見的三類問題總結

### 類型一:服務起不來
優先檢查:

- 啟動命令
- 端口
- 監聽地址
- 環境變量
- 容器日誌

### 類型二:服務能起來但不能訪問後端資源
優先檢查:

- VPC Connector
- Security Group
- IAM 權限
- Secrets 配置
- 資料庫授權

### 類型三:能用但不穩定
優先檢查:

- CPU / 記憶體是否不足
- 啟動流程是否過重
- 健康檢查是否設計不合理
- 映像是否過大
- 是否缺少版本管理與回滾策略

---

AWS快速開戶 ## 結語

AWS App Runner 很適合把已經容器化的 Web 應用快速上線,但真正影響部署成功率的,往往不是控制台點選本身,而是幾個細節:

- 容器是否正確監聽端口
- 映像是否能順利拉取
- 環境變量與密鑰是否完整
- 資料庫私網連線是否配置正確
- 出錯後是否能快速看日誌排查

如果你是第一次部署,建議先從最小可用版本開始:

1. 本地跑通容器
2. 推到 ECR
3. 在 App Runner 建服務
4. 確認首頁與 `/health` 正常
5. 再接資料庫、Secrets、VPC Connector

這樣問題會少很多,排查也更清楚。

如果後續你要進一步擴展,也可以在這個基礎上繼續完善:自訂網域、HTTPS、CI/CD、自動化版本發布、藍綠切換與監控告警。這些都應該建立在「先把部署跑穩」之上。

Telegram售前客服
客服ID
@cloudcup
联系
Telegram售后客服
客服ID
@yanhuacloud
联系