

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 使用 部署 RDS Custom for Oracle AWS CloudFormation
<a name="custom-oracle-multiaz-deployment"></a>

**注意**  
終止支援通知：2027 年 3 月 31 日， AWS 將終止對 Amazon RDS Custom for Oracle 的支援。2027 年 3 月 31 日之後，您將無法再存取 RDS Custom for Oracle 主控台或 RDS Custom for Oracle 資源。如需詳細資訊，請參閱[RDS Custom for Oracle 終止支援](RDS-Custom-for-Oracle-end-of-support.md)。

使用提供的 AWS CloudFormation 範本自動化 RDS Custom for Oracle 部署。在部署資源之前，請先完成下列先決條件。

## 先決條件
<a name="custom-oracle-prerequisites"></a><a name="custom-oracle-required-files"></a>

**下載必要的 Oracle 檔案**

您需要特定的 Oracle 安裝檔案，才能建立 CloudFormation範本。在部署之前先下載這些檔案。

1. 導覽至 [Oracle Database 19c (19.3)](https://www.oracle.com/database/technologies/oracle19c-linux-downloads.html)

1. 找到並下載 `LINUX.X64_193000_db_home.zip` 檔案

1. 將檔案重新命名為 `V982063-01.zip`

1. 下載剩餘的修補程式，選取**平台或語言**做為 `Linux x86-64`

### 最新的 OPatch 公用程式
<a name="custom-oracle-opatch"></a>

[修補程式 6880880](https://updates.oracle.com/Orion/PatchDetails/process_form?patch_num=6880880)

### 2023 年 1 月 PSU 修補程式
<a name="custom-oracle-jan-2023-patches"></a>

**資料庫 PSU 和 RU 修補程式**
+ [修補程式 34765931](https://updates.oracle.com/Orion/PatchDetails/process_form?patch_num=34765931)
+ [修補程式 34786990](https://updates.oracle.com/Orion/PatchDetails/process_form?patch_num=34786990)

**其他必要的修補程式**
+ [修補程式 35099667](https://updates.oracle.com/Orion/PatchDetails/process_form?patch_num=35099667)
+ [修補程式 35099674](https://updates.oracle.com/Orion/PatchDetails/process_form?patch_num=35099674)
+ [修補程式 28730253](https://updates.oracle.com/Orion/PatchDetails/process_form?patch_num=28730253)
+ [修補程式 29213893](https://updates.oracle.com/Orion/PatchDetails/process_form?patch_num=29213893)
+ [修補程式 35012866](https://updates.oracle.com/Orion/PatchDetails/process_form?patch_num=35012866)

### 2023 年 4 月 PSU 修補程式
<a name="custom-oracle-apr-2023-patches"></a>

**資料庫 PSU 和 RU 修補程式**
+ [修補程式 35042068](https://updates.oracle.com/Orion/PatchDetails/process_form?patch_num=35042068)
+ [修補程式 35050341](https://updates.oracle.com/Orion/PatchDetails/process_form?patch_num=35050341)

**其他必要的修補程式**
+ [修補程式 28730253](https://updates.oracle.com/Orion/PatchDetails/process_form?patch_num=28730253)
+ [修補程式 29213893](https://updates.oracle.com/Orion/PatchDetails/process_form?patch_num=29213893)
+ [修補程式 33125873](https://updates.oracle.com/Orion/PatchDetails/process_form?patch_num=33125873)
+ [修補程式 35220732](https://updates.oracle.com/Orion/PatchDetails/process_form?patch_num=35220732)
+ [修補程式 35239280](https://updates.oracle.com/Orion/PatchDetails/process_form?patch_num=35239280)

### Amazon S3 儲存貯體設定
<a name="custom-oracle-s3-setup"></a>

1. 在 中建立 Amazon S3 儲存貯體 AWS 帳戶，或選擇現有的儲存貯體。

1. 在儲存貯體中建立資料夾結構，如下所示。

   ```
   <bucket-name>/
   └── oracle_cev/
       ├── V982063-01.zip
       ├── p6880880_190000_Linux-x86-64.zip
       ├── p34765931_190000_Linux-x86-64.zip
       ├── p34786990_190000_Linux-x86-64.zip
       ├── p35099667_190000_Linux-x86-64.zip
       ├── p35099674_190000_Generic.zip
       ├── p28730253_190000_Linux-x86-64.zip
       ├── p29213893_1918000DBRU_Generic.zip
       ├── p35012866_1918000DBRU_Linux-x86-64.zip
       ├── p35042068_190000_Linux-x86-64.zip
       ├── p35050341_190000_Linux-x86-64.zip
       ├── p29213893_1919000DBRU_Generic.zip
       ├── p33125873_1919000DBRU_Linux-x86-64.zip
       ├── p35220732_190000_Linux-x86-64.zip
       └── p35239280_190000_Generic.zip
   ```

1. 上傳您先前下載到適當資料夾的所有 Oracle 檔案。

## 使用 部署 RDS Custom for Oracle AWS CloudFormation
<a name="custom-oracle-deployment-steps"></a>

### 步驟 1：準備 CloudFormation 範本
<a name="custom-oracle-step1-prereqs"></a>

您必須先下載並設定建立必要先決條件的 CloudFormation 範本，才能部署 RDS Custom for Oracle。

**複製並儲存範本**

1. 前往[使用單一和多個可用區域部署 RDS Custom for Oracle](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-rds-dbinstance.html#aws-resource-rds-dbinstance--examples--Deploying_RDS_Custom_for_Oracle_with_single_and_multiple_Availability_Zones)

1. 以您偏好的格式 (YAML 或 JSON) 複製範本

1. 以 YAML 或 JSON 格式儲存檔案。例如 `rds-custom-oracle-prereqs.yaml`

**在 AWS 主控台中啟動堆疊**

1. 開啟 AWS 主控台並導覽至 AWS CloudFormation

1. 選擇**建立堆疊** > **使用新資源 (標準)**

1. 選取**選擇現有的範本** 

1. 選取**上傳範本檔案** > **選擇檔案**

1. 選取您先前下載的範本檔案

1. 保留預設參數值

1. 選取**下一步**以建立堆疊

**替代方案：使用 AWS CLI**

您可以使用 AWS CLI而不是使用主控台來建立堆疊：

```
aws cloudformation create-stack \
  --stack-name rds-custom-oracle \
  --template-body file://rds-custom-oracle-prereqs.yaml \
  --capabilities CAPABILITY_NAMED_IAM
```

### 步驟 2：建立自訂引擎版本 (CEV) 和 Amazon RDS 執行個體
<a name="custom-oracle-step2-cev-rds"></a>

**複製並儲存範本**

1. 前往[使用單一和多個可用區域部署 RDS Custom for Oracle](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-rds-dbinstance.html#aws-resource-rds-dbinstance--examples--Deploying_RDS_Custom_for_Oracle_with_single_and_multiple_Availability_Zones)

1. 以您偏好的格式 (YAML 或 JSON) 複製範本

1. 如有需要，請在範本中更新下列參數：
   + `BucketName`
   + `CEVS3Prefix`
   + 資料庫主密碼 (取代 \*\*\*\*\*\*\*\*\*\*\*\*\*)

1. 以 YAML 或 JSON 格式儲存檔案

### 步驟 3：使用 AWS 主控台部署
<a name="custom-oracle-step3-console-deploy"></a>

1. 開啟 AWS 主控台並導覽至 AWS CloudFormation

1. 選擇**建立堆疊** > **使用新資源 (標準)**

1. 選取**選擇現有的範本** 

1. 選取**上傳範本檔案** > **選擇檔案**

1. 選取您先前下載的範本檔案

1. 將參數保留為預設值

1. 填入如下參數：

   ```
   BucketName: {{rds-custom-id}}
   CEVS3Prefix: oracle_cev
   CEVCreation: Yes
   ```

1. 檢閱組態，然後選取**下一步**以建立堆疊

**選用：使用 部署 AWS CLI**

```
aws cloudformation create-stack \
  --stack-name rds-custom-oracle \
  --template-body file://rds-custom-oracle.yaml \
  --parameters \
    ParameterKey=BucketName,ParameterValue=rds-custom-id \
    ParameterKey=CEVS3Prefix,ParameterValue=oracle_cev \
    ParameterKey=CEVCreation,ParameterValue=Yes \
  --capabilities CAPABILITY_NAMED_IAM
```

## 已建立部署資源
<a name="custom-oracle-deployment-resources"></a>

範本會建立以下資源：
+ 具有公有和私有子網路的 Amazon VPC
+ Security groups (安全群組)
+ Amazon VPC 端點
+ (IAM) 角色和政策
+ AWS KMS 用於加密的金鑰
+ 自訂引擎版本 (CEV)
+ 適用於單一可用區和多可用區組態的 RDS Custom for Oracle 執行個體

## 監控您的部署進度
<a name="custom-oracle-monitoring-deployment"></a>

建立 CloudFormation 堆疊之後，請監控其進度，以確保成功部署。部署程序包括建立自訂引擎版本 (CEV) 和 RDS 執行個體。

若要監控部署進度：

1. 開啟 CloudFormation 主控台。

1. 選擇您的堆疊名稱。

1. 選擇**事件**索引標籤來檢視進度並識別任何錯誤。

**注意**  
CEV 建立通常需要 2-3 小時。CEV 建立成功完成後，Amazon RDS 會自動開始建立 Amazon RDS 執行個體。

## 部署後
<a name="custom-oracle-post-deployment"></a>

堆疊建立程序完成後，請執行下列部署後驗證和組態步驟：

1. 從 Amazon RDS 主控台頁面，導覽至**自訂引擎版本**以驗證 CEV 建立。

1. 確認 Amazon RDS 執行個體已建立且可用

1. 測試 Amazon RDS 執行個體的連線

1. 視需要設定監控和備份策略

## 清除
<a name="custom-oracle-cleanup"></a>

若要移除所有資源，請執行下列 AWS CLI 命令：

```
aws cloudformation delete-stack --stack-name rds-custom-oracle
```

## 疑難排解
<a name="custom-oracle-troubleshooting"></a>

如果您在部署期間遇到問題，請使用下列解決方案來解決常見問題。

CEV 建立失敗  
+ 確認所有必要的修補程式都已上傳至 Amazon S3
+ 檢查 IAM 許可。
+ 驗證修補程式版本是否正確；如需必要修補程式的清單，請參閱 [先決條件](#custom-oracle-prerequisites)。

Amazon RDS 執行個體建立失敗  
+ 檢查 VPC/子網路組態
+ 驗證安全群組規則
+ 確認 CEV 可用