Valkey gerenciado na Zenifra

O Valkey gerenciado oferece uma instância compatível com o protocolo Redis para três necessidades diferentes: dados de chave-valor, cache e filas de trabalho. O card escolhido no Console define o perfil; não existe um seletor de perfil posterior.

Permissões necessárias

Criar qualquer perfil Valkey exige managed_service.create em organization:*. Para consultar status, use managed_service.status.read no ID do projeto; para conexão, managed_service.connection.read; para rotação, managed_service.credentials.rotate. owner tem acesso completo; assistant, member e API Keys precisam dos grants específicos.

Escolha o produto correto

Produto	Use para	Armazenamento persistente	Alta disponibilidade	Plano comercial
Chave‑Valor	sessões, estado compartilhado, contadores e locks	1 GB fixo no `db-free`; nos demais planos, capacidade escolhida na criação e cobrada à parte	Uma primária e duas réplicas em `db-basic`, `db-premium` e `db-enterprise`; instância única em `db-free` e `db-starter`	`db-free`, `db-starter`, `db-basic`, `db-premium`, `db-enterprise`
Cache	respostas calculadas, consultas e dados descartáveis	Nenhum, em todos os planos: os dados ficam apenas em memória	Não; instância única em todos os planos	`cache-free`, `cache-starter`, `cache-basic`, `cache-premium`, `cache-enterprise`
Filas	tarefas assíncronas, workers e eventos persistentes	1 GB fixo no `queue-free`; 5 GB incluídos nos demais planos, expansíveis com cobrança do excedente	Uma primária e duas réplicas em `queue-basic`, `queue-premium` e `queue-enterprise`; instância única em `queue-free` e `queue-starter`	`queue-free`, `queue-starter`, `queue-basic`, `queue-premium`, `queue-enterprise`

Os preços, benefícios, capacidade e modalidade de cobrança devem ser consultados no catálogo público (GET /v1/managed-services/catalog ou zenifra plans --type valkey) ou nos cards do Console. Eles podem mudar sem exigir atualização do código da aplicação. Os planos Premium e Enterprise de cada perfil incluem métricas da instância na página do projeto, com leituras pontuais e sem histórico.

Nos planos gratuitos Chave‑Valor e Filas, o armazenamento é fixo em 1 GB e não pode ser alterado durante a criação. O Cache gratuito não apresenta controle de armazenamento persistente.

Segurança e conexão

O endpoint é público em IPv4, mas exige TLS e autenticação. A conexão inicial retorna uma string valkeys:// com o usuário default; a senha completa é revelada apenas durante a criação ou rotação da credencial.

export VALKEY_URL='valkeys://default:SENHA_RECEBIDA@HOST_DO_PROJETO:PORTA_DO_PROJETO/0'

Guarde VALKEY_URL em um secret manager ou variável protegida. Não coloque a string em código, logs, tickets ou imagens. Alguns clientes não reconhecem o esquema valkeys://; nesse caso, leia host, porta, usuário e senha e configure TLS explicitamente, ou substitua somente o esquema por rediss://. Nunca desative a validação do certificado ou do hostname.

A rotação de credencial é assíncrona: a solicitação é aceita com 202 e devolve uma operação; a nova conexão, com a senha, aparece ao consultar a operação concluída (na CLI, use zenifra valkey credentials rotate --wait). Consulte Conectar ao Valkey para exemplos em oito linguagens e Rotacionar credenciais para a operação pela API.

Como escolher o perfil

Escolha Chave‑Valor quando os dados forem parte do estado da aplicação e precisarem sobreviver a reinícios.
Escolha Cache quando a aplicação conseguir reconstruir o valor original e aceitar expiração ou remoção automática.
Escolha Filas quando tarefas precisarem ser entregues a workers. Para novas integrações, comece por Streams e consumer groups; Pub/Sub é indicado apenas para eventos em tempo real que podem ser perdidos durante uma desconexão.

Criar e operar

Abra Criar projeto no Console.
Escolha o card Valkey correspondente a Chave‑Valor, Cache ou Filas.
Selecione o plano e a modalidade de cobrança. No Free de Chave‑Valor ou Filas, o armazenamento permanece fixo em 1 GB; nos demais planos persistentes, escolha a capacidade quando o Console oferecer essa opção.
Aguarde o estado pronto e copie a conexão exibida uma única vez.
Use a página do projeto, a CLI ou a API para consultar o estado, ler a conexão mascarada e rotacionar a credencial.

Para listar somente um perfil pela API, use GET /v1/project com type=valkey e profile=key_value, profile=cache ou profile=queue. Consulte a referência de projetos para paginação, busca, status e ordenação.

Não informe imagem, runtime, porta, instâncias ou regras de IP: esses campos não fazem parte da configuração pública dos serviços Valkey.

Escolha baseada no ciclo de vida

Antes de criar a instância, identifique se o dado pode ser reconstruído, se precisa sobreviver a reinícios e se há um consumidor responsável por confirmar cada trabalho. Essa decisão evita usar Cache para dados importantes ou transformar uma fila em um canal de notificações sem retenção. O catálogo mostra a capacidade e os benefícios vigentes de cada plano; a página do projeto mostra o estado e a conexão sem revelar a senha antiga.

A conexão deve ser reutilizada por processo e encerrada durante o desligamento da aplicação. Em workers, defina limites de tempo, retries com backoff e uma estratégia para mensagens que permaneçam pendentes. Em Cache, registre hits, misses, latência e taxa de reconstrução. Em Chave‑Valor, monitore o tamanho dos valores e o número de chaves. Essas métricas ajudam a escolher o próximo plano sem atrelar a aplicação a detalhes de infraestrutura.