Question

在 OpenStack 中， 堆栈（Stack） 是由 Heat（OpenStack 的编排服务）管理的一组云资源的集合，例如虚拟机、存储、网络等。通过 Heat，您可以使用模板（Heat Orchestration Template，HOT）来定义和部署整个应用程序环境，并管理其生命周期。

以下是如何在 OpenStack 中启动和管理堆栈的完整指南：

---

1. 什么是堆栈？

• 堆栈 ：是由一个模板定义的资源集合。模板描述了资源的类型、配置、依赖关系和参数。
• Heat Orchestration Template (HOT) ：一种 YAML 格式的文件，用于定义堆栈中资源的结构和行为。
• Heat 是 OpenStack 提供的一种强大的基础设施即代码（Infrastructure as Code，IaC）工具。

---

2. 启动堆栈（Launch Stack）

2.1 前提条件

1. 已登录 OpenStack 环境 ：确保您有管理员或项目用户的访问权限。
2. 已安装 Heat 服务 ：需要由 OpenStack 管理员部署和启用。
3. 准备模板文件 ：

• 模板文件（通常是 .yaml 或 .yml 格式）描述了堆栈中包含的资源和属性。
• 示例模板文件（创建一个虚拟机和网络）：

   

   heat_template_version: 2018-03-02
  
   description: Simple template to deploy a server with a private network
  
   resources:
     my_network:
       type: OS::Neutron::Net
       properties:
         name: private_network
  
     my_subnet:
       type: OS::Neutron::Subnet
       properties:
         network_id: { get_resource: my_network }
         cidr: 192.168.1.0/24
         ip_version: 4
  
     my_server:
       type: OS::Nova::Server
       properties:
         name: demo_instance
         image: cirros
         flavor: m1.small
         networks:
           - network: { get_resource: my_network }
  

2.2 使用 Horizon 启动堆栈

1. 登录到 Horizon 控制台 。
2. 导航到 Project → Orchestration → Stacks 。
3. 点击 Launch Stack 。
4. 选择模板来源：

• 直接上传模板文件 ：选择本地 .yaml 文件。
• 通过 URL 提供模板 ：输入模板文件的 URL。

1. 配置参数：

• 填写堆栈的名称。
• 如果模板需要参数（如网络名称或镜像 ID），按照要求填写。

1. 单击 Launch 开始创建堆栈。
2. 跳转到 Stacks 页面 ，可以看到堆栈的状态（例如 CREATE_IN_PROGRESS 和 CREATE_COMPLETE ）。

2.3 使用命令行（CLI）启动堆栈

1. 准备模板文件，例如 template.yaml 。
2. 运行以下命令启动堆栈：

   openstack stack create --template template.yaml --parameter key=value STACK_NAME

示例：

   openstack stack create --template template.yaml --parameter ImageID=cirros demo_stack

3. 检查堆栈状态：

   openstack stack list

---

3. 管理堆栈（Manage Stack）

3.1 查看堆栈详情

1. 通过 Horizon 查看 ：

• 转到 Project → Orchestration → Stacks 。
• 点击目标堆栈的名称，查看资源、事件、模板和输出。

1. 通过 CLI 查看 ：

• 查看堆栈资源： bash openstack stack resource list STACK_NAME
• 查看堆栈事件： bash openstack stack event list STACK_NAME
• 查看堆栈的详细信息： bash openstack stack show STACK_NAME

3.2 更新堆栈

当需要更改堆栈配置时，可以通过模板更新堆栈。

1. 准备更新后的模板文件 。
2. 通过 Horizon 更新 ：

• 转到 Project → Orchestration → Stacks 。
• 找到目标堆栈，点击 Update Stack 。
• 上传新的模板文件，填写参数后单击 Update 。

1. 通过 CLI 更新 ：

   openstack stack update --template updated_template.yaml --parameter key=value STACK_NAME

3.3 删除堆栈

当堆栈不再需要时，可以删除它及其关联资源。

1. 通过 Horizon 删除 ：

• 转到 Project → Orchestration → Stacks 。
• 找到目标堆栈，点击 Delete Stack 。

1. 通过 CLI 删除 ：

   openstack stack delete STACK_NAME

3. 验证堆栈是否删除成功：

   openstack stack list

---

4. 模板文件（HOT）的结构

4.1 模板版本

模板需要指定版本号，例如：

heat_template_version: 2018-03-02

4.2 描述信息

为模板添加说明：

description: Simple Heat template to deploy resources

4.3 参数（parameters）

定义模板中可变的输入参数：

parameters:
  instance_type:
    type: string
    description: Flavor for the instance
    default: m1.small

4.4 资源（resources）

资源是堆栈的核心部分，用于定义要创建的云资源：

resources:
  my_server:
    type: OS::Nova::Server
    properties:
      name: demo_instance
      image: cirros
      flavor: m1.small

4.5 输出（outputs）

定义堆栈的输出信息：

outputs:
  instance_ip:
    description: IP address of the instance
    value: { get_attr: [my_server, first_address] }

---

5. 常见问题及解决方法

5.1 堆栈创建失败

• 原因 ：模板中的参数或资源配置错误。
• 解决方案 ：
• 检查模板文件的语法。
• 查看堆栈事件日志，定位错误： bash openstack stack event list STACK_NAME

5.2 资源未正确创建

• 原因 ：网络配置或镜像不可用。
• 解决方案 ：
• 确保模板中引用的资源（如网络或镜像）存在且可用。
• 验证项目的配额是否充足。

5.3 更新堆栈失败

• 原因 ：尝试更改不可变的属性（如实例的镜像）。
• 解决方案 ：
• 删除并重新创建资源。
• 使用替换资源的方式更新堆栈。

---

6. 热门用途

1. 自动化部署应用程序 ：通过模板快速创建复杂的应用环境。
2. 测试和开发环境 ：一键启动和销毁测试环境。
3. 灾备恢复 ：使用模板快速恢复云资源。