Exercício - Configure o ambiente de exercício

Concluído

Importante

Este módulo cria recursos do Azure. Se você não planeja usar este módulo novamente ou se não concluir o módulo, certifique-se de remover os recursos criados. Incluímos instruções para remover todos os recursos no final do módulo.

Este módulo pressupõe que você tenha a CLI do Azure instalada. Você pode executar comandos a partir de uma janela do Prompt de Comando ou do Windows PowerShell. Recomendamos o PowerShell.

O módulo também pressupõe que você tenha uma conta do Azure. Você precisa das funções de Colaborador e Administrador de Acesso de Usuário ou a função de Proprietário na assinatura do Azure.

Importante

Se você pertencer a uma organização, talvez seja necessário coordenar com sua equipe de TI para criar sua conta de usuário do Azure Ative Directory (Azure AD) e conceder os privilégios apropriados. Além disso, as contas de convidado associadas à sua assinatura do Azure não atendem aos requisitos mínimos. Você deve ter uma conta de membro.

A lógica de modelo ARM foi integrada em um pré-fabricado de conexão que aciona um simulador de dados.

Faça o download da solução e do modelo ARM

Na unidade anterior, você clonou ou baixou o repositório do GitHub.

Entrar no Azure usando a CLI do Azure

1. Localize o script azuredeploy.bicep que criamos para você. Normalmente, esse arquivo está na raiz da pasta do repositório.

2. No menu Iniciar, abra o PowerShell. Todos os comandos da CLI do Azure são executados no console do PowerShell.

3. Altere o caminho atual para o local do script azuredeploy.bicep encontrado na etapa 1.

   cd <path for azuredeploy.bicep>
   

4. Entre no Azure usando o comando az login . Este comando abre uma janela do navegador e solicita autenticação.

   Nota

   Se o comando não conseguir abrir a janela apropriada do navegador, use este comando: az login --use-device-code. Esse fluxo de código de dispositivo retorna um código exclusivo. Abra a página de início de sessão do dispositivo no seu browser e introduza o código apresentado no seu terminal.

Definir variáveis no PowerShell

1. Defina a $projectname variável. Esse valor é o nome exclusivo base para os recursos do Azure que você cria neste exercício. Caracteres aleatórios extras são acrescentados ao nome do projeto. Certifique-se de que os seus valores estão entre aspas duplas.

   Nota

   As variáveis no PowerShell começam com o $ símbolo.

   $projectname="myproj"
   

   Importante

   O nome do projeto tem no máximo 14 caracteres. Ele pode conter apenas letras minúsculas, números e o caractere hífen.

2. Defina o nome do Registro do aplicativo, que pode ter no máximo 14 caracteres. Esse valor é o nome do registro do aplicativo para seu aplicativo de realidade mista.

   $appreg="myappreg"
   

Criar o Registo da Aplicação

Execute o comando a seguir para criar uma entidade de serviço e configurar seu acesso aos recursos do Azure.

az ad sp create-for-rbac --name ${appreg} --role Contributor --scopes /subscriptions/<SUBSCRIPTION-ID> > AppCredentials.txt

A saída deste comando é redirecionada da saída padrão para um arquivo de texto AppCredentials.txt . O comando cria o arquivo no mesmo diretório onde você executa o comando. Quaisquer erros que possam ocorrer são exibidos no console do PowerShell. Abra o arquivo para recuperar as credenciais e configurar o aplicativo simulador de telemetria mais tarde.

Nota

Tenha cuidado onde você mantém esse arquivo, porque ele contém credenciais. Considere excluir o arquivo depois de concluir este caminho de aprendizagem.

Obter o ID do objeto do Registro do aplicativo e o ID do usuário

1. Crie e defina uma variável para o ObjectID no PowerShell usando o comando a seguir.

   $objectid=$(az ad sp list --display-name ${appreg} --query [0].objectId --output tsv)
   

2. Valide se a variável contém um GUID usando o echo comando. Caso contrário, examine as etapas anteriores.

   echo $objectid
   

3. Crie e defina uma variável para o ID do usuário.

   $userid=$(az ad signed-in-user show --query objectId -o tsv)
   

4. Valide se a variável contém um GUID usando o echo comando. Caso contrário, examine as etapas anteriores.

   echo $userid
   

   

Criar o grupo de recursos do Azure

Crie o grupo de recursos usando o comando az group create no PowerShell:

az group create --name ${projectname}-rg --location eastus

Preste especial atenção à localização. Tem de ser eastus. Esta região é uma das regiões válidas para Microsoft.SignalRService/SignalR e Microsoft.DigitalTwins/digitalTwinsInstances.

Implantar o modelo ARM no grupo de recursos recém-criado

Implante o arquivo bicep fornecido em seu grupo de recursos e redirecione a saída para um arquivo de texto chamado ARM_deployment_out.txt. Este processo pode levar de 10 a 15 minutos para ser concluído.

az deployment group create --template-file azuredeploy.bicep --resource-group ${projectname}-rg `
   --parameters projectName=${projectname} userId=${userid} appRegObjectId=${objectid} `
   > ARM_deployment_out.txt

O ficheiro é apenas para referência. Não é necessário para o resto deste módulo.

Nota

Você pode receber várias mensagens de AVISO sobre a renomeação de URI válida de que a saída contém credenciais e disponibilidade de tipo. Reveja estes avisos, mas não é necessária uma ação imediata. Os avisos não afetam este módulo.

Gorjeta

Se você precisar recriar os recursos do Azure por qualquer motivo, certifique-se de excluir todas as instâncias anteriores de recursos e grupos de recursos.

Instalar a extensão da CLI do Azure

Instale a extensão azure-iot para a CLI do Azure no PowerShell usando o comando az extension no PowerShell.

az extension add --name azure-iot

Este comando descarrega e instala a extensão. Se já estiver instalado, o comando alerta-o.

Consultar a implantação do Azure para obter os principais parâmetros de configuração

Consulte a implantação do Azure usando o comando az deployment group show no PowerShell. Este comando redireciona a saída para um arquivo chamado Azure_config_settings.txt no mesmo diretório em que você executa o comando.

az deployment group show --name azuredeploy --resource-group ${projectname}-rg `
   --query properties.outputs.importantInfo.value > Azure_config_settings.txt

Consultar a implantação do Azure para o parâmetro de conexão do grupo de recursos

1. Use o comando az iot hub connection-string show para consultar o hub IoT para o parâmetro de cadeia de conexão do grupo de recursos. Você usa esse valor posteriormente no módulo.

   az iot hub connection-string show --resource-group ${projectname}-rg >> Azure_config_settings.txt
   

   O comando redireciona a saída e a acrescenta ao arquivo chamado Azure_config_settings.txt no mesmo diretório em que você executa o comando. Você criou esse arquivo na seção anterior. Os dois > símbolos indicam que o comando acrescenta em vez de substituir.

2. Confirme o conteúdo do arquivo de texto de saída no PowerShell. Este comando exibe vários parâmetros de configuração chave para uso posterior neste módulo.

   get-content Azure_config_settings.txt