Usar perfis de versão de API com o .NET no Azure Stack Hub
Importante
O SDK do .NET foi atualizado da faixa 1 para a faixa 2. É altamente recomendável migrar para o SDK da faixa 2 assim que possível. Consulte este guia de migração para obter instruções.
O SDK do .NET para o Azure Stack Hub Resource Manager fornece ferramentas para ajudá-lo a criar e gerenciar sua infraestrutura. Os provedores de recursos no SDK incluem Computação, Rede, Armazenamento, Serviços de Aplicativos e Key Vault. O SDK do .NET inclui 14 pacotes NuGet. Se você estiver usando a faixa preterida 1 SDK do .NET (não recomendado), esses pacotes serão com versões com perfis de API, como 2020-09-01-hybrid e 2019-03-01-hybrid. Os perfis de API no SDK do .NET permitem o desenvolvimento de nuvem híbrida, ajudando você a alternar entre os recursos globais do Azure e os recursos do Azure Stack Hub. Consulte a seção Perfis de versão do .NET e da API para obter mais informações.
Instalar o SDK do .NET do Azure
- Instale o Git. Para obter instruções, consulte Introdução – Instalando o Git.
- Para instalar os pacotes NuGet corretos, consulte Versões de distribuição do NuGet disponíveis.
Perfis de versão do .NET e da API
Um perfil de API é uma combinação de provedores de recursos e versões de API. Use um perfil de API para obter a versão mais recente e estável de cada tipo de recurso em um pacote de provedor de recursos.
Se você estiver usando o SDK do .NET da faixa 2 (recomendado), poderá usar os pacotes padrão
Azure.*
e configurar versões de API em seu código. Consulte a seção de exemplos para obter exemplos disso e esta consulta para pacotes padrãoAzure.*
.Se você estiver usando o SDK do .NET da faixa 1 (não recomendado), deverá baixar um dos pacotes a seguir para aproveitar os serviços do Azure Stack Hub. Baixe o que corresponde ao seu perfil de API:
Observação
A parte ResourceProvider da especificação do pacote NuGet deve ser alterada. Além disso, os pacotes para o SDK do .NET da faixa 1 foram preteridos, portanto, você pode enfrentar erros. É recomendável atualizar para o SDK do .NET da faixa 2 assim que possível.
Perfis
Para perfis que contêm datas, para usar um perfil ou versão diferente do SDK, substitua a data em Microsoft.Azure.Management.Profiles.hybrid_<date>.ResourceManager
. Por exemplo, para a versão 2008, o perfil é 2019_03_01
e a cadeia de caracteres se torna Microsoft.Azure.Management.Profiles.hybrid_2019_03_01.ResourceManager
. Observe que, às vezes, a equipe do SDK altera o nome dos pacotes, portanto, simplesmente substituir a data de uma cadeia de caracteres por uma data diferente pode não funcionar. Consulte a tabela a seguir para associação de 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, consulte o Resumo dos perfis de API.
Subscription
Se você ainda não tiver uma assinatura, crie uma assinatura e salve a ID da assinatura a ser usada posteriormente. Para obter informações sobre como criar uma assinatura, consulte este documento.
Entidade de serviço
Uma entidade de serviço e suas informações de ambiente associadas devem ser criadas e salvas em algum lugar. A entidade de serviço com owner
função é recomendada, mas dependendo do exemplo, uma contributor
função pode ser suficiente. Consulte o LEIAME no repositório de exemplo para obter os valores necessários. Você pode ler esses valores em qualquer formato compatível com a linguagem SDK, como de um arquivo JSON (que nossos exemplos usam). Dependendo do exemplo que está sendo executado, nem todos esses valores podem ser usados. Consulte o repositório de exemplo para obter o código de exemplo atualizado ou mais informações.
ID do locatário
Para localizar a ID do diretório ou do locatário do Azure Stack Hub, siga as instruções neste artigo.
Registrar provedores de recursos
Registre os provedores de recursos necessários seguindo este documento. Esses provedores de recursos serão necessários dependendo dos exemplos que você deseja executar. Por exemplo, se você quiser executar um exemplo de VM, o registro do Microsoft.Compute
provedor de recursos será necessário.
Ponto de extremidade do Azure Stack Resource Manager
O ARM (Azure Resource Manager) é uma estrutura de gerenciamento que permite aos administradores implantar, gerenciar e monitorar recursos do Azure. O Azure Resource Manager pode lidar com essas tarefas como um grupo, em vez de individualmente, em uma única operação. Você pode obter as informações de metadados do ponto de extremidade Resource Manager. O ponto de extremidade retorna um arquivo JSON com as informações necessárias para executar seu código.
- O ResourceManagerEndpointUrl no ASDK (Kit de Desenvolvimento do Azure Stack) é:
https://management.local.azurestack.external/
. - O ResourceManagerEndpointUrl em sistemas integrados é:
https://management.region.<fqdn>/
, em que<fqdn>
é o nome de domínio totalmente qualificado. - Para recuperar os metadados necessários:
<ResourceManagerUrl>/metadata/endpoints?api-version=1.0
. Para versões de API disponíveis, confira Especificações da API rest do Azure. Por exemplo, na2020-09-01
versão do perfil, você pode alterar oapi-version
para para2019-10-01
o provedor de recursosmicrosoft.resources
.
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"]
}
}
Exemplos
Consulte este repositório de exemplo para obter o código de exemplo de atualização até a data (faixa 2). Consulte este repositório de exemplo para obter o código de exemplo da faixa 1. A raiz README.md
descreve os requisitos gerais e cada subdiretório contém um exemplo específico com seu próprio README.md
que descreve como executar esse exemplo.
Consulte aqui para obter o exemplo aplicável para a versão 2008
ou perfil 2019-03-01
do Azure Stack e abaixo.
Próximas etapas
Saiba mais sobre perfis de API: