微软Azure容器服务引擎(ACS-Engine)使用手册

---

项目概述

微软Azure容器服务引擎(ACS-Engine)是用于创建基于Docker的容器集群的强大工具，它通过自动生成Azure资源管理器(ARM)模板来简化在Azure上部署DC/OS、Kubernetes、OpenShift等编排工具驱动的容器集群的过程。然而，需注意的是，此项目已被废弃，并迁移到Azure/aks-engine，但为了教育目的，我们仍可回顾其结构和关键概念。

---

1. 项目目录结构及介绍

以下是acs-engine项目的一个典型目录结构概览：

.
├── dockerignore        # Docker构建时忽略的文件列表
├── gitattributes       # Git属性设置
├── gitignore           # Git忽略的文件类型
├── LICENSE             # 开源许可协议（MIT）
├── Makefile            # 自动化构建脚本
├── README.md           # 主要的英文项目说明文档
├── README_zh-CN.md     # 中文版项目说明文档
├── examples            # 示例配置文件夹，包含不同编排系统的示例
│   └── kubernetes.json # 示例：Kubernetes配置文件
├── extensions          # 扩展功能相关的代码或配置
├── pkg                 # 包含主要的功能实现模块
├── scripts             # 脚本集合，用于各种自动化任务
└── tests               # 测试相关文件和目录

• examples: 提供了如何定义集群的各种示例。
• pkg: 核心包，实现了模板生成逻辑。
• scripts 和 tests: 分别包含了项目运行和测试所需的脚本与测试案例。
• README.md 和 README_zh-CN.md: 项目文档，分别提供了英文和中文的指南。

---

2. 项目的启动文件介绍

尽管acs-engine不直接有一个“启动文件”如传统应用，它的核心在于命令行接口执行，通常通过执行acs-engine二进制文件并传递相应的参数或配置文件来“启动”集群生成过程。这可以通过在项目根目录下执行编译后的acs-engine命令，例如：

./acs-engine generate examples/kubernetes.json

这里，generate是用于根据提供的集群定义文件生成ARM模板的主要命令。

---

3. 项目的配置文件介绍

配置文件（通常是.json格式） 是acs-engine的核心。以Kubernetes为例，你的配置文件应至少包含以下关键元素：

• apiVersion: 指定使用的API版本。
• properties.masterProfile: 描述主节点的配置。
• properties.agentPoolProfiles: 定义代理池的特性，包括VM大小、数量等。
• properties.dnsPrefix: 独特的DNS前缀，用于识别集群。
• properties.kubernetesConfig: 设置Kubernetes特定的配置，如版本等。

配置文件高度定制化，支持自定义VNET、存储选项、扩展等，具体细节需参考项目中的示例文件和文档。

---

请注意，由于项目已迁移至aks-engine，新项目可能遵循不同的架构和配置规范。建议查阅最新项目的文档进行实际操作。