Vytvoření a publikování vlastní položky Marketplace služby Azure Stack Hub

Každá položka publikovaná na Marketplace služby Azure Stack Hub používá formát Azure Gallery Package (.azpkg). Nástroj Azure Gallery Packager umožňuje vytvořit vlastní balíček Azure Gallery, který můžete nahrát na Marketplace služby Azure Stack Hub, který si pak můžou uživatelé stáhnout. Proces nasazení používá šablonu Azure Resource Manager.

Položky z Marketplace

Příklady v tomto článku ukazují, jak vytvořit jednu nabídku virtuálního počítače z Marketplace typu Windows nebo Linux.

Požadavky

Před vytvořením položky virtuálního počítače z marketplace udělejte toto:

1. Podle pokynů v tématu Přidání image virtuálního počítače do služby Azure Stack Hub nahrajte vlastní image virtuálního počítače na portál Azure Stack Hub.
2. Podle pokynů v tomto článku zabalte image (vytvořte .azpkg) a nahrajte ji na Marketplace služby Azure Stack Hub.

Vytvoření položky z Marketplace

Pokud chcete vytvořit vlastní položku marketplace, postupujte takto:

1. Stáhněte si nástroj Azure Gallery Packager:

   

2. Nástroj obsahuje ukázkové balíčky, které jsou ve formátu .azpkg a musí se nejprve extrahovat. Přípony souborů můžete přejmenovat z ".azpkg" na ".zip" nebo použít nástroj pro archivaci podle vašeho výběru:

   

3. Po extrahování soubor .zip obsahuje dostupné šablony Resource Manager Linuxu nebo Windows Azure. Můžete znovu použít předem vytvořené šablony Resource Manager a upravit příslušné parametry s podrobnostmi o produktu, které se zobrazí na portálu Služby Azure Stack Hub. Nebo můžete znovu použít soubor .azpkg a přeskočit následující kroky k přizpůsobení vlastního balíčku galerie.

4. Vytvořte šablonu Azure Resource Manager nebo použijte naše ukázkové šablony pro Windows/Linux. Tyto ukázkové šablony jsou k dispozici v nástroji packager .zip souboru, který jste stáhli v kroku 1. Můžete buď použít šablonu a změnit textová pole, nebo si můžete stáhnout předem nakonfigurovanou šablonu z GitHubu. Další informace o šablonách Azure Resource Manageru najdete v tématu věnovaném šablonám Azure Resource Manageru.

5. Balíček galerie by měl obsahovat následující strukturu:

   

6. Následující zvýrazněné hodnoty (ty s čísly) v šabloně Manifest.json nahraďte hodnotou, kterou jste zadali při nahrávání vlastní image.

   Poznámka

   V šabloně Azure Resource Manager nikdy nezakódujte žádné tajné kódy, jako jsou kódy Product Key, heslo nebo identifikovatelné informace o zákazníci. Po publikování v galerii jsou soubory JSON šablony přístupné bez nutnosti ověřování. Uložte všechny tajné kódy do Key Vault a volejte je ze šablony.

   Doporučujeme, abyste se před publikováním vlastní šablony pokusili publikovat ukázku tak, jak je, a ujistěte se, že funguje ve vašem prostředí. Jakmile ověříte, že tento krok funguje, odstraňte ukázku z galerie a proveďte iterativní změny, dokud nebudete s výsledkem spokojeni.

   Následující šablona je ukázkou souboru 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://go.microsoft.com/fwlink/?LinkId=532898" }
       ],
      "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"
            }]
       }]
   }
   

   Následující seznam vysvětluje předchozí číslování hodnot v ukázkové šabloně:

   • (1) – Název nabídky.
   • (2) – Název vydavatele bez mezery.
   • (3) – Verze šablony bez mezery.
   • (4) – název, který zákazníci vidí.
   • (5) – Název vydavatele, který zákazníci uvidí.
   • (6) - Oficiální název vydavatele.
   • (7) – Cesta a název každé ikony.

7. U všech polí odkazujících na ms-resource musíte změnit příslušné hodnoty v souboru 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. Struktura souborů šablon nasazení se zobrazí takto:

   

   Nahraďte hodnoty obrázku v souboru createuidefinition.json hodnotou, kterou jste zadali při nahrávání vlastní image.

9. Pokud chcete zajistit úspěšné nasazení prostředku, otestujte šablonu pomocí rozhraní API služby Azure Stack Hub.

10. Pokud vaše šablona spoléhá na image virtuálního počítače, podle pokynů přidejte image virtuálního počítače do služby Azure Stack Hub.

11. Šablonu Azure Resource Manager uložte do složky /Contoso.TodoList/DeploymentTemplates/.

12. Zvolte ikony a text položky z Marketplace. Přidejte ikony do složky Ikony a do souboru prostředků ve složce Řetězce přidejte text. Pro ikony použijte konvenci pro vytváření malých, středních, velkých a širokých názvů. Podrobný popis těchto velikostí najdete v referenčních informacích k uživatelskému rozhraní položek Marketplace.

    Poznámka

    Ke správnému sestavení položky z Marketplace se vyžadují všechny čtyři velikosti ikon (malé, střední, velké, široké).

13. Další úpravy souboru Manifest.json najdete v referenčních informacích : Manifest.json položky Marketplace.

14. Po dokončení úprav souborů je převeďte na soubor .azpkg. Převod provedete pomocí nástrojeAzureGallery.exe a ukázkového balíčku galerie, který jste si stáhli dříve. Spusťte následující příkaz:

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

    Poznámka

    Výstupní cesta může být libovolná cesta, kterou zvolíte, a nemusí být pod jednotkou C:. Musí však existovat úplná cesta k souboru manifest.json i k výstupnímu balíčku. Pokud je C:\<path>\galleryPackageName.azpkgnapříklad výstupní cesta , musí složka C:\<path> existovat.

Publikování položky z Marketplace

Referenční informace: Manifest.json položky Marketplace

Informace o identitě

Metadata

Obrázky

Marketplace používá následující ikony:

Kategorie

Každá položka z Marketplace by měla být označená kategorií, která určuje, kde se položka v uživatelském rozhraní portálu zobrazuje. Můžete si vybrat jednu z existujících kategorií ve službě Azure Stack Hub (Výpočetní prostředky, Data a úložiště atd.) nebo zvolit novou.

Odkazy

Každá položka z Marketplace může obsahovat různé odkazy na další obsah. Odkazy jsou zadané jako seznam názvů a identifikátorů URI:

Další vlastnosti

Kromě předchozích metadat můžou autoři z Marketplace poskytovat vlastní data páru klíč/hodnota v následující podobě:

Sanitizace HTML

Pro jakékoli pole, které povoluje HTML, jsou povoleny následující prvky a atributy:

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

Referenční informace: Uživatelské rozhraní položek Marketplace

Ikony a text pro položky Marketplace, jak je vidět na portálu Azure Stack Hub, jsou následující.

Okno Vytvořit

Okno Podrobnosti o položce Marketplace

Další kroky

• Přehled marketplace služby Azure Stack Hub
• Stažení položek z Marketplace
• Formát a struktura šablon Azure Resource Manager