Catálogo de Serviços

O Catálogo de Serviços permite que você implante serviços de infraestrutura gerenciados — bancos de dados, caches e filas de mensagens — diretamente pelo painel do Guara Cloud. Cada serviço do catálogo roda como um container dedicado dentro do seu projeto, totalmente gerenciado com credenciais automáticas, descoberta de serviços e backups opcionais.

O que é o Catálogo de Serviços?

Em vez de gerenciar seus próprios containers de banco de dados ou cache, o Catálogo de Serviços oferece serviços de infraestrutura pré-configurados e prontos para produção. Ao implantar um serviço do catálogo, o Guara Cloud cuida de:

• Provisionamento — container, rede e armazenamento são criados automaticamente
• Credenciais — usuários, senhas e strings de conexão são gerados automaticamente
• Descoberta de serviços — detalhes de conexão são injetados como variáveis de ambiente nos serviços do mesmo projeto
• Monitoramento de saúde — probes de liveness e readiness são configurados automaticamente
• Backups — snapshots automáticos via Longhorn para serviços com armazenamento persistente

Serviços disponíveis

O catálogo inclui 13 serviços gerenciados em seis categorias:

Bancos de dados

Serviço	Descrição	Versão Padrão
PostgreSQL	Banco de dados relacional open-source com conformidade ACID	17 (Alpine)
MySQL	Banco de dados relacional popular para aplicações web	9.0
MongoDB	Banco de dados NoSQL orientado a documentos para modelos de dados flexíveis	8.0
Meilisearch	Motor de busca leve e tolerante a erros com API RESTful para busca full-text	1.13
Qdrant	Banco de dados vetorial de alta performance para aplicações de IA e busca similar	1.14

Caches

Serviço	Descrição	Versão Padrão
Redis	Armazenamento de dados em memória de alta performance para cache e mensageria	7.4 (Alpine)
Valkey	Armazenamento de dados em memória compatível com Redis e open-source	8.0 (Alpine)
Memcached	Sistema de cache em memória distribuído para acelerar aplicações web dinâmicas	1.6 (Alpine)

Filas de mensagens

Serviço	Descrição	Versão Padrão
NATS	Sistema de mensageria leve e de alta performance para aplicações cloud-native	2.10 (Alpine)
RabbitMQ	Message broker completo com suporte a múltiplos protocolos de mensageria	4.0 (Management, Alpine)

Armazenamento

Serviço	Descrição	Versão Padrão
MinIO	Armazenamento de objetos compatível com S3 para arquivos, backups e dados não estruturados	latest

Ferramentas

Serviço	Descrição	Versão Padrão
Mailpit	Ferramenta leve de teste de email com interface web moderna para inspecionar emails	1.24

CI/CD

Serviço	Descrição	Versão Padrão
GitHub Actions Runner	Runner auto-hospedado que executa workflows CI/CD dos seus repositórios GitHub	2.323.0

Capacidades

Cada serviço do catálogo possui um conjunto de capacidades que determinam suas funcionalidades:

Capacidade	Descrição	Serviços
persistent-storage	Dados persistem entre reinicializações usando volumes Longhorn	PostgreSQL, MySQL, MongoDB, Redis, Valkey, NATS, RabbitMQ, Meilisearch, Qdrant, MinIO
backup	Snapshots automáticos diários via Longhorn com retenção de 3 dias	PostgreSQL, MySQL, MongoDB, Redis, Valkey, NATS, RabbitMQ, Meilisearch, Qdrant, MinIO
credentials	Usuários, senhas e strings de conexão gerados automaticamente	Todos os 13 serviços
metrics	Métricas Prometheus integradas para monitoramento	Todos os 13 serviços

Implantando um serviço do catálogo

Para implantar um serviço do catálogo pelo painel:

1. Navegue até o seu projeto
2. Clique em Novo Serviço e selecione a aba Catálogo de Serviços
3. Navegue pelos serviços disponíveis e selecione o que você precisa
4. Configure o serviço:
   • Versão — escolha entre a lista curada de versões suportadas
   • Tamanho do armazenamento — defina o tamanho inicial do volume persistente (para serviços que suportam)
   • Configurações específicas — por exemplo, o nome do banco de dados para PostgreSQL
5. Clique em Deploy

O Guara Cloud vai provisionar o container, criar o volume persistente (se aplicável), gerar as credenciais e iniciar o serviço. O processo geralmente leva menos de um minuto.

Credenciais de conexão

Quando um serviço do catálogo é implantado, o Guara Cloud gera credenciais seguras automaticamente. Você pode visualizá-las na aba Conexão da página do serviço.

Cada serviço fornece:

• Campos individuais — host, porta, usuário, senha (varia conforme o serviço)
• String de conexão — uma URI pronta para uso (ex: postgresql://guara:****@service-slug:5432/app)

As credenciais são criptografadas em repouso e só são descriptografadas quando você as visualiza no painel ou quando são injetadas nos serviços do mesmo projeto.

Descoberta de serviços

Serviços do catálogo são automaticamente descobertos por outros serviços no mesmo projeto. Ao implantar um serviço do catálogo, seus detalhes de conexão são injetados como variáveis de ambiente em todos os serviços do projeto.

Por exemplo, ao implantar um serviço PostgreSQL do catálogo, as seguintes variáveis de ambiente ficam disponíveis para os serviços da sua aplicação:

• POSTGRES_URL — string de conexão completa
• POSTGRES_HOST — hostname do serviço
• POSTGRES_PORT — número da porta
• POSTGRES_USER — usuário
• POSTGRES_PASSWORD — senha
• POSTGRES_DATABASE — nome do banco de dados

Cada tipo de serviço do catálogo usa seu próprio prefixo (ex: REDIS_, NATS_, MONGODB_, MYSQL_, RABBITMQ_, MEMCACHED_, VALKEY_, MEILISEARCH_, QDRANT_, MINIO_, MAILPIT_).

Gerenciamento de versões

Cada serviço do catálogo oferece uma lista curada de versões suportadas. Você pode alterar a versão de um serviço em execução pela aba Configurações:

1. Acesse a página do serviço
2. Clique em Configurações
3. Selecione uma nova versão no dropdown
4. Clique em Salvar

O serviço será reiniciado com a nova versão. Certifique-se de verificar a compatibilidade antes de trocar de versão, especialmente para serviços de banco de dados.

Gerenciamento de armazenamento

Serviços com a capacidade persistent-storage utilizam volumes Longhorn para persistir dados. Você pode redimensionar o volume pela aba Configurações:

1. Acesse a página do serviço
2. Clique em Configurações
3. Ajuste o controle de Tamanho do Armazenamento
4. Clique em Salvar

O armazenamento só pode ser expandido, nunca reduzido. Essa é uma limitação do Kubernetes para PersistentVolumeClaims.

O tamanho padrão de armazenamento é 1 GiB, e o máximo é 50 GiB por serviço do catálogo. O uso de armazenamento conta para a cota de armazenamento da sua conta.

Backup e restauração

Serviços com a capacidade backup recebem snapshots automáticos diários via Longhorn com período de retenção de 3 dias. Você pode visualizar e gerenciar backups pela aba Backups da página do serviço.

Visualizando backups

A aba Backups lista todos os snapshots disponíveis com a data de criação e o status. Apenas snapshots marcados como Pronto podem ser usados para restauração.

Restaurando a partir de um backup

Para restaurar um serviço do catálogo a partir de um snapshot:

1. Acesse a página do serviço
2. Clique na aba Backups
3. Selecione um snapshot da lista
4. Clique em Restaurar
5. Confirme a ação

Usando a CLI

Todas as operações do catálogo também estão disponíveis pela CLI do Guara Cloud:

Navegando e implantando

# Listar todos os serviços do catálogo disponíveis
guara catalog list

# Ver detalhes de um serviço específico
guara catalog info postgres

# Implantar um serviço do catálogo
guara catalog deploy postgres --name meu-db --version 17-alpine --storage 5

# Implantar com configuração customizada
guara catalog deploy postgres --name meu-db --config databaseName=myapp

Gerenciando credenciais

# Visualizar credenciais de conexão
guara services credentials --project meu-projeto --service meu-db

Gerenciando armazenamento

# Redimensionar armazenamento persistente (apenas expansão é suportada)
guara services resize --project meu-projeto --service meu-db --size 10

Gerenciando backups

# Listar snapshots de backup disponíveis
guara services backups --project meu-projeto --service meu-db

# Restaurar a partir de um snapshot específico
guara services restore --project meu-projeto --service meu-db --snapshot snap-20260409

Conectando aos serviços do catálogo

Serviços do catálogo são internos e não são expostos à internet pública. Para interagir com eles a partir da sua máquina local, use os comandos exec e proxy da CLI:

Shell interativo (exec)

Abra um shell dentro do container de um serviço do catálogo em execução:

# Shell interativo (padrão: /bin/sh)
guara exec --project meu-projeto --service meu-db

# Executar um comando único
guara exec --project meu-projeto --service meu-db -- psql -U dbuser -d app -c "SELECT 1"

Encaminhamento de porta (proxy)

Encaminhe uma porta local para um serviço do catálogo, permitindo conectar com suas ferramentas locais:

# Encaminhar porta local 5432 para um serviço PostgreSQL do catálogo
guara proxy --project meu-projeto --service meu-db --local-port 5432

# Depois conecte com seu cliente local
psql -h localhost -p 5432 -U dbuser -d app

O proxy permanece ativo até você pressionar Ctrl+C. A porta remota é derivada automaticamente da configuração do serviço.

Configuração

Alguns serviços do catálogo suportam configuração personalizada pela aba Configurações. As opções disponíveis dependem do tipo de serviço:

• PostgreSQL — nome do banco de dados
• MySQL — nome do banco de dados
• MongoDB — nome do banco de dados

Alterações de configuração disparam uma reinicialização do serviço para aplicar as novas definições.

Disponibilidade por plano

O Catálogo de Serviços é controlado pelo plano contratado:

Plano	Acesso ao Catálogo
Hobby	Não disponível
Pro	Disponível
Business	Disponível
Enterprise	Disponível

As alocações de recursos (CPU e memória) para serviços do catálogo escalam com o seu plano. Planos superiores recebem perfis de recursos mais generosos, garantindo melhor performance para cargas de trabalho em produção.

Próximos passos