Como começar a usar o Portainer, uma IU da Web para Docker

Portainer é uma popular interface de usuário do Docker que ajuda a visualizar seus contêineres, imagens, volumes e redes. O Portainer ajuda você a controlar os recursos do Docker em sua máquina, evitando comandos de terminal demorados.

O Portainer alcançou recentemente a versão 2.0, que adicionou suporte para clusters Kubernetes. A ferramenta também oferece suporte a ambientes Docker Swarm e Azure ACI. Neste tutorial, vamos mantê-lo simples e usar o Portainer para gerenciar uma instalação Docker local.

Duas edições do software estão disponíveis, o CE gratuito e de código aberto e o Business comercial. Os recursos extras do Business concentram-se principalmente em acesso aprimorado, gerenciamento de cotas e controles de administrador.

Instale o Portainer

Certifique-se de ter o Docker instalado e em execução antes de prosseguir. O Docker 19.01 é necessário para que todos os recursos do Portainer sejam totalmente suportados.

Primeiro de tudo, você precisará criar um novo volume do Docker. O Portainer usará isso para armazenar seus dados persistentes. O nosso se chamará portainer_data.

 volume docker criar portainer_data 

Em seguida, use o Docker para iniciar um novo contêiner do Portainer:

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

Este comando irá puxar a imagem portainer / portainer-ce e iniciar um novo container a partir dela. O contêiner será desanexado e executado em segundo plano (-d).

O volume criado anteriormente é montado em / data dentro do container, onde o Portainer armazena todos os seus dados de aplicação. O soquete Docker do host também é montado no contêiner, para que o Portainer tenha acesso à instância Docker da sua máquina. Finalmente, a porta 9000 no host é ligada à porta 9000 dentro do contêiner. Esta é a porta em que o Portainer expõe sua IU da web.

Primeira execução

Agora você pode acessar o Portainer visitando http: // localhost: 9000 em seu navegador. Você precisará definir uma senha para o usuário administrador no primeiro uso. Você será direcionado para a tela inicial.

Antes de começar a usar o Portainer, vale a pena dar uma olhada nas próprias opções de configuração do aplicativo. Clique no link “ Configurações ” link no menu de navegação esquerdo. Aqui, você pode alterar as configurações de segurança do Portainer, definir um logotipo de aplicativo personalizado e cancelar a coleta anônima de estatísticas de uso. A maioria das configurações deve ser bastante autoexplicativa, com a maioria focada em limitar o poder concedido a usuários não administradores.

A seção “ Autenticação ” O submenu na barra de navegação permite configurar como os usuários fazem o login no Portainer. O Portainer usa seu próprio sistema interno de gerenciamento de usuários por padrão, mas você pode escolher usar um servidor LDAP ou provedor OAuth existente. Selecione o método a ser usado e preencha os campos do formulário para configurar seu sistema de autenticação preferido. Ao usar o banco de dados de usuários integrado, você pode usar a página “ Usuários ” link no menu lateral para criar usuários adicionais e classificá-los em equipes.

Endpoints

O Portainer permite que você gerencie vários endpoints do Docker. Para começar, você &’ verá um único “ local ” endpoint, representando o Docker Engine em execução em sua própria máquina.

Para adicionar outro ponto de extremidade, clique no link “ Pontos de extremidade ” link na barra lateral. Em seguida, clique no botão azul “ Adicionar ponto de extremidade ” botão. Escolha o tipo de ponto de extremidade que você usará e forneça os detalhes de sua conexão.

Se tudo correr bem, você poderá adicionar o seu endpoint. Ele aparecerá como um novo bloco selecionável na tela inicial do Portainer. Orientações detalhadas sobre como adicionar pontos de extremidade adicionais estão fora do escopo deste guia introdutório, pois o sucesso exigirá a configuração correta do host ao qual você está se conectando.

Gerenciamento de contêineres

Agora você está pronto para começar a usar o Portainer para interagir com o Docker. Na tela inicial, clique no botão “ local ” ponto final. Ele será selecionado no Portainer, dando a você acesso à UI de gerenciamento completo. Você chegará a um painel simples que oferece uma visão geral de seus contêineres, imagens e volumes.

Clique em “ Containers ” no painel ou na barra lateral para abrir a tela de gerenciamento de contêiner. Você verá uma tabela exibindo todos os seus contêineres do Docker.

Para executar uma ação contra um contêiner, clique na caixa de seleção ao lado de seu nome. Agora você pode usar a linha de botões na parte superior da tela para iniciar, parar, reiniciar ou remover o contêiner. Os contêineres que estão em execução mostrarão um verde “ running ” enquanto os parados ficam com a cor vermelha “ parados ”.

Se você estiver usando uma nova instalação do Docker, seu único contêiner pode ser o próprio Portainer. Tome cuidado para não interromper este contêiner, pois ele está servindo a interface de usuário da web do Portainer que você está usando!

Clique no nome de um contêiner para visualizar e alterar seus detalhes. Esta tela permite que você inspecione as propriedades do contêiner, crie uma nova imagem do Docker a partir de seu estado atual e gerencie suas conexões de rede.

Na parte superior da tela, você encontrará cinco botões em “ Status do contêiner ” que permitem ver os registros do contêiner (“ Registros ”), inspecionar seu manifesto do Docker (“ Inspecionar ”), ver estatísticas de uso de recursos (“ Estatísticas ”), acesse um console interativo (“ Console ”) ou anexe um console ao processo de primeiro plano no contêiner (“ Anexar ”).

Crie um contêiner

Para criar um novo contêiner, retorne à tela Contêineres e clique no botão azul “ Adicionar contêiner ” botão. Você também pode editar um contêiner existente – efetivamente destruindo-o e substituindo-o por um novo com propriedades modificadas – usando o botão “ Duplicar / Editar ” botão na tela de detalhes do contêiner. Ambas as operações exibem a mesma interface.

Primeiro, digite um nome para o seu novo contêiner. Em seguida, especifique a imagem Docker a ser usada. Para imagens públicas no Docker Hub, como wordpress: latest, você pode digitar um nome de imagem sem fornecer nenhuma configuração adicional.

Para usar imagens armazenadas em um registro privado, você primeiro precisa adicionar os detalhes do registro ao Portainer. Clique no link “ Registros ” link sob o título Configurações na barra lateral esquerda. Pressione o botão azul “ Adicionar registro ” botão e defina a URL, nome de usuário e senha de seu registro. Você poderá então selecioná-lo no “ Registro ” lista suspensa na tela de criação do contêiner. Você também pode usar a tela Registros para definir credenciais para conexões Docker Hub, permitindo que você extraia imagens privadas e evite os limites de taxa aplicados a usuários não autenticados.

Agora você está pronto para implantar seu contêiner pressionando o botão “ Implantar o contêiner ” botão na parte inferior do formulário. Antes de continuar, revise as configurações adicionais que são exibidas acima do botão. Você pode configurar a vinculação da porta, forçar o Portainer a extrair a imagem antes de implantar e escolher remover o contêiner automaticamente quando ele sair.

Na parte inferior da tela, você encontrará uma IU de configurações avançadas que oferece ainda mais opções – muitos para cobrir exaustivamente aqui. Eles replicam toda a funcionalidade do comando docker run CLI, permitindo que você configure o comando do contêiner, ponto de entrada, volumes, interfaces de rede e variáveis ​​de ambiente. Grande parte desta IU deve parecer intuitiva se você já estiver familiarizado com os recursos do Docker.

Usando pilhas de contêineres

A tela de criação de contêiner permite apenas que você gire um contêiner de cada vez. O Portainer possui suporte integrado para “ stacks ” que permitem implantar contêineres vinculados. Esta funcionalidade é baseada na versão 2 do docker-compose.

Clique em “ Pilhas ” na barra de navegação e, em seguida, pressione o botão “ Adicionar pilha ” botão. Não há suporte para criar pilhas graficamente – você precisa colar ou fazer upload de um arquivo docker-compose. yml. Você também pode optar por se conectar a um repositório Git e usar seu docker-compose. yml diretamente.

Antes de implantar a pilha, você é capaz de definir as variáveis ​​de ambiente que serão disponibilizadas para os contêineres. Escolha o nível de controle de acesso do Portainer a ser aplicado e clique em “ Implantar a pilha ”. O Portainer irá puxar todas as imagens e criar todos os contêineres especificados pelo arquivo Compose.

Selecione sua pilha na tela Pilhas para gerenciar seus contêineres coletivamente. Você pode interromper todos os contêineres da pilha ou excluí-la totalmente, usando os botões na parte superior da tela. Também há controles para duplicar a pilha ou criar um modelo reutilizável a partir de seu estado atual.

Os modelos podem ser acessados ​​na tela de criação de pilha e permitem que você acione rapidamente novas instâncias de serviços usados ​​com frequência. O Portainer também vem com vários modelos integrados, acessíveis em “ Modelos de aplicativos ” link na barra de navegação.

Conveniência do Portainer

O Portainer ajuda você a criar, gerenciar e monitorar contêineres Docker rapidamente. Ele fornece uma interface gráfica para os comandos da CLI do Docker que às vezes podem se tornar longos e difíceis de manejar. Ele também torna o Docker acessível para usuários que podem não estar familiarizados com interfaces de linha de comando.

Além de seus recursos de gerenciamento de contêiner, o Portainer também fornece visibilidade para outros recursos básicos do Docker. A tela Imagens permite que você visualize, extraia, importe, exporte e exclua as imagens disponíveis em seu terminal. As telas Redes e Volumes atuam de forma semelhante, enumerando e fornecendo controle sobre seus respectivos recursos. Por fim, a tabela Eventos oferece uma lista abrangente de todas as ações executadas pelo mecanismo Docker. Isso pode ser útil ao revisar ações anteriores e identificar quando certos contêineres foram criados ou destruídos.