Guia Passo a Passo: Como Instalar e Gerenciar Contêineres Docker com Portainer

4 min readFeb 27, 2024

O Portainer é uma ferramenta de gerenciamento de contêineres que simplifica o processo de implementação, gerenciamento e manutenção de contêineres Docker. Ele fornece uma interface gráfica de usuário (GUI) intuitiva que facilita a administração de contêineres, imagens, redes e volumes Docker, permitindo que os usuários gerenciem seus ambientes Docker sem a necessidade de comandos complicados. O Portainer pode ser usado para gerenciar contêineres em ambientes locais, bem como em clusters Docker Swarm ou Kubernetes.

Aqui está um guia básico sobre como instalar e executar o Portainer no Docker:

Pré-requisitos

Docker instalado em seu sistema. Se ainda não tiver o Docker instalado, você pode encontrar instruções de instalação na documentação oficial do Docker.

Passo 1: Criar um volume Docker para o Portainer

O primeiro passo é criar um volume Docker no qual o Portainer irá armazenar seus dados. Isso permite que suas configurações e dados persistam entre as reinicializações do contêiner. Execute o seguinte comando no terminal:

docker volume create portainer_data

Passo 2: Executar o contêiner Portainer

Com o volume criado, você pode agora iniciar o contêiner Portainer usando o seguinte comando Docker. Este comando diz ao Docker para baixar a imagem do Portainer (caso ainda não esteja baixada) e executá-la, anexando o volume de dados que você criou e mapeando as portas para que você possa acessar a interface do usuário do Portainer através do navegador.

Para ambientes Docker standalone:

docker run -d -p 8000:8000 -p 9000:9000 --name=portainer --restart=always -v /var/run/docker.sock:/var/run/docker.sock -v portainer_data:/data portainer/portainer-ce

Para ambientes Docker Swarm, use o seguinte comando:

docker swarm init  # Somente se o Docker Swarm não estiver inicializado
docker stack deploy -c <(docker run portainer/portainer-ce --swarm-stack-file) portainer

Passo 3: Acessar o Portainer

Após iniciar o contêiner Portainer, você pode acessar a interface do usuário do Portainer abrindo seu navegador e indo para http://localhost:9000. Na primeira vez que você acessar, será solicitado que você crie um usuário e senha administrativos.

Passo 4: Configurar o Portainer

Depois de fazer login, você precisará conectar o Portainer ao seu ambiente Docker local ou remoto. Para ambientes Docker locais, o Portainer já deverá ter detectado o Docker e você só precisará confirmar a conexão.

Para conectar a ambientes remotos ou clusters Docker Swarm ou Kubernetes, você precisará fornecer as informações específicas da conexão, como o endereço IP e a porta, e talvez credenciais de acesso.

Passo 5: Gerenciar seus contêineres

Com o Portainer configurado, você pode começar a gerenciar seus contêineres Docker, imagens, redes e volumes diretamente da interface do usuário do Portainer. Você pode criar, iniciar, parar, escalar e remover contêineres e serviços, visualizar logs, e muito mais, tudo de uma interface amigável.

O Portainer é uma ferramenta poderosa e flexível que pode simplificar significativamente o gerenciamento de seus ambientes Docker. Com sua interface gráfica fácil de usar, o Portainer é adequado tanto para iniciantes quanto para profissionais experientes na gestão de contêineres Docker.

Veja como é fácil gerenciar seus containers em modo visual:

Na imagem apresentada anteriormente, observamos que o ambiente em questão hospeda um total de 54 contêineres. Além disso, identificamos a existência de 5 Stacks, os quais foram orquestrados utilizando o docker-compose, juntamente com outros componentes cruciais, incluindo Redes, Imagens e Volumes.

Prossigamos para a análise da lista de contêineres, onde destacamos a simplicidade e eficiência na execução de tarefas fundamentais, tais como iniciar, parar, reiniciar e remover contêineres:

E que tal a conveniência de implantar uma variedade de contêineres diretamente através do Portainer, utilizando os Modelos de Aplicativos disponíveis?

Ademais, a interface do Portainer permite o acesso direto ao Shell dos contêineres, proporcionando uma maneira prática e eficiente para a execução de comandos e gerenciamento de atividades internas. De acordo imagem abaixo: