Baixe itens de Marketplace para Azure Stack Hub

Como operador de nuvem, pode baixar itens para Azure Stack Hub a partir do Marketplace e disponibilizá-los a todos os utilizadores usando o ambiente Azure Stack Hub. Os itens que pode escolher são de uma lista com curadoria de itens do Azure Marketplace que são pré-testados e suportados para trabalhar com o Azure Stack Hub. Itens adicionais são frequentemente adicionados a esta lista, por isso continue a verificar se há novos conteúdos.

Existem dois cenários para o download de produtos marketplace:

  • Cenário desligado ou parcialmente ligado: Requer que aceda à internet utilizando a ferramenta de sindicalização marketplace para descarregar itens do Marketplace. Em seguida, transfira as suas transferências para a instalação do Azure Stack Hub desligado. Este cenário usa o PowerShell.
  • Cenário ligado: Requer que o ambiente do Azure Stack Hub esteja ligado à internet. Utiliza o portal de administrador do Azure Stack Hub para localizar e transferir itens.

Consulte os itens do Azure Marketplace para Azure Stack Hub para obter uma lista completa dos itens do mercado que pode descarregar. Veja o Azure Stack Hub Marketplace altera o artigo para uma lista de adições recentes, exclusões e atualizações para o Azure Stack Hub Marketplace.

Nota

O catálogo será diferente com base na nuvem a que o seu sistema Azure Stack Hub está ligado. O ambiente em nuvem é determinado pela subscrição Azure que utiliza para registar o seu Azure Stack Hub.

Nota

Também pode utilizar a Estação de Trabalho de Acesso ao Operador (OAW) para aceder ao ponto final privilegiado (PEP), o portal administrador para cenários de suporte e ferramentas GitHub do Azure Stack Hub. Para mais informações consulte a estação de trabalho de acesso ao operador do hub Azure Stack.

Uma implementação conectada permite-lhe usar o portal do administrador para descarregar itens de mercado.

Pré-requisitos

A sua implementação do Azure Stack Hub deve ter conectividade com a Internet e ser registada no Azure.

Use o portal para descarregar itens de mercado

  1. Inscreva-se no portal do administrador do Azure Stack Hub.

  2. Reveja o espaço de armazenamento disponível antes de descarregar itens de mercado. Mais tarde, quando selecionar itens para download, pode comparar o tamanho do download com a 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: na gestão da Região,selecione a região que pretende explorar e depois vá aos Fornecedores de RecursosArmazenamento:

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

  3. Abra o Azure Stack Hub Marketplace e ligue-se ao Azure. Para tal, selecione o serviço de gestão do Marketplace, selecione itens marketplace, e, em seguida, selecione Adicionar a partir de Azure:

    Adicionar artigos de marketplace da Azure

  4. Cada item de linha também mostra a versão atualmente disponível. Se estiver disponível mais de uma versão de um item marketplace, a coluna Versão mostra Multiple. Pode clicar em cada item para ver a sua descrição e informações adicionais, incluindo o seu tamanho de descarregamento:

    Screenshot que mostra as versões disponíveis de um item Marketplace.

  5. Se a versão de um item for mostrada como Multiple,pode selecionar esse item e, em seguida, escolher uma versão específica a partir do seletor de versão resultante. Note que a Microsoft tem agora a capacidade de adicionar atributos que bloqueiam os administradores de descarregar produtos de mercado que são incompatíveis com o seu Azure Stack, devido a várias propriedades, como a versão Azure Stack ou o modelo de faturação. Apenas a Microsoft pode adicionar estes atributos:

    Adicionar a partir de Azure

  6. Selecione o item que deseja e, em seguida, selecione Baixar. Os tempos de descarregamento variam e dependem da conectividade da rede. Após o download concluído, pode implementar o novo item de mercado como um operador Azure Stack Hub ou um utilizador.

  7. Para implementar o item descarregado, selecione + Crie um recursoe, em seguida, procure entre as categorias para o novo item do mercado. Em seguida, selecione o item para iniciar o processo de implantação. O processo varia para diferentes itens de mercado.

Quando o Azure Stack Hub tem uma conectividade limitada ou sem internet, utiliza-se o PowerShell e a ferramenta de sindicalização do mercado para descarregar os itens de mercado para uma máquina com conectividade com internet. Em seguida, transfira os itens para o seu ambiente Azure Stack Hub. Num ambiente desligado, não é possível descarregar itens de marketplace utilizando o portal Azure Stack Hub.

A ferramenta de sindicalização do mercado também pode ser usada num cenário conectado.

Há duas partes neste cenário:

  • Parte 1: Descarregue a partir de itens do Marketplace. No computador com acesso à Internet, configura o PowerShell, descarrega a ferramenta de sindicalização e, em seguida, descarrega itens do Azure Marketplace.
  • Parte 2: Faça upload e publicação no Azure Stack Hub Marketplace. Move os ficheiros que descarregou para o seu ambiente Azure Stack Hub e depois publica-os no Azure Stack Hub Marketplace.

Pré-requisitos

  • Um ambiente conectado (não tem de ser O Azure Stack Hub). Você precisa de conectividade para obter a lista de produtos da Azure com os seus detalhes, e para baixar tudo localmente. Uma vez feito isto, o resto do procedimento não requer conectividade à Internet. Cria um catálogo de itens que já descarregou para utilizar no seu ambiente desligado.

  • Meios de comunicação amovíveis para ligar ao seu ambiente desligado e transferir todos os artefactos necessários.

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

Descarregue o módulo Azs.Syndication.Admin da PowerShell Gallery utilizando o seguinte comando:

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

Uma vez registado o seu Azure Stack, pode ignorar a seguinte mensagem que aparece na lâmina de gestão do Mercado, uma vez que esta não é relevante para o caso de utilização desligado:

Gestão do mercado

Use a ferramenta de sindicalização do mercado para descarregar itens de mercado

Importante

Certifique-se de baixar a ferramenta de sindicalização do mercado sempre que descarregar itens de marketplace num cenário desconectado. São feitas alterações frequentes nesta ferramenta e a versão mais atual deve ser utilizada para cada download.

  1. Num computador com ligação à Internet, abra uma consola PowerShell como administrador.

  2. Inscreva-se na nuvem Azure e inquilino do diretório AzureAD usando a conta Azure que usou para registar o Azure Stack Hub. Para adicionar a conta, na execução Connect-AzAccount PowerShell:

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

    É-lhe pedido que introduza as suas credenciais de conta Azure e poderá ter de utilizar a autenticação de dois fatores, dependendo da configuração da sua conta.

    Nota

    Se a sessão expirar, a sua palavra-passe mudou ou pretende mudar de conta, executar o seguinte cmdlet antes de iniciar sessão com Connect-AzAccount : Remove-AzAccount -Scope Process .

  3. Se tiver várias subscrições, execute o seguinte comando para selecionar o que utilizou para o registo:

    Get-AzSubscription -SubscriptionID 'Your Azure Subscription GUID' | Select-AzSubscription
    
  4. Se ainda não o fez na etapa de pré-requisitos, descarregue a versão mais recente da ferramenta de sindicalização Marketplace se estiver a utilizar 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, tais como imagens VM, extensões ou modelos de solução para descarregar, executar o seguinte comando:

    $products = Select-AzsMarketplaceItem
    

    Isto apresenta uma tabela que lista todas as inscrições do Azure Stack disponíveis na subscrição selecionada. Escolha o registo que corresponde ao ambiente Azure Stack para o qual está a descarregar os itens de mercado e selecione OK.

    Screenshot que mostra uma lista de todos os registos Azure Stack disponíveis na subscrição selecionada.

    Você deve agora ver uma segunda tabela listando todos os itens de mercado disponíveis para download. Selecione o item que pretende descarregar e tome nota da versão. Pode segurar a tecla Ctrl para selecionar várias imagens. Screenshot que mostra outra lista de todos os registos Azure Stack disponíveis na subscrição selecionada.

    Também pode filtrar a lista de imagens utilizando a opção de critérios Adicionar. Selecione registos de pilhas de Azure

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

  2. Os IDs para os itens marketplace que selecionou para download são guardados na $products variável. Utilize o comando abaixo para começar a descarregar os itens selecionados. Substitua o caminho da pasta de destino por uma localização para armazenar os ficheiros que descarrega a partir do Azure Marketplace:

    $products | Export-AzsMarketplaceItem  -RepositoryDir "Destination folder path in quotes"
    
  3. O tempo que o download demora depende do tamanho do item. Após o download concluído, o item está disponível na pasta que especificou no script. O download inclui um ficheiro VHD (para máquinas virtuais) ou um ficheiro .zip (para extensões de máquinas virtuais e fornecedores de recursos). Também pode incluir um pacote de galeria no formato .azpkg, que é um ficheiro .zip.

  4. Se o download falhar, pode tentar novamente recorrê-lo recortando o seguinte cmdlet PowerShell:

    $products | Export-AzsMarketplaceItem  -RepositoryDir "Destination folder path in quotes"
    
  5. Também deve exportar o módulo Azs.Syndication.Admin localmente para que possa copiá-lo para a máquina a partir da qual está a importar artigos do Marketplace para o Azure Stack Hub.

    Nota

    A pasta de destino para exportação deste módulo deve ser diferente da localização para onde exportou os itens do mercado.

    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 PowerShell

  1. Tem de mover os ficheiros que já descarregou localmente para uma máquina que tenha conectividade com o ambiente Azure Stack Hub. A ferramenta de sindicalização do mercado também deve estar disponível para o seu ambiente Azure Stack Hub porque precisa de usar a ferramenta para realizar a operação de importação.

    A imagem a seguir mostra um exemplo de estrutura de pasta. D:\downloadfolder contém todos os itens de mercado descarregados. Cada sub-segmentador é um item de mercado (por exemplo, microsoft.custom-script-linux-arm-2.0.3), nomeado pelo ID do produto. Dentro de cada sub-página está o conteúdo descarregado do item do mercado.

    Estrutura de diretório de descarregamento de mercado

  2. Siga as instruções deste artigo para configurar a sessão PowerShell do operador do hub de pilha de Azure.

  3. Inscreva-se no seu Azure Stack Hub com uma identidade que tenha acesso ao proprietário à "Subscrição predefinida do Fornecedor".

  4. Importe o módulo de sindicalização e, em seguida, lance a ferramenta de sindicalização do mercado executando o seguinte script:

    Import-AzsMarketplaceItem -RepositoryDir "Source folder path in quotes"
    
  5. Após o script ter sido concluído com sucesso, os itens de marketplace devem estar disponíveis no Azure Stack Hub Marketplace.