Erstellen und Veröffentlichen eines benutzerdefinierten Azure Stack Hub-Marketplace-Elements

Jedes im Azure Stack Hub-Marketplace veröffentlichte Element verwendet das Azure Gallery Package-Format (AZPKG). Mit dem Azure Gallery Packager-Tool können Sie ein benutzerdefiniertes Azure Gallery-Paket erstellen, das Sie in den Azure Stack Hub-Marketplace hochladen können, wo es dann von Benutzern heruntergeladen werden kann. Beim Bereitstellungsprozess wird eine Azure Resource Manager-Vorlage verwendet.

Marketplace-Elemente

In den Beispielen in diesem Artikel wird veranschaulicht, wie Sie ein einzelnes VM-Marketplace-Angebot vom Typ Windows oder Linux erstellen.

Voraussetzungen

Führen Sie die folgenden Schritte aus, bevor Sie das VM-Marketplace-Element erstellen:

1. Laden Sie das benutzerdefinierte VM-Image in das Azure Stack Hub-Portal hoch. Dabei gehen Sie nach den Anweisungen unter Hinzufügen eines VM-Images zu Azure Stack Hub vor.
2. Befolgen Sie die Anweisungen in diesem Artikel, um das Image zu verpacken (Erstellen einer AZPKG-Datei) und in den Azure Stack Hub-Marketplace hochzuladen.

Erstellen von Marketplace-Elementen

Führen Sie die folgenden Schritte aus, um ein benutzerdefiniertes Marketplace-Element zu erstellen:

1. Laden Sie das Azure Gallery Packager-Tool herunter:

   

2. Das Tool umfasst Beispielpakete im AZPKG-Format, diese müssen zunächst extrahiert werden. Sie können die Dateierweiterungen von „.azpk“ in „.zip“ umbenennen oder ein Archivierungsprogramm Ihrer Wahl verwenden:

   

3. Die in der ZIP-Datei enthaltenen Linux- oder Windows-Azure Resource Manager-Vorlagen sind nach dem Extrahieren verfügbar. Sie können die vordefinierten Resource Manager-Vorlagen wiederverwenden und die entsprechenden Parameter mit den Produktdetails des Elements ändern, das im Azure Stack Hub-Portal angezeigt wird. Sie können auch einfach die AZPKG-Datei wiederverwenden und die folgenden Schritte überspringen, um das eigene Katalogpaket anzupassen.

4. Erstellen Sie eine Azure Resource Manager Vorlage, oder verwenden Sie unsere Beispielvorlagen für Windows/Linux. Diese Beispielvorlagen werden in der ZIP-Datei des Packager-Tools bereitgestellt, die Sie in Schritt 1 heruntergeladen haben. Sie können entweder die Vorlage verwenden und die Textfelder ändern, oder Sie können eine vorkonfigurierte Vorlage von GitHub herunterladen. Weitere Informationen zu den Azure Resource Manager-Vorlagen finden Sie unter Azure Resource Manager-Vorlagen.

5. Das Katalogpaket muss die folgende Struktur aufweisen:

   

6. Ersetzen Sie die folgenden markierten Werte (mit Zahlen) in der Vorlage Manifest.json durch den Wert, den Sie beim Hochladen des benutzerdefinierten Images angegeben haben.

   Hinweis

   Führen Sie in der Azure Resource Manager-Vorlage niemals eine Hartcodierung von Geheimnissen wie Produktschlüsseln, Kennwörtern oder anderen kundenbezogenen Informationen durch. JSON-Vorlagendateien sind nach der Veröffentlichung im Katalog ohne Authentifizierung zugänglich. Speichern Sie alle Geheimnisse in Key Vault, und rufen Sie sie in der Vorlage auf.

   Es wird empfohlen, dass Sie vor dem Veröffentlichen Ihrer eigenen benutzerdefinierten Vorlage versuchen, das Beispiel unverändert zu veröffentlichen, und sicherstellen, dass es in Ihrer Umgebung funktioniert. Nachdem Sie überprüft haben, dass dieser Schritt funktioniert, löschen Sie das Beispiel aus dem Katalog, und nehmen Sie iterative Änderungen vor, bis Sie mit dem Ergebnis zufrieden sind.

   Die folgende Vorlage ist ein Beispiel für die Datei „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"
            }]
       }]
   }
   

   In der folgenden Liste werden die vorangehenden nummerierten Werte in der Beispielvorlage erläutert:

   • (1): Der Name des Angebots.
   • (2): Der Name des Herausgebers ohne Leerzeichen.
   • (3): Die Version Ihrer Vorlage ohne Leerzeichen.
   • (4): Der Name, den Kunden sehen.
   • (5): Der Herausgebername, den Kunden sehen.
   • (6): Der offizielle Firmenname des Herausgebers.
   • (7): Der Pfad und der Name für die einzelnen Symbole.

7. Für alle Felder, die auf ms-resource verweisen, müssen Sie die entsprechenden Werte in der Datei strings/resources.json ändern:

   {
   "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. Die Dateistruktur der Bereitstellungsvorlagen sieht wie folgt aus:

   

   Ersetzen Sie die Werte für das Image in der Datei createuidefinition.json durch den Wert, den Sie beim Hochladen des benutzerdefinierten Images angegeben haben.

9. Testen Sie die Vorlage mit den Azure Stack Hub-APIs, um sicherzustellen, dass die Ressource bereitgestellt werden kann.

10. Wenn Ihre Vorlage auf einem VM-Image basiert, befolgen Sie die Anweisungen zum Hinzufügen eines VM-Images zu Azure Stack Hub.

11. Speichern Sie die Azure Resource Manager-Vorlage im Ordner /Contoso.TodoList/DeploymentTemplates/ .

12. Wählen Sie Symbole und Text für Ihr Marketplace-Element aus. Fügen Sie Symbole zum Ordner Symbole hinzu. Text wird der Datei Ressourcen im Ordner Zeichenfolgen hinzugefügt. Verwenden Sie für die Symbole die Namenskonvention für kleine, mittlere, große und breite Symbole. Eine ausführliche Beschreibung dieser Größen finden Sie in der Referenz zur Benutzeroberfläche für Marketplace-Elemente.

    Hinweis

    Für die ordnungsgemäße Erstellung des Marketplace-Elements sind alle vier Symbolgrößen (klein, mittel, groß, breit) erforderlich.

13. Informationen zur weiteren Bearbeitung der Datei Manifest.json finden Sie unter Referenz: Datei „manifest.json“ für Marketplace-Elemente.

14. Wenn Sie die Änderungen an den Dateien abgeschlossen haben, konvertieren Sie sie in eine AZPKG-Datei. Sie führen die Konvertierung mithilfe des Tools AzureGallery.exe und des zuvor heruntergeladenen Beispielkatalogpakets durch. Führen Sie den folgenden Befehl aus:

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

    Hinweis

    Sie können einen beliebigen Ausgabepfad wählen, und er muss sich nicht auf dem Laufwerk „C:“ befinden. Der vollständige Pfad zu sowohl der Datei „manifest.json“ als auch zum Ausgabepaket muss jedoch vorhanden sein. Beispiel: Wenn C:\<path>\galleryPackageName.azpkg der Ausgabepfad ist, muss der Ordner C:\<path> vorhanden sein.

Veröffentlichen von Marketplace-Elementen

Referenz: Datei „manifest.json“ für Marketplace-Elemente

Identitätsinformationen

Metadaten

Bilder

Marketplace verwendet die folgenden Symbole:

Kategorien

Jedes Marketplace-Element muss mit einer Kategorie gekennzeichnet werden, die die Position des Elements auf der Portalbenutzeroberfläche angibt. Sie können eine der vorhandenen Kategorien in Azure Stack Hub auswählen (Compute, Daten und Speicher usw.) oder eine neue erstellen.

Links

Jedes Marketplace-Element kann verschiedene Links zu zusätzlichen Inhalten enthalten. Die Links werden als Liste der Namen und URIs angegeben:

Zusätzliche Eigenschaften

Zusätzlich zu den oben genannten Metadaten können Marketplace-Autoren benutzerdefinierte Schlüssel-Wert-Paare mit Daten in der folgenden Form angeben.

HTML-Bereinigung

Für jedes Feld, das HTML zulässt, sind die folgenden Elemente und Attribute zulässig:

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

Referenz: Benutzeroberfläche für Marketplace-Elemente

Im Azure Stack Hub-Portal werden folgende Symbole und Texte für Marketplace-Elemente angezeigt:

Blatt "Erstellen"

Blatt „Details“ für ein Marketplace-Element

Nächste Schritte

• Der Azure Stack Hub-Marketplace – Übersicht
• Herunterladen von Marketplace-Elementen
• Format und Struktur von Azure Resource Manager-Vorlagen