n8n-nodes-portainer

Este Community Node é uma solução 100% gratuita, criada com o intuito de simplificar e auxiliar toda a comunidade a integrar e utilizar ao máximo os principais recursos oferecidos pelo Portainer em seus projetos no N8N.

Aviso: Este node foi desenvolvido de forma independente para facilitar integrações com a API pública do Portainer no n8n.
Não é afiliado, endossado ou mantido pelo Portainer.
Todas as marcas citadas pertencem aos seus respectivos proprietários.

⚙️ Requisitos

Para utilizar o nosso Community Node, é necessário atender aos seguintes requisitos:

• N8N na versão 1.54.4 ou superior
• Node.js na versão 16.0.0 ou superior
• Conta ativa no Portainer com token de API

📌 Recursos Disponíveis

🐳 Containers

📝 Gerenciamento completo de containers Docker com operações avançadas de criação, execução, monitoramento e controle de ciclo de vida.

Lista de operações

✅ Create - Criar novos containers

✅ Delete - Deletar containers

✅ Exec - Executar comandos nos containers

✅ Get - Obter informações específicas do container

✅ Get Logs - Obter logs do container

✅ Get Many - Listar todos os containers

✅ Get Stats - Obter estatísticas de uso

✅ Inspect - Inspecionar detalhes do container

✅ Pause - Pausar containers em execução

✅ Restart - Reiniciar containers

✅ Start - Iniciar containers parados

✅ Stop - Parar containers em execução

✅ Unpause - Despausar containers pausados

🖼️ Images

📝 Gerenciamento completo de imagens Docker incluindo build, pull, push, tag e análise de histórico para controle total do ciclo de vida das imagens.

Lista de operações

✅ Build - Construir imagens a partir de Dockerfile

✅ Delete - Deletar imagens

✅ Get - Obter informações específicas da imagem

✅ Get History - Obter histórico da imagem

✅ Get Many - Listar todas as imagens

✅ Inspect - Inspecionar detalhes da imagem

✅ Pull - Baixar imagens do registry

✅ Push - Enviar imagens para o registry

✅ Tag - Criar tags para imagens

⚙️ Services (Docker Swarm)

📝 Gerenciamento completo de services Docker Swarm com criação, escalonamento, atualização e monitoramento para orquestração de containers distribuídos.

Lista de operações

✅ Create - Criar novos services

✅ Delete - Deletar services

✅ Get - Obter informações específicas do service

✅ Get Logs - Obter logs do service

✅ Get Many - Listar todos os services

✅ Scale - Escalar number de réplicas

✅ Update - Atualizar configurações do service

🔐 Secrets (Docker Swarm)

📝 Gerenciamento seguro de secrets Docker Swarm para armazenamento e distribuição segura de informações sensíveis nos services.

Lista de operações

✅ Create - Criar novos secrets

✅ Delete - Deletar secrets

✅ Get - Obter informações específicas do secret

✅ Get Many - Listar todos os secrets

✅ Inspect - Inspecionar detalhes do secret

📋 Configs (Docker Swarm)

📝 Gerenciamento de configs Docker Swarm para distribuição de arquivos de configuração e dados não-sensíveis aos services do cluster.

Lista de operações

✅ Create - Criar novos configs

✅ Delete - Deletar configs

✅ Get - Obter informações específicas do config

✅ Get Many - Listar todos os configs

✅ Inspect - Inspecionar detalhes do config

🌐 Edge Groups

📝 Gerenciamento de grupos de edge computing para organização e controle centralizado de endpoints distribuídos geograficamente.

Lista de operações

✅ Create - Criar novos grupos de edge

✅ Delete - Deletar grupos de edge

✅ Get - Obter informações específicas do grupo

✅ Get Many - Listar todos os grupos de edge

✅ Update - Atualizar configurações do grupo

📦 Edge Stacks

📝 Gerenciamento de stacks de edge computing para deployment distribuído de aplicações em múltiplas localizações edge.

Lista de operações

✅ Create - Criar novos stacks de edge

✅ Delete - Deletar stacks de edge

✅ Get - Obter informações específicas do stack

✅ Get Many - Listar todos os stacks de edge

✅ Get Status - Obter status de deployment

✅ Update - Atualizar configurações do stack

🖥️ Nodes (Docker Swarm)

📝 Gerenciamento de nodes Docker Swarm para monitoramento e controle dos nós do cluster, incluindo status e configurações.

Lista de operações

✅ Get - Obter informações específicas do node

✅ Get Many - Listar todos os nodes

✅ Inspect - Inspecionar detalhes do node

✅ Update - Atualizar configurações do node

📚 Stacks (Docker Compose)

📝 Gerenciamento de stacks Docker Compose para deployment e atualização de aplicações multi-container definidas em arquivos YAML.

Lista de operações

✅ Delete - Deletar stacks

✅ Get - Obter informações específicas do stack

✅ Get Many - Listar todos os stacks

✅ Update - Atualizar configurações do stack

📋 Registries

📝 Gerenciamento de registries de imagens Docker com suporte a múltiplos tipos incluindo DockerHub, ECR, Azure, GitLab e registries customizados.

Lista de operações

✅ Create - Criar novos registries

✅ Delete - Deletar registries

✅ Get - Obter informações específicas do registry

✅ Get Many - Listar todos os registries

✅ Update - Atualizar configurações do registry

👥 Teams

📝 Gerenciamento de equipes no Portainer para controle de acesso baseado em grupos e permissões colaborativas.

Lista de operações

✅ Create - Criar novas equipes

✅ Delete - Deletar equipes

✅ Get - Obter informações específicas da equipe

✅ Get Many - Listar todas as equipes

✅ Update - Atualizar configurações da equipe

📄 Templates

📝 Gerenciamento de templates de aplicação do Portainer para deployment rápido de aplicações pré-configuradas.

Lista de operações

✅ Get - Obter informações específicas do template

✅ Get Many - Listar todos os templates

⚙️ Settings

📝 Gerenciamento de configurações do Portainer incluindo autenticação, políticas de segurança e configurações globais da plataforma.

Lista de operações

✅ Get - Obter configurações atuais

✅ Update - Atualizar configurações

🔗 Webhooks

📝 Gerenciamento de webhooks para automação e integração com sistemas externos através de notificações HTTP.

Lista de operações

✅ Create - Criar novos webhooks

✅ Delete - Deletar webhooks

✅ Get Many - Listar todos os webhooks

💻 System

📝 Informações do sistema Portainer incluindo status, versão e informações dos nós para monitoramento da plataforma.

Lista de operações

✅ Get Status - Obter status do sistema

✅ Get Version - Obter versão do Portainer

✅ Get Nodes - Obter informações dos nós

👤 Users

📝 Gerenciamento de usuários do Portainer para controle de acesso e administração de contas.

Lista de operações

✅ Get - Obter informações específicas do usuário

✅ Get Many - Listar todos os usuários

💾 Volumes

📝 Gerenciamento de volumes Docker para persistência de dados e compartilhamento entre containers.

Lista de operações

✅ Delete - Deletar volumes

✅ Get Many - Listar todos os volumes

🌐 Networks

📝 Gerenciamento de redes Docker para conectividade e isolamento entre containers.

Lista de operações

✅ Delete - Deletar redes

✅ Get Many - Listar todas as redes

🏢 Environments

📝 Gerenciamento de ambientes/endpoints do Portainer para conexão com diferentes instâncias Docker.

Lista de operações

✅ Get - Obter informações específicas do ambiente

✅ Get Many - Listar todos os ambientes

🚀 Instalação

Via n8n Community Nodes:

1. Abra sua instância do n8n
2. Vá para Settings → Community Nodes
3. Instale o pacote: n8n-nodes-portainer
4. Reinicie o n8n

Via NPM:

npm install n8n-nodes-portainer

🤝 Contribuição

Contribua para o crescimento deste projeto! Você pode ajudar de diversas formas:

• Pull Requests: Envie melhorias, correções ou novas funcionalidades.
• Issues: Relate problemas ou sugira novas ideias.
• Sugestões: Compartilhe suas opiniões e feedbacks.
• Documentação: Ajude a melhorar ou expandir a documentação existente.

Desenvolvido com ❤️ por Ramon Matias