mr-windows-service v3.0.0

MR Windows Service

Instalação

Instale o mr-windows-service em modo global

$ npm i mr-windows-service --global

Instalando ou removendo o serviço da aplicação

Instalando a aplicação node como serviço

No diretório da aplicação execute o comando:

$ windows-service install

A ferramenta irá considerar as propriedades do arquivo package.json para a geração do serviço:

• name: para definição do nome do serviço
• description: para definição da descrição do serviço
• main: para a definição do script de inicialização da aplicação

Observação: Se preferir um nome mais amigável para o serviço utilize a tag displayName

Removendo o serviço

No diretório da aplicação execute o comando:

$ windows-service remove

Atributos

Declarando os atributos do serviço manualmente

A instalação do serviço de forma manual requer os seguintes atributos

• displayName ou name
• description
• script ou main

No diretório da aplicação execute o comando:

$ windows-service install -displayName="Nome do Serviço" -description="Descrição do serviço" -script="./index.js"

Para remover basta informar apenas o atributo displayName ou name

$ windows-service remove -displayName="Nome do Serviço"

Definindo os atributos do serviço em outro arquivo json ou jsonc

Defina os atributos do serviço em um arquivo json ou jsonc e depois execute o comando de instalação informando o caminho do arquivo no atributo file.

Atributos do serviço:

// arquivo.json
{
  "displayName": ".6005 - Document Repository",
  "description": "Repositório de Documentos | MRProjetos",
  "script": "./server"
}

No diretório da aplicação execute o comando:

$ windows-service install -file="./arquivo.json"

Observação: Para remover o serviço basta substituir o comando install por remove.

Se desejar utilizar uma propriedade dentro do arquivo json para definir os atributos do serviço execute o comando de instalação informando o nome da propriedade no atributo property.

Atributos do serviço:

// arquivo.json
{
  "serviceOpts": {
    "displayName": ".6005 - Document Repository",
    "description": "Repositório de Documentos | MRProjetos",
    "script": "./server"
  }
}

No diretório da aplicação execute o comando:

$ windows-service install -file="./arquivo.json" -property="serviceOpts"

Observação: Para remover o serviço basta substituir o comando install por remove.