Egyéni Azure Stack hub Marketplace-elemek létrehozása és közzétételeCreate and publish a custom Azure Stack Hub Marketplace item

Az Azure Stack hub piactéren közzétett minden elem az Azure Gallery-csomag (. azpkg) formátumát használja.Every item published to the Azure Stack Hub Marketplace uses the Azure Gallery Package (.azpkg) format. Az Azure Gallery Packager eszköz lehetővé teszi, hogy egyéni Azure Gallery-csomagot hozzon létre, amelyet feltöltheti a Azure stack hub piactérre, amelyet aztán a felhasználók is letölthetnek.The Azure Gallery Packager tool enables you to create a custom Azure Gallery package that you can upload to the Azure Stack Hub Marketplace, which can then be downloaded by users. Az üzembe helyezési folyamat egy Azure Resource Manager sablont használ.The deployment process uses an Azure Resource Manager template.

Marketplace-elemekMarketplace items

A jelen cikkben szereplő példák bemutatják, hogyan hozhat létre Windows vagy Linux típusú, egyetlen virtuálisgép-Piactéri ajánlatot.The examples in this article show how to create a single VM Marketplace offer, of type Windows or Linux.

ElőfeltételekPrerequisites

A virtuális gép Marketplace-elemének létrehozása előtt tegye a következőket:Before creating the VM marketplace item, do the following:

  1. Töltse fel az egyéni virtuálisgép-rendszerképet a Azure Stack hub-portálra, és kövesse a virtuálisgép- rendszerkép hozzáadása Azure stack hub-hozcímű témakör útmutatását.Upload the custom VM image to the Azure Stack Hub portal, following the instructions in Add a VM image to Azure Stack Hub.
  2. A cikk utasításait követve csomagolja ki a rendszerképet (hozzon létre egy. azpkg), és töltse fel az Azure Stack hub piactérre.Follow the instructions in this article to package the image (create an .azpkg) and upload it to the Azure Stack Hub Marketplace.

Piactér-elemek létrehozásaCreate a Marketplace item

Egyéni Piactéri elem létrehozásához tegye a következőket:To create a custom marketplace item, do the following:

  1. Töltse le az Azure Gallery Packager eszközt és a minta Azure stack hub Gallery csomagot.Download the Azure Gallery Packager tool and the sample Azure Stack Hub gallery package. Ez a letöltés egyéni virtuálisgép-sablonokat tartalmaz.This download includes custom VM templates. Bontsa ki a. zip fájlt, és az Egyéni virtuális gépek mappa alatt használhatja a Linux vagy az elérhető Windows-sablonokat.Extract the .zip file, and under the folder Custom VMs, you can use either the Linux or the Windows templates that are available. Dönthet úgy, hogy újra felhasználja az előre elkészített sablonokat, és módosítja a megfelelő paramétereket az Azure Stack hub-portálon megjelenő elem termék adataival.You can decide to re-use the pre-made templates and modify the respective parameters with the product details of the item that you will show on your Azure Stack Hub portal. Vagy egyszerűen újra használhatja a. azpkg fájlt, és kihagyhatja a következő lépéseket a saját katalógus-csomag testreszabásához.Or, you can simply re-use the .azpkg file available and skip the following steps to customize your own gallery package.

  2. Hozzon létre egy Azure Resource Manager sablont, vagy használja a Windows/Linux rendszerhez készült minta sablonokat.Create an Azure Resource Manager template or use our sample templates for Windows/Linux. Ezek a sablonok az 1. lépésben letöltött csomagoló Tool. zip fájlban találhatók.These sample templates are provided in the packager tool .zip file you downloaded in step 1. Használhatja a sablont, és módosíthatja a szövegmezőket, vagy letöltheti az előre konfigurált sablont a GitHubról.You can either use the template and change the text fields, or you can download a pre-configured template from GitHub. Azure Resource Manager-sablonokkal kapcsolatos további információkért lásd: Azure Resource Manager sablonok.For more information about Azure Resource Manager templates, see Azure Resource Manager templates.

  3. A katalógus csomagjának a következő struktúrát kell tartalmaznia:The Gallery package should contain the following structure:

    Képernyőfelvétel a katalógus-csomag struktúrájáról

    A központi telepítési sablonok fájljának szerkezete a következőképpen jelenik meg:The deployment templates file structure appears as follows:

    Képernyőfelvétel a telepítési sablonok struktúrájáról

  4. Cserélje le a következő Kiemelt értékeket (számokat) a sablon Manifest.jsaz Egyéni rendszerkép feltöltésekormegadott értékre.Replace the following highlighted values (those with numbers) in the Manifest.json template with the value that you provided when uploading your custom image.

    Megjegyzés

    A Azure Resource Manager sablonban soha ne végezzen semmilyen titkos kulcsot, például a termékkulcsot, a jelszót vagy az ügyfél által azonosítható adatokat.Never hard code any secrets such as product keys, password, or any customer identifiable information in the Azure Resource Manager template. A sablon JSON-fájljai a katalógusban közzétett egyszeri hitelesítés nélkül érhetők el.Template JSON files are accessible without the need for authentication once published in the gallery. Tárolja Key Vault összes titkát, és hívja meg őket a sablonból.Store all secrets in Key Vault and call them from within the template.

    Javasoljuk, hogy a saját egyéni sablon közzététele előtt próbálja meg közzétenni a mintát, és ellenőrizze, hogy működik-e a környezetben.It's recommended that before publishing your own custom template, you try to publish the sample as-is and make sure it works in your environment. Miután ellenőrizte, hogy ez a lépés működik, törölje a mintát a katalógusból, és ismételje meg az ismétlődő módosításokat, amíg az eredmény nem teljesül.Once you've verified this step works, then delete the sample from gallery and make iterative changes until you are satisfied with the result.

    A következő sablon a fájl Manifest.jsmintája:The following template is a sample of the Manifest.json file:

    {
       "$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élda sablon előző számozott értékeit ismerteti:The following list explains the preceding numbered values in the example template:

    • (1) – az ajánlat neve.(1) - The name of the offer.
    • (2) – a közzétevő neve, szóköz nélkül.(2) - The name of the publisher, without a space.
    • (3) – a sablon verziója szóköz nélkül.(3) - The version of your template, without a space.
    • (4) – az ügyfelek által megjelenített név.(4) - The name that customers see.
    • (5) – a közzétevő neve, amelyet az ügyfelek látnak.(5) - The publisher name that customers see.
    • (6) – a közzétevő jogi neve.(6) - The publisher legal name.
    • (7) – az egyes ikonok elérési útja és neve.(7) - The path and name for each icon.
  5. Az MS-Resource értékre hivatkozó összes mező esetében módosítania kell a megfelelő értékeket a karakterlánc/resources.js fájlon belül:For all fields referring to ms-resource, you must change the appropriate values inside the strings/resources.json file:

    {
    "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"
    }
    
  6. Az erőforrás sikeres üzembe helyezésének biztosításához tesztelje a sablont az Azure stack hub API-kkal.To ensure that the resource can be deployed successfully, test the template with the Azure Stack Hub APIs.

  7. Ha a sablon egy virtuálisgép-(VM-) rendszerképre támaszkodik, kövesse az utasításokat, és adjon hozzá egy VM-rendszerképet Azure stack hubhoz.If your template relies on a virtual machine (VM) image, follow the instructions to add a VM image to Azure Stack Hub.

  8. Mentse a Azure Resource Manager sablont a /contoso.TodoList/DeploymentTemplates/ mappába.Save your Azure Resource Manager template in the /Contoso.TodoList/DeploymentTemplates/ folder.

  9. Válassza ki a Marketplace-elem ikonjait és szövegét.Choose the icons and text for your Marketplace item. Adjon hozzá ikonokat az ikonok mappához, és adjon hozzá szöveget az erőforrások fájlhoz a karakterláncok mappában.Add icons to the Icons folder, and add text to the resources file in the Strings folder. Az ikonokhoz használjon kis, közepes, nagy és széles körű elnevezési konvenciót.Use the small, medium, large, and wide naming convention for icons. A méretek részletes leírását a Marketplace-elemek felhasználói felületének dokumentációjában tekintheti meg.See the Marketplace item UI reference for a detailed description of these sizes.

    Megjegyzés

    A Piactéri elem megfelelő létrehozásához mind a négy ikon mérete (kis, közepes, nagy, széles) szükséges.All four icon sizes (small, medium, large, wide) are required for building the Marketplace item correctly.

  10. A Manifest.jstovábbi szerkesztését a következő témakörben tekintheti meg : a Piactéri elem manifest.js:.For any further edits to Manifest.json, see Reference: Marketplace item manifest.json.

  11. Amikor befejezte a fájlok módosítását, alakítsa át egy. azpkg fájlba.When you finish modifying your files, convert it to an .azpkg file. A konverziót a AzureGallery.exe eszköz és a korábban letöltött minta-katalógus használatával hajtja végre.You perform the conversion using the AzureGallery.exe tool and the sample gallery package you downloaded previously. Futtassa az alábbi parancsot:Run the following command:

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

    Megjegyzés

    A kimeneti elérési út bármely választott útvonal lehet, és nem kell a C: meghajtó alatt lennie.The output path can be any path you choose, and does not have to be under the C: drive. A fájl manifest.jsának teljes elérési útját és a kimeneti csomagot azonban léteznie kell.However, the full path to both the manifest.json file, and the output package, must exist. Ha például a kimeneti elérési út C:\<path>\galleryPackageName.azpkg , akkor a mappának C:\<path> léteznie kell.For example, if the output path is C:\<path>\galleryPackageName.azpkg, the folder C:\<path> must exist.

Piactér-elemek közzétételePublish a Marketplace item

  1. Az Azure Blob Storage-ba való feltöltéséhez használja a PowerShellt vagy a Azure Storage Explorer.Use PowerShell or Azure Storage Explorer to upload your Marketplace item (.azpkg) to Azure Blob storage. Feltöltheti a helyi Azure Stack hub tárolóba, vagy feltöltheti az Azure Storage-ba, amely a csomag ideiglenes helye.You can upload to local Azure Stack Hub storage or upload to Azure Storage, which is a temporary location for the package. Győződjön meg arról, hogy a blob nyilvánosan elérhető.Make sure that the blob is publicly accessible.

  2. Ha a katalógus-csomagot Azure Stack hubhoz szeretné importálni, az első lépés az ügyfél virtuális géphez való távoli kapcsolódás (RDP), hogy az imént létrehozott fájlt a Azure Stack hubhoz másolja.To import the gallery package into Azure Stack Hub, the first step is to remotely connect (RDP) to the client VM, in order to copy the file you just created to your Azure Stack Hub.

  3. Környezet hozzáadása:Add a context:

    $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 történő importálásához:Run the following script to import the resource into your gallery:

    Add-AzsGalleryItem -GalleryItemUri `
    https://sample.blob.core.windows.net/<temporary blob name>/<offerName.publisherName.version>.azpkg -Verbose
    
  5. Ellenőrizze, hogy rendelkezik-e az elemek tárolására elérhető érvényes Storage-fiókkal.Verify that you have a valid Storage account that is available to store your item. Az értéket lekérheti GalleryItemURI az Azure stack hub felügyeleti portálján.You can get the GalleryItemURI value from the Azure Stack Hub administrator portal. Válassza ki a Storage-fiók-> blob tulajdonságai-> URL-címet a. azpkg kiterjesztéssel.Select Storage account -> Blob Properties -> URL, with the extension .azpkg. A Storage-fiók csak ideiglenes használatra szolgál, hogy közzé lehessen tenni a piactéren.The storage account is only for temporary use, in order to publish to the marketplace.

    A katalógus-csomag befejezése és az Add-AzsGalleryItem használatával való feltöltése után az egyéni virtuális gép ekkor megjelenik a piactéren, valamint az erőforrás létrehozása nézetben.After completing your gallery package and uploading it using Add-AzsGalleryItem, your custom VM should now appear on the Marketplace as well as in the Create a resource view. Vegye figyelembe, hogy az egyéni katalógus-csomag nem látható a piactér-kezelésben.Note that the custom gallery package is not visible in Marketplace Management.

    Egyéni Marketplace-elemek feltöltveCustom marketplace item uploaded

  6. Miután sikeresen közzétette az elemet a piactéren, törölheti a tartalmat a Storage-fiókból.Once your item has been successfully published to the marketplace, you can delete the content from the storage account.

    Az alapértelmezett katalógus-összetevők é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 keresztül:All default gallery artifacts and your custom gallery artifacts are now accessible without authentication under the following URLs:

    • https://galleryartifacts.adminhosting.[Region].[externalFQDN]/artifact/20161101/[TemplateName]/DeploymentTemplates/Template.json
    • https://galleryartifacts.hosting.[Region].[externalFQDN]/artifact/20161101/[TemplateName]/DeploymentTemplates/Template.json
  7. A Piactéri elemeket a Remove-AzGalleryItem parancsmag használatával távolíthatja el.You can remove a Marketplace item by using the Remove-AzGalleryItem cmdlet. Például:For example:

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

Megjegyzés

Előfordulhat, hogy a piactér felhasználói felülete hibát jelez az elemek eltávolítása után.The Marketplace UI may show an error after you remove an item. A hiba elhárításához kattintson a Beállítások elemre a portálon.To fix the error, click Settings in the portal. Ezután válassza a módosítások elvetése a portál testreszabása alatt lehetőséget.Then, select Discard modifications under Portal customization.

Hivatkozás: Marketplace-elem manifest.jsbekapcsolvaReference: Marketplace item manifest.json

Azonosító adatokIdentity information

NameName KötelezőRequired TípusType KorlátozásokConstraints LeírásDescription
NévName XX SztringString [A-Za-z0-9] +[A-Za-z0-9]+
PublisherPublisher XX SztringString [A-Za-z0-9] +[A-Za-z0-9]+
VerzióVersion XX SztringString SemVer v2SemVer v2

MetaadatokMetadata

NameName KötelezőRequired TípusType KorlátozásokConstraints LeírásDescription
DisplayNameDisplayName XX SztringString 80 karakteres javaslatRecommendation of 80 characters Előfordulhat, hogy a portál nem jeleníti meg helyesen az elemnév nevét, ha az 80 karakternél hosszabb.The portal might not display your item name correctly if it's longer than 80 characters.
PublisherDisplayNamePublisherDisplayName XX SztringString 30 karakterből álló javaslatRecommendation of 30 characters Előfordulhat, hogy a portál nem jeleníti meg megfelelően a közzétevő nevét, ha az hosszabb 30 karakternél.The portal might not display your publisher name correctly if it's longer than 30 characters.
PublisherLegalNamePublisherLegalName XX SztringString Legfeljebb 256 karakterMaximum of 256 characters
ÖsszefoglalásSummary XX SztringString 60 – 100 karakter60 to 100 characters
LongSummaryLongSummary XX SztringString 140 – 256 karakter140 to 256 characters Azure Stack központban még nem alkalmazható.Not yet applicable in Azure Stack Hub.
LeírásDescription XX HTMLHTML 500 – 5 000 karakter500 to 5,000 characters

KépekImages

A piactér a következő ikonokat használja:The Marketplace uses the following icons:

NameName SzélességWidth MagasságHeight JegyzetekNotes
SzélesWide 255 px255 px 115 px115 px Mindig szükségesAlways required
NagyLarge 115 px115 px 115 px115 px Mindig szükségesAlways required
KözepesMedium 90 px90 px 90 px90 px Mindig szükségesAlways required
KicsiSmall 40 px40 px 40 px40 px Mindig szükségesAlways required
KépernyőfelvételScreenshot 533 px533 px 324 px324 px VálaszthatóOptional

KategóriákCategories

Minden Piactéri elemnek címkével kell rendelkeznie, amely meghatározza, hogy az elem hol jelenik meg a portál felhasználói felületén.Each Marketplace item should be tagged with a category that identifies where the item appears on the portal UI. Kiválaszthatja Azure Stack hub egyik meglévő kategóriáját (számítás, adatok + tárolás stb.), vagy választhat egy újat is.You can choose one of the existing categories in Azure Stack Hub (Compute, Data + Storage, and so on) or choose a new one.

Minden Piactéri tétel tartalmazhat további tartalmakra mutató hivatkozásokat.Each Marketplace item can include various links to additional content. A hivatkozások nevek és URI-k listájaként vannak megadva:The links are specified as a list of names and URIs:

NameName KötelezőRequired TípusType KorlátozásokConstraints LeírásDescription
DisplayNameDisplayName XX SztringString Legfeljebb 64 karakter hosszú lehet.Maximum of 64 characters.
URIUri XX URIURI

További tulajdonságokAdditional properties

Az előző metaadatok mellett a piactér-szerzők az alábbi formában is biztosíthatnak egyéni kulcs/érték párokat:In addition to the preceding metadata, Marketplace authors can provide custom key/value pair data in the following form:

NameName KötelezőRequired TípusType KorlátozásokConstraints LeírásDescription
DisplayNameDisplayName XX SztringString Legfeljebb 25 karakter hosszú lehet.Maximum of 25 characters.
ÉrtékValue XX SztringString Legfeljebb 30 karakter.Maximum of 30 characters.

HTML-tisztításHTML sanitization

A HTML-t engedélyező mezők esetében a következő elemek és attribútumok engedélyezettek:For any field that allows HTML, the following elements and attributes are allowed:

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

Hivatkozás: Marketplace-elemek felhasználói felületeReference: Marketplace item UI

A Marketplace-elemek ikonjai és szövege a Azure Stack hub-portálon látható módon történik.Icons and text for Marketplace items as seen in the Azure Stack Hub portal are as follows.

A Create (Létrehozás) panelCreate blade

Panel létrehozása – Azure Stack hub Marketplace-elemek

Marketplace-elemek részletei panelMarketplace item details blade

Azure Stack hub Marketplace-elemek részletei panel

Következő lépésekNext steps