Transferir itens do Marketplace para o 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:

    Review storage space in Azure Stack Hub administrator portal

  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:

    Add marketplace items from 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 that shows the available versions of a Marketplace item.

  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:

    Add from 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:

Marketplace management

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 that shows a list of all the Azure Stack registrations available in the selected subscription.

    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 that shows another list of all the Azure Stack registrations available in the selected subscription.

    Também pode filtrar a lista de imagens utilizando a opção de critérios Adicionar. Select Azure Stack Registrations

    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.

    Marketplace download directory structure

  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.