DEV Community: Reinaldo Coelho Sartorelli

Muito foda o artigo, parabéns. Minha primeira experiência com isso com com o modelo Perceptron na faculdade, fazendo o cálculo no Excel.

Reinaldo Coelho Sartorelli — Thu, 13 Mar 2025 11:24:58 +0000

Reinventando a Roda: Criando uma Rede Neural com csharp

Angelo Belchior ・ Feb 26

#csharp #redeneural #ia #feedforward

[Boost]

Reinaldo Coelho Sartorelli — Thu, 13 Mar 2025 11:10:57 +0000

Reinventando a Roda: Criando uma Rede Neural com csharp

Angelo Belchior ・ Feb 26

#csharp #redeneural #ia #feedforward

Artigo muito bom sobre Async/Await com Dotnet, super recomendo...

Reinaldo Coelho Sartorelli — Mon, 03 Feb 2025 23:21:11 +0000

Async/Await: Task.ConfigureAwait, Deadlock e Pink Floyd

Angelo Belchior ・ Oct 25 '23

Entendendo definitivamente o e-mail

Reinaldo Coelho Sartorelli — Mon, 22 Jan 2024 13:59:34 +0000

Neste artigo vou compartilhar tudo que sei a respeito de e-mails, iniciando por uma visão geral do que é, como funciona a troca de e-mails, sua estrutura e o que mais eu conseguir organizar.

Este artigo não será um tutorial que explica como configurar, instalar ou usar qualquer técnologia relacionada a e-mail, mas sim uma visão geral de como funciona.

Glossário

Introdução
1. O que é e-mail
2. Palavras chaves ao se falar de e-mails
Entendendo
1. Como é um e-mail
2. Como funciona a troca de e-mail
3. O que são e onde entram servidores de Anti-spam
Mão na massa
1. Usando Telnet para enviar um e-mail na unha
Conclusão
1. Referências

O que é e-mail

Um e-mail como o próprio nome diz é uma forma eletônica de "trocar cartas", ou seja, uma forma de comunicação "formal" entre as pessoas utilizando um computador.

Para um e-mail funcionar, basta que exista ao menos um servidor de e-mail (que contenha os endereços de e-mail) que possa ser acessado por pessoas conectadas numa rede de computadores (Local ou Internet), e que essas pessoas utilizem um programa como cliente de e-mail (que pode ser um programa de terminal, gráfico ou um site - conhecidos normalmente por webmail-).

Alguns exemplos de clientes de e-mail são:

De terminal:
- Mutt
- Alpine
Gráficos:
- Thunderbird
- Outlook
Webmail:

Palavras chaves ao se falar de e-mails

Ao falarmos de e-mail parece ser simples e direto - escrevo o e-mail, envio e ele é recebido pelo destinatário - porém se começarmos a estudar seu funcionamento, vamos nos deparar com uma série de termos que são utilizados em sua configuração e infra-estrutura, e que se não forem explicados, farão falta para entender todo o seu funcionamento.

Neste tópico, vou explicar esses termos e seus significados, e tentar deixar o mais claro possível o que cada um deles representa, para depois podermos junta-los e entender como cada um executa seu papel no todo.

Iremos apresentar agora:

EML
SMTP
POP3
IMAP
MX
SPF
DKIM
DMARC

EML

A extensão de arquivo .eml é utilizada para representar um arquivo de e-mail - ou seja, um arquivo que contém dentro dele a estrutura de um e-mail -, e apesar de ser a estrutura "padrão" e mais comum, não é a única estrutura de e-mail existente, podendo ser encontradas outras extensões de arquivos que representam e-mails.

Algumas outras que você pode encontrar são:

emlx - Utilizada pela Apple Mail
msg - Utilizada pelo Microsoft Outlook
mbox/mbx - Utilizada pelo Mozilla Thunderbird, Opera Mail, Eudora e KMail

E apesar de todas estas outras estruturas que representam e-mails, praticamente todos os clientes conseguem importar e exportar para o formato .eml, sendo assim, o formato mais utilizado para troca de e-mails entre clientes.

O formato básico de uma mensagem de e-mail é definido pelo RFC 5322, e é composto por duas partes: o cabeçalho e o corpo. (A RFC-5322 substituiu a RFC-2822 em 2008, que por sua vez substituiu a RFC-822 em 2001 - que foi o padrão de e-mail por décadas, e havia sido publicada em 1982 baseada na RFC-733 para a ARPANET -).

Vamos falar mais sobre a estrutura do EML no tópico Como é um e-mail.

SMTP

SMTP é a sigla para Simple Mail Transfer Protocol, ou seja, Protocolo Simples de Transferência de E-mail. Que em resumo significa que ele contém as regras necessárias para que um servidor de e-mail consiga se comunicar com outro, podendo enviar e receber e-mails.

Servidores de e-mails e outros agentes de transferência de mensagens utilizam o SMTP para enviar e receber mensagens de e-mail. Clientes de e-mail (nível de usuário) normalmente usam o SMTP apenas para enviar mensagens para um servidor de e-mail para retransmissão (normalmente enviam e-mails na porta 587 ou 465 conforme RFC-8314).

A origem dos SMTP's começou em 1980, construído sobre conceitos implementados na ARPANET desde 1971. Ele foi atualizado, modificado e extendido multiplas vezes. O protocolo em uso comum hoje tem estrutura extensível com várias extensões para autenticação, criptografia, transferência de dados binários e endereços de e-mail internacionalizados. Servidores SMTP comumente utilizam o protocolo TCP na porta 25 (para comunicações em texto plano) e 587 (para comunicações criptografadas).

Visão simples do protocolo

SMTP é um protocolo de texto simples, no qual um cliente SMTP fala com um servidor SMTP e o servidor responde. O cliente SMTP envia comandos, e o servidor SMTP responde com códigos de status e respostas de texto. Por exemplo, o cliente SMTP pode enviar o comando HELO e o servidor SMTP responderá com um código de status 250 e uma resposta de texto mail.example.com Hello client.example.com.

Uma transação SMTP (após a conexão efetuada com o servidor) consiste em três sequências de comandos/respostas:

Comando MAIL, para estabelecer o endereço de retorno (Também referido como return-path, reverse-path, bounce address, mfrom, ou envelope sender). Nele normalmente é informado o endereço de e-mail do remetente.
Comando RCPT, para estabelecer o endereço do destinatário (Também referido como forward-path, envelope recipient, ou envelope to). Nele normalmente é informado o endereço de e-mail do destinatário.
Comando DATA para sinalizar o início do texto da mensagem (No caso o conteúdo de texto EML do e-mail a ser enviado - Consiste em um cabeçalho de mensagem e um corpo de mensagem separados por uma linha vazia -). DATA é na verdade um grupo de comandos, e o servidor responde duas vezes: uma vez para o próprio comando DATA, para reconhecer que está pronto para receber o texto, e a segunda vez após a sequência de fim-de-dados (normalmente uma linha final é indicada por um .[ponto final]), para aceitar ou rejeitar a mensagem inteira.

Além disso, o cliente SMTP pode usar o comando VRFY para verificar se um nome de usuário ou alias de e-mail é válido, ou o comando EXPN para expandir um nome de lista de distribuição.

Ao final do comando DATA, cada servidor pode responder com um código que pode ser positivo (2xx), negativo (4xx ou 5xx), ou interromper a conexão (1xx ou 3xx). Além disso, o servidor pode responder com uma mensagem de status de texto opcional, e o cliente SMTP pode responder com um comando RSET para reiniciar a transação.

POP3

POP3 é a sigla para Post Office Protocol, ou seja, Protocolo de Correio Postal. Que em resumo significa que ele contém as regras necessárias para que um cliente de e-mail consiga se comunicar com um servidor de e-mail, podendo baixar e-mails.

O POP3 é um protocolo de aplicação em camadas que permite que um cliente de e-mail recupere mensagens de e-mail de um servidor de e-mail remoto. O POP3 foi projetado para ser compatível com vários formatos de caixa de correio. O POP3 permite que um cliente de e-mail faça o download de todas as mensagens de e-mail de um servidor de e-mail remoto. O POP3 é um protocolo de texto simples que usa o TCP na porta 110. Um cliente de e-mail que usa o POP3 normalmente se conecta ao servidor de e-mail, baixa todas as mensagens de e-mail e as exclui do servidor de e-mail, mas as mensagens de e-mail podem ser baixadas sem serem excluídas ou podem ser mantidas no servidor de e-mail para serem baixadas por outros dispositivos.

O POP3 foi projetado em 1984 (RFC-918) e atualizado em 1988 (RFC-1081) e 1996 (RFC-1939). O POP3 foi substituído pelo IMAP, que oferece mais recursos.

IMAP

IMAP é a sigla para Internet Message Access Protocol, ou seja, Protocolo de Acesso a Mensagens da Internet. Que em resumo significa que ele contém as regras necessárias para que um cliente de e-mail consiga se comunicar com um servidor de e-mail, podendo baixar e-mails.

O IMAP é um protocolo de aplicação em camadas que permite que um cliente de e-mail recupere mensagens de e-mail de um servidor de e-mail remoto. O IMAP foi projetado para ser compatível com vários formatos de caixa de correio. O IMAP permite que um cliente de e-mail faça o download de mensagens de e-mail individuais de um servidor de e-mail remoto. O IMAP é um protocolo de texto simples que usa o TCP na porta 143. Um cliente de e-mail que usa o IMAP normalmente se conecta ao servidor de e-mail, baixa mensagens de e-mail individuais e as exclui do servidor de e-mail, mas as mensagens de e-mail podem ser baixadas sem serem excluídas ou podem ser mantidas no servidor de e-mail para serem baixadas por outros dispositivos.

MX

MX é a sigla para Mail Exchanger, que especifica qual é o Servidor de e-mail responsável por aceitar mensagens através de um nome de domínio (@dominio.com por exemplo).

O MX é um registro DNS que aponta um servidor de e-mail para aceitar mensagens para um domínio. Este registro de DNS contém o nome de domínio de um servidor de e-mail e um valor de prioridade, ou seja, ele permite que você tenha uma lista de servidores e ordene-os por prioridade.

O MX é um registro de DNS obrigatório para que um servidor de e-mail possa receber mensagens de e-mail.

O registro de DNS apresenta a seguinte estrutura:

Dominio         TTL     Classe  Tipo    Prioridade   Host do email
example.com.    1936    IN      MX      10           onemail.example.com.
example.com.    1936    IN      MX      10           twomail.example.com.

No caso acima temos dois servidores de e-mail para o domínio example.com, e ambos tem a mesma prioridade, ou seja, o servidor de e-mail que for enviar uma mensagem para o domínio example.com pode escolher um dos dois servidores para enviar a mensagem.

SPF

SPF é a sigla para Sender Policy Framework, ou seja, "Estrutura de Política do Remetente". Que em resumo significa que ele contém as regras necessárias para que um servidor de e-mail consiga validar se um servidor de e-mail é autorizado a enviar mensagens em nome de um domínio.

O SPF é um registro de DNS consultado quando um e-mail é enviado, ele contém a lista de servidores que podem enviar e-mails em nome daquele domínio, e é consultando esta lista, que o servidor que está recebendo a mensagem verifica se o servidor que está dizendo ser o remetente da mensagem é realmente autorizado a enviar mensagens em nome do domínio que está informando.

Caso o servidor que está recebendo a mensagem não encontre o registro SPF, ele pode considerar a mensagem como SPAM, pois não tem como saber se o servidor que está enviando a mensagem é realmente autorizado a enviar mensagens em nome do domínio que está informando.

Existem algumas nuances sobre o SPF como por exemplo, ele pode ser configurado para informar que o servidor deve Recusar o recebimento caso o SPF não esteja condizendo com o esperado, ou apenas marcar a mensagem como SPAM, ou ainda, aceitar a mensagem mesmo que o SPF não esteja condizendo com o esperado.

Para mais informações sobre SPF, seguem alguns links de apoio que podem ajudar com detalhes:

Documento oficial do SPF (rfc 7208):
https://datatracker.ietf.org/doc/html/rfc7208

Tabela de Registros de SPF, informando detalhes referentes ao texto preenchido no campo valor:
https://mxtoolbox.com/dmarc/spf/spf-record-tags

DKIM

DKIM é a sigla para DomainKeys Identified Mail, é um método de autenticação de e-mail projetado para detectar endereços de remetente forjados em e-mails (spoofing de e-mail), uma técnica frequentemente usada em phishing e spam de e-mail.

DKIM permite ao recipiente checar se o e-mail foi autorizado pelo proprietário do domínio do remetente. Ele faz isso criptografando o conteúdo do cabeçalho e do corpo do e-mail usando uma chave criptográfica publicada no DNS do domínio do remetente. Um destinatário pode usar uma chave pública publicada no DNS para decodificar o conteúdo criptografado e verificar se ele corresponde ao conteúdo do e-mail.

DKIM é um Internet Standard. Ele foi difinido na RFC 6376, datado de Setembro de 2011, com atualizações em RFC 8301 e RFC 8463.

Exemplo de um cabeçalho DKIM inserido em um e-mail:

DKIM-Signature: v=1; a=rsa-sha256; d=example.net; s=brisbane;
     c=relaxed/simple; q=dns/txt; i=foo@eng.example.net;
     t=1117574938; x=1118006938; l=200;
     h=from:to:subject:date:keywords:keywords;
     z=From:foo@eng.example.net|To:joe@example.com|
       Subject:demo=20run|Date:July=205,=202005=203:44:08=20PM=20-0700;
     bh=MTIzNDU2Nzg5MDEyMzQ1Njc4OTAxMjM0NTY3ODkwMTI=;
     b=dzdVyOfAKCdLXdJOc9G2q8LoXSlEniSbav+yuU4zGeeruD00lszZ
              VoG4ZHRNiYzR

DMARC

DMARC é a sigla para Domain-based Message Authentication, Reporting and Conformance, ou seja, Autenticação de Mensagens Baseada em Domínio, Relatórios e Conformidade.

Ele é designado para dar aos proprietários de domínios de e-mail a capacidade de proteger seu domínio contra uso não autorizado, comumente conhecido como spoofing de e-mail. O objetivo e o resultado primário da implementação do DMARC é proteger um domínio contra uso em ataques de comprometimento de e-mail comercial, e-mail de phishing, golpes de e-mail e outras atividades de ameaças cibernéticas.

Uma vez que a entrada de DNS DEMARC é publicada, qualquer servidor de e-mail que receba um e-mail de um domínio protegido pelo DMARC pode verificar a autenticidade do e-mail. Se o e-mail passar na autenticação, ele será entregue na caixa de entrada do destinatário. Se o e-mail falhar na autenticação, ele pode ser entregue na pasta de spam ou rejeitado completamente, dependendo da política de DMARC publicada pelo proprietário do domínio.

DMARC extende dois mecanismos de autenticação de e-mail existentes, Sender Policy Framework (SPF) e DomainKeys Identified Mail (DKIM). Ele permite que o proprietário administrativo de um domínio publique uma política em seus registros DNS para especificar como verificar o campo From: apresentado aos usuários finais; como o receptor deve lidar com falhas - e fornece um mecanismo de relatório para as ações executadas sob essas políticas.

DMARC foi publicado na RFC 7489 em Março de 2015.

Como é um e-mail

Um e-mail - em sua estrutura EML - é composto por duas partes: o cabeçalho e o corpo. O cabeçalho é composto por uma série de campos em formato de Chave/Valor, e o corpo é composto por uma série de linhas de texto organizada por algumas regras que o que podem separá-lo em "aquivos" de tipo específicos.

O cabeçalho e o corpo de um e-mail são separados por uma linha vazia.

Sobre o Cabeçalho

O cabeçalho de um e-mail é composto por uma série de campos em formato de Chave/Valor, onde cada campo é separado por uma quebra de linha, e cada campo é composto por uma chave e um valor separados por dois pontos :.
Alguns campos podem ter mais de um valor, e neste caso, os valores são separados por ponto e vírgula ;.

Sobre o Corpo

Existem diversas formas de representar a estrutura do corpo de um e-mail, e uma delas é chamada de Multi-part MIME, que é uma estrutura que permite que o corpo de um e-mail seja composto por diversos "arquivos" de tipos diferentes, podendo dar subporte a arquivos de mídia como imagens, vídeos, áudios, etc.

Mais detalhes

Um exemplo de um EML simples pode ser verificado na figura abaixo, onde se destaca a separação entre o cabeçalho e o corpo do e-mail:

Todos os detalhes de como se formam a estrutura de um EML podem ser encontrados na RFC 5322.

Como funciona a troca de e-mail

Quando falamos sobre a troca de e-mails e nos referimos as comuninações entre os servidores, estamos falando sobre algumas entidades conceituais que não citamos ainda, são elas:

MUA - Mail User Agent (Cliente de e-mail)
- Podem ser clientes de terminal, gráficos ou webmail.
MSA - Mail Submission Agent (Agente de envio de e-mail)
- Servidor de e-mail que recebe o pedido de envio do e-mail e prepara na fila de envio (normalmente o mesmo servidor do MTA).
MTA - Mail Transfer Agent (Agente de transferência de e-mail)
- Servidor que a partir do e-mail em fila, efetua a tentativa de entrega a cada um dos destinatários.
MDA - Mail Delivery Agent (Agente de entrega de e-mail)
- Servidor de e-mail que recebe o e-mail, e pode armazená-lo (junto ao MRA para obtenção via POP/IMAP posterior), ou entregar diretamente ao MUA do destinatário.
MRA - Mail Retrieval Agent (Agente de recuperação de e-mail)
- Servidor de e-mail que armazena os e-mails recebidos, e permite que o usuário os recupere via POP/IMAP.

Vamos desenhar uma sequência de troca de e-mails entre dois usuários, para entendermos como funciona a troca de e-mails entre os servidores.

Figura:

Diagrama MermaidJs:

    sequenceDiagram

    box Usuários/Cliente de e-mail
    participant A as alice@origem.com (MUA)
    participant B as bob@destino.com (MUA)
    end

    box Servidor origem.com
    participant MSA as Agente de envio (MSA)
    participant MTA as Agente de transferência (MTA)
    end

    box DNS destino.com
    participant MX as Dominio MX
    end

    box Servidores destino.com
    participant AntiSpam as Anti-Spam (SpamAssassin)
    participant MDA as Agente de entrega (MDA)
    participant MRA as Agente de recuperação (MRA)
    end

    A -->> MSA: Envia e-mail
    MSA -->> MTA: Agenda e prepara repasse
    MTA -->> MX: Consulta servidor de entrega
    MX -->> MTA: Responde IP do servidor de entrega
    MTA -->> AntiSpam: Efetua entrega do e-mail
    AntiSpam -->> MDA: Repassa o e-mail já analisado
    MDA -->> MRA: Armazena e-mail
    MRA -->> B: Notifica recebimento de e-mail

O processo acima pode se repetir para cada destinatário de e-mail individualmente (principalmente se a entrega é referente a domínios diferentes).

O que são e onde entram servidores de Anti-spam

Servidores de Anti-spam são servidores de e-mail que tem como objetivo principal efetuar um filtro e agir como um portal (Gateway) de entrada de e-mails, ou seja, eles recebem os e-mails e os encaminham para o servidor de e-mail do destinatário após efetuarem a varredura e análise do conteúdo. Normalmente são referenciados pelo dominio MX, onde recebem o e-mail antes de repassar ao servidor adequado de entrega.

Um antispam não necessáriamente rejeita um e-mail suspeito, essa ação é configurável e pode ser definida pelo administrador do servidor de e-mail, e normalmente é feita através de uma pontuação, onde o e-mail é analisado e recebe uma pontuação, e caso a pontuação seja maior que o valor configurado, o e-mail é rejeitado, caso contrário, ele é aceito.

Existem servidores Antispam que podem ser instalados como um servidor adicional, um dos mais famosos é o Spam Assassin, e existem também serviços de Anti-spam que podem ser contratados, como por exemplo o Spam Experts.

Usando Telnet para enviar um e-mail na unha

Abaixo mostrarei como você pode enviar um e-mail diretamente do seu terminal para um servidor de envio (MSA), simulando o comportamento que um cliente de e-mail faria para enviar um e-mail.

Para esse exemplo vamos precisar de alguns pré-requisitos:

Ter o cliente Telnet instalado (Windows ou Linux) 1.1. Caso vá efetuar conexão num servidor com criptografia, precisa também do programa openssl instalado
Ter acesso a um servidor de e-mail que aceite conexões na porta 25 (ou 587 se for necessário logar com usuário e senha)
Ter um endereço de e-mail válido para enviar e receber o e-mail de teste

Primeiro, precisamos nos conectar via telnet ao servidor de e-mail

Para um modo simples, sem conexão criptografada, podemos apenas apontar para o servidor e porta para solicitar conexão:

## Iniciar efetuando a chamada do telnet para o servidor de e-mail e a porta
$ telnet <endereco_servidor> <porta> ## Exemplo: telnet localhost 25

Para o caso de conexão criptografada, precisamos informar que queremos iniciar a conexão com o comando STARTTLS por exemplo:

$ openssl s_client -starttls smtp -connect <endereco_servidor>:<porta> -crlf -ign_eof
## Quando for necessário logar STARTTLS
## Exemplo: openssl s_client -starttls smtp -connect localhost:25 -crlf -ign_eof

Após conectado no seridor, é necessário efetuar um comando de HandShake para iniciar a comunicação, e o comando mais comum é o EHLO ou HELO:

EHLO meuservidor.com

Caso o servidor necessite de autenticação (usuário e senha), os mesmos devem ser informados através do comando AUTH LOGIN, e em seguida informando o usuário e senha em base64:

AUTH LOGIN # Informa que irá informar a autenticação
bWV1dXN1YXJpb0BtZXVkb21pbmlvLmNvbQ== ## Login em base64
TWFuZUFjaG91UXVlRXVJYVBhc3NhckFTZW5oYU5laA== ## Senha em base64

Existem outros tipos de autenticação que podem ser informados como AUTH PLAIN (Para dados em Plain Text) ou AUTH CRAM-MD5 (Para dados em MD5).

Em seguida, precisamos informar o remetente da mensagem:

MAIL FROM: <teste@meudominio.com.br> # Informa o remetente. Obrigatório informar < e > para indicar o endereço.

Na linha seguinte, informamos o endereço do destinatário (Caso queira enviar para mais de um destinatário, basta repetir o comando RCPT TO: para cada um dos destinatários):

RCPT TO: <destinatario@dominio-dele.com> # Informa o destinatário da mensagem neste servidor.

E finalmente para encerrar precisamos enviar o conteúdo do e-mail (no caso o conteúdo do EML), e para isso usamos o comando DATA:

DATA # Ao informar ele deve apresentar um retorno com o código 354
# Todo conteúdo abaixo é a estrutura de um EML normal, e deve ser enviado linha a linha.
FROM: teste@meudominio.com.br
TO: destinatario@dominio-dele.com
CC: outro-em-copia@outro-dominio.com.br
Message-ID: <xpto-message-id-unico@meudominio.com.br>
SUBJECT: Hello World!
MIME-Version: 1.0
Content-Type: text/html; charset="ISO-8859-1"
<!DOCTYPE HTML>
<html>
 <body>
  teste
 </body>
</html>
. ## O ponto é quem efetua a conclusão do processo e dispara o envio.

Ao entrar com o comando DATA e pressionar ENTER, o servidor irá aguardar que você envie todo o conteúudo do e-mail, e só irá considerar que você concluiu quando encontrar uma linha final contendo apenas um ., o que indica o final do conteúdo EML a ser enviado.

Caso não queira efetuar todos esses passos na mão, existem servidores onde você pode efetuar o envio de e-mails para testes, como por exemplo o MxtoolBox, onde você pode informar o servidor de e-mail e ele executará um teste.

Alguns outros comandos também existem, porém são menos comuns, por exemplo:

VRFY <usuario> # Verifica se o usuário existe no servidor
EXPN <lista> # Expande uma lista de distribuição
HELP # Exibe a lista de comandos disponíveis
NOOP # Não faz nada, apenas retorna um OK
RSET # Reinicia o processo de envio
QUIT # Encerra a conexão

Um exemplo de envio simples efetuado manualmente por telnet seria:

Referências

Explicação Wikipedia
- Email
- SMTP
- POP3
- IMAP
- MX
- SPF
- DKIM
- DMARC
RFCs referentes a e-mail:
- RFC 5321
- RFC 5322
- RFC 2045
- RFC 2046
- RFC 2047
- RFC 2049
- RFC 2821
- RFC 2822
- RFC 3461
- RFC 3462
- RFC 3463
- RFC 3464
- RFC 3465
- RFC 3466
- RFC 3467
- RFC 3468
- RFC 3469
- RFC 4409
Outros sites e documentos:
- Comandos de SMTP
- MxtoolBox - Site para testes de e-mail
- Spam Assassin - Servidor de Anti-spam

Como monto meu ambiente Windows do Zero

Reinaldo Coelho Sartorelli — Tue, 24 Sep 2019 21:47:50 +0000

Motivado pelo post do @luizcarlosfaria:
Dev Desktop fresh setup windows features tools

Porque automatizar

Porque devemos automatizar nosso setup de Desktop?
Pelo mesmo motivo pelo qual fazemos qualquer automação, para poupar tempo e esforço.
Se você não tem a necessidade de vez ou outra recriar sua máquina, provavelmente este artigo não é para você.

O que vou usar

Para o processo, vou utilizar basicamente:

Script PowerShell - Instalação de pacotes Windows.
Chocolatey.org - Gerenciador de pacotes para instalação de aplicativos.

Começando

Imagine que você acabou de formatar a máquina e precisa reinstalar tudo (ou quase, você entenderá ao final) que você tinha na máquina para voltar as atividades.

E agora, como você pode preparar seu ambiente novamente em 3 passos?

1 - Instando as Features do Windows

NOTA: A instalação de features do windows varia se você estiver tratando de uma versão Desktop ou Server, por isso vale dar uma lida neste artigo.
NOTA2: Este post está apresentando como tratar em Windows10 Desktop.

Atualmente o powershell nos dá bastante poder em relação ao windows e nos permite instalar praticamente tudo via script.
Para isso bastam 2 passos:

Liberar acesso a política de execução de script do powershell.
Escolher a lista de features que gostaria de instalar.

Abaixo segue o script básico que uso na minha máquina como desenvolvedor para ter acesso a funções de IIS, Hyper-V, DotNet Core Hosting e Telnet Client (basicamente o mais importante).

// code/config-windows.ps1

#######################################################
### PASSO 1 - Efetua liberação de acesso ao powershell.
#######################################################
Set-ExecutionPolicy Bypass -Scope Process

# ##############################################################################################
### PASSO 2 - Efetua um teste de conexão com a internet para garantir os recursos necessários.
###     ALERTA: O Windows tem comandos diferentes de acordo com a sua versão, se os comandos abaixo
###             não funcionarem, verifique: https://peter.hahndorf.eu/blog/WindowsFeatureViaCmd.html
# ##############################################################################################
Write-Host "Verificando se ha conexao com a internet..."
$hasInternet = (Test-Connection google.com -Count 3 -Quiet);
if ($hasInternet -eq $false) {
  Write-Host "Concluido teste de internet com FALHA..."
  return $false
}
Write-Host "Concluido teste de internet com sucesso..."

Write-Host "Instalando recurso Hostable Web Core"
Enable-WindowsOptionalFeature -Online -FeatureName "IIS-HostableWebCore" -NoRestart

Write-Host "Instalando HTTP Redirect"
Enable-WindowsOptionalFeature -Online -FeatureName "IIS-HttpRedirect" -NoRestart

Write-Host "Instalando WebDAV (File access and manipulation. More: https://www.cloudwards.net/what-is-webdav/)"
Enable-WindowsOptionalFeature -Online -FeatureName "IIS-WebDAV" -NoRestart

Write-Host "Instalando recurso WebSocket"
Enable-WindowsOptionalFeature -Online -FeatureName "IIS-WebSockets" -NoRestart

Write-Host "Instalando Logging IIS"
Enable-WindowsOptionalFeature -Online -FeatureName "IIS-CustomLogging" -NoRestart
Enable-WindowsOptionalFeature -Online -FeatureName "IIS-HttpLogging" -NoRestart
Enable-WindowsOptionalFeature -Online -FeatureName "IIS-LoggingLibraries" -NoRestart
Enable-WindowsOptionalFeature -Online -FeatureName "IIS-ODBCLogging" -NoRestart
Enable-WindowsOptionalFeature -Online -FeatureName "IIS-ManagementScriptingTools" -NoRestart
Enable-WindowsOptionalFeature -Online -FeatureName "IIS-HttpTracing" -NoRestart
Enable-WindowsOptionalFeature -Online -FeatureName "IIS-RequestMonitor" -NoRestart

Write-Host "Instalando DotNetFramework"
Enable-WindowsOptionalFeature -Online -FeatureName "WCF-Services45" -NoRestart

Write-Host "Ativando recurso: ASPNET45"
Enable-WindowsOptionalFeature -Online -FeatureName "IIS-ASPNET45" -NoRestart # -LimitAccess

Write-Host "Ativando recurso: Hyper-V"
Enable-WindowsOptionalFeature -Online -FeatureName "Microsoft-Hyper-V" -NoRestart # -LimitAccess
Enable-WindowsOptionalFeature -Online -FeatureName "Microsoft-Hyper-V-Management-Clients" -NoRestart # -LimitAccess
Enable-WindowsOptionalFeature -Online -FeatureName "Microsoft-Hyper-V-Management-PowerShell" -NoRestart # -LimitAccess
Enable-WindowsOptionalFeature -Online -FeatureName "Microsoft-Hyper-V-Offline" -NoRestart # -LimitAccess
Enable-WindowsOptionalFeature -Online -FeatureName "Microsoft-Hyper-V-Online" -NoRestart # -LimitAccess

## Detalhes em: https://docs.microsoft.com/en-us/iis/install/installing-iis-85/installing-iis-85-on-windows-server-2012-r2
Write-Host "Instalando recurso: IIS"
Enable-WindowsOptionalFeature -Online -FeatureName "IIS-WebServer" -NoRestart
Enable-WindowsOptionalFeature -Online -FeatureName "IIS-WebServerManagementTools" -NoRestart
Enable-WindowsOptionalFeature -Online -FeatureName "IIS-ManagementConsole" -NoRestart
Enable-WindowsOptionalFeature -Online -FeatureName "IIS-DefaultDocument" -NoRestart
Enable-WindowsOptionalFeature -Online -FeatureName "IIS-HttpLogging" -NoRestart
Enable-WindowsOptionalFeature -Online -FeatureName "IIS-LoggingLibraries" -NoRestart

Write-Host "Instalando recurso: Application Initialization"
Enable-WindowsOptionalFeature -Online -FeatureName "IIS-ApplicationInit" -NoRestart

## Outros apoios opcionais:
Enable-WindowsOptionalFeature -Online -FeatureName "TelnetClient" -NoRestart

2 - Instando o Chocolatey

Estando com o windows ajustado, temos agora que instalar nosso gerenciador de pacotes, para que possamos instalar os aplicativos que vamos usar em nosso ambiente.

No site do chocolatey você tem os passos mais recentes da instalação, mas se for utilizar a forma mais simples (com o repositório do nuget.org), é só executar o comando powershell de instalação.

NOTA: Sim, é possível instalar um repositório privado de programas, seja para você ou para a empresa, isso também se encontra na documentação do site.

Para nosso exemplo, precisamos apenas executar o script:

// code/install-chocolatey.ps1

Set-ExecutionPolicy Bypass -Scope Process -Force; iex ((New-Object System.Net.WebClient).DownloadString('https://chocolatey.org/install.ps1'))

Informação adicional: O & antes dos comandos no Powershell é uma das formas de executar comandos console no script powershell.

3 - Instalando os programas

Agora que temos o windows atualizado e o chocolatey instalado, podemos colocar nossa lista de programas para instalar e ir tomar um café...

// code/install-programs.ps1

## Programas basicos
& cinst 7zip -y
& cinst GoogleChrome -y
& cinst ChocolateyGUI -y
& cinst notepadplusplus -y

## Office
& cinst libreoffice -y

## Desenvolvimento
& cinst dotnetcore-sdk -y
& cinst git -y
& cinst sql-server-management-studio -y
& cinst nodejs -y
& cinst visualstudio2019community -y
& cinst visualstudiocode -y
& cinst kdiff3 -y

## Meus Programas
& cinst dropbox -y
& cinst skype -y
& cinst vlc -y
& cinst slack -y

## Jogos
& cinst steam -y

## Container
& cinst docker -y
& cinst docker-compose -y
& cinst docker-machine -y
& cinst docker-desktop -y

## VMs as a Code
& cinst terraform -y
& cinst packer -y

Quando o script terminar, sua máquina estará pronta, com todos os programas que você tinha instalados.

Como encontrar novos programas

Uma das suas dúvidas neste momento pode ser "E como eu encontro outros programas?". O choco (apelido carinhoso do chocolatey) tem vários comandos úteis, um deles é o search que permite pesquisar no repositório.

Imagine que você gostaria de saber por exemplo o que existem de opções relacionadas a office no repositório, então você poderia pesquisar com o comando abaixo:

// code/chocolatey-search.txt

& choco search office

Você terá um resultado parecido com:

// code/resultado-pesquisa.txt

Chocolatey v0.10.15
office-to-pdf 1.8 [Approved]
officeribboneditor 4.4.2 - Possibly broken
kingsoft-office-free 9.1.0.20140820 - Possibly broken
office-online-chrome 1.5.0.20170115 [Approved]
Office365ProPlus 2016.20190418 [Approved]
wps-office-free 11.2.0.8970 [Approved] Downloads cached for licensed users
Office365Business 11509.33604 [Approved]
microsoft-office-deployment 16.0.11901.20022 [Approved]
cryptopro-office-signature 2.0.11980 [Approved] Downloads cached for licensed users
OfficeProPlus2013 15.0.4827 [Approved] Downloads cached for licensed users
disableofficenag-winconfig 0.0.1 [Approved]
Office365HomePremium 2016.20160728 [Approved] Downloads cached for licensed users
disableofficemacros-winconfig 0.0.1 [Approved]
officecustomuieditor 1.1 - Possibly broken
8x8virtualoffice 6.2.4.4 [Approved]
office2013-proofingtools-nl 15.0.4420.1017 [Approved] Downloads cached for licensed users
office365-2016-deployment-tool 16.0.7614.3602 [Approved] Downloads cached for licensed users - Possibly broken for FOSS users (due to original download location changes by vendor)
officedevtools 14.0.23930 [Approved] Downloads cached for licensed users
visualstudio2017-workload-office 1.2.2 [Approved]
visualstudio2019-workload-office 1.0.0 [Approved]
libreoffice-help 5.2.0 [Approved] - Possibly broken
windows-iso-downloader 8.21 [Approved] Downloads cached for licensed users
OffCAT 2.1 [Approved] Downloads cached for licensed users - Possibly broken for FOSS users (due to original download location changes by vendor)
crealogix-paymaker-office 5.0.8.1 [Approved] Downloads cached for licensed users - Possibly broken for FOSS users (due to original download location changes by vendor)
libreoffice-fresh 6.2.5 [Approved] Downloads cached for licensed users
libreoffice-still 6.0.7 [Approved] Downloads cached for licensed users - Possibly broken for FOSS users (due to original download location changes by vendor)
officetabenterprise 9.80 - Possibly broken
officetabfree 9.70.20140510 - Possibly broken
officeremote 1.1.3.0 [Approved]
vstor2010 10.0.60828 [Approved] Downloads cached for licensed users
onlyoffice 5.3.5 [Approved] Downloads cached for licensed users
officegate-configuration-tool 1.2.8 [Approved] Downloads cached for licensed users
Excel.Viewer 12.0.6219.1000 - Possibly broken
Powerpoint.Viewer 12.0.6219.1000 - Possibly broken
Word.Viewer 12.0.6219.1000 - Possibly broken
visualstudio2019-workload-officebuildtools 1.0.0 [Approved]
visualstudio2017-workload-officebuildtools 1.0.1 [Approved]
sharepoint.2010.sdk 12.0.0.1 - Possibly broken
FoxitReader 9.6.0.25144 [Approved] Downloads cached for licensed users
SkypeForBusiness 11107.33602 [Approved] Downloads cached for licensed users - Possibly broken for FOSS users (due to original download location changes by vendor)
invantive-control-for-excel 17.32.70 [Approved] Downloads cached for licensed users
CutePDF 3.2 [Approved] Downloads cached for licensed users
contract-tools 1.30.6.0 [Approved] Downloads cached for licensed users
officeins 1.20 [Approved] Downloads cached for licensed users
wsus-offline-update 11.8.1 [Approved] Downloads cached for licensed users
project.2010.sdk 12.0.0.1 - Possibly broken
kontur-addtotrusted 2.0.18.2 [Approved] Downloads cached for licensed users
kontur-addtotrusted.portable 2.0.18.2 [Approved] Downloads cached for licensed users
kontur-plugin 3.10.2 [Approved] Downloads cached for licensed users
wordcontentcontroltoolkit 1.3 - Possibly broken
SkypeForBusinessBasic 11107.33602 [Approved] Downloads cached for licensed users - Possibly broken for FOSS users (due to original download location changes by vendor)
previewhandlerpack 1.0.0.0 - Possibly broken
kontur-certificates 4.7.27.6074 [Approved] Downloads cached for licensed users
tomboy 1.15.7 [Approved] Downloads cached for licensed users
rutoken-web-tool 1.4.0.42 [Approved] Downloads cached for licensed users
cryptopro-pdf 2.0.0811 [Approved] Downloads cached for licensed users - Possibly broken for FOSS users (due to original download location changes by vendor)
gosuslugi-plugin 3.0.7.0 [Approved] Downloads cached for licensed users
microsoft-teams.install 1.2.00.24753 [Approved] Downloads cached for licensed users
microsoft-teams 1.2.00.24753 [Approved] Downloads cached for licensed users
yed 3.19 [Approved]
onenote 16.0.11929.20300 [Approved] Downloads cached for licensed users
OpenOffice 4.1.6 [Approved]
produkey.install 1.93 [Approved] Downloads cached for licensed users
produkey.portable 1.93 [Approved] Downloads cached for licensed users
ProduKey 1.92 [Approved] - Possibly broken
FileFormatConverters 1.0.1 - Possibly broken
rutoken-drivers 4.2.5.0 [Approved] Downloads cached for licensed users
rutoken-egais-drivers 4.3.2.0 [Approved] Downloads cached for licensed users
rutoken-magistra-drivers 1.06.00.0035 [Approved] Downloads cached for licensed users
rutoken-web-plugin 1.6.2.0 [Approved] Downloads cached for licensed users
rutoken-plugin 4.0.1.0 [Approved] Downloads cached for licensed users
libreoffice 5.4.4.20180111 [Approved] - Possibly broken
libreoffice-oldstable 5.3.7.20180111 [Approved] - Possibly broken
driver-officegate 1.0.0.0 [Approved] Downloads cached for licensed users
MSAccess2010-redist 1.0
MSAccess2010-redist-x64 1.1 [Approved]
MSAccess2010-redist-x86 1.2 [Approved]
azure-information-protection-client 1.48.204.0 [Approved] Downloads cached for licensed users - Possibly broken for FOSS users (due to original download location changes by vendor)
azure-information-protection-unified-labeling-client 2.0.779.0 [Approved] Downloads cached for licensed users - Possibly broken for FOSS users (due to original download location changes by vendor)
MSFilterPack2-redist-x64 1.1 [Approved]
msoidcli 2.1 [Approved] Downloads cached for licensed users
rubberduck 1.4.3 [Approved] Downloads cached for licensed users
msoid-cli 7.250 [Approved] Downloads cached for licensed users
brutaldoom-goingdown 1.0.0 [Approved] Downloads cached for licensed users
winscan2pdf 4.98 [Approved]
kopano-deskapp-nightly 2.4.1 [Approved]
tidytabs 1.3.5 [Approved] - Possibly broken
tidytabs.portable 1.3.5 [Approved] Downloads cached for licensed users - Possibly broken for FOSS users (due to original download location changes by vendor)
tidytabs.install 1.3.5 [Approved] Downloads cached for licensed users - Possibly broken for FOSS users (due to original download location changes by vendor)
cdmessenger 3.3 [Approved] Downloads cached for licensed users
ekeyfinder 0.1.7 [Approved]
teamviewer-chrome 13.0.281 [Approved]
polleverywhere 2.11.1 [Approved] Downloads cached for licensed users
made2010 2016.07.01 [Approved] Downloads cached for licensed users
projectlibre.portable 1.9.1 [Approved] Downloads cached for licensed users
InSync 1.5.5.37367 [Approved] Downloads cached for licensed users
xmlspy 2019.3.1 [Approved] Downloads cached for licensed users
ammyy-admin 3.9.0.0 [Approved]
hdguard 10.0.0.4 [Approved] Downloads cached for licensed users
softkey-revealer.portable 2.8.0.20161009 [Approved] Downloads cached for licensed users
greenshot 1.2.10.6 [Approved] Downloads cached for licensed users
keyfinder 2.0.10.13 [Approved]
expandrive 7.0.16 [Approved] Downloads cached for licensed users
doPDF 10.3.115 [Approved] Downloads cached for licensed users
bioviadraw-ae 2018.0.0.20180925 [Approved] Downloads cached for licensed users
password-generator 3.0.0 [Approved] Downloads cached for licensed users - Possibly broken for FOSS users (due to original download location changes by vendor)
invantive-dotnet-optimizer 17.8.8 [Approved]
clamav 0.99.3 [Approved] Downloads cached for licensed users
hardentools 1.0 [Approved]
teamviewer 14.6.2452 [Approved] Downloads cached for licensed users
sparkleshare 1.5.0.20161115 [Approved] Downloads cached for licensed users
batch-docs 5.6.0 [Approved] Downloads cached for licensed users
biorhythms-calculator 2.0.0 [Approved] Downloads cached for licensed users - Possibly broken for FOSS users (due to original download location changes by vendor)
batch-word-replace 5.6.0 [Approved] Downloads cached for licensed users
envelope-printer 2.0.1 [Approved] Downloads cached for licensed users
save-to-google-drive-chrome 2.1.1 [Approved]
openchrom 1.3.0 [Approved] Downloads cached for licensed users
ultimate-settings-panel 6.3 [Approved] Downloads cached for licensed users
gsuite-migration-exchange 5.1.20.0 [Approved] Downloads cached for licensed users
dropbox 81.4.195 [Approved] Downloads cached for licensed users
leanify 0.4.2 [Approved] Downloads cached for licensed users
ost2 2.13.0.28 [Approved] Downloads cached for licensed users
bginfo 4.28 [Approved] Downloads cached for licensed users
123 packages found.

Outras opções principais de comando no chocolatey são:

choco install [nome do pacote] - Instala o programa.
choco uninstall [nome do pacote] - Remove o programa.
choco update [nome do pacote] - Atualiza o programa.

É possível também utilizar algumas abreviações como por exemplo:

cup all -y - Atualiza todos os programas que tiverem versão atualizada.

Limitações

Quando utilizamos a instalação padrão e o repositório publico do Chocolatey, você normalmente não terá acesso a programas que não sejam freeware, trial ou opensource.

Os programas licensiados como pacote Office da Microsoft por exemplo não se encontram na listagem.

Se você tem a necessidade de ter programas registrados o que pode fazer é criar um repositório seu e criar os scripts de instalação você mesmo para o seu programa.

A boa notícia é que com algumas exceções, você consegue ter pelo menos a grande maioria dos seus programas instalados, já que o chocolatey está contando com um repositório bem abrangente.

Conclusões

Se você achou que executar 3 scripts ainda assim é trabalhoso, pode juntá-los num só e executar apenas um script para efetuar todos esses passos em sequência, e ao formatar a máquina ter praticamente tudo instalado com literalmente um clique.

Eu sou muito adepto a projetos open-source e tenho basicamente todo o meu pacote de programas disponíveis no Chocolatey.

Espero que tenham gostado, e me informem se este artigo te ajudou em alguma coisa.

Dá pra gerar serviço Windows/Linux com .Net?

Reinaldo Coelho Sartorelli — Mon, 09 Sep 2019 01:49:18 +0000

Recentemente tive a necessidade de manter um código de serviço Windows que também pudesse ser executado como um serviço no Linux.

Estudando algumas possibilidades, a maneira mais elegante que encontrei foi aproveitar o mesmo projeto dotnetcore para gera o serviço do Windows ou um CLI que permite a configuração como serviço no Linux.

Vou explicar em seguida, todos os passos que fiz para que isso funcionasse utilizando a biblioteca TopShelf e gerando uma compilação para cada plataforma.

Todo código apresentado abaixo está disponível no GitHub:

dotnet-service-cross-platform

O que é a biblioteca TopShelf

TopShelf é uma biblioteca que visa facilitar e organizar o processo para gerar serviço Windows.

A partir da versão 4.1, está suportando o padrão netstandard2.0 que nos permite compilar o projeto para FullFramework e dotnetcore.

Atualmente ela trabalha da seguinte forma, você cria uma aplicação console utilizando a biblioteca TopShelf, ela irá entender automaticamente alguns comandos como “install” por exemplo, que efetua a instalação do serviço do Windows. Se você não informar nenhum parâmetro esperado pelo TopShelf, a aplicação irá executar como um console, e isso nos permite fazer o que esperamos.

Criando o código comum

O código comum será um projeto console em dotnetcore (estou usando a versão 2.1 no caso), onde vou adicionar a dependência para a biblioteca TopShelf.

A sequência inicial de comandos para criar o projeto será:

c:\code\simple-service-counter> dotnet new console

Em seguida adicionamos a referência ao TopShelf:

c:\code\simple-service-counter > dotnet add package Topshelf --version 4.1.0.177-develop

Em seguida vamos a um detalhe importante, vamos ajustar o projeto para dar suporte a mais de um Framework, possibilitando que nosso build compile para ambas as plataformas.

Vamos criar uma classe (ImplementacaoServico.cs) que será nosso código do serviço. Nosso serviço será um simples contador, mas você poderá implementar o que precisar.

Vamos agora configurar a classe inicial do projeto console para utilizar o TopShelf e chamar nossa lógica.

Perfeito, com esses poucos passos você pode executar seu projeto simplesmente para verificar se está funcionando como um console normal.

Execute o comando abaixo para ver seu serviço executado como um console:

c:\code\simple-service-counter > dotnet run --framework net461 (ou netcoreapp2.1)

Se tudo estiver correto, você deverá ter um resultado como este:

Tudo OK até aqui? Então vamos seguir para gerar e instalar o serviço no Windows e em seguida no Linux.

Publicando e instalando no Windows

Primeiramente vamos publicar nosso serviço apontando para o framework 4.6.1 que nos permite instalar o serviço no windows.

Execute o seguinte comando para gerar a publicação:

c:\code\simple-service-counter > dotnet publish simple-service-counter.csproj -c Release -f net461 -o dist\windows --self-contained

Agora vamos instala-lo no windows, para isso entre na pasta “dist\windows” dentro da pasta do projeto e digite:

c:\code\simple-service-counter\dist\windows > simple-service-counter.exe install

E você deverá ter a seguinte saída:

Se você abrir o gerenciador de serviços do Windows, poderá iniciar e parar o serviço.

Para remover o serviço, somente digite:

c:\code\simple-service-counter\dist\windows > simple-service-counter.exe uninstall

Fácil né.

Publicando e instalando no Linux

Para o Linux vamos fazer uma publicação utilizando dotnetcore 2.1 e publicar para Linux utilizando a opção self-contained (Que leva com a publicação todas as dependências, incluindo o framework evitando a necessidade de instalá-lo no Linux).

Para gerar a publicação, execute o comando:

c:\code\simple-service-counter > dotnet publish simple-service-counter.csproj -c Release -f netcoreapp2.1 -o dist\linux -r linux-x64 --self-contained

Agora vamos compactar a pasta “dist\linux” onde foi publicado o projeto e vamos levar esta pasta para um servidor (ou VM) com Linux (meu caso Lubuntu 18.10).

Note que o arquivo compactado fica grande ~30MB. E isso é porque está levando junto todas as dependências, incluindo o framework.

Copie o arquivo compactado para sua máquina Linux. ( Use o programa scp ou outro recurso qualquer para copiar).

Já no Linux, descompacte o arquivo com o comando

$ unzip <arquivo>.zip -d ~/meuservico

Em seguida precisamos dar permissão de execução para o programa executável, então entre na pasta onde estão os arquivos e altere a permissão para:

$ chmod 755 simple-service-counter

Podemos agora testar se nosso console funciona simplesmente executando ele no Shell:

$ ./simple-service-counter

Veja que a saída de console do programa funciona conforme esperado.

O que precisamos agora para torná-lo um serviço, que possa ser iniciado e parado nos padrões systemd é seguir os passos:

Criar um arquivo de configuração em “/etc/systemd/system/servico-counter.service”, com o conteúdo:

[Unit]
Description=Servico contador
After=network.target
[Service]
User=root
Restart=on-failure
Type=exec
ExecStart=/<LOCAL>/meuservico/linux/simple-service-counter
[Install]
WantedBy=multi-user.target

Iniciar o serviço executando:

$ sudo systemctl start servico-counter

Verificar o status do serviço para verificar se está em execução, com o comando:

$ sudo systemctl status servico-counter

Esta checagem se estiver ok irá apresentar a seguinte saida:

Podemos definir para que ele seja iniciado com o boot se desejar, utilizando o comando:

$ sudo systemctl enable servico-counter

Podemos também pará-lo, com o comando:

$ sudo systemctl stop servico-counter

Para remover o serviço, basta apagar o arquivo “/etc/systemd/system/servico-counter.service” e em seguida excluir a pasta da aplicação.

Simples também né!!!

Conclusão

Como vimos é muito simples criar uma estrutura que nos permita portar um serviço entre windows e Linux mantendo um único código fonte para ambos.

Espero que este artigo ajude e que eu possa gerar muitos outros em seguida.

Tem alguma dica, sugestão, crítica ou dúvida, pode me enviar.

Muito obrigado.

NOTAS IMPORTANTES

Um problema que identifiquei em todas as versões posteriores que utilizei do TopShelf é que algo nele não está mais permitindo a execução como console no Linux :-(.

Abri uma issue no projeto do TopShelf para verificarem este ponto, ou entendermos o porque de ter parado:
Topshelf#513