Baixe itens de Marketplace para Azure Stack HubDownload Marketplace items to Azure Stack Hub

Como operador de nuvem, pode baixar itens para Azure Stack Hub a partir do Marketplace e disponibilizá-los a todos os utilizadores usando o ambiente Azure Stack Hub.As a cloud operator, you can download items to Azure Stack Hub from the Marketplace and make them available to all users using the Azure Stack Hub environment. Os itens que pode escolher são de uma lista com curadoria de itens do Azure Marketplace que são pré-testados e suportados para trabalhar com o Azure Stack Hub.The items you can choose are from a curated list of Azure Marketplace items that are pre-tested and supported to work with Azure Stack Hub. Itens adicionais são frequentemente adicionados a esta lista, por isso continue a verificar se há novos conteúdos.Additional items are frequently added to this list, so continue to check back for new content.

Existem dois cenários para o download de produtos marketplace:There are two scenarios for downloading Marketplace products:

  • Cenário desligado ou parcialmente ligado: Requer que aceda à internet utilizando a ferramenta de sindicalização marketplace para descarregar itens do Marketplace.Disconnected or partially connected scenario: Requires you to access the internet using the Marketplace syndication tool to download Marketplace items. Em seguida, transfira os seus downloads para a instalação do Azure Stack Hub desligado.Then, you transfer your downloads to your disconnected Azure Stack Hub installation. Este cenário usa o PowerShell.This scenario uses PowerShell.
  • Cenário ligado: Requer que o ambiente do Azure Stack Hub esteja ligado à internet.Connected scenario: Requires your Azure Stack Hub environment to be connected to the internet. Utiliza o portal de administrador do Azure Stack Hub para localizar e transferir itens.You use the Azure Stack Hub administrator portal to locate and download items.

Consulte os itens do Azure Marketplace para Azure Stack Hub para obter uma lista completa dos itens de mercado que pode descarregar.See Azure Marketplace items for Azure Stack Hub for a complete list of the marketplace items you can download. Veja o Azure Stack Hub Marketplace altera o artigo para uma lista de adições recentes, supressões e atualizações para o Azure Stack Hub Marketplace.See the Azure Stack Hub Marketplace changes article for a list of recent additions, deletions, and updates to Azure Stack Hub Marketplace.

Nota

O catálogo será diferente com base na nuvem a que o seu sistema Azure Stack Hub está ligado.The catalog will be different based on the cloud your Azure Stack Hub system is connected to. O ambiente em nuvem é determinado pela subscrição Azure que utiliza para registar o seu Azure Stack Hub.The cloud environment is determined by the Azure subscription you use for registering your Azure Stack Hub.

Nota

Também pode utilizar a Estação de Trabalho de Acesso ao Operador (OAW) para aceder ao ponto final privilegiado (PEP), o portal administrador para cenários de suporte e ferramentas Azure Stack Hub GitHub.You can also use the The Operator Access Workstation (OAW) to access the privileged endpoint (PEP), the Administrator portal for support scenarios, and Azure Stack Hub GitHub Tools. Para mais informações consulte a estação de trabalho de acesso ao operador do hub de Azure Stack.For more information see Azure Stack Hub Operator Access Workstation.

Uma implementação conectada permite-lhe usar o portal do administrador para descarregar itens de mercado.A connected deployment allows you to use the administrator portal to download marketplace items.

Pré-requisitosPrerequisites

A sua implementação do Azure Stack Hub deve ter conectividade com a Internet e estar registada no Azure.Your Azure Stack Hub deployment must have internet connectivity and be registered with Azure.

Use o portal para descarregar itens de mercadoUse the portal to download marketplace items

  1. Inscreva-se no portal do administrador do Azure Stack Hub.Sign into the Azure Stack Hub administrator portal.

  2. Reveja o espaço de armazenamento disponível antes de descarregar itens de mercado.Review the available storage space before downloading marketplace items. Mais tarde, quando selecionar itens para download, pode comparar o tamanho do download com a capacidade de armazenamento disponível.Later, when you select items for download, you can compare the download size to your available storage capacity. Se a capacidade for limitada, considere opções para gerir o espaço disponível.If capacity is limited, consider options for managing available space.

    Para rever o espaço disponível: na gestão da Região, selecione a região que pretende explorar e depois vá ao Armazenamento de Fornecedores de > Storage Recursos:To review available space: in Region management, select the region you want to explore and then go to Resource Providers > Storage:

    Reveja o espaço de armazenamento no portal de administrador do Azure Stack Hub

  3. Abra o Azure Stack Hub Marketplace e ligue-se ao Azure.Open Azure Stack Hub Marketplace and connect to Azure. Para tal, selecione o serviço de gestão do Marketplace, selecione itens marketplace, e, em seguida, selecione Adicionar a partir de Azure:To do so, select the Marketplace management service, select Marketplace items, and then select Add from Azure:

    Adicione artigos de marketplace da Azure

  4. Cada item de linha também mostra a versão atualmente disponível.Each line item also shows the currently available version. Se estiver disponível mais de uma versão de um item marketplace, a coluna Versão mostra Multiple.If more than one version of a Marketplace item is available, the Version column shows Multiple. Pode clicar em cada item para ver a sua descrição e informações adicionais, incluindo o seu tamanho de descarregamento:You can click on each item to view its description and additional information, including its download size:

    Screenshot que mostra as versões disponíveis de um item Marketplace.

  5. Se a versão de um item for mostrada como Multiple, pode selecionar esse item e, em seguida, escolher uma versão específica a partir do seletor de versão resultante.If the version of an item is shown as Multiple, you can select that item and then choose a specific version from the resulting version selector dropdown. Note que a Microsoft tem agora a capacidade de adicionar atributos que bloqueiam os administradores de descarregar produtos de marketplace que são incompatíveis com o seu Azure Stack, devido a várias propriedades, como a versão Azure Stack ou o modelo de faturação.Note that Microsoft now has the ability to add attributes that block administrators from downloading marketplace products that are incompatible with their Azure Stack, due to various properties, such as the Azure Stack version or billing model. Só a Microsoft pode adicionar estes atributos:Only Microsoft can add these attributes:

    Adicionar a partir de AzureAdd from Azure

  6. Selecione o item que deseja e, em seguida, selecione Baixar.Select the item you want, and then select Download. Os tempos de descarregamento variam e dependem da conectividade da rede.Download times vary and depends on the network connectivity. Após o download concluído, pode implementar o novo item de mercado como um operador Azure Stack Hub ou um utilizador.After the download completes, you can deploy the new marketplace item as either an Azure Stack Hub operator or a user.

  7. Para implementar o item descarregado, selecione + Crie um recurso e, em seguida, procure entre as categorias para o novo item do mercado.To deploy the downloaded item, select + Create a resource, and then search among the categories for the new marketplace item. Em seguida, selecione o item para iniciar o processo de implantação.Next, select the item to begin the deployment process. O processo varia para diferentes itens de mercado.The process varies for different marketplace items.

Quando o Azure Stack Hub tem uma conectividade limitada ou sem internet, utiliza-se o PowerShell e a ferramenta de sindicalização do mercado para descarregar os itens de mercado para uma máquina com conectividade com internet.When Azure Stack Hub has limited or no internet connectivity, you use PowerShell and the marketplace syndication tool to download the marketplace items to a machine with internet connectivity. Em seguida, transfira os itens para o seu ambiente Azure Stack Hub.You then transfer the items to your Azure Stack Hub environment. Num ambiente desligado, não é possível descarregar itens de marketplace utilizando o portal Azure Stack Hub.In a disconnected environment, you can't download marketplace items by using the Azure Stack Hub portal.

A ferramenta de sindicalização do mercado também pode ser usada num cenário conectado.The marketplace syndication tool can also be used in a connected scenario.

Há duas partes neste cenário:There are two parts to this scenario:

  • Parte 1: Descarregue a partir de itens do Marketplace.Part 1: Download from Marketplace items. No computador com acesso à Internet, configura o PowerShell, descarrega a ferramenta de sindicalização e, em seguida, descarrega itens do Azure Marketplace.On the computer with internet access, you configure PowerShell, download the syndication tool, and then download items from Azure Marketplace.
  • Parte 2: Faça upload e publicação no Azure Stack Hub Marketplace.Part 2: Upload and publish to Azure Stack Hub Marketplace. Move os ficheiros que descarregou para o seu ambiente Azure Stack Hub e depois publica-os no Azure Stack Hub Marketplace.You move the files you downloaded to your Azure Stack Hub environment and then publish them to Azure Stack Hub Marketplace.

Pré-requisitosPrerequisites

  • Um ambiente conectado (não tem de ser O Azure Stack Hub).A connected environment (does not have to be Azure Stack Hub). Você precisa de conectividade para obter a lista de produtos da Azure com os seus detalhes, e para baixar tudo localmente.You need connectivity to get the list of products from Azure with their details, and to download everything locally. Uma vez feito isto, o resto do procedimento não requer conectividade à Internet.Once this is done, the rest of the procedure does not require internet connectivity. Cria um catálogo de itens que já descarregou para utilizar no seu ambiente desligado.It creates a catalog of items you've previously downloaded for you to use in your disconnected environment.

  • Meios de comunicação amovíveis para ligar ao ambiente desligado e transferir todos os artefactos necessários.Removable media to connect to your disconnected environment and transfer all the necessary artifacts.

  • Um ambiente Azure Stack Hub desligado com os seguintes pré-requisitos:A disconnected Azure Stack Hub environment with the following prerequisites:

  • Descarregue o módulo Azs.Syndication.Admin da PowerShell Gallery utilizando o seguinte comando:Download the Azs.Syndication.Admin module from the PowerShell Gallery using the following command:

    Install-Module -Name Azs.Syndication.Admin -AllowPrerelease -PassThru
    
  • .NET Quadro 4.7 ou posterior..NET Framework 4.7 or later.

Uma vez registado o seu Azure Stack, pode ignorar a seguinte mensagem que aparece na lâmina de gestão do Mercado, uma vez que esta não é relevante para o caso de utilização desligado:Once you have registered your Azure Stack, you can disregard the following message that appears on the Marketplace management blade, as this is not relevant for the disconnected use case:

Gestão do mercado

Use a ferramenta de sindicalização do mercado para descarregar itens de mercadoUse the marketplace syndication tool to download marketplace items

Importante

Certifique-se de baixar a ferramenta de sindicalização do mercado sempre que descarregar itens de marketplace num cenário desconectado.Be sure to download the marketplace syndication tool each time you download marketplace items in a disconnected scenario. São feitas alterações frequentes nesta ferramenta e a versão mais atual deve ser utilizada para cada download.Frequent changes are made to this tool and the most current version should be used for each download.

  1. Num computador com uma ligação à Internet, abra uma consola PowerShell como administrador.On a computer with an Internet connection, open a PowerShell console as an administrator.

  2. Inscreva-se na nuvem Azure e inquilino do diretório AzureAD usando a conta Azure que usou para registar o Azure Stack Hub.Sign in to the appropriate Azure cloud and AzureAD directory tenant using the Azure account that you've used to register Azure Stack Hub. Para adicionar a conta, na execução Add-AzureRmAccount PowerShell:To add the account, in PowerShell run Add-AzureRmAccount:

    Login-AzAccount -Environment AzureCloud -Tenant '<mydirectory>.onmicrosoft.com'
    

    É-lhe pedido que introduza as suas credenciais de conta Azure e poderá ter de utilizar a autenticação de dois fatores, dependendo da configuração da sua conta.You are prompted to enter your Azure account credentials and you might have to use two-factor authentication, depending on your account configuration.

    Nota

    Se a sessão expirar, a sua palavra-passe mudou ou pretende mudar de conta, execute o seguinte cmdlet antes de iniciar sessão com Add-AzRmAccount : RemoveAzAccount -Scope Process .If your session expires, your password has changed, or you want to switch accounts, run the following cmdlet before you sign in using Add-AzRmAccount: RemoveAzAccount -Scope Process.

  3. Se tiver várias subscrições, execute o seguinte comando para selecionar o que utilizou para o registo:If you have multiple subscriptions, run the following command to select the one you used for registration:

    Get-AzSubscription -SubscriptionID 'Your Azure Subscription GUID' | Select-AzSubscription
    
  4. Se ainda não o fez na etapa de pré-requisitos, descarregue a versão mais recente da ferramenta de sindicalização Marketplace:If you haven't done it in the pre-requisites step already, download the latest version of the Marketplace syndication tool:

    Install-Module -Name Azs.Syndication.Admin -AllowPrerelease -PassThru
    
  5. Para selecionar os itens do Marketplace, tais como imagens VM, extensões ou modelos de solução para descarregar, executar o seguinte comando:To select the Marketplace items such as VM images, extensions, or solution templates to download, run the following command:

    $products = Select-AzsMarketplaceItem
    

    Isto apresenta uma tabela que lista todas as inscrições do Azure Stack disponíveis na subscrição selecionada.This displays a table that lists all the Azure Stack registrations available in the selected subscription. Escolha o registo que corresponde ao ambiente Azure Stack para o qual está a descarregar os itens de mercado e selecione OK.Choose the registration that matches the Azure Stack environment you're downloading the marketplace items for, and select OK.

    Screenshot que mostra uma lista de todos os registos Azure Stack disponíveis na subscrição selecionada.

    Você deve agora ver uma segunda tabela listando todos os itens de mercado disponíveis para download.You should now see a second table listing all the marketplace items available for download. Selecione o item que pretende descarregar e tome nota da versão.Select the item that you want to download and make a note of the Version. Pode segurar a tecla Ctrl para selecionar várias imagens.You can hold the Ctrl key to select multiple images. Screenshot que mostra outra lista de todos os registos Azure Stack disponíveis na subscrição selecionada.Screenshot that shows another list of all the Azure Stack registrations available in the selected subscription.

    Também pode filtrar a lista de imagens utilizando a opção de critérios Adicionar.You can also filter the list of images by using the Add criteria option. Selecione registos de pilhas de AzureSelect Azure Stack Registrations

    Depois de fazer as suas seleções, selecione OK.Once you've made your selections, select OK.

  6. Os IDs para os itens marketplace que selecionou para download são guardados na $products variável.The IDs for the Marketplace items you've selected for download are saved in the $products variable. Utilize o comando abaixo para começar a descarregar os itens selecionados.Use the command below to begin downloading the selected items. Substitua o caminho da pasta de destino por uma localização para armazenar os ficheiros que descarrega a partir do Azure Marketplace:Replace the destination folder path with a location to store the files you download from Azure Marketplace:

    $products | Export-AzsMarketplaceItem  -RepositoryDir "Destination folder path in quotes"
    
  7. O tempo que o download demora depende do tamanho do item.The time that the download takes depends on the size of the item. Após o download concluído, o item está disponível na pasta que especificou no script.After the download completes, the item is available in the folder that you specified in the script. O download inclui um ficheiro VHD (para máquinas virtuais) ou um ficheiro .zip (para extensões de máquinas virtuais e fornecedores de recursos).The download includes a VHD file (for virtual machines), or a .zip file (for virtual machine extensions and resource providers). Também pode incluir um pacote de galeria no formato .azpkg, que é um ficheiro .zip.It might also include a gallery package in the .azpkg format, which is a .zip file.

  8. Se o download falhar, pode tentar novamente recorrê-lo re-executar o seguinte cmdlet PowerShell:If the download fails, you can try again by re-running the following PowerShell cmdlet:

    $products | Export-AzsMarketplaceItem  -RepositoryDir "Destination folder path in quotes"
    
  9. Também deve exportar o módulo Azs.Syndication.Admin localmente para que possa copiá-lo para a máquina a partir da qual está a importar artigos do Marketplace para o Azure Stack Hub.You should also export the Azs.Syndication.Admin module locally so that you can copy it over to the machine from which you are importing Marketplace items to Azure Stack Hub.

    Nota

    A pasta de destino para exportação deste módulo deve ser diferente da localização para onde exportou os itens do mercado.The destination folder for exporting this module should be different from the location to which you have exported the marketplace items.

    Save-Package -ProviderName NuGet -Source https://www.powershellgallery.com/api/v2 -Name Azs.Syndication.Admin -Path "Destination folder path in quotes" -Force
    

Importe o download e publique no Azure Stack Hub Marketplace usando PowerShellImport the download and publish to Azure Stack Hub Marketplace using PowerShell

  1. Tem de mover os ficheiros que já descarregou localmente para uma máquina que tenha conectividade com o ambiente Azure Stack Hub.You must move the files that you have previously downloaded locally to a machine that has connectivity to your Azure Stack Hub environment. A ferramenta de sindicalização do mercado também deve estar disponível para o seu ambiente Azure Stack Hub porque precisa de usar a ferramenta para realizar a operação de importação.The marketplace syndication tool must also be available to your Azure Stack Hub environment because you need to use the tool to perform the import operation.

    A imagem a seguir mostra um exemplo de estrutura de pasta.The following image shows a folder structure example. D:\downloadfolder contém todos os itens de mercado descarregados.D:\downloadfolder contains all the downloaded marketplace items. Cada sub-segmentador é um item de mercado (por exemplo, microsoft.custom-script-linux-arm-2.0.3), nomeado pelo ID do produto.Each subfolder is a marketplace item (for example, microsoft.custom-script-linux-arm-2.0.3), named by the product ID. Dentro de cada sub-página está o conteúdo descarregado do item do mercado.Inside each subfolder is the marketplace item's downloaded content.

    Estrutura de diretório de descarregamento de mercado

  2. Siga as instruções deste artigo para configurar a sessão PowerShell do operador do hub de pilha de Azure.Follow the instructions in this article to configure the Azure Stack Hub Operator PowerShell session.

  3. Inscreva-se no seu Azure Stack Hub com uma identidade que tenha acesso ao proprietário à "Subscrição predefinida do Fornecedor".Sign in to your Azure Stack Hub with an identity that has owner access to the "Default Provider Subscription".

  4. Importe o módulo de sindicalização e, em seguida, lance a ferramenta de sindicalização do mercado executando o seguinte script:Import the syndication module and then launch the marketplace syndication tool by running the following script:

    Import-AzsMarketplaceItem -RepositoryDir "Source folder path in quotes"
    
  5. Após o script ter sido concluído com sucesso, os itens de marketplace devem estar disponíveis no Azure Stack Hub Marketplace.After the script successfully completes, the marketplace items should be available in Azure Stack Hub Marketplace.