资源编排模板详解

资源编排中的模板，是对一组资源的定义和描述。您可以按照模板语法和资源的属性，编写自己的模板，也可以直接使用阿里云提供的模板样例。目前，支持20多种阿里云资源的编排服务。本文将对阿里云资源和资源编排模板分别进行介绍。

1. 资源

开始编写模板之前，您需要对所需的资源有所了解。

资源Type

一个资源类型，对应一种阿里云资源，是每种资源的唯一标识。您可以查阅资源类型列表。

例如，阿里云云服务器的资源类型是 ALIYUN::ECS::Instance。

资源Properties

列出了当前资源支持的所有可配置属性。

如上图所示，云服务器的可配置属性有 SecurityGroupId, InstanceType, ImageId等。归根结底，编写模板就是编辑资源，您可以通过配置资源的属性来自定义资源。在元数据中，清楚了描述了每个属性的特性。下面介绍几个比较重要的特性：

  • key: 属性关键字。通过它来标识您要配置当前资源的哪个属性。
  • type: 表明当前属性值是什么类型。您在给属性赋值的时候，类型一定要匹配。否则在创建模板的时候，语法检查会不通过。
  • required: 表明此属性是否是必须配置项。如果某项属性被标记为 required为 true，那么这个属性是必须要配置的。例如，资源 ALIYUN::ECS::Instance 的 SecurityGroupId, InstanceType 和 ImageId 三个属性都被标记为 required ，那么当您编辑 ALIYUN::ECS::Instance 类型的资源的时候，这三个属性的配置是不能省略的。
  • constraints: 表明当前属性是否有其他约束。例如，DiskMappings 的constraints如下： 
    [ { "length": { "max": 4 } } ]

    表明DiskMappings的值的长度不能超过4，同时DiskMappings的type为list，那么当您给DiskMappings赋值时，要配置成长度不好过4的数组。

资源Attributes

Attributes 枚举了当前资源的所有可获取属性，以及属性的描述信息。

如上图所示，云服务器的可获取属性有 InstanceId, ZoneId等。可获取属性，可以在 Resources 和 Outputs 两部分中进行获取。例如，下面模板片段定义了一个名为WebServer的 ALIYUN::ECS::Instance 资源，在Outputs部分通过Fn::GetAtt方法，获取到WebServer的实例ID。

"Resources" : {
  "WebServer": {
    "Type": "ALIYUN::ECS::Instance",
    "Properties": {
      "ImageId" : {"Ref": "ImageId"},
      "InstanceType": {"Ref": "InstanceType"},
      "SecurityGroupId": {"Ref": "SecurityGroupId"}
    }
  }
},
"Outputs": {
  "InstanceId": {
       "Value" : {"Fn::GetAtt": ["WebServer","InstanceId"]}
  }
}

2. 模板

接下来，会对资源编排模板进行详细的介绍。模板是一个 JSON 格式的文本文件。一般而言，模板分为六个部分：ROSTemplateFormatVersion, Description, Parameters, Mappings, Resources 和 Outputs。 格式如下：

{
  "ROSTemplateFormatVersion" : "2015-09-01",

  "Description" : "模板描述",

  "Parameters" : {
  },

  "Mappings" : {
  },

  "Resources" : {
  },

  "Outputs" : {
  }
}

其中，只有 ROSTemplateFormatVersion 是 必须指定 的部分。

  • ROSTemplateFormatVersion: 指定模板格式的版本，目前仅支持值 2015-09-01。
  • Description: 模板的描述信息

下面对 Parameters, Mappings, Resources, Outputs 逐一说明。

2.1 Resources

描述资源栈中每个资源，以及资源之间的关系。一个资源可以被其他资源和 Outputs 所引用。

Resources 语法

"Resources" : {
    "资源 ID" : {
        "Type" : "资源类型",
        "Properties" : {
        },
        "DeletionPolicy" : "Retain",
        "DependsOn": "资源"
    }
}
  • 资源 ID: 是资源在当前模板中的唯一标识，可以被其他的部分引用。您可以任意设置。
  • Type: 标识当前资源的类型，参考资源类型
  • Properties:
    • 您可以给此资源配置任意多个属性，做为创建物理资源的参数和值。每种资源的可配置属性，可以通过 ROS控制台 -> 资源类型 -> 属性数据 来查看。例如，ECS Instance 的 Properties 地址。
    • 属性值类型可以是字符串、字符串列表、布尔值，也可以引用Parameters。下面是一个简单的例子，资源WebServer的属性 ImageId 和 SecurityGroupId 分别引用参数 ImageIdRef 和 SecurityGroupId 参数。有关 Parameters 的详解见下节。
    {
  "ROSTemplateFormatVersion" : "2015-09-01",
  "Description": "ecs实例，指定imageId",
  "Parameters" : {
    "ImageIdRef": {
      "Type" : "String",
      "Description": "镜像文件 ID，表示启动实例时选择的镜像资源"
    },
    "SecurityGroupId": {
      "Type": "String",
      "Description": "安全组Id"
    }
  },
  "Resources" : {
    "WebServer": {
      "Type": "ALIYUN::ECS::Instance",
      "Properties": {
        "ImageId" : {"Ref": "ImageIdRef"},
        "InstanceType": "ecs.t1.small",
        "SecurityGroupId": {"Ref": "SecurityGroupId"}
      }
    }
  }
}
  • DeletionPolicy: 配置此属性，可以在资源栈被删除时 保留 该资源
  • DependsOn: 指定资源的创建顺序。下面是一个简单的例子，DatabaseServer 将在 WebServer 创建成功后才开始创建。

{
  "ROSTemplateFormatVersion" : "2015-09-01",
  "Description": "先创建DBServer, 再创建WebServer",
  "Parameters" : {
    "SecurityGroupId": {
      "Type": "String",
      "Description": "安全组Id"
    }
  },
  "Resources" : {
    "WebServer": {
      "Type": "ALIYUN::ECS::Instance",
      "DependsOn": "DatabseServer"
    },
    "DatabseServer": {
      "Type": "ALIYUN::ECS::Instance",
      "Properties": {
        "ImageId" : "m-25l0rcfjo",
        "InstanceType": "ecs.t1.small",
        "SecurityGroupId": {"Ref": "SecurityGroupId"}
      }
    }
  }
}

2.2 Parameters

把可能会变化的值，放到Parameter中，让模板变得更灵活。详细描述请参考帮助文档。注意，这里仅仅是把易变项抽象为参数而已，在创建资源栈的时候需要给每个参数赋值。

Parameters 语法

通过文档可知 Parameters 可以配置的属性比较多，不过只有 Type 这个属性是 必须设置 的。 格式如下：

"Parameters" : {
    "参数 ID" : {
        "Type" : "参数类型"
    }
}
  • 参数 ID: 参数唯一标识，可以在 Resources 部分引用。
  • Type: 参数的数据类型。支持 String, Number, CommaDelimitedList, Json, Boolean 五种数据类型。
  • Default: 给参数配置缺省值。创建资源栈的时候，如果您没有显示的给参数赋值，那么将采用 Default值 。
  • AllowedValues: 配置合法的参数值列表。您可以配置此项，来约束参数值的可选值。
  • MaxLength 和 MinLength: 当参数的Type为 String 类型时，可以通过这两个配置项来限定参数值的长度。
  • MaxValue 和 MinValue: 当参数的Type为 Number 类型时，可以通过这两个配置项来限定参数值的大小。
  • NoEcho: 如果您希望调用查询资源栈时隐藏参数值，可以设置 NoEcho: true

Parameters 示例

以下 Parameters 部分示例声明两个参数。

  • InstanceType 参数类型是 String 类型，默认值是 ecs.t1.small ，允许值是 ecs.t1.small 和 ecs.t1.xsmall 两种值。
  • SecurityGroupPriority 参数类型是 Number ，可指定的最大值是 100 ，最小值是 1。
"Parameters" : {
    "InstanceType": {
      "Type": "String",
      "Default": "ecs.t1.small",
      "Description": "实例的资源规格",
      "AllowedValues": [
        "ecs.t1.xsmall",
        "ecs.t1.small"
      ]
    },
    "SecurityGroupPriority": {
      "Default": 1,
      "Description": "生成的安全组的优先级，优先级可选范围为1-100，默认值为1，即最高优先级。",
      "Type": "Number",
      "MinValue": 1,
      "MaxValue": 100
    }
}

2.3 Mappings

在 Mappings 部分，您可以配置多个枚举值或者映射表。在模板的 Resources 和 Outputs 部分可以使用 Fn::FindInMap 内部函数，通过给定 key 获取 value。

Mappings 语法

映像部分由　Key-Value 对组成。其中 Key 和 Value 可以为字符串类型或者数字类型。筛选某个值，搜索深度为3。定义 Mappings，格式如下：

"Mappings" : {
    "ValidMapping" : {
        "TestKey1" : { "key1" : "value1" }
    }
}

获取枚举值的方法如下：

{ "Fn::FindInMap" : [ "ValidMapping", { "Ref" : "TestKey1" }, "key1"]}

Mappings 示例

以下示例，展示类型是 ALIYUN::ECS::Instance 的资源 WebServer，其属性 ImageId 根据 region 以及操作系统位数进行映射。

{
  "ROSTemplateFormatVersion": "2015-09-01",
  "Parameters": {
    "regionParam": {
        "Description": "选择创建ECS的区域",
        "Type": "String",
        "AllowedValues": ["hangzhou", "beijing"]
    },
    "sysTypeParam": {
        "Description": "操作系统位数",
        "Type": "Number",
        "AllowedValues": [32, 64]
    },
    "SecurityGroupId": {
      "Type": "String",
      "Description": "安全组Id"
    }de
  },
  "Mappings" : {
    "RegionMap" : {
      "hangzhou" : { "32" : "m-25l0rcfjo", "64" : "m-25l0rcfj1" },
      "beijing" : { "32" : "m-25l0rcfj2", "64" : "m-25l0rcfj3" }
    }
  },
  "Resources": {
    "WebServer": {
      "Type": "ALIYUN::ECS::Instance",
      "Properties": {
        "ImageId" : { "Fn::FindInMap" : [ "RegionMap", { "Ref" : "regionParam" }, { "Ref" : "sysTypParam" }]},
        "InstanceType": "ecs.t1.small",
        "SecurityGroupId": {"Ref": "SecurityGroupId"}
      }
    }
  }
}

2.4 Outputs

当您调用查询资源栈详情接口的时候，资源编排服务会根据 Outputs 部分返回对应的值，往往用来获取资源的属性值。

Outputs 语法

输出部分由 输出ID 和 输出值表达式 组成。格式如下：

"Outputs" : {
    "输出 ID" : {
        "Description" : "输出的描述",
        "Value" : {输出值表达式}
    }
}

其中，输出值表达式，使用内部函数 Fn::GetAtt 来获取资源的属性值。格式如下：

{"Fn::GetAtt": ["resourceId", "attributeId"]}

Outputs 示例

在以下示例中，分别获取资源 WebServer 的 InstanceId 属性和 PublicIp 属性。

"Outputs": {
  "InstanceId": {
       "Value" : {"Fn::GetAtt": ["WebServer","InstanceId"]}
  },
  "PublicIp": {
       "Value" : {"Fn::GetAtt": ["WebServer","PublicIp"]}
  }
}

更多模板示例，请参考 ROS 模板样例

时间： 2024-04-11 00:17:38

资源编排模板详解的相关文章

用资源编排模板创建0M带宽的ECS实例

最近时有用户咨询,如何用资源编排服务(ROS)创建0M带宽的ECS实例.一键体验 >> 以前大家习惯的ECS售卖页表单选择的购买方式,带宽直接选择0M即可,如下图所示.但是,用模板和API来创建,就有点儿不知所措了. 通过资源编排服务创建ECS实例 如果您对使用资源编排服务创建云资源还不熟悉,请参考我们之前的介绍 <通过资源编排创建一个ECS实例>,ALIYUN::ECS::Instance 插件地址.涉及ECS实例带宽相关的参数如下图: 创建0M带宽的实例,主要就两点: 网络类型

AngularJS入门教程之更多模板详解_AngularJS

在这一步,你将实现手机详细信息视图,这个视图会在用户点击手机列表中的一部手机时被显示出来. 请重置工作目录: git checkout -f step-8 现在当你点击列表中的一部手机之后,这部手机的详细信息页面就会被显示出来. 为了实现手机详细信息视图我们将会使用$http来获取数据,同时我们也要增添一个phone-detail.html视图模板. 步骤7和步骤8之间最重要的不同在下面列出.你可以在GitHub里看到完整的差别. 数据 除了phones.json,app/phones/目录也包

ThinkPHP模板引擎之导入资源文件方法详解_php实例

一般而言,网页传统方式的导入外部JS和CSS等资源文件的方法是直接在模板文件使用: <script type='text/javascript' src='/Public/Js/Util/Array.js'> <link rel="stylesheet" type="text/css" href="/App/Tpl/default/Public/css/style.css" /> ThinkPHP的模板引擎提供了专门的标签

我的Java开发学习之旅------&amp;gt;Java资源的国际化详解

internationalization (国际化)简称 i18n,因为在i和n之间还有18个字符,localization(本地化 ),简称L10n. 国际化相关的Java类 Java国际化主要通过如下3个类完成 java.util.ResourceBundle:用于加载一个资源包 java.util.Locale:对应一个特定的国家/区域.语言环境. java.text.MessageFormat:用于将消息格式化 国际化资源文件 为实现程序的国际化,必须提供程序所需要的资源文件.资源文件的

AngularJS入门教程之链接与图片模板详解_AngularJS

这一步,你会为手机列表的手机添加缩略图以及一些链接,不过这些链接还不会起作用.接下来你会使用这些链接来分类显示手机的额外信息. 请重置工作目录: git checkout -f step-6 现在你应该能够看到列表里面手机的图片和链接了. 步骤5和步骤6之间最重要的不同在下面列出.你可以在GitHub里看到完整的差别. 数据 注意到现在phones.json文件包含了唯一标识符和每一部手机的图像链接.这些url现在指向app/img/phones/目录. app/phones/phones.js

Android 往Framework中添加新资源的方法详解_Android

有时候我们想在标准的Framework中添加自己的新的资源怎么办呢?办法就是我们来尝试下.通过Eclipse的联系,我们可以联想到是否就是简单的把字符串放在res的各个文件夹里面.先来试试看,编译,系统立即报错.为什么呢?它提示你利用make update-api这个命令来更新public.xml文件或者把这个声明称hide类型.这个肯定不是我们想要的.所以方法有二:方法1:正常添加完资源后,执行make update-api函数.系统更新res/values/public.xml文件.方法2:

C++中的类模板详解及示例_C 语言

C++中的函数模板 对于类的声明来说,也有同样的问题.有时,有两个或多个类,其功能是相同的,仅仅是数据类型不同,如下面语句声明了一个类: 复制代码 代码如下: class Compare_int{ public:  Compare(int a,int b)  {   x=a;   y=b;  }   int max()  {   return (x>y)?x:y;  }  int min()  {   return (x<y)?x:y;  } private:  int x,y;}; 其作用是

AngularJS初始化静态模板详解_AngularJS

AngularJS可以通过ng-app来自动初始化模块,也可以通过angular.bootstrap(document, [module])手动启动应用,不管用哪种方法,应用启动后,动态往dom树里面添加的dom元素,无法执行angular指令,即无法通过ng-model.ng-click给动态添加的dom元素绑定数据和事件,怎么办? 动态添加dom元素的场景非常常见,如点击某页面上修改用户资料的按钮,发送ajax请求去查询用户资料,然后通过模板引擎将事先写在页面里的静态模板编译成HTML字符串

AngularJS入门教程之静态模板详解_AngularJS

为了说明angularJS如何增强了标准HTML,我们先将创建一个静态HTML页面模板,然后把这个静态HTML页面模板转换成能动态显示的AngularJS模板. 在本步骤中,我们往HTML页面中添加两个手机的基本信息,用以下命令将工作目录重置到步骤1. git checkout -f step-1 请编辑app/index.html文件,将下面的代码添加到index.html文件中,然后运行该应用查看效果. app/index.html <ul> <li> <span>