Baixar itens do Marketplace para Azure Stack HubDownload Marketplace items to Azure Stack Hub

Como um operador de nuvem, você pode baixar itens para Azure Stack Hub do Marketplace e disponibilizá-los para todos os usuários usando o ambiente de Hub de Azure Stack.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 você pode escolher são de uma lista organizada de itens do Azure Marketplace que são testados previamente e com suporte para funcionar com o Hub de Azure Stack.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 essa lista, portanto, continue a voltar a verificar o novo conteúdo.Additional items are frequently added to this list, so continue to check back for new content.

Há dois cenários para baixar produtos do Marketplace:There are two scenarios for downloading Marketplace products:

  • Cenário desconectado ou parcialmente conectado: exige que você acesse a Internet usando a ferramenta de distribuição do Marketplace para baixar 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, você transfere seus downloads para a instalação desconectada do hub de Azure Stack.Then, you transfer your downloads to your disconnected Azure Stack Hub installation. Esse cenário usa o PowerShell.This scenario uses PowerShell.
  • Cenário conectado: requer que o ambiente de Hub de Azure Stack esteja conectado à Internet.Connected scenario: Requires your Azure Stack Hub environment to be connected to the internet. Use o portal do administrador do Hub Azure Stack para localizar e baixar itens.You use the Azure Stack Hub administrator portal to locate and download items.

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

Observação

O catálogo será diferente com base na nuvem à qual o sistema de Hub de Azure Stack está conectado.The catalog will be different based on the cloud your Azure Stack Hub system is connected to. O ambiente de nuvem é determinado pela assinatura do Azure que você usa para registrar seu hub de Azure Stack.The cloud environment is determined by the Azure subscription you use for registering your Azure Stack Hub.

Observação

Você também pode usar a estação de trabalho de acesso do operador (OAW) para acessar o ponto de extremidade privilegiado (PEP), o portal do administrador para cenários de suporte e as ferramentas GitHub do hub de Azure Stack.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 obter mais informações, consulte Azure Stack estação de trabalho acesso de operador de Hub.For more information see Azure Stack Hub Operator Access Workstation.

Uma implantação conectada permite que você use o portal do administrador para baixar itens do Marketplace.A connected deployment allows you to use the administrator portal to download marketplace items.

Pré-requisitosPrerequisites

Sua implantação de Hub de Azure Stack deve ter conectividade com a Internet e ser registrada com o Azure.Your Azure Stack Hub deployment must have internet connectivity and be registered with Azure.

Usar o portal para baixar itens do MarketplaceUse the portal to download marketplace items

  1. Entre no portal do administrador do hub de Azure Stack.Sign into the Azure Stack Hub administrator portal.

  2. Examine o espaço de armazenamento disponível antes de baixar itens do Marketplace.Review the available storage space before downloading marketplace items. Posteriormente, ao selecionar itens para download, você poderá 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 as opções para gerenciar o espaço disponível.If capacity is limited, consider options for managing available space.

    Para examinar o espaço disponível: em Gerenciamento de região, selecione a região que você deseja explorar e vá para provedores de recursos > armazenamento:To review available space: in Region management, select the region you want to explore and then go to Resource Providers > Storage:

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

  3. Abra o Marketplace do Hub Azure Stack e conecte-se ao Azure.Open Azure Stack Hub Marketplace and connect to Azure. Para fazer isso, selecione o serviço de Gerenciamento do Marketplace , selecione itens do Marketplace e, em seguida, selecione Adicionar do Azure:To do so, select the Marketplace management service, select Marketplace items, and then select Add from Azure:

    Adicionar itens do Marketplace do Azure

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

    Captura de tela que mostra as versões disponíveis de um item do Marketplace.

  5. Se a versão de um item for mostrada como múltipla, você poderá selecionar esse item e, em seguida, escolher uma versão específica na lista suspensa 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. Observe que a Microsoft agora tem a capacidade de adicionar atributos que impedem que os administradores baixem os produtos do Marketplace que são incompatíveis com seus Azure Stack, devido a várias propriedades, como a versão Azure Stack ou o modelo de cobrança.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. Somente a Microsoft pode adicionar estes atributos:Only Microsoft can add these attributes:

    Adicionar do AzureAdd from Azure

  6. Selecione o item desejado e, em seguida, selecione baixar.Select the item you want, and then select Download. Os tempos de download variam e dependem da conectividade de rede.Download times vary and depends on the network connectivity. Após a conclusão do download, você pode implantar o novo item do Marketplace como um operador Azure Stack Hub ou um usuário.After the download completes, you can deploy the new marketplace item as either an Azure Stack Hub operator or a user.

  7. Para implantar o item baixado, selecione + criar um recurso e, em seguida, pesquise entre as categorias do novo item do Marketplace.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 de acordo com itens diferentes do Marketplace.The process varies for different marketplace items.

Quando Azure Stack Hub tem conectividade limitada ou sem Internet, você usa o PowerShell e a ferramenta de distribuição do Marketplace para baixar os itens do Marketplace para um computador com conectividade com a 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, você transfere os itens para seu ambiente de Hub de Azure Stack.You then transfer the items to your Azure Stack Hub environment. Em um ambiente desconectado, não é possível baixar itens do Marketplace usando o portal do Hub Azure Stack.In a disconnected environment, you can't download marketplace items by using the Azure Stack Hub portal.

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

Há duas partes que compõem esse cenário:There are two parts to this scenario:

  • Parte 1: baixar de itens do Marketplace.Part 1: Download from Marketplace items. No computador com acesso à Internet, você configura o PowerShell, baixa a ferramenta de distribuição e, em seguida, baixa 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: carregar e publicar no Azure Stack Marketplace do Hub.Part 2: Upload and publish to Azure Stack Hub Marketplace. Você move os arquivos baixados para o ambiente de Hub de Azure Stack e os publica no Marketplace de Hub Azure Stack.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 precisa ser Azure Stack Hub).A connected environment (does not have to be Azure Stack Hub). Você precisa de conectividade para obter a lista de produtos do Azure com 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. Quando isso for feito, o restante do procedimento não exigirá conectividade com a Internet.Once this is done, the rest of the procedure does not require internet connectivity. Ele cria um catálogo de itens que você baixou anteriormente para uso em seu ambiente desconectado.It creates a catalog of items you've previously downloaded for you to use in your disconnected environment.

  • Mídia removível para se conectar ao seu ambiente desconectado e transferir todos os artefatos necessários.Removable media to connect to your disconnected environment and transfer all the necessary artifacts.

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

Baixe o módulo AZS. Syndication. admin do Galeria do PowerShell usando 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

Depois de registrar seu Azure Stack, você pode desconsiderar a seguinte mensagem que aparece na folha de gerenciamento do Marketplace, pois isso não é relevante para o caso de uso desconectado: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:

Gerenciamento do Marketplace

Usar a ferramenta de distribuição do Marketplace para baixar itens do MarketplaceUse the marketplace syndication tool to download marketplace items

Importante

Certifique-se de baixar a ferramenta de distribuição do Marketplace toda vez que você baixar itens do Marketplace em um cenário desconectado.Be sure to download the marketplace syndication tool each time you download marketplace items in a disconnected scenario. Alterações frequentes são feitas nessa ferramenta e a versão mais atual deve ser usada para cada download.Frequent changes are made to this tool and the most current version should be used for each download.

  1. Em um computador com uma conexão com a Internet, abra um console do PowerShell como administrador.On a computer with an Internet connection, open a PowerShell console as an administrator.

  2. Entre na nuvem do Azure e no locatário do diretório AzureAD apropriados usando a conta do Azure que você usou para registrar 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 do PowerShell Login-AzAccount :To add the account, in PowerShell run Login-AzAccount:

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

    Você será solicitado a inserir suas credenciais de conta do Azure e talvez precise usar 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.

    Observação

    Se sua sessão expirar, sua senha foi alterada ou você deseja alternar contas, execute o seguinte cmdlet antes de entrar usando Add-AzAccount : Remove-AzAccount -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-AzAccount: Remove-AzAccount -Scope Process.

  3. Se você tiver várias assinaturas, execute o seguinte comando para selecionar aquela que você usou para o registro: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 você ainda não fez isso na etapa pré-requisitos, baixe a versão mais recente da ferramenta de distribuição do 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, como imagens de VM, extensões ou modelos de solução para baixar, execute 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
    

    Isso exibe uma tabela que lista todos os registros de Azure Stack disponíveis na assinatura selecionada.This displays a table that lists all the Azure Stack registrations available in the selected subscription. Escolha o registro que corresponde ao ambiente de Azure Stack para o qual você está baixando os itens do Marketplace e selecione OK.Choose the registration that matches the Azure Stack environment you're downloading the marketplace items for, and select OK.

    Captura de tela que mostra uma lista de todos os registros de Azure Stack disponíveis na assinatura selecionada.

    Agora você deve ver uma segunda tabela listando todos os itens do Marketplace disponíveis para download.You should now see a second table listing all the marketplace items available for download. Selecione o item que você deseja baixar e anote a versão.Select the item that you want to download and make a note of the Version. Você pode manter a tecla Ctrl pressionada para selecionar várias imagens.You can hold the Ctrl key to select multiple images. Captura de tela que mostra outra lista de todos os registros de Azure Stack disponíveis na assinatura selecionada.Screenshot that shows another list of all the Azure Stack registrations available in the selected subscription.

    Você também pode filtrar a lista de imagens usando a opção Adicionar critérios .You can also filter the list of images by using the Add criteria option. Selecionar registros de Azure StackSelect Azure Stack Registrations

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

  6. As IDs para os itens do Marketplace que você selecionou para download são salvas na $products variável.The IDs for the Marketplace items you've selected for download are saved in the $products variable. Use o comando a seguir para começar a baixar os itens selecionados.Use the command below to begin downloading the selected items. Substitua o caminho da pasta de destino por um local para armazenar os arquivos baixados 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 leva depende do tamanho do item.The time that the download takes depends on the size of the item. Após a conclusão do download, o item estará disponível na pasta que você especificou no script.After the download completes, the item is available in the folder that you specified in the script. O download inclui um arquivo VHD (para máquinas virtuais) ou um arquivo. zip (para extensões de máquina virtual e provedores de recursos).The download includes a VHD file (for virtual machines), or a .zip file (for virtual machine extensions and resource providers). Ele também pode incluir um pacote da galeria no formato . azpkg , que é um arquivo. zip.It might also include a gallery package in the .azpkg format, which is a .zip file.

  8. Se o download falhar, você poderá tentar novamente executando novamente o seguinte cmdlet do 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. Você também deve exportar o módulo AZS. Syndication. admin localmente para que você possa copiá-lo para o computador do qual você está importando itens do Marketplace para 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.

    Observação

    A pasta de destino para exportar esse módulo deve ser diferente do local para o qual você exportou os itens do Marketplace.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
    

Importar o download e publicar para Azure Stack Marketplace do Hub usando o PowerShellImport the download and publish to Azure Stack Hub Marketplace using PowerShell

  1. Você deve mover os arquivos que você baixou anteriormente localmente para um computador que tenha conectividade com seu ambiente de Hub de Azure Stack.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 distribuição do Marketplace também deve estar disponível para seu ambiente de Hub de Azure Stack porque você precisa usar a ferramenta para executar 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 do Marketplace baixados.D:\downloadfolder contains all the downloaded marketplace items. Cada subpasta é um item do Marketplace (por exemplo, Microsoft. Custom-script-Linux-ARM-2.0.3), nomeado pela 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 subpasta está o conteúdo baixado do item do Marketplace.Inside each subfolder is the marketplace item's downloaded content.

    Estrutura do diretório de download do Marketplace

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

  3. Entre em seu hub de Azure Stack com uma identidade que tenha acesso de proprietário à "assinatura de provedor padrão".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 distribuição e, em seguida, inicie a ferramenta de distribuição do Marketplace 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. Depois que o script for concluído com êxito, os itens do Marketplace deverão estar disponíveis no Marketplace do Hub Azure Stack.After the script successfully completes, the marketplace items should be available in Azure Stack Hub Marketplace.