Import an ROS template as an architecture template - Resource Orchestration Service

This topic describes how to import an existing Resource Orchestration Service (ROS) template to create an architecture diagram.

Note

If an ROS template does not contain layout information, the ROS Architecture Editor automatically arranges the resource layout based on an algorithm. The quality of the automatic layout depends on the complexity of the template.
If you import a complex template, you may need to manually adjust the resource layout to optimize the architecture diagram.

Prerequisites

An ROS template is required. To create a template, see Template Quick Start.

To verify the solution, use the following sample template to create an elastic IP address (EIP) and an ECS instance:

ROSTemplateFormatVersion: '2015-09-01'
Parameters:
  Zone:
    Type: String
    AssociationProperty: ALIYUN::ECS::Instance::ZoneId
    AssociationPropertyMetadata:
      WithAvailableResource: true
      DefaultValueStrategy: first
    Label:
      en: VSwitch Availability Zone
    Default: cn-beijing-f
Resources:
  VPC:
    Type: ALIYUN::ECS::VPC
    Properties:
      CidrBlock: 10.0.0.0/8
      EnableIpv6: false
  VSwitch:
    Type: ALIYUN::ECS::VSwitch
    Properties:
      ZoneId:
        Ref: Zone
      VpcId:
        Ref: VPC
      CidrBlock: 10.0.0.0/24
  SecurityGroup:
    Type: ALIYUN::ECS::SecurityGroup
    Properties:
      VpcId:
        Ref: VPC
  ECSInstance:
    Type: ALIYUN::ECS::Instance
    Properties:
      VSwitchId:
        Ref: VSwitch
      ZoneId:
        Ref: Zone
      VpcId:
        Ref: VPC
      SecurityGroupIds:
        - Ref: SecurityGroup
      SystemDiskSize: 40
      InstanceChargeType: PostPaid
      AllocatePublicIP: false
      IoOptimized: optimized
      ImageId: aliyun_3_x64_20G_qboot_alibase_20230727.vhd
      SystemDiskCategory: cloud_efficiency
      InstanceType: ecs.t5-lc2m1.nano
  EIP:
    Type: ALIYUN::VPC::EIP
    Properties:
      Isp: BGP
      DeletionProtection: false
      Netmode: public
      InstanceChargeType: PayAsYouGo
      InternetChargeType: PayByBandwidth
      Bandwidth: 5
  EIPAssociation:
    Type: ALIYUN::VPC::EIPAssociation
    Properties:
      AllocationId:
        Ref: EIP
      InstanceId:
        Ref: ECSInstance
      Mode: NAT
Metadata:
  ALIYUN::ROS::Composer:
    67cb9fc3:
      Rect:
        - 632
        - 588
        - -184
        - -217
        - 0
        - 0
      ResT: Composer::ROSParameter::AlibabaCloud
      Label: AlibabaCloud
    67cb9fc4:
      Parent: 67cb9fc3
      Rect:
        - 598
        - 523
        - -164
        - -172
        - 1
        - 0
      Reg: cn-beijing
      ResT: Composer::ROSParameter::Region
      Label: Region
    4ce1a0a6:
      Res:
        - Zone
      Parent: fe688e94
      Rect:
        - 520
        - 320
        - -124
        - -9
        - 3
        - 0
      ResT: Composer::ROSParameter::Zone
      Label: Zone
    fe688e94:
      Res:
        - VPC
      Parent: 67cb9fc4
      Rect:
        - 560
        - 400
        - -144
        - -69
        - 2
        - 0
      Label: VPC
    a8e63de3:
      Res:
        - VSwitch
      Parent: 4ce1a0a6
      Rect:
        - 480
        - 240
        - -104
        - 51
        - 4
        - 0
      Label: vSwitch
    d6a407f2:
      Res:
        - SecurityGroup
      Parent: fe688e94
      Rect:
        - 160
        - 120
        - 30
        - 145
        - 10
        - 0
      Label: Security group
    6d7f85e4:
      Res:
        - ECSInstance
      Parent: a8e63de3
      Rect:
        - 40
        - 40
        - 90
        - 185
        - 11
        - 0
      Layer:
        - d6a407f2
      Label: ECS instance
    69c24097:
      Res:
        - EIP
        - EIPAssociation
      Parent: 67cb9fc4
      Rect:
        - 40
        - 40
        - 90
        - -150
        - 2
        - 0
      Label: EIP
    52dd50ee-a0c0-4d13-a3e3-df80fb4c4aa9:
      Parent: 67cb9fc4
      Edge:
        - 69c24097
        - 6d7f85e4
      Line: 0:0:0:#969696:0

Procedure

Log on to the ROS Architecture Editor console.
In the left navigation pane, click Architecture Templates.
On the Architecture Templates page, click Create Architecture Template. In the dialog box, select ROS or Terraform, and then click OK.
Note
You can import only ROS templates. Terraform templates are not supported.
On the architecture template editor page, click the icon in the upper-left corner. In the drop-down menu, click Import Template Content.
In the Import Template Content dialog box, paste the template content into the editor and click OK. The ROS Architecture Editor automatically renders an architecture diagram based on the template content. The following figure shows an example.