ServiçoPulse

ServiçoPulse

ServicePulse fornece monitoramento de produção em tempo real para aplicações distribuídas. Ele monitora a integridade dos endpoints de um sistema, detecta erros de processamento, envia mensagens de falha para reprocessamento e garante que as necessidades específicas do ambiente sejam atendidas, tudo em um painel consolidado.

ServicePulse faz parte da Plataforma de Serviços Particulares, que inclui NServiceBus e ferramentas para construir, monitorar e depurar sistemas distribuídos.

Consulte a documentação do ServicePulse para obter mais informações.

Configurando o projeto para desenvolvimento

Configurando instâncias do ServiceControl Main e do ServiceControl Monitoring

O ServicePulse apresenta principalmente dados fornecidos pelas instâncias ServiceControl e ServiceControl Monitoring.

Os URLs para ambos os serviços podem ser definidos em src/Frontend/public/js/app.constants.js .

Configurando gerenciadores de pacotes

ServicePulse usa npm e Bower como gerenciadores de pacotes. Para que a solução funcione, as dependências devem ser baixadas antes de iniciar o site do ServicePulse.

Instalar dependências

Instale as seguintes dependências se ainda não as tiver instaladas.

• Git para Windows
• Node.js
  • NOTA: É uma boa prática ao instalar ou atualizar o node.js em seu ambiente local também verificar e certificar-se de que a versão do node.js para os fluxos de trabalho ci.yml e release.yml corresponde à versão do seu ambiente local. Procure o name: Set up Node.js

Definir ambiente de desenvolvimento

Passo 0 – Usando um IDE adequado para desenvolvimento frontend

Embora o Visual Studio ou o Rider pareçam ser IDEs adequados para desenvolvimento front-end, eles tendem a não ser confiáveis ​​com as estruturas, linting e formatação de front-end mais recentes. Por isso, temos recomendações extras para ajudá-lo a ter ainda mais sucesso no desenvolvimento front-end.

Etapa 1 – execute o servidor de desenvolvimento Vue.js

Navegue até ServicePulsesrcFrontend e:

• execute npm install para instalar todas as dependências do npm
• execute o seguinte comando npm run dev (isso hospedará um servidor de desenvolvimento na porta 5173 e começará a observar alterações no diretório /Frontend )

Se npm run dev falhar com um erro relacionado aos submódulos git não configurados corretamente, execute o comando npm install novamente para garantir que todas as dependências necessárias estejam disponíveis e, em seguida, execute npm run dev .

Passo 2 - abra o navegador

Após realizar as etapas acima, navegue até a URL apresentada pela execução da aplicação Vue.js para ver a aplicação ServicePulse.

Executando testes automatizados

Os testes automatizados de front-end utilizam Vitest como estrutura de teste e biblioteca de teste para utilitários de teste. O Vitest fornece dois modos: watch mode no ambiente de desenvolvimento e run mode no ambiente de CI por padrão. Watch mode executa novamente testes relevantes após salvar o arquivo, fornecendo feedback imediato durante o desenvolvimento.

Antes de executar o teste, certifique-se de ter configurado o servidor de desenvolvimento. Navegue até ServicePulsesrcFrontend e execute npm install para instalar todas as dependências do npm.

Executando testes de componentes

Navegue até ServicePulsesrcFrontend e execute:

 npm run test:component

Este comando executa todos os arquivos de teste de componentes *.spcs.ts no diretório ServicePulsesrcFrontendsrc e seus subdiretórios. Com watch mode ativado, ele permite o desenvolvimento eficiente de testes, já que apenas os testes relevantes são executados novamente ao salvar o arquivo.

Executando testes de aplicativos

Navegue até ServicePulsesrcFrontend e execute:

 npm run test:application

Semelhante aos testes de componentes, este comando executa todos os arquivos de teste do aplicativo *.spcs.ts no diretório ServicePulsesrcFrontendtest e seus subdiretórios.

Executando cobertura de teste

Navegue até ServicePulsesrcFrontend e execute:

 npm run test:coverage

Este comando gera um relatório indicando a porcentagem de instruções, ramificações, funções e linhas cobertas pelos testes. Além disso, identifica números de linha descobertos.

Scripts npm fornecidos

Vue.js

• dev - executa vite que inicia o servidor de desenvolvimento fazendo hot reload nos arquivos de origem
• build - executa o script de construção que envia arquivos para a pasta ..app
• lint - verifica com eslint todos os arquivos vue, ts e js
• type-check - executa TypeScript no modo sem emissão

Teste

• test:application - executa todos os testes da aplicação localizados na pasta Frontend/test .
• test:component - executa testes de todos os testes de componentes localizados na pasta Frontend/src e em quaisquer subdiretórios.
• test:coverage - executa o relatório de cobertura de teste nos arquivos definidos em vitest.config.ts

Executando a partir de ServicePulse.Host.exe

É possível executar o ServicePulse diretamente via ServicePulse.Host.exe .

Etapa 1 – reservar URL ACL

ServicePulse.Host.exe depende de um servidor web auto-hospedado. Uma reserva de URL ACL deve ser configurada antes que o projeto possa ser executado. Execute o Visual Studio com privilégios administrativos ou execute o seguinte comando para adicionar a reserva de URL ACL necessária:

add urlacl url=URL

Onde URL é o URL configurado na máquina local.

Etapa 2 - construir site ServicePulse

Execute o script de construção na linha de comando:

 PowerShell -File .build.ps1

Observação

Pode ser necessário alterar a política de execução do PowerShell usando Set-ExecutionPolicy Unrestricted -scope UserPolicy

Etapa 3 - execute ServicePulse.Host.exe

Crie e execute o projeto ServicePulse.Host no IDE.

Versões de navegador suportadas

ServicePulse é compatível com as seguintes versões de navegador de desktop:

• Versão principal mais recente do Chrome
• Borda com EdgeHTML v17+
• Versão atual do Firefox ESR
• Versão principal mais recente do Safari

Desenvolvimento de imagem de contêiner

Um Dockerfile para ServicePulse reside na pasta src/ServicePulse . As imagens de contêiner são todas criadas como parte do fluxo de trabalho de lançamento e preparadas no Github Container Registry. Para filiais com PRs, a imagem será marcada com o número do PR, por exemplo, pr-1234 .