Egyéni marketplace-elem Azure Stack Hub közzététele

A piactéren közzétett Azure Stack Hub 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ához, amelyet feltölthet az Azure Stack Hub Marketplace-be, amelyet aztán a felhasználók letölthetnek. Az üzembe helyezési folyamat egy Azure Resource Manager használ.

Marketplace-elemek

A cikkben található példák bemutatják, hogyan hozhat létre egyetlen virtuálisgép-piactéri ajánlatot, amely Windows Linux.

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 a Azure Stack Hub portálra a Virtuálisgép-rendszerkép hozzáadása aAzure Stack Hub.
  2. A cikkben található utasításokat követve csomagolja be a rendszerképet (hozzon létre egy .azpkg fájlt), és töltse fel a 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:

    Katalóguscsomagoló

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

    Mintacsomagok

  3. A kicsomagolt fájl .zip tartalmazza az elérhető Linux- Windows Azure Resource Manager-sablonokat. Újból felhasználhatja az előre Resource Manager sablonokat, és módosíthatja a megfelelő paramétereket a termék adataival a saját portálján Azure Stack Hub elem adataival. Másik megoldásként ú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 Azure Resource Manager sablont, vagy használja a mintasablonokat a Windows/Linuxhoz. Ezek a mintasablonok az 1. lépésben letöltött .zip a csomagkezelő eszközben biztosítanak. Használhatja a sablont, és módosíthatja a szövegmezőket, vagy letölthet egy előre konfigurált sablont a GitHub. A sablonokkal kapcsolatos további Azure Resource Manager lásd: Azure Resource Manager sablonok.

  5. A katalóguscsomagnak a következő struktúrát kell tartalmaznia:

    Képernyőkép a katalógus csomagstruktúráról

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

    Megjegyzés

    Soha ne kódolt titkos kulcsokat, például termékkulcsokat, jelszót vagy ügyfélazonosításra alkalmas adatokat a Azure Resource Manager sablonban. A sablon JSON-fájljai anélkül érhetők el, hogy hitelesítésre lenne szükség a katalógusban való közzététel után. Tárolja az összes titkos 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 a saját kezűleg közzétenni a mintát, és ellenőrizze, hogy működik-e az Ön környezetében. Miután meggyőződött arról, hogy ez a lépés működik, törölje a mintát a katalógusból, és iteratív módosításokat kell végrehajtotta, amíg elégedett az eredménnyel.

    Az alábbi sablon egy példa a Manifest.json fájlra:

    {
       "$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 a példasablon előző számolt értékeit ismerteti:

    • (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 számára látható név.
    • (5) – Az ügyfelek számára látható közzétevő neve.
    • (6) – A közzétevő jogi neve.
    • (7) – Az egyes ikonok elérési útja és neve.
  7. Az ms-resourcefájlra hivatkozó összes mező esetén 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 üzembe helyezési sablonok fájlstruktúrája a következőképpen jelenik meg:

    Üzembehelyezési sablonok

    Cserélje le a createuidefinition.json fájlban található 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 a Azure Stack Hub API-okkal.

  10. Ha a sablon virtuálisgép-rendszerképre támaszkodik, kövesse az utasításokat a virtuálisgép-rendszerkép hozzáadásához a Azure Stack Hub.

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

  12. Válassza ki a Marketplace-elem ikonjait és szövegét. Adjon hozzá ikonokat az Ikonok mappához, és adjon hozzá szöveget a Strings (Sztringek) mappában található resources fájlhoz. Az ikonokhozhasználja a kis, közepes,nagyés széles elnevezési konvenciót. A méretek részletes leírását a Marketplace-elem felhasználói felületének referenciája tartalmazza.

    Megjegyzés

    Mind a négy ikonméret (kicsi, közepes, nagy, széles) szükséges a Marketplace-elem megfelelő építéséhez.

  13. A Manifest.jsontovábbi szerkesztéséhez lásd: Referencia: Marketplace-elem manifest.json.

  14. Amikor végzett a fájlok módosításával, alakítsa át .azpkg fájlvá. Az átalakítást aAzureGallery.exe eszköz és a korábban letöltött katalógusminta-csomag használatával végezheti el. Futtassa az alábbi parancsot:

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

    Megjegyzés

    A kimeneti útvonal bármilyen elérési út lehet, és nem kell a C: meghajtó alatt lennie. Azonban a manifest.json fájl és a kimeneti csomag teljes elérési útja is léteznie kell. Ha például a kimeneti elérési út , a C:\<path>\galleryPackageName.azpkg mappának C:\<path> léteznie kell.

Marketplace-elem közzététele

  1. A PowerShell vagy Azure Storage Explorer marketplace-elem (.azpkg) feltöltése az Azure Blob Storage-ba. Feltölthet egy helyi tárterületre Azure Stack Hub feltölthet az Azure Storage, amely a csomag ideiglenes helye. Győződjön meg arról, hogy a blob nyilvánosan elérhető.

  2. A katalóguscsomag importálása Azure Stack Hub első lépése az ügyfél virtuális géphez való távoli csatlakozás (RDP), hogy az újonnan létrehozott fájlt a saját Azure Stack Hub.

  3. Környezet hozzáadása:

    $ArmEndpoint = "https://adminmanagement.local.azurestack.external"
    Add-AzEnvironment -Name "AzureStackAdmin" -ArmEndpoint $ArmEndpoint
    Connect-AzAccount -EnvironmentName "AzureStackAdmin"
    
  4. Az alábbi szkript futtatásával importálja az erőforrást a katalógusba:

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

    Ha az Add-AzsGalleryItemfuttatásakor hiba történik, előfordulhat, hogy a 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: A PowerShell-modulok Azure Stack Hub eltávolítása.

  5. Ellenőrizze, hogy van-e érvényes Storage, amely elérhető az elem tárolására. Az értéket a felügyeleti GalleryItemURI portálon Azure Stack Hub le. Válassza Storage fiók – Blob tulajdonságai – > URLlehetőséget . Azpkg kiterjesztéssel. A tárfiók csak ideiglenes használatra van a piactéren való közzétételhez.

    A katalóguscsomag befejezése és az Add-AzsGalleryItemhasználatával való feltöltése után az egyéni virtuális gépnek most már meg kell jelenni 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-felügyeletben.

    Feltöltött egyéni Marketplace-elem –

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

    Az összes alapértelmezett katalógus-összetevő és az egyéni katalógus-összetevők mostantól hitelesítés nélkül elérhetők a következő URL-címeken:

    • https://galleryartifacts.adminhosting.[Region].[externalFQDN]/artifact/20161101/[TemplateName]/DeploymentTemplates/Template.json
    • https://galleryartifacts.hosting.[Region].[externalFQDN]/artifact/20161101/[TemplateName]/DeploymentTemplates/Template.json
  7. A Marketplace-elemet a Remove-AzGalleryItem parancsmaggal távolíthatja el. Például:

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

Megjegyzés

A Marketplace felhasználói felületén hibaüzenet jelenhet meg az elemek eltávolítása után. A hiba kijavításhoz kattintson a Gépház elemre a portálon. Ezután válassza a Módosítások elvetése lehetőséget a Portál testreszabása alatt.

Referencia: Marketplace-elem manifest.json

Identitással kapcsolatos információk

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

Metaadatok

Name Kötelező Típus Korlátozások Description
DisplayName X Sztring 80 karakteres javaslat Előfordulhat, hogy a portál nem jeleníti meg helyesen az elem nevét, ha az hosszabb 80 karakternél.
PublisherDisplayName (Közzétevőlemez neve) X Sztring 30 karakteres javaslat Előfordulhat, hogy a portál nem jeleníti meg helyesen a közzétevő nevét, ha az hosszabb 30 karakternél.
PublisherLegalName (Közzétevő neve) X Sztring Legfeljebb 256 karakter
Összefoglalás X Sztring 60–100 karakter
LongSummary (Hosszú távú) X Sztring 140–256 karakter Még nem alkalmazható a Azure Stack Hub.
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 szükséges
Nagy 115 képpont 115 képpont Mindig szükséges
Közepes 90 képpont 90 képpont Mindig szükséges
Kicsi 40 képpont 40 képpont Mindig szükséges
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, hol jelenik meg az elem a portál felhasználói felületén. Választhat egy meglévő kategóriát a Azure Stack Hub(Számítás,Adatok +Storage stb.), vagy kiválaszthat egy újat.

Minden Marketplace-elem tartalmazhat további tartalmakra mutató különböző hivatkozásokat. 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ú lehet.
Uri X URI

További tulajdonságok

A fenti metaadatok mellett a Marketplace szerzői egyéni kulcs/érték páradatokat is nyújthatnak a következő formában:

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

HTML-sanitizálás

A HTML-t megengedő mezőkhöz 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

A Marketplace-elemek ikonjai és szövegei a Azure Stack Hub a következőképpen jelennek meg.

A Create (Létrehozás) panel

A Marketplace-Azure Stack Hub létrehozása panel

Marketplace-elem részletei panel

Azure Stack Hub Marketplace elem részletei panel

Következő lépések