Patchmon - Histórico de revisão

Diegocosta: /* Atualizar */

2026-08-22T13:50:38Z

Atualizar

← Edição anterior		Edição das 10h50min de 22 de agosto de 2026
Linha 325:		Linha 325:
	</pre>		</pre>

	Desta forma o comando docker compose pull baixa as imagens Docker mais recentes definidas no seu docker-compose.yml, mas não recria nem reinicia os containers.		Desta forma o comando docker compose pull baixa as imagens Docker mais recentes definidas no seu '''docker-compose.yml''', mas não recria nem reinicia os containers.

	Em seguida, o comando docker compose up -d verifica o estado dos serviços e cria ou recria os containers necessários. Caso alguma imagem tenha sido atualizada pelo pull, o serviço correspondente será recriado para utilizar a nova versão.		Em seguida, o comando '''docker compose up -d''' verifica o estado dos serviços e cria ou recria os containers necessários. Caso alguma imagem tenha sido atualizada pelo '''pull''', o serviço correspondente será recriado para utilizar a nova versão.

	= Conclusão =		= Conclusão =

Diegocosta: /* Atualizar */

2026-08-22T13:50:08Z

Atualizar

← Edição anterior		Edição das 10h50min de 22 de agosto de 2026
Linha 327:		Linha 327:
	Desta forma o comando docker compose pull baixa as imagens Docker mais recentes definidas no seu docker-compose.yml, mas não recria nem reinicia os containers.		Desta forma o comando docker compose pull baixa as imagens Docker mais recentes definidas no seu docker-compose.yml, mas não recria nem reinicia os containers.

	~~Depois~~, o comando docker compose up -d verifica o estado dos serviços e cria ou recria os containers ~~que forem~~ necessários. ~~Quando uma~~ imagem ~~foi~~ atualizada pelo pull, o serviço correspondente será recriado para utilizar a nova ~~imagem. Os serviços que não sofreram alterações permanecem como estão~~.		Em seguida, o comando docker compose up -d verifica o estado dos serviços e cria ou recria os containers necessários. Caso alguma imagem tenha sido atualizada pelo pull, o serviço correspondente será recriado para utilizar a nova versão.

	= Conclusão =		= Conclusão =

Diegocosta: /* Atualizar */

2026-08-22T13:49:00Z

Atualizar

← Edição anterior		Edição das 10h49min de 22 de agosto de 2026
Linha 327:		Linha 327:
	Desta forma o comando docker compose pull baixa as imagens Docker mais recentes definidas no seu docker-compose.yml, mas não recria nem reinicia os containers.		Desta forma o comando docker compose pull baixa as imagens Docker mais recentes definidas no seu docker-compose.yml, mas não recria nem reinicia os containers.

	Depois o comando docker compose up -d ~~levanta~~ os containers ~~novamente~~, ~~já com~~ a nova ~~versão, sem necessariamente atualizar todos, apenas aqueles~~ que ~~tiveram atualizações será envolvido~~.		Depois, o comando docker compose up -d verifica o estado dos serviços e cria ou recria os containers que forem necessários. Quando uma imagem foi atualizada pelo pull, o serviço correspondente será recriado para utilizar a nova imagem. Os serviços que não sofreram alterações permanecem como estão.

	= Conclusão =		= Conclusão =

Diegocosta: /* Atualizar */

2026-08-22T13:47:44Z

Atualizar

← Edição anterior		Edição das 10h47min de 22 de agosto de 2026
Linha 327:		Linha 327:
	Desta forma o comando docker compose pull baixa as imagens Docker mais recentes definidas no seu docker-compose.yml, mas não recria nem reinicia os containers.		Desta forma o comando docker compose pull baixa as imagens Docker mais recentes definidas no seu docker-compose.yml, mas não recria nem reinicia os containers.

	Depois o comando docker compose up -d levanta os containers novamente, já com a nova versão, sem necessariamente atualizar todos, apenas aqueles que tiveram ~~atualização~~ será envolvido.		Depois o comando docker compose up -d levanta os containers novamente, já com a nova versão, sem necessariamente atualizar todos, apenas aqueles que tiveram atualizações será envolvido.

	= Conclusão =		= Conclusão =

Diegocosta: /* Atualizar */

2026-08-22T13:47:10Z

Atualizar

← Edição anterior		Edição das 10h47min de 22 de agosto de 2026
Linha 315:		Linha 315:
	= Atualizar =		= Atualizar =

			Para atualizar a versão do Patchmon, basta seguir os passos abaixo:

	{{Nota\|Altere /home/diegocosta/patchmon para o destino onde colocou os arquivos ~~dockerfile~~.}}		{{Nota\|Altere /home/diegocosta/patchmon para o destino onde colocou os arquivos docker-compose.yml e .env}}

	<pre>		<pre>
Linha 323:		Linha 324:
	docker compose up -d		docker compose up -d
	</pre>		</pre>

			Desta forma o comando docker compose pull baixa as imagens Docker mais recentes definidas no seu docker-compose.yml, mas não recria nem reinicia os containers.

			Depois o comando docker compose up -d levanta os containers novamente, já com a nova versão, sem necessariamente atualizar todos, apenas aqueles que tiveram atualização será envolvido.

	= Conclusão =		= Conclusão =

Diegocosta: /* Atualizar */

2026-08-22T13:30:53Z

Atualizar

← Edição anterior		Edição das 10h30min de 22 de agosto de 2026
Linha 315:		Linha 315:
	= Atualizar =		= Atualizar =

	Altere /home/diegocosta/patchmon para o destino onde colocou os arquivos dockerfile
			{{Nota\|Altere /home/diegocosta/patchmon para o destino onde colocou os arquivos dockerfile.}}

	<pre>		<pre>
	cd /home/diegocosta/patchmon/		cd /home/diegocosta/patchmon/

Diegocosta: /* Conclusão */

2026-08-22T13:30:23Z

Conclusão

← Edição anterior		Edição das 10h30min de 22 de agosto de 2026
Linha 311:		Linha 311:
	<pre>		<pre>
	docker compose logs -f		docker compose logs -f
			</pre>

			= Atualizar =

			Altere /home/diegocosta/patchmon para o destino onde colocou os arquivos dockerfile
			<pre>
			cd /home/diegocosta/patchmon/
			docker compose pull
			docker compose up -d
	</pre>		</pre>

Diegocosta: /* Vídeo */

2026-08-15T13:25:36Z

Vídeo

← Edição anterior		Edição das 10h25min de 15 de agosto de 2026
Linha 8:		Linha 8:
	= Vídeo =		= Vídeo =

	<embedvideo service="youtube">~~/embedvideo>~~		<embedvideo service="youtube">https://youtu.be/HmPwT7DBuFc</embedvideo>

	https://youtu.be/Nz


			https://youtu.be/HmPwT7DBuFc

	= Instalação do Docker no Debian 13 =		= Instalação do Docker no Debian 13 =

Diegocosta: /* 2. Instalar o Docker CE */

2026-08-08T17:18:11Z

2. Instalar o Docker CE

← Edição anterior		Edição das 14h18min de 8 de agosto de 2026
Linha 65:		Linha 65:

	<pre>		<pre>
	sudo curl -fsSL https://download.docker.com/linux/debian/gpg \		sudo curl -fsSL https://download.docker.com/linux/debian/gpg -o /etc/apt/keyrings/docker.asc
	-o /etc/apt/keyrings/docker.asc
	</pre>		</pre>

Diegocosta: Criou página com '= Sobre = Olá! Visitante, reunimos aqui, informações sobre a ferramenta '''PatchMon''' sendo uma ferramenta de gerenciamento e monitoramento de atualizações de sistemas operacionais. Seu objetivo é centralizar a identificação, o acompanhamento e a aplicação de atualizações em servidores e máquinas Linux, permitindo que a equipe de TI tenha uma visão consolidada do estado de atualização dos ativos. Em ambientes com diversos servidores, acompanhar manualme...'

2026-08-08T17:17:38Z

Criou página com '= Sobre = Olá! Visitante, reunimos aqui, informações sobre a ferramenta '''PatchMon''' sendo uma ferramenta de gerenciamento e monitoramento de atualizações de sistemas operacionais. Seu objetivo é centralizar a identificação, o acompanhamento e a aplicação de atualizações em servidores e máquinas Linux, permitindo que a equipe de TI tenha uma visão consolidada do estado de atualização dos ativos. Em ambientes com diversos servidores, acompanhar manualme...'

Página nova

= Sobre =
Olá! Visitante, reunimos aqui, informações sobre a ferramenta '''PatchMon''' sendo uma ferramenta de gerenciamento e monitoramento de atualizações de sistemas operacionais. Seu objetivo é centralizar a identificação, o acompanhamento e a aplicação de atualizações em servidores e máquinas Linux, permitindo que a equipe de TI tenha uma visão consolidada do estado de atualização dos ativos.

Em ambientes com diversos servidores, acompanhar manualmente quais máquinas possuem pacotes desatualizados pode se tornar trabalhoso e sujeito a falhas. O PatchMon permite automatizar parte desse processo, facilitando a identificação de atualizações pendentes e o gerenciamento dos hosts a partir de uma interface centralizada.

Site Oficial: https://patchmon.net/

= Vídeo =

<embedvideo service="youtube">/embedvideo>

https://youtu.be/Nz

= Instalação do Docker no Debian 13 =

Este documento apresenta o processo de instalação do [https://patchmon.net/ PatchMon] utilizando Docker em um servidor com Debian 13.

O procedimento contempla a instalação do Docker CE, configuração do usuário para execução do Docker sem ''root'', instalação do PatchMon, configuração do CORS e inclusão do próprio servidor como um host monitorado.

== Pré-requisitos ==

Antes de iniciar, certifique-se de que:

* O sistema operacional utilizado é o Debian 13.
* O servidor possui acesso à Internet.
* O usuário utilizado possui privilégios administrativos.
* O Docker será executado pelo usuário local, sem a necessidade de utilizar ''root''.
* A porta TCP 3000 está disponível para o PatchMon.
* O endereço IP do servidor é conhecido.

== 1. Adicionar o usuário aos grupos sudo e docker ==

Para executar o Docker sem utilizar ''root'', o usuário que executará os comandos deve pertencer aos grupos '''sudo''' e ''docker''.

Neste exemplo, o usuário utilizado é '''diegocosta'''.

{{Nota|Substitua '''diegocosta''' pelo nome do usuário existente no seu servidor.}}

<pre>
usermod -aG sudo diegocosta
usermod -aG docker diegocosta
</pre>

O grupo ''sudo'' permite que o usuário execute comandos administrativos utilizando ''sudo'', enquanto o grupo ''docker'' permite executar comandos do Docker sem utilizar diretamente a conta ''root''.

== 2. Instalar o Docker CE ==

A instalação será realizada utilizando o repositório oficial do Docker para Debian.

Primeiro, instale os pacotes necessários:

<pre>
apt install -y sudo ca-certificates curl
</pre>

Crie o diretório utilizado para armazenar a chave do repositório:

<pre>
sudo install -m 0755 -d /etc/apt/keyrings
</pre>

Baixe a chave GPG oficial do Docker:

<pre>
sudo curl -fsSL https://download.docker.com/linux/debian/gpg \
-o /etc/apt/keyrings/docker.asc
</pre>

Ajuste as permissões da chave:

<pre>
sudo chmod a+r /etc/apt/keyrings/docker.asc
</pre>

Adicione o repositório oficial do Docker:

<pre>
sudo tee /etc/apt/sources.list.d/docker.sources <<EOF
Types: deb
URIs: https://download.docker.com/linux/debian
Suites: $(. /etc/os-release && echo "$VERSION_CODENAME")
Components: stable
Architectures: $(dpkg --print-architecture)
Signed-By: /etc/apt/keyrings/docker.asc
EOF
</pre>

Atualize a lista de pacotes:

<pre>
sudo apt update
</pre>

Instale os componentes necessários:

<pre>
sudo apt install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
</pre>

== 3. Testar o Docker ==

Antes de instalar o PatchMon, confirme se o Docker está funcionando corretamente.

<pre>
docker version
</pre>

Também é possível executar um container de teste:

<pre>
docker run hello-world
</pre>

Se o container for executado corretamente, o ambiente Docker está pronto para receber o PatchMon.

= 4. Instalar o PatchMon =

Crie o diretório que será utilizado para armazenar os arquivos do PatchMon:

<pre>
mkdir patchmon && cd patchmon
</pre>

Execute o script oficial de preparação do ambiente Docker disponibilizado pelo projeto:

<pre>
bash -c "$(curl -fsSL https://raw.githubusercontent.com/PatchMon/PatchMon/refs/heads/main/docker/setup-env.sh)"
</pre>

O script irá preparar os arquivos necessários para execução do PatchMon através do Docker Compose.

== 5. Configurar o CORS ==

Antes de iniciar os containers, é necessário ajustar a configuração do CORS.

O PatchMon utiliza a variável '''CORS_ORIGIN''' para definir as origens autorizadas.

Edite o arquivo ''.env'':

<pre>
nano /home/diegocosta/patchmon/.env
</pre>

Localize a variável:

<pre>
CORS_ORIGIN=
</pre>

Adicione o endereço IP do servidor na porta 3000.

Exemplo:

<pre>
CORS_ORIGIN=http://192.168.1.100:3000
</pre>

{{Nota|Substitua ''192.168.1.100'' pelo endereço IP real do servidor onde o PatchMon está instalado.}}

Caso já existam outras origens configuradas na variável, mantenha-as e adicione o novo endereço separado por vírgula.

Exemplo:

<pre>
CORS_ORIGIN=http://localhost:3000,http://192.168.1.100:3000
</pre>

A configuração do CORS deve ser realizada antes da inicialização dos containers.

== 6. Inicializar o PatchMon ==

Com a configuração concluída, permaneça no diretório do PatchMon:

<pre>
cd ~/patchmon
</pre>

Inicie os containers:

<pre>
docker compose up -d
</pre>

Verifique os containers em execução:

<pre>
docker compose ps
</pre>

Os containers necessários para o funcionamento do PatchMon deverão aparecer como ''running''.

Também é possível verificar todos os containers Docker:

<pre>
docker ps
</pre>

= 7. Primeiro acesso ao PatchMon =

Acesse o PatchMon através do navegador utilizando o endereço IP do servidor.

Exemplo:

<pre>
http://192.168.1.100:3000
</pre>

Substitua o endereço IP pelo endereço configurado no servidor.

Após o acesso, realize a configuração inicial da aplicação conforme solicitado pelo PatchMon.

== 8. Adicionar o próprio servidor como Host ==

Como o PatchMon está sendo executado em Docker, o próprio servidor pode ser adicionado como um host utilizando o agente em modo Docker.

No menu lateral do PatchMon, acesse:

<pre>
Hosts
|
+-- Add Host
</pre>

Selecione:

* Sistema operacional: '''Linux'''
* Friendly Name: '''Patchmon'''
* Tipo: '''Docker'''

Após preencher as informações, utilize a opção '''Copy command'''.

O PatchMon irá gerar um comando específico para instalação e registro do agente.

Cole o comando no terminal do próprio servidor onde o PatchMon está instalado e execute-o.

Após a execução, o agente deverá estabelecer comunicação com o servidor PatchMon.

A integração pode ser verificada através da área '''Hosts''' ou diretamente no dashboard.

== 9. Testar o gerenciamento de atualizações ==

Com o host adicionado, podemos verificar quais versões de pacotes estão disponíveis para atualização.

Como exemplo, podemos consultar a versão disponível do OpenSSL:

<pre>
apt-cache madison openssl
</pre>

O comando exibirá as versões disponíveis do pacote nos repositórios configurados.

Para instalar uma versão específica, utilize:

<pre>
sudo apt install openssl=3.5.5-1~deb13u2
</pre>

{{Nota|A versão apresentada neste exemplo pode mudar conforme os repositórios e atualizações disponíveis. Utilize uma versão efetivamente disponível no seu ambiente.}}

== 10. Configurar o intervalo de atualização ==

Por padrão, o job responsável pela verificação de atualizações é executado periodicamente.

A frequência pode ser alterada diretamente pela interface do PatchMon.

Acesse:

<pre>
Settings
|
+-- Agent Updates
</pre>

Defina o intervalo desejado.

Para ambiente de testes, por exemplo, pode ser utilizado um intervalo de '''5 minutos'''.

Depois de alterar o intervalo, utilize '''Save and Deploy'''.

A configuração será aplicada aos agentes.

== 11. Aguardar a execução do agente ==

Após realizar a configuração, aguarde alguns minutos para que o agente execute o próximo ciclo de verificação.

Em um ambiente configurado para execução a cada 5 minutos, normalmente será necessário aguardar aproximadamente 5 a 10 minutos para visualizar os resultados.

Após esse período, verifique novamente o host no PatchMon.

== 12. Verificações finais ==

Após a instalação, recomendamos verificar:

<pre>
docker ps
</pre>

Verificar o status dos containers:

<pre>
docker compose ps
</pre>

Verificar os logs caso exista algum problema:

<pre>
docker compose logs
</pre>

Para acompanhar os logs em tempo real:

<pre>
docker compose logs -f
</pre>

= Conclusão =

Com os procedimentos apresentados neste documento, o PatchMon estará instalado em um servidor Debian 13 utilizando Docker.

O ambiente também estará preparado para:

* Gerenciar hosts Linux.
* Executar o agente utilizando Docker.
* Identificar atualizações disponíveis.
* Realizar atualizações através do PatchMon.
* Acompanhar o estado dos hosts através do dashboard.
* Configurar a frequência de execução dos agentes.

Para ambientes de produção, recomenda-se validar previamente as configurações em um ambiente de homologação, principalmente os procedimentos de atualização automática e os intervalos de execução dos agentes.