Compartilhar via

Implantar o acelerador da solução de monitoramento remoto localmente - Visual Studio

  • Artigo

Este artigo mostra como implantar o acelerador de solução de Monitoramento Remoto no computador local para teste e desenvolvimento. Você aprenderá como executar os microsserviços no Visual Studio. Uma implantação de microsserviços local usa os seguintes serviços de nuvem: Hub IoT, Cosmos DB, Azure Streaming Analytics e Azure Time Series Insights.

Se você quiser executar o acelerador de solução de Monitoramento Remoto no Docker em seu computador local, confira Implantar o acelerador de solução de Monitoramento Remoto localmente – Docker.

Pré-requisitos

Para implantar os serviços do Azure usados pelo acelerador de solução de Monitoramento Remoto, você precisará de uma assinatura ativa do Azure.

Se você não tiver uma conta, poderá criar uma conta de avaliação gratuita em apenas alguns minutos. Para obter detalhes, consulte Avaliação gratuita do Azure.

Configuração do computador

Para concluir a implantação local, você precisa ter as seguintes ferramentas instaladas no computador de desenvolvimento local:

Observação

O Visual Studio está disponível para Windows e Mac.

Fazer o download do código-fonte

Os repositórios de código-fonte de Monitoramento Remoto incluem o código-fonte e os arquivos de configuração do Docker necessários para executar as imagens do Docker dos microsserviços.

Para clonar e criar uma versão local do repositório, use o ambiente da linha de comando para navegar até uma pasta adequada no computador local. Em seguida, execute um dos seguintes conjuntos de comandos para clonar o repositório do .NET:

Para baixar a versão mais recente das implementações do microsserviço .NET, execute:

git clone --recurse-submodules https://github.com/Azure/azure-iot-pcs-remote-monitoring-dotnet.git

# To retrieve the latest submodules, run the following command:

cd azure-iot-pcs-remote-monitoring-dotnet
git submodule foreach git pull origin master

Observação

Esses comandos baixam o código-fonte para todos os microsserviços, bem como os scripts usados para executar os microsserviços localmente. Embora o código-fonte não seja necessário para executar os microsserviços no Docker, ele é útil se você planeja modificar o acelerador de solução e testar suas alterações localmente no futuro.

Implantar os serviços do Azure

Embora este artigo mostre como executar os microsserviços localmente, eles dependem de serviços do Azure em execução na nuvem. Use o seguinte script a seguir para implantar os serviços do Azure. Os exemplos de script a seguir pressupõem que você estará usando o repositório .NET em um computador Windows. Se estiver trabalhando em outro ambiente, ajuste os caminhos, extensões de arquivo e separadores de caminho adequadamente.

Criar novos recursos do Azure

Se você ainda não criou os recursos do Azure necessários, siga estas etapas:

  1. No ambiente da linha de comando, navegue até a pasta \services\scripts\local\launch em sua cópia clonada do repositório.

  2. Execute os seguintes comandos para instalar as ferramentas da CLI pcs e entrar em sua conta do Azure:

    npm install -g iot-solutions
pcs login

  3. Execute o script start.cmd. O script solicitará as seguintes informações:

    • Um nome de solução.

    • A assinatura do Azure a utilizar.

    • O local do datacenter do Azure para usar.

      O script cria um grupo de recursos no Azure com o nome da solução. Esse grupo de recursos contém os recursos do Azure usados pelo acelerador de solução. Depois que você não precisar mais dos recursos correspondentes, você pode excluir esse grupo de recursos.

      O script também adiciona um conjunto de variáveis de ambiente com um prefixo PCS em seu computador local. Essas variáveis de ambiente fornecem os detalhes para que o Monitoramento Remoto possa ser lido de um recurso do Azure Key Vault. Esse recurso Key Vault é de onde o Monitoramento Remoto lerá seus valores de configuração.

      Dica

      Quando o script for concluído, ele também salvará as variáveis de ambiente em um arquivo chamado <pasta> inicial\.pcs\<solution name.env>. Você pode usá-las para implantações futuras de acelerador de solução. Observe que todas as variáveis de ambiente definidas em seu computador local substituem valores no arquivo services\scripts\local\.env ao executar docker-compose.

  4. Saia do ambiente de linha de comando.

Usar recursos existentes do Azure

Se você já tiver criado os recursos necessários do Azure, crie as variáveis de ambiente correspondentes no seu computador local. Defina as variáveis de ambiente para o seguinte:

  • PCS_KEYVAULT_NAME - Nome do recurso Key Vault do Azure
  • PCS_AAD_APPID - A ID do aplicativo AAD
  • PCS_AAD_APPSECRET - O segredo do aplicativo AAD

Os valores de configuração serão lidos neste recurso de Key Vault do Azure. Essas variáveis de ambiente podem ser salvas no <arquivo home folder>\.pcs\<solution name.env> da implantação. Observe que as variáveis de ambiente definidas em seu computador local substituem valores no arquivo services\scripts\local\.env quando você executa o docker-compose.

Parte da configuração necessária pelo microsserviço é armazenada em uma instância de Key Vault que foi criada na implantação inicial. As variáveis correspondentes no keyvault devem ser modificadas conforme necessário.

Executar os microsserviços

Nesta seção, você executa os microsserviços do Monitoramento Remoto. Execute a interface do usuário da Web nativamente, o serviço de Simulação de Dispositivo no Docker e os microsserviços no Visual Studio.

Executar o serviço de simulação de dispositivo

Abra uma nova janela do prompt de comando para ter certeza de que você tem acesso às variáveis de ambiente definidas pelo script start.cmd na seção anterior.

Execute o seguinte comando para iniciar o contêiner do Docker para o serviço de simulação de dispositivo. O serviço simula os dispositivos para a solução de monitoramento remoto.

<path_to_cloned_repository>\services\device-simulation\scripts\docker\run.cmd

Implantar todos os outros microsserviços na máquina local

As etapas a seguir mostram como executar os microsserviços de Monitoramento Remoto no Visual Studio:

  1. Inicie o Visual Studio.
  2. Abra a solução remoto monitoring.sln na pasta serviços em sua cópia local do repositório.
  3. No Gerenciador de Soluções, clique com o botão direito na solução e clique em Propriedades.
  4. Selecione Project de Inicialização de Propriedades > Comuns.
  5. Selecione Vários projetos de inicialização e defina Ação como Iniciar para os projetos a seguir:
    • WebService (asa-manager\WebService)
    • WebService (auth\WebService)
    • WebService (config\WebService)
    • WebService (device-telemetry\WebService)
    • WebService (iothub-manager\WebService)
    • WebService (storage-adapter\WebService)
  6. Clique em OK para salvar suas opções.
  7. Clique em Depurar > Iniciar Depuração para compilar e executar os serviços Web no computador local.

Cada serviço Web abre uma janela do navegador e do prompt de comando. No prompt de comando, há uma saída do serviço em execução, e a janela do navegador permite que você monitore o status. Não feche os prompts de comando ou páginas da Web, essa ação interrompe o serviço Web.

Iniciar o trabalho do Stream Analytics

Execute estas etapas para iniciar o trabalho do Stream Analytics:

  1. Navegue até o Portal do Azure.
  2. Navegue até o Grupo de recursos criado para sua solução. O nome do grupo de recursos é o nome escolhido para sua solução quando você executou o script start.cmd .
  3. Clique no trabalho do Stream Analytics na lista de recursos.
  4. Na página visão geral do trabalho do Stream Analytics, clique no botão Iniciar. Clique em Iniciar para iniciar o trabalho.

Executar a interface do usuário da Web

Nesta etapa, você inicia a interface do usuário da Web. Abra uma nova janela do prompt de comando para ter certeza de que você tem acesso às variáveis de ambiente definidas pelo script start.cmd. Navegue até a pasta webui em sua cópia local do repositório e execute os seguintes comandos:

npm install
npm start

Quando o início for concluído, o navegador exibirá a página http://localhost:3000/dashboard. São esperados erros nessa página. Para exibir o aplicativo sem erros, conclua a etapa a seguir.

Configurar e executar o NGINX

Configure um servidor proxy reverso para vincular o aplicativo Web e os microsserviços em execução no computador local:

  • Copie o arquivo nginx.conf da pasta webui\scripts\localhost em sua cópia local do repositório para o diretório de instalação nginx\conf.
  • Execute nginx.

Para saber mais sobre como executar nginx, confira nginx para Windows.

Conectar-se ao painel

Para acessar o painel da solução de Monitoramento Remoto, navegue até http://localhost:9000 em seu navegador.

Limpeza

Para evitar encargos desnecessários, quando terminar o teste, remova os serviços de nuvem de sua assinatura do Azure. Para remover os serviços, navegue até o portal do Azure e exclua o grupo de recursos que o script start.cmd criou.

Você também pode excluir a cópia local do repositório de Monitoramento Remoto criada quando você clonou o código-fonte do GitHub.

Próximas etapas

Agora que você implantou a solução de monitoramento remoto, a próxima etapa é explorar os recursos do painel de solução.