编排新添加模板

admin

创建一个模板¶

Orchestration服务使用模版来描述栈。想要学习模版语言，参考`Heat developer documentation <http://docs.openstack.org/developer/heat/index.html>`__中的`the Template Guide <http://docs.openstack.org/develo ... e/index.html>`__ 。

• 使用下面的内容创建``demo-template.yml``文件：
  heat_template_version: 2015-10-15description: Launch a basic instance using the ``m1.tiny`` flavor and one network.parameters:  ImageID:    type: string    description: Image to use for the instance.  NetID:    type: string    description: Network ID to use for the instance.resources:  server:    type: OS::Nova::Server    properties:      image: { get_param: ImageID }      flavor: m1.tiny      networks:      - network: { get_param: NetID }outputs:  instance_name:    description: Name of the instance.    value: { get_attr: [ server, name  }  instance_ip:    description: IP address of the instance.    value: { get_attr: [ server, first_address  }
  6 p1 e# _# F; @& c! v* R

创建一个栈¶

使用``demo-template.yml`` 模版创建一个栈。

• 加载 ``demo``凭证，作为非管理员项目执行下面的步骤：
  $ source demo-openrc.sh
• 检测可用网络。
  $ neutron net-list+--------------------------------------+---------+-----------------------------------------------------+| id                                   | name    | subnets                                             |+--------------------------------------+---------+-----------------------------------------------------+| 9c13da20-4c4f-486f-a4e9-692e9ea397f1 | public  | 85140549-1f54-4bc6-a2c5-f08428de3f7a 203.0.113.0/24 || 303a9aaf-40fd-4fc8-9213-39bff933467b | private | ddeba0b1-21eb-471a-8f31-10f0e290cc36 172.16.1.0/24  |+--------------------------------------+---------+-----------------------------------------------------+
  
  
  注解
  ( G0 i3 M, f2 h8 b3 I3 X
  这个输出可能跟你的环境有所不同。
• 设置``NET_ID``环境变量表示网络ID。例如，使用``public`` 网络：
  $ export NET_ID=$(neutron net-list | awk '/ public / { print $2 }')
• 在公共网络上创建一个CirrOS实例的栈：
  $ heat stack-create -f demo-template.yml -P "ImageID=cirros;NetID=$NET_ID" stack+--------------------------------------+------------+--------------------+---------------------+--------------+| id                                   | stack_name | stack_status       | creation_time       | updated_time |+--------------------------------------+------------+--------------------+---------------------+--------------+| dbf46d1b-0b97-4d45-a0b3-9662a1eb6cf3 | stack      | CREATE_IN_PROGRESS | 2015-10-13T15:27:20 | None         |+--------------------------------------+------------+--------------------+---------------------+--------------+
• 等一段时间，验证栈的创建是否成功：
  $ heat stack-list+--------------------------------------+------------+-----------------+---------------------+--------------+| id                                   | stack_name | stack_status    | creation_time       | updated_time |+--------------------------------------+------------+-----------------+---------------------+--------------+| dbf46d1b-0b97-4d45-a0b3-9662a1eb6cf3 | stack      | CREATE_COMPLETE | 2015-10-13T15:27:20 | None         |+--------------------------------------+------------+-----------------+---------------------+--------------+
• 查看实例的名称和IB地址并和``nova`` 命令的输出比较：
  $ heat output-show --all stack[  {    "output_value": "stack-server-3nzfyfofu6d4",    "description": "Name of the instance.",    "output_key": "instance_name"  },  {    "output_value": "10.4.31.106",    "description": "IP address of the instance.",    "output_key": "instance_ip"  }$ nova list+--------------------------------------+---------------------------+--------+------------+-------------+---------------------------------+| ID                                   | Name                      | Status | Task State | Power State | Networks                        |+--------------------------------------+---------------------------+--------+------------+-------------+---------------------------------+| 0fc2af0c-ae79-4d22-8f36-9e860c257da5 | stack-server-3nzfyfofu6d4 | ACTIVE | -          | Running     | public=10.4.31.106              |+--------------------------------------+---------------------------+--------+------------+-------------+---------------------------------+
• 删除栈。
  $ heat stack-delete stack
  

admin

环境文件就是一个特殊类型的模板，它为 Heat 模板提供了自定义的功能。这个文件包括两个主要的部分：
3 I! ?! `) T" M+ K* g) u参数 - 应用到一个模板参数的常规设置。它们在环境文件的 parameters 项中设置。
5 P5 W; c& a2 ]8 I/ B' B6 ^参数默认值 - 这些参数被用来修改模板中的参数的默认值。它们在环境文件的 parameter_defaults 项中设置。
" J, s, ^; j' i+ I. x- H1 i" T* g资源注册表 - 它设置了自定义资源名，并连接到其它 Heat 模板。这提供了一个创建没有存在于核心资源集合中的自定义资源的方法。它在环境文件的 resource_registry 项中设置。
5 _3 j  h5 J! n: T* @! Q以下是一个基本环境文件的实例：
; e! r2 m5 R! b, {* Uresource_registry:
  OS::Nova::Server::MyServer: myserver.yaml

parameter_defaults:
  NetworkName: my_network

# b: F4 h) d  S) ?parameters:
" c2 |( [8 g4 W0 i* D  MyIP: 192.168.0.1
' _2 z9 b/ H/ Q( F
* U. ~" e6 {0 U这会创建一个新的、名为 OS::Nova::Server::MyServer 的资源类型。myserver.yaml 是一个 Heat 模板文件，它被用来创建这个资源类型来覆盖内建的资源类型。
/ P! |) u- k0 Y' M

admin

Heat 模板

$ k& D: b9 a! i+ [  M7 O9 \director 使用 Heat Orchestration Templates（HOT）作为模板格式来组成 Overcloud 的部署计划。HOT 格式的模板通常使用 YAML 格式。一个模板的目的是创建一个堆栈（stack），堆栈中包括了一组资源集合，Heat 会创建并配置每个资源。资源就是 OpenStack 中的对象（object），它包括计算资源、网络配置、安全组、扩展规则和自定义资源。
一个 Heat 模板有以下 3 个主要项：
参数 - 一组传递给 Heat 的参数，可以被用来自定义一个堆栈，并设置在没有传递值时相关参数所使用的默认值。这些参数在模板的 parameters 项中定义。
$ p9 g- y9 o, k$ h+ z5 @. Q3 q: V资源 - 一组作为堆栈的一部分需要创建和配置的对象。OpenStack 包括一组分布在所有组件中的资源，它们在模板的 resources 项中定义。
输出 - 一组在堆栈创建后传递给 Heat 的值。您可以通过 Heat API 或客户端工具程序来访问这些值。它们在模板的 output 项中定义。
以下是一个基本 Heat 模板的示例：
. V5 [3 P, d: M- u5 D( Z7 r/ W
heat_template_version: 2013-05-23
6 r# j% S3 g, l, ^' y3 s! S, P- |6 i
/ g  g) {/ G5 A  sdescription: > A very basic Heat template.
( K- K- k. z8 `) F# V3 o
parameters:
% W4 w$ Z7 U; o  key_name:
    type: string
  J7 ^* b* C8 G    default: lars
    description: Name of an existing key pair to use for the instance
5 J2 V: |% q* G5 L3 a  flavor:
# @9 N3 n. A4 ~3 m0 k$ r1 U* y    type: string
    description: Instance type for the instance to be created
    default: m1.small
  image:
    type: string
0 t4 }  A9 b0 c2 f    default: cirros
    description: ID or name of the image to use for the instance
+ [; h6 k$ a% s* i$ \
resources:
  my_instance:
) V7 ]. T7 z$ W+ u/ l    type: OS::Nova::Server
% D$ N- o0 O. d& [5 `3 ]! j    properties:
      name: My Cirros Instance
      image: { get_param: image }
4 Y  X2 [' T4 g: O      flavor: { get_param: flavor }
      key_name: { get_param: key_name }

6 N  n: P5 q1 {  e" ]5 Doutput:
  instance_name:
    description: Get the instance's name
+ O: D6 H6 [+ l/ i. U  L1 J    value: { get_attr: [ my_instance, name ] }

* x' j% M* x' d- J8 \' `- v% r这个模板使用资源类型 type: OS::Nova::Server 创建一个名为 my_instance 的实例，它具有特定的 flavor、镜像和关键字。这个堆栈会返回 instance_name 的值（My Cirros Instance）。

admin

示例 1
以下示例是一个用于部署单个虚拟系统的简单 Heat 模板，该示例限制为此模板中硬编码的映像、密钥和虚拟硬件样板值的单一组合：
heat_template_version: 2013-05-23

: H4 g5 e* p$ q- i8 idescription: Simple template to deploy a single compute instance with hardcoded values
& z2 p" T- v  E/ i
resources:
  my_instance:
, _* h- N# B( u! A1 s, C+ z1 R# P/ g    type: OS::Nova::Server
    properties:
6 s. @4 S" }0 \- k      key_name: my_key_pair_1
  g5 E! J% }& x- K8 E      image: cirros-0.3.1-x86_64
: L9 Z9 e( @! Z" _1 Q; ^      flavor: m1.tiny
& m3 V1 P, B' a( OCopy
0 I" m) `1 Y! T示例 2
以下示例是一个 Heat 模板，它使用参数来部署单个虚拟系统，因此可以复用于其他配置：
4 ~3 W) n, A- \heat_template_version: 2013-05-23
description: Simple template to deploy a single compute instance with parameters

parameters:
& s) u! r: A$ [7 y/ A; }  key_name:
0 X* K3 s& w5 w8 i6 T0 s" n    type: string
& a+ `, o& c- B! t    label: Key Name
    description: Name of key-pair to be used for compute instance
) P  _6 ~# s0 J  image_id:
    type: string
    label: Image ID
% x8 o1 M. s& l$ R9 i* ~    description: Image to be used for compute instance
  instance_type:
4 X; k( I8 ^+ y5 y    type: string
    label: Instance Type
0 G5 k+ P% m# T( J' Q+ f    description: Type of instance (flavor) to be used
9 D& ~6 O$ ]5 ^# A8 Sresources:
  my_instance:
7 \# W! p1 [' ^' H4 [  `7 K" X( o    type: OS::Nova::Server
    properties:
      key_name: { get_param: key_name }
      image: { get_param: image_id }
8 B# B% b3 P* v4 P      flavor: { get_param: instance_type }
9 F5 V4 m" [; L. W7 NCopy
$ w& a  ^& o! \8 C4 }- W6 {示例 3
% L% _8 m1 t* K' b6 x. c* D以下示例是一个简单的 Heat 模板，它通过使用参数的查找注释来部署具有两个虚拟机实例的堆栈：
7 ?1 L- J* l# g0 G( k2 A& Iheat_template_version: 2013-05-23

description: Simple template to deploy a stack with two virtual machine instances

7 g4 w. L1 `' U9 a+ |& |parameters:
  image_name_1:
1 F7 y& Y% T- Q    type: string
    label: Image Name
# {0 i4 W* S( }( G+ \! `    description: SCOIMAGE Specify an image name for instance1
    default: cirros-0.3.1-x86_64
/ [0 f, `/ f& m% g0 e. [2 C  image_name_2:
    type: string
    label: Image Name
    description: SCOIMAGE Specify an image name for instance2
8 y0 H8 P* s) Y4 o% B0 _    default: cirros-0.3.1-x86_64
# ^9 S- i/ k+ |& r8 K0 k  m  network_id:
9 j5 X. D  l; a" Q* E% }# c  T    type: string
( w8 S9 H2 A" U2 `' C, y7 ~0 k8 [    label: Network ID
    description: SCONETWORK Network to be used for the compute instance

. M- u, T: \3 a. N0 I0 yresources:
  my_instance1:
    type: OS::Nova::Server
2 \; g- s& e. \+ d. p$ g    properties:
% Z" r' \, N& F! R      image: { get_param: image_name_1 }
      flavor: m1.small
& {9 E" W1 ]% i* A% Q/ u      networks:
6 O* G% Q9 w) z* ~9 T7 Y4 C; I        - network : { get_param : network_id }
  my_instance2:
: ~) j+ h7 u. Q! Y0 W3 F    type: OS::Nova::Server
    properties:
      image: { get_param: image_name_2 }
8 E% ~0 S! t0 J# _" O, m$ p      flavor: m1.tiny
      networks:
+ d! u4 P4 Q6 {0 Q        - network : { get_param : network_id }
Copy
* c; X! d! T3 n& S5 ^示例 4
以下示例是一个简单的 Heat 模板，此模板通过使用 user_data 节来针对虚拟机设置 admin 密码：
heat_template_version: 2013-05-23
; e, [8 H2 p0 @7 I. a* B: o
description: Simple template to set the admin password for a virtual machine

parameters:
  key_name:
. j1 Z. O! O. ~    type: string
    label: Key Name
    description: SCOKEY Name of the key pair to be used for the compute instance
7 K3 ?9 x. ?$ T% ]0 J+ _  image_name:
    type: string
: G3 y& f, C$ r3 P2 m    label: Image Name
) d) O3 j1 l% s9 L; n    description: SCOIMAGE Name of the image to be used for the compute instance
  password:
    type: string
& H+ b# T2 i/ {) E    label: password
9 Y$ Q) ~  I5 l7 S$ S1 h    description: admin password
    hidden: true

- I9 U! g* R) W6 D
resources:
  my_instance:
( {6 v6 {5 c7 M3 \& |+ v1 v    type: OS::Nova::Server
    properties:
: S) j% p5 E1 h      key_name: { get_param: key_name }
      admin_user: sampleuser
      image: { get_param: image_name }
  y# {2 z: ~8 ^6 V4 q. N, {      flavor: m1.small
      user_data:
        str_replace:
          template: |
            #!/bin/bash
7 U3 \  _% J2 Y  c$ o' e* G" ^            echo "Setting  password to  " $password           
            echo $password |passwd --stdin sampleuser
6 J% {5 h6 ?9 ^$ H+ _3 o
          params:
! I% }+ n% J# E* `" `6 R7 ]. d            $password: { get_param: password }
Copy
示例 5
以下示例是一个简单的 Heat 模板，此模板用于在您指定了要使用的存储连接组以及引导卷部署所在的存储模板的 PowerVC 上，部署 AIX 或 Linux on Power 服务器：
' c/ M* o7 U% jheat_template_version: 2013-05-23
* v) D5 I2 D$ `2 `) h- z7 Y& H! b* M& Zdescription: Template to Deploy on NPIV v7k storage only

parameters:
% l, D3 e1 p6 ?* I  network_id1:
5 O6 l& @7 ?/ @" R( d( [    type: string
# A* L, |) T( b' w3 }* ]  N    description: SCONETWORK ID of the (nova) network a server should be deployed to.
. Z2 ?* x; w. d+ _  flavor_id:
    type: string
    description: SCOFLAVOR The flavor to be applied to the server DatabaseTierVM.
  image:
    type: string
) [, k+ ^, S1 ~% p3 T- K    label: Image
    description: SCOIMAGE The Image to be deployed
resources:
  heat:
    type: OS::Nova::Server
    properties:
% k" X2 E2 h; L3 l5 W" @% \/ s      image: { get_param: image }
, i# }8 C) T# M- J2 I8 O6 E      flavor: { get_param: flavor_id }
      availability_zone: D0EB
      metadata: { selected-scg: d91acbbe-3d81-4279-b389-54b3ad4a1c8c, selected-storage-template: 0431b2f3-fea6-4aa5-b3fb-d0e82ccf5ebb }
) K# B1 V: n2 h$ s& L) {      networks:
) W' p+ r- Q1 m' J$ E         - network : { get_param : network_id1 }
; H3 O/ N' x7 T/ _Copy
注：
2 P; `, z/ B' v3 [/ g您可以使用 OpenStack Dashboard 中的“主机聚集”面板为 PowerVM® 服务器创建可用性专区。 请先确保您创建的新可用性专区添加到相关域和项目，然后再尝试使用这些可用性专区。 您可以在要使用的映像的 Image_topology 中找到 selected-scg（存储连接组）和 selected-storage-template。 请在 OpenStack Controller 上运行 glance image-show <image id> 命令。 映像拓扑指定该特定映像所支持的存储连接组和存储模板。