Resource Orchestration Service:Stack quick start

Langkah 1: Menulis templat

Templat adalah file teks dalam format JSON, YAML, atau Terraform yang menggunakan encoding UTF-8. Gunakan templat untuk mendefinisikan sumber daya Alibaba Cloud beserta detail konfigurasinya, menentukan dependensi antar-sumber daya, lalu membuat stack berdasarkan templat tersebut. Anda dapat menulis templat berdasarkan struktur templat dan jenis sumber daya, atau menggunakan templat contoh. Untuk informasi selengkapnya tentang cara menulis templat, lihat Quick start for writing a template. Untuk informasi lebih lanjut tentang struktur templat, lihat JSON and YAML template structure dan Terraform template structure.

Topik ini menggunakan templat YAML contoh berikut, yang membuat VPC dan vSwitch:

ROSTemplateFormatVersion: '2015-09-01'
Description: Example of provisioning VPC and vSwitch.
Parameters:
  VpcName:
    Type: String
    Description: The name must be 2 to 128 characters in length and can contain letters, digits, underscores (_), and hyphens (-). It must start with a letter and cannot start with http:// or https://.
    Default: null
  VpcCidrBlock:
    Type: String
    Description: The CIDR block of the VPC.
    Default: 192.168.0.0/16
    AllowedValues:
      - 10.0.0.0/8
      - 172.16.0.0/12
      - 192.168.0.0/16
  ZoneId:
    Type: String
    Description: Zone ID.
    AssociationProperty: ALIYUN::ECS::Instance::ZoneId
  VSwitchName:
    Type: String
    Description: The name must be 2 to 128 characters in length and can contain letters, digits, underscores (_), and hyphens (-). It must start with a letter and cannot start with http:// or https://.
    Default: null
  VSwitchCidrBlock:
    Type: String
    Description: The CIDR block of the VSwitch.
    Default: 192.168.0.0/24
    AllowedValues:
      - 10.0.0.0/24
      - 172.16.0.0/24
      - 192.168.0.0/24
  Tags:
    Type: Json
    Description: A maximum of 20 tags can be specified. Each tag is a key-value pair. The tag value can be left empty.
    Default:
      - Key: ros
        Value: beginner-tutorial
Resources:
  Vpc:
    Type: ALIYUN::ECS::VPC
    Properties:
      VpcName:
        Ref: VpcName
      CidrBlock:
        Ref: VpcCidrBlock
      Tags:
        Ref: Tags
  VSwitch:
    Type: ALIYUN::ECS::VSwitch
    Properties:
      VpcId:
        Ref: Vpc
      ZoneId:
        Ref: ZoneId
      VSwitchName:
        Ref: VSwitchName
      CidrBlock:
        Ref: VSwitchCidrBlock
      Tags:
        Ref: Tags
Outputs:
  VpcId:
    Description: The VPC ID allocated by the system.
    Value:
      Fn::GetAtt:
        - Vpc
        - VpcId
  VSwitchId:
    Description: The VSwitch ID allocated by the system.
    Value:
      Fn::GetAtt:
        - VSwitch
        - VSwitchId
                

Berikut penjelasan mengenai templat tersebut:

• ROSTemplateFormatVersion: Nomor versi templat. Versi saat ini adalah 2015-09-01.

• Description: Deskripsi templat. Gunakan bagian ini untuk menjelaskan skenario penggunaan templat dan arsitektur yang dibuat oleh templat tersebut. Deskripsi yang rinci membantu pengguna memahami isi templat.

• Parameters: Parameter templat. Contoh ini mendefinisikan parameter untuk nama VPC (VpcName), blok CIDR VPC (VpcCidrBlock), ID zona (ZoneId), nama vSwitch (VSwitchName), blok CIDR vSwitch (VSwitchCidrBlock), dan tag (Tags). Untuk informasi selengkapnya tentang cara mendefinisikan parameter, lihat Parameters.

• Resources: Sumber daya Alibaba Cloud yang terdapat dalam templat. Contoh ini membuat satu VPC dan satu vSwitch. Properti sumber daya mereferensi parameter yang didefinisikan di Parameters. Untuk informasi selengkapnya, lihat Resources, ALIYUN::ECS::VPC, dan ALIYUN::ECS::VSwitch.

• Outputs: Informasi sumber daya yang dikembalikan setelah stack dibuat. Contoh ini mengembalikan ID VPC dan ID vSwitch. Untuk informasi selengkapnya, lihat Outputs.

Langkah 2: Membuat stack

1. Login ke ROS console.

2. Di panel navigasi kiri, klik Stacks.

3. Di bilah navigasi atas, pilih wilayah dari daftar drop-down wilayah, misalnya China (Hangzhou).

4. Di halaman Stacks, klik Create Stack. Di bagian Specify Template, klik Select an Existing Template.

   Catatan

   • Jika Anda memilih Create Template atau ROS Infrastructure Composer, Anda akan diarahkan ke halaman yang sesuai.

5. Di halaman Specify Template, klik Select an Existing Template di bagian Specify Template. Untuk menempelkan konten templat langsung ke konsol, atur Template Import Method menjadi Enter Template Content. Di tab ROS pada bagian Template Content, masukkan templat YAML yang telah Anda tulis di Langkah 1: Menulis templat. Lalu, klik Next.

6. Di halaman Configure Parameters, masukkan nama stack, konfigurasikan parameter templat berikut, lalu klik Next.

   Untuk detail properti stack yang Anda konfigurasikan pada langkah ini, lihat Create a stack.

   Parameter	Description	Example
   VpcName	Nama VPC.	myVPC
   VpcCidrBlock	Blok CIDR VPC. Nilai yang valid: 10.0.0.0/8 172.16.0.0/12 192.168.0.0/16 (default)	192.168.0.0/16
   ZoneId	ID zona.	Zona K di wilayah China (Hangzhou)
   VSwitchName	Nama vSwitch.	myVSwitch
   VSwitchCidrBlock	Blok CIDR vSwitch. Nilai yang valid: 10.0.0.0/24 172.16.0.0/24 192.168.0.0/24 Catatan Blok CIDR vSwitch harus berada dalam blok CIDR VPC tempat vSwitch tersebut berada.	192.168.0.0/24
   Tags	Tag. Anda dapat menentukan maksimal 20 tag. Setiap tag merupakan pasangan kunci-nilai. Nilai tag dapat dikosongkan.	[{"Key": "ros", "Value": "beginner-tutorial"}]

7. Klik Create.

Langkah 4: Menggunakan sumber daya dalam stack

Setelah stack dibuat, Anda dapat menggunakan sumber daya dalam stack sesuai kebutuhan. Misalnya, Anda dapat menerapkan sumber daya Alibaba Cloud di vSwitch VPC tersebut.

1. Di panel navigasi kiri Konsol ROS, klik Stacks.

2. Di halaman Stacks, klik ID stack yang ingin Anda lihat.

3. Klik tab Resources, lalu klik ID sumber daya vSwitch.

4. Di Konsol VPC, lihat informasi dasar vSwitch, termasuk ID vSwitch, zona, dan ID VPC tempat vSwitch tersebut berada.

5. Terapkan sumber daya Alibaba Cloud di vSwitch tersebut.

   Untuk informasi selengkapnya, lihat Create cloud resources.

Langkah 5 (Opsional): Memperbarui stack

Saat Anda perlu mengubah sumber daya dalam stack, seperti VpcName, perbarui stack tersebut.

1. Di panel navigasi kiri Konsol ROS, klik Stacks.

2. Di halaman Stacks, temukan stack yang ingin Anda perbarui dan klik Update di kolom Actions.

3. Di halaman Configure Template Parameters, perbarui parameter tersebut. Misalnya, ubah nilai VpcName menjadi testVPC.

4. Klik Modify.

Langkah 6 (Opsional): Menghapus stack

Saat Anda tidak lagi memerlukan sumber daya yang telah dibuat, hapus stack untuk melepaskan sumber daya tersebut dan menghindari biaya yang tidak perlu.

1. Di panel navigasi kiri Konsol ROS, klik Stacks.

2. Di halaman Stacks, temukan stack yang ingin Anda hapus dan klik Delete di kolom Actions.

3. Di kotak dialog Delete Stacks, atur Method to Delete the Stack menjadi Release Resources untuk melepaskan sumber daya yang dibuat oleh stack tersebut.

4. Klik OK.