Resource Orchestration Service：Gunakan OOS Parameter Store untuk membuat parameter untuk Template ROS

Langkah 1: Buat parameter di konsol OOS

1. Masuk ke konsol OOS.

2. Di panel navigasi sisi kiri, klik Parameter Store.

3. Di bilah navigasi atas, pilih wilayah tempat Anda ingin membuat parameter.

   Catatan

   Wilayah yang Anda pilih untuk parameter harus sama dengan wilayah tempat Anda ingin membuat tumpukan. Dalam contoh ini, wilayah China (Hangzhou) dipilih.

4. Buat parameter ImageId umum.

   1. Pada halaman Parameter Store, klik tab Common Parameters lalu klik Create Common Parameter.

   2. Pada halaman Create Common Parameter, konfigurasikan Parameter Name, Value, dan Parameter Type.

      Dalam contoh ini, parameter diatur ke nilai berikut:

      • Parameter Name: my_image

      • Parameter Type: String

      • Value: centos_7_9_x64_20G_alibase_2020****.vhd

   3. Klik Create.

      Setelah parameter dibuat, Anda dapat mengklik nama parameter pada tab Common Parameters untuk melihat detail parameter. Pada tab Description, Anda dapat melihat detail seperti nama, versi, tipe, dan nilai.

5. Buat parameter SecurityGroupIds umum.

   1. Pada halaman Parameter Store, klik tab Common Parameters lalu klik Create Common Parameter.

   2. Pada halaman Create Common Parameter, konfigurasikan Parameter Name, Value, dan Parameter Type.

      Dalam contoh ini, parameter diatur ke nilai berikut:

      • Parameter Name: security_group_ids

      • Parameter Type: StringList

      • Value: sg-group1,sg-group2

   3. Klik Create.

      Setelah parameter dibuat, Anda dapat mengklik nama parameter pada tab Common Parameters untuk melihat detail parameter. Pada tab Description, Anda dapat melihat detail seperti nama, versi, tipe, dan nilai.

6. Buat parameter Password enkripsi.

   1. Pada halaman Parameter Store, klik tab Encryption Parameters lalu klik Create Encryption Parameter.

   2. Pada halaman Create Encryption Parameter, konfigurasikan Parameter Name, Value, dan KMS Key ID.

      Dalam contoh ini, parameter diatur ke nilai berikut:

      • Parameter Name: Password

      • KMS Key ID: Default Service CMK

      • Value: MyPassword1

   3. Klik Create.

      Setelah parameter dibuat, Anda dapat mengklik nama parameter Password pada tab Encryption Parameters untuk melihat detail parameter. Pada tab Description, Anda dapat mengklik Show di sebelah Value untuk melihat nilai parameter Password.

Langkah 2: Buat template ROS

Setelah parameter dibuat, buat template ROS dan rujuk parameter di bagian Parameters atau Resources dari template.

• Rujuk parameter di bagian Parameters

  Untuk parameter umum, atur parameter Type ke ALIYUN::OOS::Parameter::Value. Untuk parameter enkripsi, atur parameter Type ke ALIYUN::OOS::SecretParameter::Value.

  Berikut adalah contoh kode untuk merujuk nilai parameter ImageId versi terbaru:

  Parameters:
    ImageId:
      Type: ALIYUN::OOS::Parameter::Value
      Default: my_image

  Jika Anda ingin merujuk nilai parameter versi 1, ganti my_image dalam kode dengan my_image:1.

• Rujuk parameter di bagian Resources

  Anda dapat merujuk parameter di bagian Properties dari suatu resource. Format: {{resolve:<Parameter type>:<Parameter key>:<Parameter version>}}.

  • Tipe parameter

    Wajib. Kategori parameter. Nilai valid:

    • oos: parameter umum

    • oos-secret: parameter enkripsi

  • Nama parameter

    Wajib. Nama parameter.

  • Versi parameter

    Opsional. Versi parameter. Jika Anda tidak menentukan versi parameter, versi terbaru akan digunakan.

  Berikut adalah contoh kode untuk merujuk nilai parameter ImageId versi terbaru dan nilai parameter Password versi 2:

  Resources:
    ECS:
      Type: ALIYUN::ECS::Instance
      Properties:
        ImageId: '{{resolve:oos:my_image}}'
        Password: '{{resolve:oos-secret:Password:2}}'
        ...: null

Saat merujuk parameter dalam template, sebagian besar fungsi tersedia di template, kecuali fungsi Ref, Fn::GetAtt, Fn::GetStackOutput, dan Fn::Calculate. Untuk informasi lebih lanjut tentang fungsi, lihat Fungsi. Fungsi yang tidak tersedia termasuk Ref, Fn::GetAtt, Fn::GetStackOutput, dan Fn::Calculate.

Dalam contoh ini, template berikut dibuat:

ROSTemplateFormatVersion: '2015-09-01'
Parameters:
  InstanceType:
    Type: String
    Default: ecs.c6.large
  ImageId:
    Type: ALIYUN::OOS::Parameter::Value
    Default: my_image
  Vpc:
    Type: String
  VSwitch:
    Type: String
Resources:
  ECS:
    Type: ALIYUN::ECS::InstanceGroup
    Properties:
      ImageId:
        Ref: ImageId
      InstanceType:
        Ref: InstanceType
      VpcId:
        Ref: Vpc
      VSwitchId:
        Ref: VSwitch
      SecurityGroupIds: '{{resolve:oos:security_group_ids:1}}'
      Password: '{{resolve:oos-secret:Password}}'
      MaxAmount: 1
Outputs:
  InstanceIds:
    Value:
      Fn::GetAtt:
        - ECS
        - InstanceIds

ROS mengonversi tipe parameter yang dirujuk dalam template ROS berdasarkan tipe parameter yang didefinisikan di OOS. Parameter OOS mendukung tipe String dan StringList. Jika parameter bertipe StringList dirujuk dalam template ROS, ROS mengonversi parameter menjadi tipe List untuk template. Sebagai contoh, jika Anda menggunakan parameter SecurityGroupIds yang bertipe StringList dan bernilai sg-group1,sg-group2 untuk membuat resource bertipe ALIYUN::ECS::InstanceGroup, nilai parameter SecurityGroupIds dikonversi menjadi ["sg-group1", "sg-group2"].

Langkah 3: Buat tumpukan di konsol ROS

Di konsol ROS, gunakan template yang Anda buat di Langkah 2 untuk membuat tumpukan. Dalam contoh ini, template digunakan untuk membuat sekelompok instance ECS. Untuk informasi lebih lanjut, lihat Buat tumpukan.

Setelah tumpukan dibuat, Anda dapat melakukan operasi berikut untuk memeriksa apakah parameter dirujuk sesuai harapan dalam template: Di panel navigasi sisi kiri konsol ROS, klik Stacks. Pada halaman Stacks, temukan tumpukan dan klik nama tumpukan. Pada halaman yang muncul, klik tab Parameters untuk melihat parameter dan nilai parameter.