Baixar itens do Marketplace para o 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. 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. Itens adicionais são frequentemente adicionados a essa lista, portanto, continue a voltar a verificar o novo conteúdo.

Há dois cenários para baixar produtos do Marketplace:

  • 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. Em seguida, você transfere seus downloads para a instalação desconectada do hub de Azure Stack. Esse cenário usa o PowerShell.
  • Cenário conectado: requer que o ambiente de Hub de Azure Stack esteja conectado à Internet. Use o portal do administrador do Hub Azure Stack para localizar e baixar itens.

Confira itens do Azure Marketplace para Azure Stack Hub para obter uma lista completa dos itens do Marketplace que você pode baixar. 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.

Observação

O catálogo será diferente com base na nuvem à qual o sistema de Hub de Azure Stack está conectado. O ambiente de nuvem é determinado pela assinatura do Azure que você usa para registrar seu hub de Azure Stack.

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 de GitHub do Hub Azure Stack. Para obter mais informações, consulte Azure Stack estação de trabalho acesso de operador de Hub.

Uma implantação conectada permite que você use o portal do administrador para baixar itens do Marketplace.

Pré-requisitos

Sua implantação de Hub de Azure Stack deve ter conectividade com a Internet e ser registrada com o Azure.

Usar o portal para baixar itens do Marketplace

  1. Entre no portal do administrador do hub de Azure Stack.

  2. Examine o espaço de armazenamento disponível antes de baixar itens do Marketplace. Posteriormente, ao selecionar itens para download, você poderá comparar o tamanho do download com a capacidade de armazenamento disponível. Se a capacidade for limitada, considere as opções para gerenciar o espaço disponível.

    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 recursosArmazenamento:

    Review storage space in Azure Stack Hub administrator portal

  3. Abra o Marketplace do Hub Azure Stack e conecte-se ao Azure. Para fazer isso, selecione o serviço de Gerenciamento do Marketplace , selecione itens do Marketplacee, em seguida, selecione Adicionar do Azure:

    Add marketplace items from Azure

  4. Cada item de linha também mostra a versão disponível no momento. Se mais de uma versão de um item do Marketplace estiver disponível, a coluna versão mostrará vários. Você pode clicar em cada item para exibir sua descrição e informações adicionais, incluindo seu tamanho de download:

    Screenshot that shows the available versions of a Marketplace item.

  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. 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. Somente a Microsoft pode adicionar estes atributos:

    Add from Azure

  6. Selecione o item desejado e, em seguida, selecione baixar. Os tempos de download variam e dependem da conectividade de rede. 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.

  7. Para implantar o item baixado, selecione + criar um recursoe, em seguida, pesquise entre as categorias do novo item do Marketplace. Em seguida, selecione o item para iniciar o processo de implantação. O processo varia de acordo com itens diferentes do Marketplace.

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. Em seguida, você transfere os itens para seu ambiente de Hub de Azure Stack. Em um ambiente desconectado, não é possível baixar itens do Marketplace usando o portal do Hub Azure Stack.

A ferramenta de distribuição do Marketplace também pode ser usada em um cenário conectado.

Há duas partes que compõem esse cenário:

  • Parte 1: baixar de itens do Marketplace. No computador com acesso à Internet, você configura o PowerShell, baixa a ferramenta de distribuição e, em seguida, baixa itens do Azure Marketplace.
  • parte 2: Upload e publicar no Marketplace do Hub Azure Stack. Você move os arquivos baixados para o ambiente de Hub de Azure Stack e os publica no Marketplace de Hub Azure Stack.

Pré-requisitos

  • Um ambiente conectado (não precisa ser Azure Stack Hub). Você precisa de conectividade para obter a lista de produtos do Azure com seus detalhes e para baixar tudo localmente. Quando isso for feito, o restante do procedimento não exigirá conectividade com a Internet. Ele cria um catálogo de itens que você baixou anteriormente para uso em seu ambiente desconectado.

  • Mídia removível para se conectar ao seu ambiente desconectado e transferir todos os artefatos necessários.

  • Um ambiente de Hub Azure Stack desconectado com os seguintes pré-requisitos:

Baixe o módulo AZS. Syndication. admin do Galeria do PowerShell usando o seguinte comando:

Install-Module -Name Azs.Syndication.Admin
Install-Module -Name Azs.Syndication.Admin -RequiredVersion 0.1.154-preview -AllowPrerelease

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:

Marketplace management

Usar a ferramenta de distribuição do Marketplace para baixar itens do Marketplace

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. Alterações frequentes são feitas nessa ferramenta e a versão mais atual deve ser usada para cada download.

  1. Em um computador com uma conexão com a Internet, abra um console do PowerShell como administrador.

  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. Para adicionar a conta, na execução do PowerShell Connect-AzAccount :

    Connect-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.

    Observação

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

    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 se estiver usando a versão mais recente do hub de Azure Stack:

Install-Module -Name Azs.Syndication.Admin
Install-Module -Name Azs.Syndication.Admin -RequiredVersion 0.1.154-preview -AllowPrerelease
  1. Para selecionar os itens do Marketplace, como imagens de VM, extensões ou modelos de solução para baixar, execute o seguinte comando:

    $products = Select-AzsMarketplaceItem
    

    Isso exibe uma tabela que lista todos os registros de Azure Stack disponíveis na assinatura selecionada. Escolha o registro que corresponde ao ambiente de Azure Stack para o qual você está baixando os itens do Marketplace e selecione OK.

    Screenshot that shows a list of all the Azure Stack registrations available in the selected subscription.

    Agora você deve ver uma segunda tabela listando todos os itens do Marketplace disponíveis para download. Selecione o item que você deseja baixar e anote a versão. Você pode manter a tecla Ctrl pressionada para selecionar várias imagens. 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 . Select Azure Stack Registrations

    Depois de fazer suas seleções, selecione OK.

  2. As IDs para os itens do Marketplace que você selecionou para download são salvas na $products variável. Use o comando a seguir para começar a baixar os itens selecionados. Substitua o caminho da pasta de destino por um local para armazenar os arquivos baixados do Azure Marketplace:

    $products | Export-AzsMarketplaceItem  -RepositoryDir "Destination folder path in quotes"
    
  3. O tempo que o download leva depende do tamanho do item. Após a conclusão do download, o item estará disponível na pasta que você especificou no 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). Ele também pode incluir um pacote da galeria no formato . azpkg , que é um arquivo .zip.

  4. Se o download falhar, você poderá tentar novamente executando novamente o seguinte cmdlet do PowerShell:

    $products | Export-AzsMarketplaceItem  -RepositoryDir "Destination folder path in quotes"
    
  5. 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.

    Observação

    A pasta de destino para exportar este módulo deve ser diferente da localização para a qual você exportou os itens do marketplace.

    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 no Azure Stack Hub Marketplace usando o PowerShell

  1. Você deve mover os arquivos baixados anteriormente localmente para um computador que tenha conectividade com seu Azure Stack Hub ambiente. A ferramenta de sindicalção do marketplace também deve estar disponível para seu ambiente Azure Stack Hub, pois você precisa usar a ferramenta para executar a operação de importação.

    A imagem a seguir mostra um exemplo de estrutura de pasta. D:\downloadfolder contém todos os itens do marketplace baixados. Cada subpasta é um item do marketplace (por exemplo, microsoft.custom-script-linux-arm-2.0.3), nomeado pela ID do produto. Dentro de cada subpasta está o conteúdo baixado do item do marketplace.

    Marketplace download directory structure

  2. Siga as instruções neste artigo para configurar a sessão do Azure Stack Hub Operator PowerShell.

  3. Entre em seu Azure Stack Hub com uma identidade que tenha acesso de proprietário à "Assinatura do Provedor Padrão".

  4. Importe o módulo de sindicalagem e, em seguida, iniciar a ferramenta de sindicalagem do marketplace executando o seguinte 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 Azure Stack Hub Marketplace.