Azure 市场 ARM 模板发布指南

本文定义了 Azure 市场的一些基本概念,步骤 2 将引导服务商完成 ARM 模板的准备工作,并将其部署到 Azure 市场。 您只要遵循以下步骤,就能轻松地将您的 ARM 模板发布到 Azure 市场。

本文中的 “Azure 市场”作用范围均指中国大陆。

ARM 模板发布后,在Azure 中国市场Azure 中国入口上都可以看到。

1. 先决条件和准备

1.1 首先,注册成为 Azure 市场服务商。 请参考 Azure 市场服务商指南

1.2 其次,准备发布前资料和 ARM 模板文件,请参考 Azure 市场 ARM 模板制作指南

1.3 再次,ARM模板制作完成后需要进行本地测试,注意测试可以利用Powershell或Azure-cli等工具,请参考 创建和部署第一个 Azure 资源管理器模板

1.4 最后,准备 UI 定义文件 createuidefination,请参考 Azure 市场 ARM 模板 Azure 门户用户界面指南

2. 通过发布平台将 ARM 模板发布到 Azure 中国市场

为了将 ARM 模板产品发布到发布平台,首先,你需要根据1.1部分的介绍登录到发布平台

其次,你需要点击页面菜单中的“发布”->“ARM 模板”,也就是发布 ARM 模板,然后开始 ARM 模板发布过程。完成后,您需要点击保存按钮以防止页面内容丢失。下面对您需要填写的字段或内容进行详细解释。

2.1 定义产品/服务和 SKU

SKU 是 ARM 模板产品的商业名称并且并且是产品/服务的最小购买单位,一个 ARM 模板可以包含虚拟机、存储帐户、虚拟网络、Web 应用、数据库服务器和第三方服务等多个构件,它实质上是资源组的完整配置文件。

在 Azure 市场中,发布者、产品/服务和 SKU 可以唯一地定义一个 ARM 产品,产品/服务是其所有 SKU 的“父级”,发布者可以拥有多个产品/服务并决定如何构造产品/服务。 将产品/服务推送到待发布环境时,它会随其所有的 SKU 一起推送。 请仔细考虑 SKU ID,因为它们会被显示在 URL 中:

2.2 登录 Azure 市场选择发布功能

  • 使用发布商账号登录到发布平台
  • 在发布菜单中选择发布 ARM 模板

2.3 选择服务商 ID

服务商 ID 下拉框允许你选择将产品/服务在哪个发布商下发布。注意一旦产品/服务请求被提交,这个字段变不能再被修改。

2.4 填写产品/服务的服务ID

在提示输入字段中输入产品/服务的 ID,产品/服务的 ID 一般是销售商计划在 Azure 市场售卖的产品或服务的名称。

产品/服务的 ID 只能包含小写字母、数字、短横线或下划线,并且只能以小写字母或数字结尾,长度不超过50个字符或25个汉字。注意一旦产品/服务请求被提交,这个字段变不能再被修改。

2.5 填写 ARM 模板名称

ARM 模板名称是产品/服务的对外显示名称,显示在Azure 中国市场Azure 中国管理平台上,它不能超过25个汉字或50个字符。请尽量包含一个可识别的商标名称,不要包含公司名称,除非您在使用公司名称作为一种营销方式。 如果你同时在你自己的网站上销售这一产品/服务,请将 ARM 模板名称同你自己网站上产品名称保持一致。

2.6 填写简要描述

摘要描述对客户是可见的,因此需要有比较好的易读性,长度最多不超过100个汉字或200个非字符。

2.7 填写详细描述

详细描述对客户是可见的,它可以在富文本编辑器模式下编辑,也可以通过在富文本编辑器中单击“HTML”标签来直接添加HTML代码。请注意这个编辑器不能添加图片,图片需要在“上传图片”中单独上传。

详细描述一般包含产品介绍、使用说明和技术详情等内容,是产品的主要展示部分,因此请注意整体布局,并注意以下几点:

  • 产品介绍,一般包含产品概述、功能特点、技术架构以及应用场景等。
  • 使用说明,一般包含产品部署说明、登录说明、使用方法等。
  • 技术详情,一般包括软件安装位置、系统启停、日志管理、系统维护等注意事项。
  • 使用说明和技术详情等内容,也可以写成产品手册,加入到“相关链接”之中。
  • 详细描述中不能插入图片,图片插入功能请参考 “图片” 模块。
  • 建议字数在400字以上。

2.8 选择定价模式

有两种定价模式,免费和BYOL。

对于免费模式,微软将仅收取基础设施的费用,不收取软件许可费。请参阅 Azure 服务价格

对于 BYOL 模式,发布者可以管理运行在 ARM 上的软件的许可证,微软只会收取基础设施费用。在这种模式下,客户需要通过电子邮件、电话或其他联系方式从服务商那里获得许可证,服务商可以指定是否为客户提供免费试用;从部署 ARM 产品开始算,免费试用期为30天、90天或无试用期。

2.9 来源网站

一般填写公司网站地址就可以。

2.10 填写最终用户协议 EULA

我们建议最终用户协议的 url 地址放到服务商公司的网站上。

2.11 填写隐私声明

我们建议隐私声明的 url 地址放到服务商公司的网站上。

2.12 添加相关链接

可以增加一些有用的链接,比如使用指南之类的。这些链接会在镜像的使用说明后面显示。

所有上载到发布平台上的 logo 需要遵循以下规范:

  • Azure的设计有一个简单的调色板,请尽量限制 logo 上的主要和次要颜色数。

  • Azure入口的主题色是白色和黑色,因此,尽量避免使用这些颜色作为logo的背景颜色。请使用一些能使你的 logo 在 Azure门户中更突出的颜色,我们推荐简单的主颜色;如果您使用的是透明背景,请确保 logo 或文本不是白色、黑色或蓝色。

  • 不要在 logo 上使用渐变背景色。
  • 避免在 logo 上放置文字,甚至你的公司或商标名称。Logo 的外观看起来应该平整,应该避免渐变的颜色。

  • Logo 不要拉伸变形。

  • Logo 必须符合像素(115x115,255x115)。

2.14 上传其它图片

第一张'封面'图片会在 Azure 门户和 Azure 市场的镜像详细页上显示,其它的‘更多图片’只会出现在 Azure 市场的镜像详细页上。对于图片的规范,请参阅上一节上传logo,并且图片必须符合像素(533x324)。

2.15 上传 ARM 模板文件

如果您的 ARM 模板由多个文件组成,请将主模板文件上传到这里,引用的其它模板文件或安装包等作为附件上传。请注意,如果您的 ARM 模板里引用了其它镜像,如果此镜像还没有发布到 Azure 市场,需要先将它隐藏发布到 Azure 市场。

2.16 上传 ARM 模板附件

上传主模板文件引用的各种 UI 文件、其它模板文件或安装包等。UI 文件和 ARM 模板共同构成了发布到 Azure 市场需要的资源,具体请参考 Azure 市场 ARM 模板 Azure 门户用户界面指南

2.17 选择类别

从类别列表中选择和 ARM 模板相关的最多3个类别,所选类别将用于将您的产品/服务对应到 Azure 中国市场Azure 中国管理平台的产品类别中。

2.18 销售商机管理

如果你想收集用户信息,进行销售商机管理,你需要提供 Azure 存储连接字符串,系统会将用户数据存入您的存储表中。具体请参考Azure 市场销售商机

2.19 填写技术支持和客服信息

请留下技术支持和客服联系方式。

2.20. Global Azure 的 ARM 模板在 Azure 中国市场的发布问题

Global Azure 市场中 ARM 模板的描述一般基于英文,我们建议在 Azure 中国市场中发布 ARM 模板的时候,2.5-2.7 节中的文字以中文为主。

3. 编辑、更新、升级和删除 ARM 模板

在发布平台“保存”您的发布请求后,您需要检查一下页面是否有内容缺失或显示问题,请进入到未上架服务(或登录发布平台,点击页面右上角的服务商链接,可以查找所有已经提交或发布的产品/服务),您可以轻松地编辑、更新和删除您的产品/服务。

3.1 编辑、预览或删除按钮

  • 编辑功能。只能编辑用于展示的字段,产品/服务本身的元数据不能被修改,因此服务商ID、服务ID、ARM 模板文件等均不能修改。
  • 预览功能。产品/服务发布后在 Azure 市场上的预览展示,其中的“立即部署”按钮此时无效,因为还没有真正的发布产品/服务。
  • 删除功能。请注意删除产品/服务后,产品/服务将不能被恢复。

3.2 发布新版本

  • 发布新版本功能主要用于产品/服务本身的升级,所以服务商ID、服务ID不能修改,但一定要上传新的 ARM 模板文件(实际上新的模板文件可以和现有模板文件一致)。

3.3 申请上架

请参考 章节4。请注意点击了“申请上架”申请后,此产品/服务的编辑、删除、发布新版本等功能将不能使用,除非系统管理员退回您的请求。

4. ARM 模板上架审批

4.1 申请上架。

在服务商“保存” ARM 模板发布请求后,需要点击按钮 “申请上架” ,之后平台管理员才能开始驱动上架流程。在点击“申请上架”之前,你可以检查、编辑和升级 ARM 模板,使之更完善。

4.2 预发布

在申请上架后,您需要等待 Azure 中国市场管理员的预发布审批。正常情况下,审批可以在1~2周内完成,您会收到管理员的邮件通知,如果您的镜像没有通过部署测试,则需要退回修改并重新提交。

预发布审批通过后,平台管理员会联系并请您测试产品/服务,您需要登录 Azure 管理平台,对产品进行各种用例场景下的测试。无论 ARM 模板测试是否通过,您都需要将测试结果反馈给平台管理员。

4.3 正式发布

如果测试结果正常,ARM 产品/服务会被正式批准并上架,并会显示在 Azure 中国市场Azure 中国管理平台上。这个过程一般需要3-5个工作日。