66 lines
2 KiB
Markdown
66 lines
2 KiB
Markdown
---
|
|
id: KB-INFRA-001
|
|
title: Caminho correto de plugins no container GLPI oficial
|
|
domain: infrastructure
|
|
tags:
|
|
- glpi
|
|
- docker
|
|
- plugins
|
|
- mount
|
|
- orbstack
|
|
status: active
|
|
severity: high
|
|
created_at: 2026-05-01
|
|
updated_at: 2026-05-01
|
|
applies_to:
|
|
- glpi/glpi:latest
|
|
- macOS + OrbStack / Linux Docker Swarm
|
|
- ambiente local de desenvolvimento
|
|
related_records: []
|
|
---
|
|
|
|
# Contexto
|
|
O plugin `GLPI Matrix` nao era exibido na interface do GLPI, mesmo existindo no host e no container.
|
|
|
|
# Sintoma observavel
|
|
- Plugin presente em `/home/glpi/glpi_dev/plugins/glpimatrix`.
|
|
- Interface de plugins do GLPI nao listava o plugin.
|
|
|
|
# Causa raiz
|
|
O bind mount estava apontando para caminho incorreto do container:
|
|
- **Incorreto**: `/var/www/html/glpi/plugins`
|
|
- **Correto (nesta imagem)**: `/var/www/glpi/plugins`
|
|
|
|
A imagem `glpi/glpi:latest` usada neste projeto executa o core em `/var/www/glpi`.
|
|
|
|
# Correcao aplicada
|
|
No `docker-compose.yml`, atualizar volumes do servico `glpi`:
|
|
- `/home/glpi/glpi_dev/plugins/:/var/www/glpi/plugins`
|
|
- `/home/glpi/glpi_dev/files:/var/glpi/files`
|
|
- `/home/glpi/glpi_dev/config:/var/glpi/config`
|
|
- `/home/glpi/glpi_dev/marketplace/:/var/glpi/marketplace`
|
|
|
|
# Validacao padrao
|
|
Executar:
|
|
1. `docker compose up -d --force-recreate glpi`
|
|
2. `docker exec devportal_glpi ls -la /var/www/glpi/plugins`
|
|
3. `curl -s -o /dev/null -w "%{http_code}\n" http://localhost`
|
|
|
|
Esperado:
|
|
- diretorio do plugin visivel em `/var/www/glpi/plugins`;
|
|
- HTTP `200`;
|
|
- plugin listavel em `Configuracao > Plugins` apos refresh.
|
|
|
|
# Impacto
|
|
- Sem essa correcao, agentes podem interpretar incorretamente que o plugin esta invalido.
|
|
- O problema e de infraestrutura/container path, nao de logica do plugin.
|
|
|
|
# Regra para agentes
|
|
Antes de diagnosticar erro funcional de plugin, validar:
|
|
1. caminho de mount do plugin;
|
|
2. estrutura interna da imagem em uso;
|
|
3. cache e estado do container.
|
|
|
|
# Classificacao
|
|
- Tipo: Licao aprendida de infraestrutura.
|
|
- Reutilizacao: obrigatoria em novos setups locais GLPI.
|