Baixar itens do Marketplace no Azure Stack Hub
Como operador de nuvem, você pode baixar itens para o Azure Stack Hub no 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 com suporte para trabalhar com o Azure Stack Hub. Itens adicionais são frequentemente adicionados a esta lista, portanto, continue a verificar novamente 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 sindicaçã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: exige que seu ambiente do Azure Stack Hub esteja conectado à Internet. Use o portal de 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 de itens do marketplace que você pode baixar. Consulte o artigo Alterações do marketplace do Azure Stack Hub para obter uma lista de adições, exclusões e atualizações recentes do marketplace do Azure Stack Hub.
Nota
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.
Nota
Você também pode usar A OAW (Estação de Trabalho de Acesso ao Operador) para acessar o PEP (ponto de extremidade privilegiado), o portal do administrador para cenários de suporte e as ferramentas de GitHub do Azure Stack Hub. Para obter mais informações, consulte a 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
Entre no portal de administrador do Azure Stack Hub.
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 opções para gerenciar o espaço disponível.
Para examinar o espaço disponível: em Região de gerenciamento, selecione a região que você deseja explorar e vá para Provedores de Recursos>Armazenamento:
Abra o Azure Stack Hub Marketplace e conecte-se ao Azure. Para fazer isso, selecione o serviço Gerenciamento do marketplace, selecione Itens do marketplace e, em seguida, Adicionar do Azure:
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árias. Você pode clicar em cada item para exibir sua descrição e informações adicionais, incluindo seu tamanho de download:
Se a versão de um item for mostrada como Várias, você poderá selecionar esse item e escolher uma versão específica na lista suspensa disponível no seletor de versão. Observe que a Microsoft agora tem a capacidade de adicionar atributos que impedem os administradores de baixar produtos do marketplace 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 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 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 marketplace.
Quando o Azure Stack Hub tem conectividade limitada ou sem conectividade com a Internet, você pode usar 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 o 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 sindicalização do Marketplace também pode ser usada em um cenário conectado.
Há duas partes neste 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 os itens do Azure Marketplace.
- Parte 2: carregar e publicar no Azure Stack Hub Marketplace. Mova os arquivos baixados para o ambiente do Azure Stack Hub e, em seguida, publique-os 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 baixar tudo localmente. Depois que 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 você usar em seu ambiente desconectado.
- Mídia removível para se conectar ao 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 do PowerShell do Azure Stack Hub versão 1.2.11 ou posterior. Se ainda não estiver presente, instale os módulos específicos do PowerShell para o Azure Stack Hub.
- Para habilitar a importação de um item do marketplace baixado, o ambiente 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 o Azure Stack Hub, você pode desconsiderar a seguinte mensagem exibida 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 de lá
Certifique-se de baixar a ferramenta de distribuição de conteúdo 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 usar módulos do Az em vez do AzureRM, pois o AzureRM foi preterido. Veja os exemplos a seguir.
Em um computador com uma conexão com a Internet, abra um console do PowerShell como administrador.
Faça login no locatário apropriado do diretório do Entra ID e da nuvem do Azure usando a conta do Azure que você utilizou 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 conta.
Nota
Se a sessão expirar, sua senha tiver sido alterada ou você quiser alternar as contas, execute o seguinte cmdlet antes de entrar usando
Connect-AzAccount:Remove-AzAccount -Scope Process.Se você tiver várias assinaturas, execute o seguinte comando para selecionar a que você usou para o registro:
Get-AzSubscription -SubscriptionID 'Your Azure Subscription GUID' | Select-AzSubscriptionSe 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 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 a serem baixados, 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 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.
Você também pode filtrar a lista de imagens usando a opção Adicionar critérios.
Depois de fazer suas seleções, selecione OK.
As IDs dos itens do marketplace que você selecionou para download são salvas 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 que você baixa 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 poder copiá-lo para o computador do qual você está importando itens do marketplace para o Azure Stack Hub.
Nota
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
É necessário mover os arquivos baixados anteriormente no local para um computador que tenha conectividade com seu ambiente do Azure Stack Hub. A ferramenta de sindicalização do marketplace também deve 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 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 há o conteúdo baixado do item do marketplace.
estrutura de diretório de download do
Siga as instruções em Conectar-se ao Azure Stack Hub com o PowerShell para configurar a sessão powershell do operador do Azure Stack Hub.
Entre em seu Azure Stack Hub com uma identidade que tenha acesso de proprietário à Assinatura de provedor 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 momento, 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.
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"Depois que o cmdlet for concluído com êxito, os itens do marketplace deverão estar disponíveis no Azure Stack Hub Marketplace.