Utilizar perfis de versão de API com .NET no Azure Stack Hub

  • Artigo

Importante

O SDK .NET foi atualizado da faixa 1 para a faixa 2. Recomendamos vivamente a migração para o SDK track 2 o mais rapidamente possível. Veja este guia de migração para obter instruções.

O SDK .NET para o Azure Stack Hub Resource Manager fornece ferramentas para o ajudar a criar e gerir a sua infraestrutura. Os fornecedores de recursos no SDK incluem Computação, Rede, Armazenamento, Serviços aplicacionais e Key Vault. O SDK .NET inclui 14 pacotes NuGet. Se estiver a utilizar o SDK .NET da faixa 1 preterido (não recomendado), estes pacotes têm uma versão com perfis de API, como 2020-09-01-hybrid e 2019-03-01-hybrid. Os perfis de API no SDK .NET permitem o desenvolvimento de cloud híbrida, ajudando-o a alternar entre os recursos globais do Azure e os recursos do Azure Stack Hub. Veja a secção Perfis de versão de .NET e API para obter mais informações.

Instalar o SDK .NET do Azure

Perfis de versão de .NET e API

Um perfil de API é uma combinação de fornecedores de recursos e versões de API. Utilize um perfil de API para obter a versão mais recente e estável de cada tipo de recurso num pacote de fornecedor de recursos.

Nota

A parte ResourceProvider da especificação do pacote NuGet tem de ser alterada. Além disso, os pacotes para o SDK .NET do track 1 são preteridos, pelo que poderá enfrentar erros. Recomendamos que atualize para o SDK do .NET track 2 o mais rapidamente possível.

Perfis

Para perfis que contenham datas, para utilizar um perfil ou versão do SDK diferente, substitua a data em Microsoft.Azure.Management.Profiles.hybrid_<date>.ResourceManager. Por exemplo, para a versão de 2008, o perfil é 2019_03_01e a cadeia torna-se Microsoft.Azure.Management.Profiles.hybrid_2019_03_01.ResourceManager. Tenha em atenção que, por vezes, a equipa do SDK altera o nome dos pacotes, pelo que simplesmente substituir a data de uma cadeia por uma data diferente poderá não funcionar. Veja a tabela seguinte para associar perfis e versões do Azure Stack.

Versão do Azure Stack Perfil
2311 2020_09_01
2301 2020_09_01
2206 2020_09_01
2108 2020_09_01
2102 2020_09_01
2008 2019_03_01

Para obter mais informações sobre o Azure Stack Hub e perfis de API, veja Resumo dos perfis de API.

Subscrição

Se ainda não tiver uma subscrição, crie uma subscrição e guarde o ID da subscrição para ser utilizado mais tarde. Para obter informações sobre como criar uma subscrição, veja este documento.

Service principal (Principal de serviço)

Um principal de serviço e as respetivas informações de ambiente associadas devem ser criadas e guardadas algures. O principal de serviço com owner função é recomendado, mas dependendo do exemplo, uma função contributor pode ser suficiente. Veja o README no repositório de exemplo para obter os valores necessários. Pode ler estes valores em qualquer formato suportado pela linguagem SDK, como a partir de um ficheiro JSON (que os nossos exemplos utilizam). Consoante o exemplo que está a ser executado, nem todos estes valores podem ser utilizados. Veja o repositório de exemplo para obter código de exemplo atualizado ou mais informações.

ID do inquilino

Para localizar o diretório ou ID de inquilino do Azure Stack Hub, siga as instruções neste artigo.

Registar fornecedores de recursos

Registe os fornecedores de recursos necessários ao seguir este documento. Estes fornecedores de recursos serão necessários consoante os exemplos que pretende executar. Por exemplo, se quiser executar um exemplo de VM, é necessário o registo do Microsoft.Compute fornecedor de recursos.

Ponto final do gestor de recursos do Azure Stack

O Azure Resource Manager (ARM) é uma arquitetura de gestão que permite aos administradores implementar, gerir e monitorizar recursos do Azure. O Azure Resource Manager pode processar estas tarefas como um grupo, em vez de individualmente, numa única operação. Pode obter as informações de metadados a partir do ponto final Resource Manager. O ponto final devolve um ficheiro JSON com as informações necessárias para executar o código.

  • O ResourceManagerEndpointUrl no Azure Stack Development Kit (ASDK) é: https://management.local.azurestack.external/.
  • O ResourceManagerEndpointUrl em sistemas integrados é: https://management.region.<fqdn>/, onde <fqdn> é o seu nome de domínio completamente qualificado.
  • Para obter os metadados necessários: <ResourceManagerUrl>/metadata/endpoints?api-version=1.0. Para obter as versões de API disponíveis, veja Especificações da API rest do Azure. Por exemplo, na 2020-09-01 versão do perfil, pode alterar o api-version para 2019-10-01 para o fornecedor microsoft.resourcesde recursos .

JSON de exemplo:

{
   "galleryEndpoint": "https://portal.local.azurestack.external:30015/",
   "graphEndpoint": "https://graph.windows.net/",
   "portal Endpoint": "https://portal.local.azurestack.external/",
   "authentication": 
      {
         "loginEndpoint": "https://login.windows.net/",
         "audiences": ["https://management.yourtenant.onmicrosoft.com/3cc5febd-e4b7-4a85-a2ed-1d730e2f5928"]
      }
}

Amostras

Veja este repositório de exemplo para obter o código de exemplo de atualização até à data (faixa 2). Veja este repositório de exemplo para controlar 1 código de exemplo. A raiz README.md descreve os requisitos gerais e cada subdiretório contém um exemplo específico com o seu próprio README.md que descreve como executar esse exemplo.

Veja aqui o exemplo aplicável à versão 2008 ou perfil 2019-03-01 do Azure Stack e abaixo.

Passos seguintes

Saiba mais sobre os perfis de API: