Creare e pubblicare un elemento del MarketplaceCreate and publish a Marketplace item

Si applica a: Azure Stack integrate di sistemi Azure Stack Development KitApplies to: Azure Stack integrated systems and Azure Stack Development Kit

Creare un elemento del MarketplaceCreate a Marketplace item

  1. Scaricare lo strumento Azure Packager di raccolta e l'elemento dello Stack di Azure Marketplace di esempio.Download the Azure Gallery Packager tool and the sample Azure Stack Marketplace item.
  2. Aprire l'elemento del Marketplace di esempio e rinominare il SimpleVMTemplate cartella.Open the sample Marketplace item and rename the SimpleVMTemplate folder. (Utilizzare lo stesso nome dell'elemento del Marketplace, ad esempio, Contoso.TodoList.) Questa cartella contiene:(Use the same name as your Marketplace item--for example, Contoso.TodoList.) This folder contains:

    /Contoso.TodoList/
    /Contoso.TodoList/Manifest.json
    /Contoso.TodoList/UIDefinition.json
    /Contoso.TodoList/Icons/
    /Contoso.TodoList/Strings/
    /Contoso.TodoList/DeploymentTemplates/
    
  3. Creare un modello di gestione risorse di Azure o scegliere un modello da GitHub.Create an Azure Resource Manager template or choose a template from GitHub. L'elemento del Marketplace Usa questo modello per creare una risorsa.The Marketplace item uses this template to create a resource.
  4. Per assicurarsi che la risorsa può essere distribuita correttamente, verificare il modello con le API di Microsoft Azure Stack.To make sure that the resource can be deployed successfully, test the template with the Microsoft Azure Stack APIs.
  5. Se il modello si basa su un'immagine di macchina virtuale, seguire le istruzioni per aggiungere un'immagine di macchina virtuale di Azure Stack.If your template relies on a virtual machine image, follow the instructions to add a virtual machine image to Azure Stack.
  6. Salvare il modello di gestione risorse di Azure nel /Contoso.TodoList/DeploymentTemplates/ cartella.Save your Azure Resource Manager template in the /Contoso.TodoList/DeploymentTemplates/ folder.
  7. Scegliere le icone e testo per l'elemento del Marketplace.Choose the icons and text for your Marketplace item. Aggiungere le icone per il icone cartella e aggiungere testo al risorse file nel stringhe cartella.Add icons to the Icons folder, and add text to the resources file in the Strings folder. Usare la convenzione di denominazione Small, Medium, Large e Wide per le icone.Use the Small, Medium, Large, and Wide naming convention for icons. Vedere elemento del Marketplace riferimento all'interfaccia utente per una descrizione dettagliata.See Marketplace item UI reference for a detailed description.

    Nota

    Tutte le dimensioni di quattro icona (piccolo, medio, grande, wide) sono necessari per la compilazione correttamente l'elemento del Marketplace.All four icon sizes (small, medium, large, wide) are required for building the Marketplace item correctly.

  8. Nel manifest.json file, modificare nome per il nome dell'elemento del Marketplace.In the manifest.json file, change name to the name of your Marketplace item. Modificare inoltre publisher per il nome o la società.Also change publisher to your name or company.
  9. In elementi, modificare nome e percorso per le informazioni corrette per il modello di gestione risorse di Azure che incluso.Under artifacts, change name and path to the correct information for the Azure Resource Manager template that you included.

      "artifacts": [
         {
             "name": "Type your template name",
             "type": "Template",
             "path": "DeploymentTemplates\\Type your path",
             "isDefault": true
         }
    
  10. Sostituire elementi del Marketplace personale con un elenco delle categorie in cui deve essere visualizzato l'elemento del Marketplace.Replace My Marketplace Items with a list of the categories where your Marketplace item should appear.

         "categories":[
             "My Marketplace Items"
          ],
    
  11. Per tutte le altre modifiche a manifest.json, fare riferimento a riferimento: Marketplace elemento manifest.json.For any further edits to manifest.json, refer to Reference: Marketplace item manifest.json.
  12. Per creare un pacchetto in un file .azpkg le cartelle, aprire un prompt dei comandi ed eseguire il comando seguente:To package the folders into an .azpkg file, open a command prompt and run the following command:

    AzureGalleryPackager.exe package –m <path to manifest.json> -o <output location for the package>
    

    Nota

    Il percorso completo per il pacchetto di output deve esistere.The full path to the output package must exist. Ad esempio, se il percorso di output è C:\MarketPlaceItem\yourpackage.azpkg, deve esistere nella cartella C:\MarketPlaceItem.For example, if the output path is C:\MarketPlaceItem\yourpackage.azpkg, the folder C:\MarketPlaceItem must exist.

Pubblicare un elemento del MarketplacePublish a Marketplace item

  1. Usare PowerShell o Azure Storage Explorer per caricare l'elemento del Marketplace (.azpkg) di archiviazione Blob di Azure.Use PowerShell or Azure Storage Explorer to upload your Marketplace item (.azpkg) to Azure Blob storage. È possibile caricare in archiviazione di Azure Stack locale o caricare in archiviazione di Azure.You can upload to local Azure Stack storage or upload to Azure Storage. (È un percorso temporaneo per il pacchetto). Assicurarsi che il blob è accessibile pubblicamente.(It's a temporary location for the package.) Make sure that the blob is publicly accessible.
  2. Nella macchina virtuale client nell'ambiente di Microsoft Azure Stack, assicurarsi che la sessione di PowerShell sia configurata con le credenziali di amministratore del servizio.On the client virtual machine in the Microsoft Azure Stack environment, make sure that your PowerShell session is set up with your service administrator credentials. È possibile trovare istruzioni su come autenticare PowerShell nello Stack di Azure in distribuire un modello con PowerShell.You can find instructions for how to authenticate PowerShell in Azure Stack in Deploy a template with PowerShell.
  3. Utilizzare il Aggiungi AzureRMGalleryItem cmdlet di PowerShell per pubblicare l'elemento del Marketplace allo Stack di Azure.Use the Add-AzureRMGalleryItem PowerShell cmdlet to publish the Marketplace item to Azure Stack. ad esempio:For example:

    Add-AzureRMGalleryItem -GalleryItemUri `
    https://sample.blob.core.windows.net/gallerypackages/Microsoft.SimpleTemplate.1.0.0.azpkg –Verbose
    
    ParametroParameter DescrizioneDescription
    SubscriptionIDSubscriptionID ID sottoscrizione amministratore.Admin subscription ID. È possibile recuperarlo utilizzando PowerShell.You can retrieve it by using PowerShell. Se si preferisce eseguire questa operazione nel portale, passare alla sottoscrizione del provider e copiare l'ID sottoscrizione.If you'd prefer to get it in the portal, go to the provider subscription and copy the subscription ID.
    GalleryItemUriGalleryItemUri URI del BLOB per il pacchetto di raccolta che è già stato caricato in un archivio.Blob URI for your gallery package that has already been uploaded to storage.
    ApiversionApiversion Impostare come 2015-04-01.Set as 2015-04-01.
  4. Passare al portale.Go to the portal. È ora possibile visualizzare l'elemento del Marketplace nel portale, come un operatore o un utente.You can now see the Marketplace item in the portal--as an operator or as a user.

    Nota

    Il pacchetto potrebbe richiedere alcuni minuti.The package might take several minutes to appear.

  5. L'elemento del Marketplace ora è stato salvato a Stack Azure Marketplace.Your Marketplace item has now been saved to the Azure Stack Marketplace. È possibile eliminarlo dal percorso di archiviazione Blob.You can choose to delete it from your Blob storage location.
  6. È possibile rimuovere un elemento del Marketplace tramite il Remove AzureRMGalleryItem cmdlet.You can remove a Marketplace item by using the Remove-AzureRMGalleryItem cmdlet. Esempio:Example:

     Remove-AzureRMGalleryItem -Name Microsoft.SimpleTemplate.1.0.0  –Verbose
    

    Nota

    L'interfaccia utente di Marketplace potrebbe mostrare un errore dopo la rimozione di un elemento.The Marketplace UI may show an error after you remove an item. Per correggere l'errore, fare clic su impostazioni nel portale.To fix the error, click Settings in the portal. Selezionare quindi annullare modifiche in personalizzazione portale.Then, select Discard modifications under Portal customization.

Informazioni di riferimento: Manifest.json elemento MarketplaceReference: Marketplace item manifest.json

Informazioni sull'identitàIdentity information

NomeName ObbligatoriaRequired TipoType VincoliConstraints DescrizioneDescription
NomeName XX StringString [A-Za-z0-9] +[A-Za-z0-9]+
EditorePublisher XX StringString [A-Za-z0-9] +[A-Za-z0-9]+
VersioneVersion XX StringString SemVer v2SemVer v2

MetadataMetadata

NomeName ObbligatoriaRequired TipoType VincoliConstraints DescrizioneDescription
DisplayNameDisplayName XX StringString Indicazione di 80 caratteriRecommendation of 80 characters Il portale potrebbe non visualizzare correttamente il nome dell'elemento se è più lungo di 80 caratteri.The portal might not display your item name gracefully if it is longer than 80 characters.
PublisherDisplayNamePublisherDisplayName XX StringString Indicazione di 30 caratteriRecommendation of 30 characters Il portale potrebbe non visualizzare correttamente il nome del server di pubblicazione in caso di più di 30 caratteri.The portal might not display your publisher name gracefully if it is longer than 30 characters.
PublisherLegalNamePublisherLegalName XX StringString Numero massimo di 256 caratteriMaximum of 256 characters
RiepilogoSummary XX StringString Da 60 a 100 caratteri60 to 100 characters
LongSummaryLongSummary XX StringString Da 140 a 256 caratteri140 to 256 characters Non ancora applicabile nello Stack di Azure.Not yet applicable in Azure Stack.
DescrizioneDescription XX HTMLHTML 500 a 5.000 caratteri500 to 5,000 characters

ImmaginiImages

Marketplace utilizza le icone seguenti:The Marketplace uses the following icons:

NomeName LarghezzaWidth Altezza:Height NoteNotes
AmpiaWide 255 px255 px 115 px115 px È necessario sempreAlways required
LargeLarge 115 px115 px 115 px115 px È necessario sempreAlways required
MediaMedium 90 px90 px 90 px90 px È necessario sempreAlways required
SmallSmall 40 px40 px 40 px40 px È necessario sempreAlways required
SchermataScreenshot 533 px533 px 32 px32 px FacoltativoOptional

CategorieCategories

Ogni elemento del Marketplace deve essere contrassegnato con una categoria che identifica in cui l'elemento viene visualizzato nel portale di interfaccia utente.Each Marketplace item should be tagged with a category that identifies where the item appears on the portal UI. È possibile scegliere una delle categorie esistenti nello Stack di Azure (calcolo, dati e archiviazione, e così via) o uno nuovo.You can choose one of the existing categories in Azure Stack (Compute, Data + Storage, etc.) or choose a new one.

Ogni elemento del Marketplace può includere vari collegamenti a contenuto aggiuntivo.Each Marketplace item can include various links to additional content. I collegamenti vengono specificati come un elenco di nomi e di URI.The links are specified as a list of names and URIs.

NomeName ObbligatoriaRequired TipoType VincoliConstraints DescrizioneDescription
DisplayNameDisplayName XX StringString Numero massimo di 64 caratteriMaximum of 64 characters
UriUri XX URIURI

Proprietà aggiuntiveAdditional properties

Oltre ai metadati precedenti, gli autori di Marketplace possono fornire dati di coppia chiave/valore personalizzato nel formato seguente:In addition to the preceding metadata, Marketplace authors can provide custom key/value pair data in the following form:

NomeName ObbligatoriaRequired TipoType VincoliConstraints DescrizioneDescription
DisplayNameDisplayName XX StringString Numero massimo di 25 caratteriMaximum of 25 characters
ValoreValue XX StringString Numero massimo di 30 caratteriMaximum of 30 characters

Purificazione HTMLHTML sanitization

Per qualsiasi campo che consente di HTML, sono consentiti elementi e gli attributi seguenti:For any field that allows HTML, the following elements and attributes are allowed:

s1, S2, h3, h4, h5, p, ol, ul, li, un [destinazione | href], Brasile, sicuro, em, b, sih1, h2, h3, h4, h5, p, ol, ul, li, a[target|href], br, strong, em, b, i

: Riferimento Elemento del Marketplace dell'interfaccia utenteReference: Marketplace item UI

Icone e testo per gli elementi del Marketplace come illustrato nel portale di Azure Stack sono i seguenti.Icons and text for Marketplace items as seen in the Azure Stack portal are as follows.

Pannello CreaCreate blade

Pannello Crea

Pannello con i dettagli dell'elemento del MarketplaceMarketplace item details blade

Pannello con i dettagli dell'elemento del Marketplace