Ir para o conteúdo
Promovaweb

Perguntas frequentes

Onde fica o token de setup da primeira instalação?

Desde as versões 2.43 e 2.39.4, o Portainer escreve o token nos próprios logs, na linha setup_token=. Você lê o token com docker logs no container do Portainer e cola no campo Setup token da configuração inicial. O token vale uma vez só e deixa de ser necessário depois que o administrador existe. Fonte oficial.

Por que a interface parou de responder logo depois da instalação?

Um Portainer novo espera 5 minutos pela criação do administrador. Sem o cadastro nesse prazo, o Server para de atender requisições por segurança. Reinicie o container com docker stop portainer e docker start portainer para abrir outros 5 minutos. Fonte oficial.

Para que servem as portas 9443, 9000 e 8000?

A 9443 serve a interface em HTTPS, com certificado autoassinado. A 9000 serve a interface em HTTP e é a porta que um proxy reverso como o Traefik usa na rede interna. A 8000 é o servidor de túnel dos Edge Agents e só tem uso com eles. Fonte oficial.

Qual a diferença entre o Portainer Agent e o Edge Agent?

No Portainer Agent, o Server precisa alcançar o agente pela porta 9001, normalmente numa rede privada. No Edge Agent Standard, o agente consulta a API do Server por HTTPS e abre o túnel até a porta 8000 quando necessário. O ambiente remoto precisa de conexões de saída para o Server, sem receber conexões de entrada para esse gerenciamento. Fonte oficial.

Uma stack criada pelo terminal aparece no Portainer?

Aparece, marcada como externa e com controle limitado. O Portainer enxerga os containers da stack, mas não tem o arquivo Compose dela, que ficou na pasta do servidor. Uma stack criada pelo editor web permite editar o YAML no painel. Numa stack vinculada ao Git, você edita o arquivo no repositório. Fonte oficial.

Posso usar o Portainer Community Edition em produção?

Pode. A Portainer.io não recomenda a Community Edition para apps críticos de negócio, porque a edição gratuita não inclui os recursos estendidos nem o suporte prioritário da Business Edition. Fonte oficial.

Por que os usuários perderam acesso depois da troca para a Business Edition?

Na migração da Community Edition para a Business Edition, os usuários padrão, ou seja, os que não são administradores, recebem o papel de usuário só de leitura por segurança. O administrador reatribui o papel certo em cada ambiente depois da troca. Fonte oficial.

Como a licença da Business Edition define um nó?

Cada servidor administrado pelo Portainer entra no cálculo de nós. Um servidor com Server e Agent juntos representa um nó só. Num Docker Swarm, cada nó do cluster entra no cálculo, mesmo sem agente. Um servidor exclusivo de gerência fica fora do limite quando ele próprio não é administrado pelo Portainer. Fonte oficial.

Por que o login falha com o Portainer atrás de um proxy?

O Portainer marca o cookie de login como Secure quando a conexão parece HTTPS. Se o navegador chega ao proxy em HTTP enquanto o proxy fala com o Portainer em HTTPS, o navegador descarta o cookie e o login falha com o erro 401. O esquema que o Portainer enxerga precisa ser o mesmo do navegador. Fonte oficial.

A interface do Portainer existe em português?

A documentação oficial informa que a interface está disponível apenas em inglês. O projeto considera incluir outros idiomas, mas não informa uma versão ou data para isso. Fonte oficial.

StayCloud

Uma VPS para desenvolver com agentes

Servidor da StayCloud em São Paulo, com acesso root e disco NVMe, para deixar seus agentes de IA rodando o dia todo.

Montar minha VPS

Link de parceiro da Promovaweb.