Baixar itens do Marketplace para o Azure Stack Hub

  • Artigo

Como operador de nuvem, você pode baixar itens para o Azure Stack Hub do Marketplace e disponibilizá-los para todos os usuários usando o ambiente do Azure Stack Hub. Os itens que você pode escolher são de uma lista com curadoria de itens do Azure Marketplace que são testados previamente e com suporte para funcionar com o Azure Stack Hub. Itens adicionais são frequentemente adicionados a essa lista, portanto, continue a marcar de volta para 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 sindicalização do Marketplace para baixar itens do Marketplace. Em seguida, você transfere seus downloads para a instalação desconectada do Azure Stack Hub. Esse cenário usa o PowerShell.
  • Cenário conectado: requer que o ambiente do Azure Stack Hub esteja conectado à Internet. Você usa o portal do administrador do Azure Stack Hub para localizar e baixar itens.

Consulte Azure Marketplace itens do Azure Stack Hub para obter uma lista completa dos itens do marketplace que você pode baixar. Confira o artigo Alterações do Marketplace do Azure Stack Hub para obter uma lista de adições, exclusões e atualizações recentes no Azure Stack Hub Marketplace.

Observação

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

Observação

Você também pode usar a OAW (Estação de Trabalho de Acesso do Operador) para acessar o PEP (ponto de extremidade privilegiado), o portal do Administrador para cenários de suporte e as Ferramentas do GitHub do Azure Stack Hub. Para obter mais informações, consulte Estação de trabalho de acesso do operador do Azure Stack Hub.

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

Pré-requisitos

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

Usar o portal para baixar itens do marketplace

  1. Entre no portal do administrador do Azure Stack Hub.

  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: no Gerenciamento de regiões, selecione a região que você deseja explorar e vá paraArmazenamento de Provedores> de Recursos:

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

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

    Adicionar itens do marketplace do 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ãomostrará Múltiplo. Você pode clicar em cada item para exibir sua descrição e informações adicionais, incluindo seu tamanho de download:

    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últiplo, você poderá selecionar esse item e, em seguida, escolher uma versão específica na lista suspensa do seletor de versão resultante. Observe que a Microsoft agora tem a capacidade de adicionar atributos que impedem os administradores de baixar produtos do marketplace incompatíveis com o Azure Stack, devido a várias propriedades, como a versão do Azure Stack ou o modelo de cobrança. Somente a Microsoft pode adicionar estes atributos:

    Adicionar por meio de do 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 ou um usuário do Azure Stack Hub.

  7. Para implantar o item baixado, selecione + Criar um recurso e, em seguida, pesquise pelo novo item do Marketplace entre as categorias. Em seguida, selecione o item para iniciar o processo de implantação. O processo varia para diferentes itens do marketplace.

Quando o Azure Stack Hub tem conectividade limitada ou sem Internet, você usa o PowerShell e a ferramenta de sindicalizaçã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 do Azure Stack Hub. Em um ambiente desconectado, não é possível baixar itens do Marketplace usando o portal do Azure Stack Hub.

A ferramenta de sindicalizaçã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 sindicalização e, em seguida, baixa itens do Azure Marketplace.
  • Parte 2: carregar e publicar no Marketplace do Azure Stack Hub. Você move os arquivos baixados para o ambiente do Azure Stack Hub e os publica no Marketplace do Azure Stack Hub.

Pré-requisitos

  • Um ambiente conectado (não precisa ser o Azure Stack Hub). Você precisa de conectividade para obter a lista de produtos do Azure com os respectivos detalhes e para baixar tudo localmente. Depois que isso for feito, o restante do procedimento não exigirá conectividade com a Internet. Ela 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 desconectado do Azure Stack Hub com os seguintes pré-requisitos:

Baixe o módulo Azs.Syndication.Administração 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 ela não é relevante para o caso de uso desconectado:

Gerenciamento do Marketplace

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

Certifique-se de baixar a ferramenta de sindicalizaçã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.

Importante

É recomendável que você use módulos Az em vez do AzureRM. Consulte os exemplos a seguir.

  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 do AzureAD apropriados usando a conta do Azure que você usou para registrar o Azure Stack Hub. Para adicionar a conta, no PowerShell, execute 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 a 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 de pré-requisitos, baixe a versão mais recente da ferramenta de sindicalização do Marketplace se você estiver usando a versão mais recente do Azure Stack Hub:

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 a serem baixados, execute o seguinte comando:

    $products = Select-AzsMarketplaceItem

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

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

    Você deverá ver então 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 para selecionar várias imagens. Captura de tela que mostra outra lista de todos os registros do Azure Stack disponíveis na assinatura selecionada.

    Você também pode filtrar a lista de imagens usando a opção Adicionar critérios . Selecionar Registros do Azure Stack

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

  2. As IDs dos 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 que você baixar 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ê tiver especificado 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 de 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.Administração localmente para poder copiá-lo para o computador do qual você está importando itens do Marketplace para o Azure Stack Hub.

    Observação

    A pasta de destino para exportar este módulo deve ser diferente do local para o 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 localmente anteriormente para um computador que tenha conectividade com o ambiente do Azure Stack Hub. A ferramenta de sindicalização do Marketplace também precisa estar disponível para seu ambiente do Azure Stack Hub porque 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 há o conteúdo baixado do item do marketplace.

    Estrutura do diretório de download do Marketplace

  2. Siga as instruções em Conectar-se ao Azure Stack Hub com o PowerShell para configurar a sessão do PowerShell do operador do Azure Stack Hub.

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

  4. Copie o nome da pasta; por exemplo, microsoft.dsc-arm-2.77.0 e crie uma pasta com esse nome.

  5. Mova a pasta baixada para essa pasta. Neste ponto, você tem C:\microsoft.dsc-arm-2.77.0\microsoft.dsc-arm-2.77.0\original-sub-folders-are-here e C:\microsoft.dsc-arm-2.77.0\microsoft.dsc-arm-2.77.0\productDetails.json.

  6. Importe o módulo de sindicalização e inicie a ferramenta de sindicalização do marketplace executando o seguinte cmdlet:

    Import-AzsMarketplaceItem -RepositoryDir "C:\microsoft.dsc-arm-2.77.0"

  7. Depois que o cmdlet for concluído com êxito, os itens do marketplace deverão estar disponíveis no Azure Stack Hub Marketplace.

Próximas etapas

Conectar-se ao Azure Stack Hub com o PowerShell