Baixar itens do Marketplace para o Azure Stack Hub
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 estão em uma lista selecionada de itens do Azure Marketplace que são pré-testados e suportados para funcionar com o Azure Stack Hub. Itens adicionais são frequentemente adicionados a esta lista, portanto, continue a verificar novamente se há novos conteúdos.
Há dois cenários para baixar produtos do Marketplace:
- Cenário desconectado ou parcialmente conectado: Requer 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 Azure Stack Hub. Este cenário usa o PowerShell.
- Cenário conectado: Requer que seu ambiente do Azure Stack Hub esteja conectado à Internet. Use o portal do administrador do Azure Stack Hub para localizar e baixar itens.
Consulte itens do Azure Marketplace para o Azure Stack Hub para obter uma lista completa dos itens do marketplace que você pode baixar. Consulte o artigo sobre as alterações no Marketplace do Azure Stack Hub para obter uma lista de adições, exclusões e atualizações recentes.
Observação
O catálogo será diferente com base na nuvem à qual seu sistema 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 Estação de Trabalho de Acesso ao Operador (OAW) para acessar o ponto de extremidade privilegiado (PEP), o portal do administrador para cenários de suporte e as Ferramentas GitHub do Azure Stack Hub. Para obter mais informações, consulte Estação de Trabalho de Acesso para Operadores 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 estar registrada no Azure.
Use o portal para baixar itens do marketplace
Entre no portal do administrador do Azure Stack Hub.
Revise o espaço de armazenamento disponível antes de baixar itens do marketplace. Mais tarde, ao selecionar itens para download, você pode comparar o tamanho do download com sua capacidade de armazenamento disponível. Se a capacidade for limitada, considere opções para gerir o espaço disponível.
Para rever o espaço disponível: em gestão de Região, selecione a região que pretende explorar e, em seguida, aceda a Fornecedores de Recursos>Armazenamento:
Abra o Azure Stack Hub Marketplace 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 do Azure .
Cada item de linha também mostra a versão atualmente disponível. 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 ver sua descrição e informações adicionais, incluindo o tamanho do download:
Se a versão de um item for mostrada como Vários, 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 que são incompatíveis com seu 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:
Selecione o item desejado e, em seguida, selecione Download. 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 do Azure Stack Hub ou um usuário.
Para implantar o item baixado, selecione + Criar um recursoe pesquise as categorias para o novo item do marketplace. Em seguida, selecione o item para iniciar o processo de implantação. O processo varia para diferentes itens do mercado.
Quando o Azure Stack Hub tem conectividade com a Internet limitada ou inexistente, você pode usar o PowerShell e a ferramenta de distribuição do marketplace para baixar os itens do marketplace para uma máquina com conectividade com a Internet. Em seguida, você transfere os itens para seu ambiente do Azure Stack Hub. Em um ambiente desconectado, você não pode baixar itens do marketplace usando o portal do Azure Stack Hub.
A ferramenta de distribuição da plataforma de mercado também pode ser usada num cenário conectado.
Há duas partes para este cenário:
- Parte 1: Download de itens do Marketplace. No computador com acesso à Internet, configure o PowerShell, transfira a ferramenta de distribuição e, em seguida, transfira itens do Azure Marketplace.
- Parte 2: Carregar e publicar no Azure Stack Hub Marketplace. Você move os arquivos baixados para seu ambiente do Azure Stack Hub e os publica no Azure Stack Hub Marketplace.
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 seus detalhes e para baixar tudo localmente. Uma vez feito isso, o resto do procedimento não requer conectividade com a Internet. Ele cria um catálogo de itens que você baixou anteriormente para usar 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:
- Sua implantação do Azure Stack Hub deve ser registrada no Azure.
- O computador que tem conectividade com a Internet deve ter Módulo PowerShell do Azure Stack Hub versão 1.2.11 ou posterior. Se ainda não estiver presente, instale os módulos PowerShell específicos do Azure Stack Hub.
- Para habilitar a importação de um item de marketplace baixado, o ambiente do PowerShell para o operador do Azure Stack Hub deve ser configurado.
- .NET Framework 4.7 ou posterior.
Baixe o módulo Azs.Syndication.Admin da 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 Hub, você pode ignorar a seguinte mensagem que aparece na folha de gerenciamento do marketplace, pois isso não é relevante para o caso de uso desconectado:
Use a ferramenta de distribuição do marketplace para baixar itens do marketplace
Certifique-se de baixar a ferramenta de distribuição do marketplace sempre que baixar itens do marketplace em um cenário desconectado. Alterações frequentes são feitas nesta ferramenta e a versão mais atual deve ser usada para cada download.
Importante
É recomendável usar os módulos Az em vez de AzureRM, pois AzureRM está descontinuado. Veja os exemplos a seguir.
Em um computador com conexão com a Internet, abra um console do PowerShell como administrador.
Entre na nuvem do Azure apropriada e no locatário do diretório Entra ID 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 seja necessário usar a autenticação de dois fatores, dependendo da configuração da sua conta.
Observação
Se sua sessão expirar, sua senha tiver sido alterada ou você quiser mudar de conta, execute o seguinte cmdlet antes de entrar usando
Connect-AzAccount:Remove-AzAccount -Scope Process.Se tiver várias subscrições, execute o seguinte comando para selecionar a que utilizou para o registo:
Get-AzSubscription -SubscriptionID 'Your Azure Subscription GUID' | Select-AzSubscriptionSe você ainda não tiver feito isso na etapa de pré-requisitos, baixe a versão mais recente da ferramenta de distribuição do marketplace se 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
Para selecionar itens do marketplace, como imagens de VM, extensões ou modelos de solução para download, execute o seguinte comando:
$products = Select-AzsMarketplaceItemIsso 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.
Agora você deve ver uma segunda tabela listando todos os itens do mercado disponíveis para download. Selecione o item que deseja baixar e anote a versão . Você pode manter pressionada a tecla Ctrl para selecionar várias imagens.
Você também pode filtrar a lista de imagens usando a opção Adicionar critérios.
Depois de fazer suas seleções, selecione OK.
Os IDs dos itens do marketplace selecionados para download são salvos na variável
$products. Use o comando a seguir para 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"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 especificada 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.Se o download falhar, você poderá tentar novamente executando novamente o seguinte cmdlet do PowerShell:
$products | Export-AzsMarketplaceItem -RepositoryDir "Destination folder path in quotes"Você também deve exportar o módulo Azs.Syndication.Admin localmente para que possa copiá-lo para a máquina da qual 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
Importe o download e publique no Azure Stack Hub Marketplace usando o PowerShell
Você deve mover os arquivos que você baixado anteriormente localmente para uma máquina que tenha conectividade com seu ambiente do Azure Stack Hub. A ferramenta de distribuição do marketplace também deve estar disponível para seu ambiente do 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 pastas. 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.
Siga as instruções em Conectar ao Azure Stack Hub com PowerShell para configurar a sessão PowerShell do operador do Azure Stack Hub.
Entre no seu Azure Stack Hub com uma identidade que tenha acesso de proprietário à Subscrição do Fornecedor Padrão .
Copie o nome da pasta; Por exemplo, microsoft.dsc-arm-2.77.0e crie uma pasta com esse nome.
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.jsno.
Importe o módulo de distribuição e inicie a ferramenta de distribuição do marketplace executando o seguinte cmdlet:
Import-AzsMarketplaceItem -RepositoryDir "C:\microsoft.dsc-arm-2.77.0"Depois que o cmdlet for concluído com êxito, os itens do marketplace deverão estar disponíveis no Azure Stack Hub Marketplace.