A integração com MinIO deixa você criar e remover buckets, navegar pelos arquivos, enviar e baixar objetos direto do painel. As métricas do MinIO (capacidade, drives, requisições) ficam na tela Observabilidade.
O miniCP não instala o MinIO. Ele se conecta a um servidor MinIO que já existe, pela API S3.
Ativar a integração
- Abra Configuracoes e vá até a aba MinIO.
- Ligue a chave Habilitado.
- Preencha os campos:
| Campo | O que informar |
|---|---|
| Host / IP | Endereço do servidor MinIO. |
| Porta (API) | Porta da API S3. O padrão é 9000. |
| HTTPS/TLS | Ligue se a API do MinIO responde em HTTPS. |
| Access Key | Chave de acesso com permissão de administrador. |
| Secret Key | Senha da chave. Deixe vazio para manter a atual. |
- Salve as configurações.
Depois de habilitado, aparece o item MinIO no menu lateral, no grupo de rede.
Atenção: use a porta da API S3 (normalmente 9000), não a porta do Console web (normalmente 9001). As credenciais precisam ter permissão de admin no MinIO.
Se a conexão falhar, a tela MinIO mostra a mensagem "Falha ao conectar no MinIO" com o erro devolvido. Confira host, porta, TLS e credenciais.
Gerenciar buckets
A tela MinIO lista os buckets com nome e data de criação.
Criar um bucket
- Clique em Criar Bucket.
- Informe o Nome do Bucket.
- Clique em Criar.
Regras para o nome: de 3 a 63 caracteres, só letras minúsculas, números, ponto ou hífen. Deve começar e terminar com letra ou número.
Remover um bucket
Clique no ícone de lixeira na linha do bucket e confirme.
Atenção: o bucket precisa estar vazio para ser removido. Apague os objetos antes.
Navegar e gerenciar arquivos
- Clique no ícone de pasta na linha do bucket para abrir.
- As "pastas" (prefixos) aparecem primeiro. Clique para entrar.
- Use a trilha no topo para voltar a um nível anterior, ou Buckets para voltar à lista.
Para cada objeto você vê nome, tamanho e data de modificação, com as ações:
- Baixar (ícone de download);
- Remover (ícone de lixeira, com confirmação).
Para enviar um arquivo para a pasta atual:
- No quadro Enviar para, escolha o arquivo.
- Clique em Upload.
Dica: a listagem mostra até 1000 itens por pasta. Se houver mais, aparece o aviso de lista truncada. Organize os objetos em prefixos (pastas) para navegar melhor.
Chaves de acesso
O painel não cria nem gerencia usuários, políticas ou chaves de acesso do MinIO. Para criar uma chave para uma aplicação (por exemplo, uma loja que guarda imagens no S3), use o Console do MinIO ou a ferramenta mc:
mc admin user add meuminio app-loja SENHA-FORTE
mc admin policy attach meuminio readwrite --user app-loja
Prefira chaves com acesso restrito ao bucket da aplicação. Não use a chave de admin do painel nas aplicações.
Métricas do MinIO
As métricas ficam em Monitoramento > Observabilidade. Lá o MinIO é cadastrado separado da integração acima.
- Em Observabilidade, clique no botão MinIO.
- Informe Nome, Host, Porta (API), Access Key, Secret Key e, se for o caso, Usar HTTPS/TLS.
- Clique em Adicionar.
- Na lista de conexões, clique no botão de monitor ao vivo do MinIO.
O monitor mostra:
| Indicador | Significado |
|---|---|
| Modo | Estado do cluster (online ou não). |
| Servidores | Quantidade de nós. |
| Drives Online / Offline | Discos ativos e com falha. |
| Capacidade e Uso | Espaço usado, total e percentual. |
| Buckets e Objetos | Contagem total. |
| Req S3 e Erros S3 | Requisições recebidas e com erro. |
| Trafego IN / OUT | Volume recebido e enviado. |
| Versao e Uptime | Versão do MinIO e tempo no ar. |
Também há gráficos de uso, objetos, drives online e requisições.
Dica: se aparecer o aviso "Metricas Prometheus indisponiveis", as requisições e o tráfego ficam zerados. Verifique se o endpoint de métricas do MinIO está acessível e se as credenciais estão corretas.