テンプレート名
ACS-RDS-BulkyModifyDBInstanceSpec:複数の RDS インスタンスの構成を変更
テンプレートの説明
ApsaraDB RDS インスタンスの構成を変更します。次の点にご注意ください:
アップグレードによって基盤となるデータの移行が発生する場合があります。移行が完了すると、ワークロードのスイッチオーバーがトリガーされます。スイッチオーバー中、一時的な接続中断は約 30 秒間続きます。アプリケーションが RDS インスタンスに自動的に再接続するように構成されていることを確認してください。
仕様変更中、インスタンスは指定したスイッチオーバー時間に基づいて自動的に再起動されます。
インスタンスがクラウドディスクを使用していて、仕様変更中にストレージタイプを変更しない場合、ストレージ容量を拡張してもワークロードは影響を受けません。仕様変更が完了すると、ワークロードはすぐにスイッチオーバーされます。インスタンスがローカルディスクを使用している場合、または仕様変更中にクラウドディスク間でストレージタイプを変更する場合、ストレージ容量を拡張すると一時的な接続中断が発生します。仕様変更が完了したら、メンテナンスウィンドウ中にワークロードをスイッチオーバーできます。
一時的な接続中断中は、データベース、アカウント、ネットワーク設定に関連するほとんどの操作を実行できません。オフピーク時にインスタンスの仕様を変更することをお勧めします。
プライマリインスタンスのストレージ容量は、読み取り専用インスタンスのストレージ容量以下である必要があります。
テンプレートタイプ
自動
所有者
Alibaba Cloud
入力パラメーター
パラメーター | 説明 | データ型 | 必須 | デフォルト値 | 制限 |
regionId | リージョン ID。 | String | はい | ||
targets | 宛先インスタンス。 | Json | はい | ||
dBInstanceStorageType | インスタンスのストレージタイプ。 | String | はい | ||
dBInstanceClass | 宛先インスタンスのタイプ。 | String | はい | ||
dBInstanceStorage | 宛先インスタンスのストレージ容量。 | Number | はい | ||
effectiveTime | 変更が有効になる時間。 | String | いいえ | 即時 | |
direction | インスタンスの構成変更のタイプ。 | String | いいえ | Up | |
rateControl | OOS RAM ロール | Json | いいえ | '{'Mode': 'Concurrency', 'MaxErrors': 0, 'Concurrency': 10}' | |
OOSAssumeRole | CloudOps Orchestration Service (OOS) がアシュームする RAM ロール。 | String | いいえ | "" |
出力パラメーター
該当なし。
テンプレートを実行するために必要な権限ポリシー
{
"Version": "1",
"Statement": [
{
"Action": [
"rds:DescribeDBInstanceAttribute",
"rds:DescribeDBInstances",
"rds:ModifyDBInstanceSpec"
],
"Resource": "*",
"Effect": "Allow"
},
{
"Action": [
"oos:GetApplicationGroup"
],
"Resource": "*",
"Effect": "Allow"
}
]
}
詳細
ACS-RDS-BulkyModifyDBInstanceSpec
テンプレートコンテンツ
FormatVersion: OOS-2019-06-01
Description:
name-en: ACS-RDS-BulkyModifyDBInstanceSpec
name-zh-cn: RDS インスタンスの構成を変更
en: |-
<div><p>ApsaraDB RDS インスタンスの構成を変更します。次の注意事項にご留意ください:</p>
<ul>
<li>RDS の構成変更には、基盤となるデータ移行が含まれる場合があります。移行が完了すると、スイッチオーバーが発生します。スイッチオーバーにより、約 30 秒間の一時的な接続中断が発生します。アプリケーションに再接続メカニズムがあることを確認してください。</li>
<li>インスタンスタイプを変更すると、指定したスイッチオーバー時間に基づいてインスタンスが自動的に再起動されます。手動操作は不要です。</li>
<li>同じストレージタイプのディスクを拡張しても、サービスには影響しません。この変更はすぐに有効になり、メンテナンスウィンドウを待つことはありません。ローカル SSD の拡張やディスクタイプの変更は、一時的な接続中断を引き起こします。メンテナンスウィンドウ中に切り替えることを選択できます。</li>
<li>一時的な接続中断の間、データベース、アカウント、ネットワークに関連するほとんどの操作は実行できません。オフピーク時間にインスタンスの仕様を変更してください。</li>
<li>プライマリインスタンスのディスク領域は、その読み取り専用インスタンスのディスク領域以下である必要があります。</li>
</ul>
</div>
zh-cn: |-
<div><p>修改RDS实例的配置,变更提醒: </p>
<ul>
<li>RDS变更配置可能涉及底层数据迁移,请您耐心等待。在迁移完成后会进行切换,切换时会出现30秒左右的闪断,请确保应用具备重连机制。</li>
<li>变更实例规格过程会根据您选择的切换时间自动重启实例,无需手动操作。</li>
<li>云盘同存储类型的扩容业务无感,变配后会将立即执行,不会等待运维窗口;本地盘及不同类型云盘扩容业务会出现闪断,可选择运维窗口切换。</li>
<li>闪断过程中,与数据库、账号、网络等相关的大部分操作都无法执行,因此请尽量在业务低峰期执行变配操作。</li>
<li>主实例磁盘空间须小于等于只读实例磁盘空间</li>
</ul>
</div>
Parameters:
regionId:
Label:
en: リージョン ID
zh-cn: 地域ID
Type: String
AssociationProperty: ALIYUN::ECS::RegionId
targets:
Type: Json
Label:
en: ターゲットインスタンス
zh-cn: 目标实例
AssociationProperty: Targets
AssociationPropertyMetadata:
ResourceType: ALIYUN::RDS::Instance
RegionId: regionId
Status: Running
dBInstanceStorageType:
Type: String
Label:
en: インスタンスのストレージタイプ
zh-cn: 实例储存类型
Description:
en: |-
<div><p>インスタンスのストレージタイプ。有効な値:</p>
<ul>
<li>local_ssd: ローカル SSD</li>
<li>cloud_essd: ESSD PL1 ディスク</li>
<li>cloud_essd2: ESSD PL2 ディスク</li>
<li>cloud_essd3: ESSD PL3 ディスク</li>
<li>general_essd: 汎用 ESSD</li>
</ul>
</div>
zh-cn: |-
<div><p>实例储存类型,取值: </p>
<ul>
<li>local_ssd: 本地 SSD 盘</li>
<li>cloud_essd: ESSD PL1 云盘</li>
<li>cloud_essd2: ESSD PL2 云盘</li>
<li>cloud_essd3: ESSD PL3 云盘</li>
<li>general_essd: 通用云盘</li>
</ul>
</div>
AllowedValues:
- local_ssd
- cloud_essd
- cloud_essd2
- cloud_essd3
- general_essd
dBInstanceClass:
Type: String
Label:
en: ターゲットインスタンスタイプ
zh-cn: 目标实例规格
AssociationProperty: ALIYUN::RDS::Instance::InstanceType
AssociationPropertyMetadata:
DBInstanceStorageType: ${dBInstanceStorageType}
dBInstanceStorage:
Type: Number
Label:
en: ターゲットストレージ容量
zh-cn: 目标存储空间大小
Description:
en: 単位は GB です。ストレージ容量は 5 GB 単位で増加します。
zh-cn: 单位: GB,每 5GB 进行递增
effectiveTime:
Type: String
Label:
en: 有効期間
zh-cn: 变更生效时间
Description:
en: |-
<div><p>構成変更が有効になる時間:</p>
<ul>
<li>Immediate: 構成変更はすぐに有効になります。</li>
<li>MaintainTime: 構成変更はメンテナンスウィンドウ中に有効になります。</li>
</ul>
</div>
zh-cn: |-
<div><p>配置变更生效时间:</p>
<ul>
<li>Immediate: 配置变更生效立即生效。</li>
<li>MaintainTime: 配置变更生效于维护时间段。</li>
</ul>
</div>
AllowedValues:
- Immediate
- MaintainTime
Default: Immediate
direction:
Type: String
Label:
en: 方向
zh-cn: 实例变配类型
Description:
en: DBInstanceStorageType パラメーターのみを変更する場合 (例:標準 SSD から ESSD へ)、このパラメーターは空のままにしてください。
zh-cn: 如果仅变更 DBInstanceStorageType 参数,例如将 SSD 云盘变更为 ESSD 云盘,则此参数留空。
AllowedValues:
- Up
- Down
- TempUpgrade
- Serverless
Default: Up
rateControl:
Label:
en: 同時実行率
zh-cn: 任务执行的并发比率
Type: Json
AssociationProperty: RateControl
Default:
Mode: Concurrency
MaxErrors: 0
Concurrency: 10
OOSAssumeRole:
Label:
en: OOSAssumeRole
zh-cn: OOS扮演的RAM角色
Type: String
Default: ''
RamRole: '{{ OOSAssumeRole }}'
Tasks:
- Name: getInstance
Description:
en: RDS インスタンスの取得
zh-cn: 获取RDS实例
Action: ACS::SelectTargets
Properties:
ResourceType: ALIYUN::RDS::Instance
RegionId: '{{ regionId }}'
Filters:
- '{{ targets }}'
Outputs:
instanceIds:
Type: List
ValueSelector: Instances.Instance[].InstanceId
- Name: modifyDBInstanceSpec
Action: ACS::RDS::ModifyDBInstanceSpec
Description:
en: RDS インスタンスの変更
zh-cn: 变更RDS实例
Properties:
regionId: '{{ regionId }}'
dBInstanceId: '{{ ACS::TaskLoopItem }}'
dBInstanceClass: '{{ dBInstanceClass }}'
dBInstanceStorage: '{{ dBInstanceStorage }}'
dBInstanceStorageType: '{{ dBInstanceStorageType }}'
effectiveTime: '{{ effectiveTime }}'
direction: '{{ direction }}'
Loop:
RateControl: '{{ rateControl }}'
Items: '{{ getInstance.instanceIds }}'
Metadata:
ALIYUN::OOS::Interface:
ParameterGroups:
- Parameters:
- regionId
- targets
Label:
default:
zh-cn: 选择实例
en: インスタンスの選択
- Parameters:
- dBInstanceStorageType
- dBInstanceClass
- dBInstanceStorage
- effectiveTime
- direction
Label:
default:
zh-cn: 配置参数
en: パラメーターの設定
- Parameters:
- rateControl
- OOSAssumeRole
Label:
default:
zh-cn: 高级选项
en: 詳細オプション