创建并发布自定义 Azure Stack Hub 市场项

发布到 Azure Stack Hub 市场的每个项都使用 Azure 库包 (.azpkg) 格式。 使用 Azure Gallery Packager 工具可以创建自定义 Azure 库包，然后可将此包上传到 Azure Stack Hub 市场供用户下载。 部署过程使用 Azure 资源管理器模板。

市场项

本文中的示例演示如何创建 Windows 或 Linux 类型的单个 VM 市场套餐。

先决条件

创建 VM 市场项之前，请执行以下操作：

1. 按照将 VM 映像添加到 Azure Stack Hub 中的说明将自定义 VM 映像上传到 Azure Stack Hub 门户。
2. 按照本文中的说明打包映像（创建 .azpkg），并将其上传到 Azure Stack Hub 市场。

创建市场项

若要创建自定义市场项，请执行以下操作：

1. 下载 Azure Gallery Packager 工具：

   

2. 该工具包含 .azpkg 格式的示例包，必须先解压缩。 你可以将文件扩展名从“.azpkg”重命名为“.zip”，或使用所选的存档程序工具：

   

3. 解压缩后，.zip 文件将包含可用的 Linux 或 Windows Azure 资源管理器模板。 你可以重复使用预制的资源管理器模板，并使用要显示在 Azure Stack Hub 门户中的项的产品详细信息修改相应的参数。 也可重复使用 .azpkg 文件，并跳过后续的自定义库包步骤。

4. 创建 Azure 资源管理器模板，或使用适用于 Windows/Linux 的示例模板。 在步骤 1 下载的打包器工具 .zip 文件中已提供这些示例模板。 可以使用模板并更改文本字段，或者从 GitHub 下载预配置的模板。 有关 Azure 资源管理器模板的详细信息，请参阅 Azure 资源管理器模板。

5. 库包应包含以下结构：

   

6. 将 Manifest.json 模板中突出显示的以下值（带编号的值）替换为在上传自定义映像时提供的值。

   注意

   切勿对 Azure 资源管理器模板中的任何机密（例如产品密钥、密码或任何客户身份信息）进行硬编码。 将模板 JSON 文件发布到库中后，无法身份验证即可访问这些文件。 将所有机密存储在 Key Vault 中，然后从模板内部调用它们。

   建议在发布自己的自定义模板之前，尝试按原样发布示例，确保示例在你的环境中正常工作。 验证此步骤有效后，请从库中删除该示例，并进行迭代更改，直到对结果满意为止。

   以下模板是 Manifest.json 文件的示例：

   {
      "$schema": "https://gallery.azure.com/schemas/2015-10-01/manifest.json#",
      "name": "Test", (1)
      "publisher": "<Publisher name>", (2)
      "version": "<Version number>", (3)
      "displayName": "ms-resource:displayName", (4)
      "publisherDisplayName": "ms-resource:publisherDisplayName", (5)
      "publisherLegalName": "ms-resource:publisherDisplayName", (6)
      "summary": "ms-resource:summary",
      "longSummary": "ms-resource:longSummary",
      "description": "ms-resource:description",
      "longDescription": "ms-resource:description",
      "links": [
       { "displayName": "ms-resource:documentationLink", "uri": "http://docs.azure.cn/zh-cn/azure-resource-manager/resource-group-authoring-templates" }
       ],
      "artifacts": [
         {
            "isDefault": true
         }
      ],
      "images": [{
         "context": "ibiza",
         "items": [{
            "id": "small",
            "path": "icons\\Small.png", (7)
            "type": "icon"
            },
            {
               "id": "medium",
               "path": "icons\\Medium.png",
               "type": "icon"
            },
            {
               "id": "large",
               "path": "icons\\Large.png",
               "type": "icon"
            },
            {
               "id": "wide",
               "path": "icons\\Wide.png",
               "type": "icon"
            }]
       }]
   }
   

   以下列表解释了示例模板中的上述带有编号的值：

   • (1) - 套餐的名称。
   • (2) - 发布者的名称，不带空格。
   • (3) - 模板的版本，不带空格。
   • (4) - 客户看到的名称。
   • (5) - 客户看到的发布者名称。
   • (6) - 发布者的法定名称。
   • (7) - 每个图标的路径和名称。

7. 对于引用 ms-resource 的所有字段，必须在 strings/resources.json 文件中更改相应的值：

   {
   "displayName": "<OfferName.PublisherName.Version>",
   "publisherDisplayName": "<Publisher name>",
   "summary": "Create a simple VM",
   "longSummary": "Create a simple VM and use it",
   "description": "<p>This is just a sample of the type of description you could create for your gallery item!</p><p>This is a second paragraph.</p>",
   "documentationLink": "Documentation"
   }
   

8. 部署模板文件结构如下所示：

   

   将 createuidefinition.json 文件中映像的值替换为在上传自定义映像时提供的值。

9. 为确保资源可以成功部署，请使用 Azure Stack Hub API 测试该模板。

10. 如果你的模板依赖于虚拟机 (VM) 映像，请根据说明将 VM 映像添加到 Azure Stack Hub。

11. 将 Azure Resource Manager 模板保存在 /Contoso.TodoList/DeploymentTemplates/ 文件夹中。

12. 为市场项选择图标和文本。 将图标添加到 Icons 文件夹，并向 Strings 文件夹中的 resources 文件添加文本。 为图标使用 small、medium、large 和 wide 命名约定。 有关这些大小的详细说明，请参阅市场项 UI 参考。

    注意

    为正确生成市场项，需要全部四个图标大小（small、medium、large、wide）。

13. 若要进一步编辑 Manifest.json，请参阅参考：市场项 manifest.json。

14. 修改完文件后，请将其转换为 .azpkg 文件。 可以使用 AzureGallery.exe 工具以及前面下载的示例库包来执行转换。 运行以下命令：

    .\AzureStackHubGallery.exe package -m c:\<path>\<gallery package name>\manifest.json -o c:\Temp
    

    注意

    输出路径可以是所选的任何路径，且不一定要在 C: 驱动器下。 但是，manifest.json 文件和输出包的完整路径必须存在。 例如，如果输出路径为 C:\<path>\galleryPackageName.azpkg，则文件夹 C:\<path> 必须存在。

发布市场项

参考：市场项 manifest.json

标识信息

Metadata

映像

市场使用以下图标：

Categories

应当为每个市场项标记一个类别，该类别标识在门户 UI 中的何处显示该项。 可以选择 Azure Stack Hub 中的现有类别之一（“计算”、“数据 + 存储”等），也可以选择新建一个。

链接

每个市场项可以包括指向其他内容的各种链接。 链接以名称和 URI 的列表形式进行指定：

其他属性

除了前面的元数据之外，市场作者可以采用以下形式提供自定义键/值对数据：

HTML 清理

对于允许使用 HTML 的任何字段，将允许使用以下元素和属性：

h1, h2, h3, h4, h5, p, ol, ul, li, a[target|href], br, strong, em, b, i

参考：市场项 UI

在 Azure Stack Hub 门户中显示的市场项的图标和文本将如下所示。

“创建”边栏选项卡

市场项详细信息边栏选项卡

后续步骤

• Azure Stack Hub 市场概述
• 下载市场项
• Azure 资源管理器模板的格式和结构