Como usar o Portainer para gerenciar contêineres Docker

Armando Couto 🇧🇷
programming to live
6 min readMay 30, 2022
vista de fora de um homem trabalhando no computador em frente à janela. O prédio é cinza e o monitor se destaca por ser branco. | portainer ubuntu contêineres docker
Sigmund on Unsplash

Ao lidar com projetos com grande volume de informação e com códigos extremamente longos, é comum que usemos aplicações de gerenciamento em contêineres. O Docker é uma dessas aplicações, mas o objetivo desse post não é falar sobre ele, e sim sobre o Portainer.

O Portainer otimiza o gerenciamento dos seus contêineres Docker. Trata-se de uma IU de gestão Docker, incluindo o ambiente Docker Swarm.

Além de facilitar a gestão dos seus contêineres, permite administrar imagens, redes e volumes a partir do painel Portainer Web-based.

Neste tutorial, vou mostrar um passo a passo de como instalar e configurar o Portainer no Ubuntu 16.04 LTS. Para isso, você já deve ter o Ubuntu instalado na sua máquina.

Em seguida, ensinarei a implantar um contêiner fantasma e a gerenciar um ambiente docker usando o Portainer.

Dividi este texto em 3 passos principais:

  • Como instalar o Portainer no Ubuntu 16.04 LTS
  • Como implantar contêiner de aplicação de Blog Fantasma
  • Como gerir o ambiente do Docker utilizando o Portainer

Vamos começar?

Como instalar o Portainer no Ubuntu 16.04 LTS

Antes de começar, você precisa atualizar o repositório do seu sistema e os pacotes.

sudo apt update
sudo apt upgrade

Agora sim podemos começar.

Para instalar o Portainer é preciso que você já tenha instalado o docker no Ubuntu. Por isso, vou explicar rapidamente como instalar o Docker.

Instalando o Docker

Começaremos instalando o Docker na sua máquina, então use o comando apt abaixo.

sudo apt install docker.io -y

Quando a instalação estiver completa, inicie o serviço Docker e habilite-o para ser iniciado sempre que o sistema for inicializado.

systemctl start docker
systemctl enable docker

Terminada essa etapa, o Docker deve estar instalado no seu servidor Ubuntu 16.04. Verifique se deu certo utilizando o comando ‘docker version’.

Instalando e configurando o Portainer

Como já instalamos o Docker, chegou o momento de instalar o Portainer.

Nessa etapa, temos duas opções:

  • instalar o Portainer como um contêiner docker autônomo
  • instalar o Portainer sozinho sem um contêiner docker.

Neste tutorial, optamos por instalar o Portainer como um contêiner Docker.

É muito simples de instalar e executar em qualquer sistema porque só precisamos assegurar o suporte do sistema para o Docker.

Antes de instalar o Portainer, baixe o arquivo do Portainer a partir do DockerHub usando o comando de pull docker abaixo.

docker pull portainer/portainer

Agora execute o Portainer usando o seguinte comando Docker:

docker run -d -p 9000:9000 -v /var/run/docker.sock:/var/run/docker.sock portainer/portainer

Depois disso, o Portainer estará instalado e sendo executado como um contêiner. Verifique usando o comando docker ps

Se tudo tiver dado certo, você terá o resultado a seguir.

O Portainer está funcionando como um container Docker com o nome ‘elatted_hopper’, e roda sob a porta 9000.

A seguir, vamos configurar a senha de administração para o Portainer.

Abra o seu navegador e digite o endereço IP do servidor com a porta 9000.

http://192.168.33.10:9000/

Você receberá a seguinte página sobre o usuário administrador e a configuração da senha.

Digite sua senha de administrador e clique no botão ‘Criar usuário’.

Agora precisamos definir o ambiente docker que o Portainer vai se conectar.

O Portainer oferece suporte para ambiente autônomo Docker, Docker Swarm, e modo Swarm.

Para este tutorial, vamos configurar o Portainer para se conectar ao ambiente local Docker.

Escolha o ambiente ‘Local’ e clique no botão ‘Connect’.

E agora verá o Dashboard de Administrador Portainer.

Com isso, o Portainer foi instalado como um Container Docker no Ubuntu 16.04.

Como implantar um novo contêiner de aplicação

Nesta etapa, utilizaremos o Application Container com o Portainer.

Clique no menu ‘App Template’.

Agora escolha o aplicativo que você quer instalar. Preferi instalar, neste tutorial, o blog ‘Ghost’ como um Docker Container.

Clique em Ghost.

Digite o nome do container como ‘ghost-blog’ e clique em ‘Mostrar opções avançadas’.

Na configuração ‘Port mapping’, digite a porta 80 no ‘host’.

Agora clique no botão ‘Deploy the container’.

E quando estiver completa, você receberá a página do contêiner como abaixo.

Pronto! O Ghost está instalado como um Docker Contêiner e usa a porta 80 no host.

Abra o seu navegador e digite o endereço IP do servidor.

http://192.168.33.10/

E você terá a página inicial do blog ‘ghost’ como abaixo.

Como gerir o ambiente do Docker utilizando o Portainer

Neste tópico, quero mostrar como configurar ambientes Docker, desde as imagens Docker e contêineres até os volumes e redes.

Vamos, então, fazer um passeio por cada seção do Portainer para que você possa ver como é simples utilizá-lo.

Para gerir os contêineres

A Portainer oferece uma forma simples e fácil de gestão para Contêineres Docker.

Clique no menu ‘Containers’ à esquerda e você terá a página como abaixo.

Podemos começar, parar, reiniciar, criar um novo container, acessar o shell do container, ver os registros do container e suas estatísticas a partir desta página de manutenção do Portainer container.

Confira cada uma das funções.

Shell do container ghost:

Logs do container ghost:

As estatísticas do contêiner:

Para gerir imagens do Docker

Clique no menu ‘Imagens’ e você terá a página como abaixo.

Agora podemos ver a lista de imagens Docker no nosso sistema, e podemos criar manualmente uma nova imagem Docker, ou puxar/baixar novas imagens a partir do repositório DockerHub.

Para gerir Redes

A partir deste menu, nós criamos novas redes personalizadas para o nosso ambiente Docker. Clique no menu ‘Networks’.

Para gerir volumes

Este menu fornece uma forma fácil de criar novos volumes personalizados para o nosso contêiner.

Só precisamos criar novos volumes personalizados. Quando quisermos criar um novo contêiner, basta anexá-lo ao recipiente através do menu ‘Opções avançadas’.

Conclusão

Pronto! A instalação e configuração do Portainer no Ubuntu 16.04 foi concluída com sucesso! Agora você pode gerenciar seus contêineres Docker sem mais problemas.

Caso queira ver mais sobre o sistema de contêineres, acesse um dos textos abaixo:

Kubernetes: confira os comandos mais usados

Principais comandos Docker

Se este tutorial te ajudou na instalação, deixe-me saber. Clique nas palminhas para incentivar a produção de mais textos. Até a próxima!

--

--