Abaixo está um passo a passo para instalar o Portainer (versão Community Edition) junto com o Portainer Agent, garantindo que os dados do Portainer sejam salvos em um volume persistente no Docker.

Pré-requisitos:

• Docker instalado na máquina.
• Acesso ao terminal do servidor onde deseja instalar o Portainer.

Passo a Passo:

Criar um volume para dados persistentes do Portainer: Este volume será utilizado para armazenar os dados de configurações, usuários e endpoints do Portainer, garantindo que eles não sejam perdidos caso o contêiner seja removido ou recriado.

docker volume create portainer_data

Executar o contêiner do Portainer: Utilize o comando abaixo para iniciar o Portainer em sua máquina. Este comando:

• Mapeará a porta 9443 (HTTPS) do contêiner para a porta 9443 local,
• Mapeará a porta 8000 (túnel do agente, opcional) para a porta 8000 local,
• Mapeará a porta 9000 (interface web legacy) para a porta 9000 local,
• Montará o volume portainer_data:/data para persistência,
• Montará o /var/run/docker.sock para que o Portainer possa gerenciar os contêineres locais.

Executar o Portainer Agent: O agente facilita a conexão de Portainer com vários hosts Docker ou Kubernetes. Inicie o agent com:

docker run -d \
  --name portainer_agent \
  -p 9001:9001 \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -v /var/lib/docker/volumes:/var/lib/docker/volumes \
  --restart=always \
  portainer/agent:latest

Acessar a interface do Portainer:

Abra seu navegador e acesse:

https://SEU_ENDEREÇO_IP:9443

ou

http://SEU_ENDEREÇO_IP:9000

Na primeira vez, você precisará criar um usuário administrador e senha.

Adicionar o Agente como Endpoint no Portainer: Depois de fazer login:

• Vá em "Endpoints" (na interface do Portainer),
• Clique em "Add endpoint",
• Selecione "Docker" e escolha a opção de "Agent",
• Informe o endereço do seu agente, por exemplo: http://SEU_ENDEREÇO_IP:9001
• Clique em "Add endpoint".

Resumo:

• Você criou um volume portainer_data para armazenar dados do Portainer.
• Executou o Portainer mapeando as portas e usando o volume persistente.
• Executou o Portainer Agent para gerenciar endpoints remotamente.
• Configurou o Portainer via interface web para conectar ao agente.

Com isso, você terá o Portainer instalado, os dados persistindo entre reinicializações, e o agente permitindo a gerência de múltiplos ambientes a partir de uma única interface.