Egyéni Azure Stack Hub Marketplace-elem létrehozása és közzététele

Az Azure Stack Hub Marketplace-en közzétett minden elem az Azure Gallery Package (.azpkg) formátumot használja. Az Azure Gallery Packager eszköz lehetővé teszi egy egyéni Azure Gallery-csomag létrehozását, amelyet feltölthet az Azure Stack Hub Marketplace-be, amelyet aztán a felhasználók tölthetnek le. Az üzembe helyezési folyamat egy Azure Resource Manager-sablont használ.

Marketplace-elemek

A cikkben szereplő példák bemutatják, hogyan hozhat létre egyetlen, Windows vagy Linux típusú virtuálisgép-piactéri ajánlatot.

Előfeltételek

A virtuális gép marketplace-elemének létrehozása előtt tegye a következőket:

1. Töltse fel az egyéni virtuálisgép-rendszerképet az Azure Stack Hub portálra a Virtuálisgép-rendszerkép hozzáadása az Azure Stack Hubhoz című cikk utasításait követve.
2. A cikkben található utasításokat követve csomagolja be a rendszerképet (hozzon létre egy .azpkg-t), és töltse fel az Azure Stack Hub Marketplace-be.

Marketplace-elem létrehozása

Egyéni marketplace-elem létrehozásához tegye a következőket:

1. Töltse le az Azure Gallery Packager eszközt:

   

2. Az eszköz .azpkg formátumú mintacsomagokat tartalmaz, amelyeket először ki kell nyerni. A fájlkiterjesztéseket átnevezheti ".azpkg" névről ".zip" névre, vagy használhat egy tetszőleges archiváló eszközt:

   

3. A kinyerés után a .zip fájl tartalmazza az elérhető Linux- vagy Windows Azure-Resource Manager-sablonokat. Újra felhasználhatja az előre elkészített Resource Manager sablonokat, és módosíthatja a megfelelő paramétereket az Elem termékadataival, amelyeket az Azure Stack Hub portálon fog megjeleníteni. Vagy újra felhasználhatja az .azpkg fájlt, és kihagyhatja a következő lépéseket a saját katalóguscsomag testreszabásához.

4. Hozzon létre egy Azure Resource Manager-sablont, vagy használja a Windowshoz/Linuxhoz készült mintasablonokat. Ezek a mintasablonok az 1. lépésben letöltött .zip csomagkezelő eszközben találhatók. Használhatja a sablont és módosíthatja a szövegmezőket, vagy letölthet egy előre konfigurált sablont a GitHubról. További információk az Azure Resource Manager-sablonokról: Azure Resource Manager-sablonok.

5. A Katalógus csomagnak a következő struktúrát kell tartalmaznia:

   

6. Cserélje le a Manifest.json sablonban a következő kiemelt értékeket (számokat) az egyéni rendszerkép feltöltésekor megadott értékre.

   Megjegyzés

   Soha ne kódjon titkos kódokat, például termékkulcsokat, jelszót vagy ügyfélazonosításra alkalmas adatokat az Azure Resource Manager sablonban. A sablon JSON-fájljai anélkül érhetők el, hogy hitelesítésre van szükség a katalógusban való közzététel után. Tárolja az összes titkos kódot Key Vault, és hívja meg őket a sablonból.

   Javasoljuk, hogy a saját egyéni sablon közzététele előtt próbálja meg az adott módon közzétenni a mintát, és győződjön meg arról, hogy működik a környezetben. Ha ellenőrizte, hogy ez a lépés működik, törölje a mintát a katalógusból, és végezze el az iteratív módosításokat, amíg meg nem elégedett az eredménnyel.

   Az alábbi sablon a Manifest.json fájl mintája:

   {
      "$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"
            }]
       }]
   }
   

   Az alábbi lista az előző számozott értékeket ismerteti a példasablonban:

   • (1) - Az ajánlat neve.
   • (2) – A közzétevő neve szóköz nélkül.
   • (3) – A sablon verziója szóköz nélkül.
   • (4) – Az ügyfelek által látott név.
   • (5) – A közzétevő neve, amelyet az ügyfelek látnak.
   • (6) - A kiadó hivatalos neve.
   • (7) – Az egyes ikonok elérési útja és neve.

7. Az ms-resource mezőre hivatkozó összes mező esetében módosítania kell a megfelelő értékeket a strings/resources.json fájlban:

   {
   "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. Az üzembehelyezési sablonok fájlstruktúrája a következőképpen jelenik meg:

   

   Cserélje le a createuidefinition.json fájlban lévő kép értékeit az egyéni rendszerkép feltöltésekor megadott értékre.

9. Az erőforrás sikeres üzembe helyezésének biztosításához tesztelje a sablont az Azure Stack Hub API-kkal.

10. Ha a sablon egy virtuálisgép-rendszerképre támaszkodik, kövesse az utasításokat , és adjon hozzá egy virtuálisgép-rendszerképet az Azure Stack Hubhoz.

11. Mentse az Azure Resource Manager-sablont a /Contoso.TodoList/DeploymentTemplates/ mappába.

12. Válassza ki a Marketplace-elem ikonjait és szövegét. Ikonok hozzáadása az Ikonok mappához, és szöveg hozzáadása az erőforrások fájlhoz a Sztringek mappában. A kis, közepes, nagy és széles elnevezési konvenciót használja az ikonokhoz. Ezeknek a méreteknek a részletes leírását a Marketplace elem felhasználói felületének referenciájában találja.

    Megjegyzés

    A Marketplace-elem megfelelő felépítéséhez mind a négy ikonméretre (kicsi, közepes, nagy, széles) szükség van.

13. A Manifest.json fájl további módosításaiért lásd : Referencia: Marketplace-elem jegyzékfájlja.json.

14. Amikor befejezte a fájlok módosítását, konvertálja .azpkg fájllá. Az átalakítást a AzureGallery.exe eszközzel és a korábban letöltött mintagyűjtemény-csomaggal hajthatja végre. Futtassa az alábbi parancsot:

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

    Megjegyzés

    A kimeneti elérési út tetszőleges elérési út lehet, és nem kell a C: meghajtó alatt lennie. A manifest.json fájl és a kimeneti csomag teljes elérési útjának azonban léteznie kell. Ha például a kimeneti elérési út , C:\<path>\galleryPackageName.azpkgakkor a mappának C:\<path> léteznie kell.

Marketplace-elem közzététele

Az modulok

1. A PowerShell vagy a Azure Storage Explorer használatával feltöltheti Marketplace-elemét (.azpkg) az Azure Blob Storage-ba. Feltölthet a helyi Azure Stack Hub-tárolóba, vagy feltöltheti az Azure Storage-ba, amely a csomag ideiglenes helye. Győződjön meg arról, hogy a blob nyilvánosan elérhető.

2. A katalóguscsomag Azure Stack Hubba való importálásához az első lépés az, hogy távolról csatlakozik (RDP) az ügyfél virtuális gépéhez, hogy az imént létrehozott fájlt átmásolja az Azure Stack Hubra.

3. Környezet hozzáadása:

   $ArmEndpoint = "https://adminmanagement.local.azurestack.external"
   Add-AzEnvironment -Name "AzureStackAdmin" -ArmEndpoint $ArmEndpoint
   Connect-AzAccount -EnvironmentName "AzureStackAdmin"
   

4. Futtassa a következő szkriptet az erőforrás katalógusba való importálásához:

   Add-AzsGalleryItem -GalleryItemUri `
   https://sample.blob.core.windows.net/<temporary blob name>/<offerName.publisherName.version>.azpkg -Verbose
   

   Ha hibát tapasztal az Add-AzsGalleryItem futtatásakor, előfordulhat, hogy a gallery.admin modul két verziója van telepítve. Távolítsa el a modul összes verzióját, és telepítse a legújabb verziót. A PowerShell-modulok eltávolításának lépéseiért lásd: Az Azure Stack Hub PowerShell-modulok meglévő verzióinak eltávolítása.

5. Ellenőrizze, hogy van-e érvényes Tárfiókja, amely elérhető az elem tárolásához. Az értéket az GalleryItemURI Azure Stack Hub felügyeleti portálján szerezheti be. Válassza a Storage-fiók –> Blob tulajdonságai –> URL-cím lehetőséget az .azpkg kiterjesztéssel. A tárfiók csak ideiglenesen használható a piactéren való közzétételhez.

   Miután befejezte a katalóguscsomagot, és feltöltötte azt az Add-AzsGalleryItem paranccsal, az egyéni virtuális gépnek meg kell jelennie a Marketplace-en és az Erőforrás létrehozása nézetben is. Vegye figyelembe, hogy az egyéni katalóguscsomag nem látható a Marketplace Managementben.

   

6. Miután az elem sikeresen közzé lett téve a piactéren, törölheti a tartalmat a tárfiókból.

   A katalógus összes alapértelmezett összetevője és az egyéni katalógusösszetevők mostantól hitelesítés nélkül is elérhetők az alábbi URL-címek alatt:

   • https://galleryartifacts.adminhosting.[Region].[externalFQDN]/artifact/20161101/[TemplateName]/DeploymentTemplates/Template.json
   • https://galleryartifacts.hosting.[Region].[externalFQDN]/artifact/20161101/[TemplateName]/DeploymentTemplates/Template.json

7. Marketplace-elemet a Remove-AzGalleryItem parancsmaggal távolíthat el. Például:

   Remove-AzsGalleryItem -Name <Gallery package name> -Verbose
   

Megjegyzés

Előfordulhat, hogy a Marketplace felhasználói felülete hibaüzenetet jelenít meg egy elem eltávolítása után. A hiba kijavításához kattintson a Beállítások elemre a portálon. Ezután válassza a Módosítások elvetése lehetőséget a Portál testreszabása területen.

AzureRM-modulok

1. A PowerShell vagy a Azure Storage Explorer használatával feltöltheti Marketplace-elemét (.azpkg) az Azure Blob Storage-ba. Feltölthet a helyi Azure Stack Hub-tárolóba, vagy feltöltheti az Azure Storage-ba, amely a csomag ideiglenes helye. Győződjön meg arról, hogy a blob nyilvánosan elérhető.

2. A katalóguscsomag Azure Stack Hubba való importálásához az első lépés az, hogy távolról csatlakozik (RDP) az ügyfél virtuális gépéhez, hogy az imént létrehozott fájlt átmásolja az Azure Stack Hubra.

3. Környezet hozzáadása:

   $ArmEndpoint = "https://adminmanagement.local.azurestack.external"
   Add-AzureRMEnvironment -Name "AzureStackAdmin" -ArmEndpoint $ArmEndpoint
   Add-AzureRMAccount -EnvironmentName "AzureStackAdmin"
   

4. Futtassa a következő szkriptet az erőforrás katalógusba való importálásához:

   Add-AzsGalleryItem -GalleryItemUri `
   https://sample.blob.core.windows.net/<temporary blob name>/<offerName.publisherName.version>.azpkg -Verbose
   

   Ha hibát tapasztal az Add-AzsGalleryItem futtatásakor, előfordulhat, hogy a gallery.admin modul két verziója van telepítve. Távolítsa el a modul összes verzióját, és telepítse a legújabb verziót. A PowerShell-modulok eltávolításának lépéseiért lásd: Az Azure Stack Hub PowerShell-modulok meglévő verzióinak eltávolítása.

5. Ellenőrizze, hogy van-e érvényes Tárfiókja, amely elérhető az elem tárolásához. Az értéket az GalleryItemURI Azure Stack Hub felügyeleti portálján szerezheti be. Válassza a Storage-fiók –> Blob tulajdonságai –> URL-cím lehetőséget az .azpkg kiterjesztéssel. A tárfiók csak ideiglenesen használható a piactéren való közzétételhez.

   Miután befejezte a katalóguscsomagot, és feltöltötte azt az Add-AzsGalleryItem paranccsal, az egyéni virtuális gépnek meg kell jelennie a Marketplace-en és az Erőforrás létrehozása nézetben is. Vegye figyelembe, hogy az egyéni katalóguscsomag nem látható a Marketplace Managementben.

   

6. Miután az elem sikeresen közzé lett téve a piactéren, törölheti a tartalmat a tárfiókból.

   A katalógus összes alapértelmezett összetevője és az egyéni katalógusösszetevők mostantól hitelesítés nélkül is elérhetők az alábbi URL-címek alatt:

   • https://galleryartifacts.adminhosting.[Region].[externalFQDN]/artifact/20161101/[TemplateName]/DeploymentTemplates/Template.json
   • https://galleryartifacts.hosting.[Region].[externalFQDN]/artifact/20161101/[TemplateName]/DeploymentTemplates/Template.json

7. Marketplace-elemet a Remove-AzGalleryItem parancsmaggal távolíthat el. Például:

   Remove-AzsGalleryItem -Name <Gallery package name> -Verbose
   

Megjegyzés

Előfordulhat, hogy a Marketplace felhasználói felülete hibaüzenetet jelenít meg egy elem eltávolítása után. A hiba kijavításához kattintson a Beállítások elemre a portálon. Ezután válassza a Módosítások elvetése lehetőséget a Portál testreszabása területen.

Referencia: Marketplace item manifest.json

Identitásadatok

Name	Kötelező	Típus	Korlátozások	Leírás
Name (Név)	X	Sztring	[A-Za-z0-9]+
Publisher	X	Sztring	[A-Za-z0-9]+
Verzió	X	Sztring	SemVer v2

Metaadatok

Name	Kötelező	Típus	Korlátozások	Description
DisplayName	X	Sztring	Javaslat 80 karakterre	Előfordulhat, hogy a portál nem megfelelően jeleníti meg az elem nevét, ha az hosszabb 80 karakternél.
PublisherDisplayName	X	Sztring	30 karakteres javaslat	Előfordulhat, hogy a portál nem megfelelően jeleníti meg a közzétevő nevét, ha az hosszabb 30 karakternél.
PublisherLegalName	X	Sztring	Legfeljebb 256 karakter
Összefoglalás	X	Sztring	60–100 karakter
LongSummary	X	Sztring	140–256 karakter	Az Azure Stack Hubban még nem alkalmazható.
Description	X	HTML	500–5000 karakter

Képek

A Marketplace az alábbi ikonokat használja:

Name	Szélesség	Magasság	Jegyzetek
Széles	255 képpont	115 képpont	Mindig kötelező
Nagy	115 képpont	115 képpont	Mindig kötelező
Közepes	90 képpont	90 képpont	Mindig kötelező
Kicsi	40 képpont	40 képpont	Mindig kötelező
Képernyőfelvétel	533 képpont	324 képpont	Választható

Kategóriák

Minden Marketplace-elemet meg kell címkézni egy kategóriával, amely azonosítja, hogy hol jelenik meg az elem a portál felhasználói felületén. Választhat az Azure Stack Hub meglévő kategóriái közül (számítás, adatok + tárolás stb.), vagy választhat egy újat.

Hivatkozások

Minden Marketplace-elem különböző hivatkozásokat tartalmazhat további tartalmakra. A hivatkozások nevek és URI-k listájaként vannak megadva:

Name	Kötelező	Típus	Korlátozások	Description
DisplayName	X	Sztring	Legfeljebb 64 karakter hosszúságú lehet.
Uri	X	URI

További tulajdonságok

Az előző metaadatok mellett a Marketplace-szerzők az alábbi formában adhatnak meg egyéni kulcs-/értékpár-adatokat:

Name	Kötelező	Típus	Korlátozások	Description
DisplayName	X	Sztring	Legfeljebb 25 karakter hosszúságú lehet.
Érték	X	Sztring	Legfeljebb 30 karakter hosszúságú lehet.

HTML-tisztítás

A HTML-t engedélyező mezők esetében a következő elemek és attribútumok engedélyezettek:

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

Referencia: Marketplace-elem felhasználói felülete

Az Azure Stack Hub portálon látható Marketplace-elemek ikonjai és szövegei a következők.

A Create (Létrehozás) panel

Marketplace-elem részleteinek panelje

Következő lépések

• Az Azure Stack Hub Marketplace áttekintése
• Marketplace-elemek letöltése
• Az Azure Resource Manager-sablonok formázása és szerkezete