Templat OOS untuk mengubah spesifikasi instans RDS secara massal - CloudOps Orchestration Service

Nama templat

ACS-RDS-BulkyModifyDBInstanceSpec: Mengubah spesifikasi instans ApsaraDB for RDS.

Execute Now

Description

Mengubah spesifikasi instans ApsaraDB for RDS. Catatan:

Perubahan spesifikasi dapat melibatkan migrasi data, diikuti oleh switchover yang menyebabkan gangguan koneksi selama sekitar 30 detik. Pastikan aplikasi Anda mendukung koneksi ulang otomatis.
Perubahan tipe instans memicu restart otomatis pada waktu switchover yang dipilih. Tidak diperlukan intervensi manual.
Peningkatan kapasitas penyimpanan dalam tipe disk cloud yang sama berlaku langsung tanpa dampak terhadap layanan. Namun, peningkatan local disk atau perubahan tipe penyimpanan menyebabkan gangguan koneksi singkat dan dapat dijadwalkan selama maintenance window.
Selama gangguan koneksi, sebagian besar operasi database, akun, dan jaringan tidak tersedia. Lakukan perubahan spesifikasi selama jam sepi.
Kapasitas disk instans primary harus kurang dari atau sama dengan kapasitas disk instans read-only-nya.

Template type

Automation

Owner

Alibaba Cloud

Input parameters

Parameter	Description	Type	Required	Default	Constraints
regionId	ID wilayah.	String	Yes
targets	Instans target.	Json	Yes
dBInstanceStorageType	Tipe penyimpanan instans.	String	Yes
dBInstanceClass	Tipe instans target.	String	Yes
dBInstanceStorage	Storage space target dalam GB.	Number	Yes
effectiveTime	Waktu penerapan perubahan spesifikasi.	String	No	Immediate
direction	Arah perubahan spesifikasi.	String	No	Up
OOSAssumeRole	Peran RAM yang diasumsikan oleh OOS.	String	No	""
OOSAssumeRole	Peran RAM yang diasumsikan oleh OOS.	String	No	""

Output parameters

None.

Required permissions

{
    "Version": "1",
    "Statement": [
        {
            "Action": [
                "rds:DescribeDBInstanceAttribute",
                "rds:DescribeDBInstances",
                "rds:ModifyDBInstanceSpec"
            ],
            "Resource": "*",
            "Effect": "Allow"
        },
        {
            "Action": [
                "oos:GetApplicationGroup"
            ],
            "Resource": "*",
            "Effect": "Allow"
        }
    ]
}

Details

ACS-RDS-BulkyModifyDBInstanceSpec

Template content

FormatVersion: OOS-2019-06-01
Description:
  name-en: ACS-RDS-BulkyModifyDBInstanceSpec
  name-zh-cn: 修改RDS实例的配置
  en: |-
    <div><p>Mengubah spesifikasi instans ApsaraDB for RDS. Perhatikan hal berikut:</p>
    <ul>
    <li>Mengubah spesifikasi instans ApsaraDB for RDS dapat melibatkan migrasi data di lapisan bawah. Setelah migrasi, alih bencana akan terjadi, yang menyebabkan gangguan koneksi sementara selama sekitar 30 detik. Pastikan aplikasi Anda memiliki mekanisme koneksi ulang otomatis.</li>
    <li>Saat Anda mengubah tipe instans, instans akan dimulai ulang secara otomatis berdasarkan waktu alih bencana yang dipilih. Tidak diperlukan intervensi manual.</li>
    <li>Memperluas kapasitas penyimpanan disk cloud dengan jenis penyimpanan yang sama tidak akan memengaruhi layanan Anda dan akan segera terjadi, dengan melewati jendela pemeliharaan. Memperluas disk lokal atau disk cloud ke jenis penyimpanan yang berbeda akan menyebabkan gangguan koneksi sementara. Anda dapat memilih untuk melakukan alih bencana selama jendela pemeliharaan.</li>
    <li>Selama gangguan koneksi sementara, Anda tidak dapat melakukan sebagian besar operasi yang terkait dengan database, akun, dan jaringan. Kami merekomendasikan untuk melakukan perubahan spesifikasi selama jam di luar puncak.</li>
    <li>Ruang disk instans utama harus lebih kecil dari atau sama dengan ruang disk instans hanya bacanya.</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 Wilayah
      zh-cn: 地域ID
    Type: String
    AssociationProperty: ALIYUN::ECS::RegionId
  targets:
    Type: Json
    Label:
      en: Instans Target
      zh-cn: 目标实例
    AssociationProperty: Targets
    AssociationPropertyMetadata:
      ResourceType: ALIYUN::RDS::Instance
      RegionId: regionId
      Status: Running
  dBInstanceStorageType:
    Type: String
    Label:
      en: Jenis Penyimpanan Instans
      zh-cn: 实例储存类型
    Description:
      en: |-
        <div><p>Jenis penyimpanan instans. Nilai yang valid:</p>
            <ul>
                <li>local_ssd: SSD lokal</li>
                <li>cloud_essd: disk cloud ESSD PL1</li>
                <li>cloud_essd2: disk cloud ESSD PL2</li>
                <li>cloud_essd3: disk cloud ESSD PL3</li>
                <li>general_essd: Disk cloud tujuan umum</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: Tipe Instans Target
      zh-cn: 目标实例规格
    AssociationProperty: ALIYUN::RDS::Instance::InstanceType
    AssociationPropertyMetadata:
      DBInstanceStorageType: ${dBInstanceStorageType}
  dBInstanceStorage:
    Type: Number
    Label:
      en: Ruang Penyimpanan Target
      zh-cn: 目标存储空间大小
    Description:
      en: Ruang penyimpanan dalam GB. Nilai harus ditentukan dalam kelipatan 5.
      zh-cn: 单位：GB，每 5GB 进行递增
  effectiveTime:
    Type: String
    Label:
      en: Waktu Efektif
      zh-cn: 变更生效时间
    Description:
      en: |-
        <div><p>Waktu saat perubahan spesifikasi mulai berlaku.</p>
          <ul>
            <li>Immediate: Perubahan segera berlaku.</li>
            <li>MaintainTime: Perubahan berlaku selama jendela pemeliharaan.</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: Arah
      zh-cn: 实例变配类型
    Description:
      en: Jika Anda hanya mengubah jenis penyimpanan instans, seperti mengubah disk cloud SSD ke disk cloud ESSD, biarkan parameter ini kosong.
      zh-cn: 如果仅变更 DBInstanceStorageType 参数，例如将 SSD 云盘变更为 ESSD 云盘，则此参数留空。
    AllowedValues:
      - Up
      - Down
      - TempUpgrade
      - Serverless
    Default: Up
  rateControl:
    Label:
      en: Tingkat Konkurensi
      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: Mendapatkan informasi tentang instans ApsaraDB for RDS yang ditentukan.
      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: Mengubah spesifikasi instans ApsaraDB for 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: Pilih Instans
      - Parameters:
          - dBInstanceStorageType
          - dBInstanceClass
          - dBInstanceStorage
          - effectiveTime
          - direction
        Label:
          default:
            zh-cn: 配置参数
            en: Konfigurasi Parameter
      - Parameters:
          - rateControl
          - OOSAssumeRole
        Label:
          default:
            zh-cn: 高级选项
            en: Opsi Lanjutan