NCache para Kubernetes

Cache distribuído, implantação com Helm e YAML

Implantar um NCache aglomerado em AKS, EKS, GKE, OpenShift ou Kubernetes local Com um único comando Helm ou manifestos YAML simples, você pode conectar-se a partir da sua aplicação com algumas linhas de código.

helm install ncache oci://registry-1.docker.io/alachisoft/ncache-helm --version 5.3.8 \
  --namespace ncache --create-namespace \
  --set-string deployment.key="<deployment-key>" \
  --set-string deployment.platform="AKS"

Plataforma

NCache Diagrama da arquitetura do Kubernetes para AKS, EKS, GKE e OpenShift, mostrando microsserviços .NET e Java conectando-se ao NCache Serviço de descoberta e pods de cache distribuídos para escalabilidade linear.
NCache na arquitetura Kubernetes

O gráfico Helm e os manifestos YAML criam os mesmos objetos do Kubernetes:

Componente Objeto Kubernetes Propósito
Servidores de cache StatefulSet (ncache) Servidores em estado sólido com identidades estáveis. Dois por padrão, cada um em seu próprio nó.
Serviço de descoberta Sem cabeça Serviço (ncache-cacheserver) Os clientes dentro do cluster encontram os servidores através do DNS, sem IPs estáticos.
Portal do cliente LoadBalancer (ncache-client-gateway) Conexões de aplicativos externos ativadas 9800 e 9803-9997.
Portal de gerenciamento LoadBalancer (ncache-mgmt-gateway) Centro de Gestão (9801/9802) e Portal na Nuvem (9998/9999), com afinidade de sessão.
Loja estatal ConfigMap (ncache-store) Licenciamento e estado do ciclo de vida compartilhados entre os pods.
Cache do cliente(Opcional) DaemonSet (ncache-cliente) Cache de cliente fora do processo em cada nó, próximo ao seu aplicativo.

NCache Open Source usa um servidor StatefulSet, um serviço de descoberta sem interface gráfica, e um Porta do nó Porta de entrada.

 

Conecte seu aplicativo

Dentro do cluster, os clientes encontram os servidores através do serviço de descoberta:

ICache cache = CacheManager.GetCache("defaultCache");

Fora do clusterConecte-se através do gateway do cliente:

var options = new ConnectionOptions
{
    IsInproc = false,
    Servers = new List<ServerInfo>
    {
        new ServerInfo(isLoadBalancer: true, name: "<client-gateway-endpoint>", port: 9800)
    }
};
ICache cache = CacheManager.GetCache("defaultCache", options);

O servidor envia configurações de ajuste de conexão, balanceamento de carga, registro de logs e cache do cliente para o cliente quando este se conecta.

 

Escolha seu método de implantação

  NCache: Elmo NCache: YAML NCache Código aberto: YAML
Arquivos Gráfico OCI publicado ncache.yaml, client-gatewayservice.yaml, mgmt-gatewayservice.yaml ncache.yaml, discoveryservice.yaml, client-gatewayservice.yaml
Instalar/alterar Instalação/atualização do Helm kubectl aplicar kubectl aplicar
Configuração do cache caches[N] valores Centro de Gerenciamento NCache Ferramentas de código aberto
Atualizações de versão Funcionamento contínuo e offline, integrado. Manual, um pod de cada vez manual
Destaques A maioria das equipes Controle total, GitOps Projetos de código aberto
 

Parte A: Implantação com Helm

Um único gráfico abrange todas as plataformas. Você seleciona a plataforma com `deployment.platform`. Você só precisa dos valores de `helm install`, `helm upgrade` e `helm show`.

Pré-requisitos:

  • Kubernetes 1.25.0 ou superior com dois ou mais nós de trabalho Linux agendáveis.
  • kubectl e Helm com suporte a OCI, além de permissão para criar recursos de namespace e recursos RBAC em todo o cluster.
  • Um balanceador de carga que suporta serviços LoadBalancer (em hardware dedicado, por exemplo, MetalLB).
  • Uma chave de implantação. Para produção, também são necessárias uma chave de licença e o nome do ambiente.

Instale

helm show values oci://registry-1.docker.io/alachisoft/ncache-helm --version 5.3.8

helm install ncache oci://registry-1.docker.io/alachisoft/ncache-helm --version 5.3.8 \
  --namespace ncache --create-namespace \
  --set-string deployment.key="<deployment-key>" \
  --set-string deployment.platform="on-prem"   # on-prem | AKS | EKS | GKE | OpenShift

kubectl get pods,jobs -n ncache
kubectl get svc -n ncache

Uma tarefa de configuração aplica as configurações de cache e licença. Quando terminar, abra o Centro de Gerenciamento em http://<management-gateway-endpoint>:9801.

Defina os caches em values.yaml

Existem quatro entradas predefinidas: cache padrão (o único ativado por padrão), cache de sessão, pubsubCache (Pub/Sub) e cache de dados.

caches:
  - name: defaultCache
    enabled: true
    topology: Partition-Replica
    size: 2048
    eviction: LRU
  - name: sessionCache
    enabled: true
    clientCache:
      enabled: true
      isolationLevel: inproc
      size: 512
Configuração Padrão Opções
tipo de loja Cache Distribuído Cache distribuído, Pub/Sub
topologia Réplica de partição Réplica de partição, Particionado, Replicado
réplica assíncrona verdadeiro Deve permanecer válido para Pub/Sub
tamanho 1024 MB Mínimo 100
compressão/limiar falso / 100 KB O limite se aplica quando a compressão está ativada.
despejo / taxa de despejo LRU / 5% LRU, LFU, Prioridade
provedor de criptografia nenhum AES-128, AES-192, AES-256 (chave de 16, 24 ou 32 caracteres)
nível de isolamento do cache do cliente outproc inproc, outproc

Entradas de caches são nomeados cacheAtive as entradas em ordem e desative-as em ordem inversa.

Observação: Desativar um cache o exclui. Alterar a definição de um cache o recria. sem preservar dados.

Operações do segundo dia com melhoria do leme

helm upgrade ncache oci://registry-1.docker.io/alachisoft/ncache-helm --version 5.3.8 \
  --namespace ncache --reuse-values <flags>
Tarefa Bandeiras
Escala (o recurso de redução de escala remove um pod por vez, após a sincronização dos caches) --set deployment.servers=3
Ativar ou desativar uma licença em todos os pods --set-string license.licenseKey=" "license.envName="Production" license.action="activate" (ou "deactivate")
Adicionar ou redimensionar um cache --set 'caches[1].enabled=true' · --set 'caches[1].size=2048'
Defina o ponto de extremidade de gerenciamento --set-string gateway.mgmtCenterEndpoint=" "

As alterações de configuração podem ser combinadas em uma única atualização. As atualizações de imagem devem ser executadas separadamente. Os parâmetros deployment.name, deployment.platform e deployment.podAntiAffinity só podem ser definidos durante a instalação.

Atualizações de versão

Atualização contínua (Versões secundárias e de correção): os pods são substituídos um de cada vez, começando pelo de número mais alto. Cada pod deve permanecer pronto por um período de `image.delayMinutes` antes que o próximo seja atualizado.

helm upgrade ncache ... --reuse-values \
  --set-string image.tag="<target-tag>" --set image.upgrade=rolling --set image.delayMinutes=2

Se um pod falhar, o gráfico restaura a imagem anterior. Então executar o reversão do leme ncache -n ncacheAssim, a próxima atualização não tentará novamente a imagem com falha.

Atualização offline (Versões principais): o gráfico faz backup da configuração e dos dados, interrompe todos os pods, os atualiza e restaura os caches. Espere períodos de inatividade. Interrompa as gravações do aplicativo e faça seu próprio backup primeiro.

helm upgrade ncache ... --reuse-values \
  --set-string image.tag="<target-tag>" --set image.upgrade=offline

Uma atualização bem-sucedida do Helm significa que a alteração foi aceita. Em seguida, uma tarefa de configuração a aplica. Acompanhe a tarefa com kubectl logs -n ncache -f "job/ncache-lifecycle- "Em seguida, confirme o resultado no Centro de Gerenciamento.

Especificações da plataforma

Plataforma plataforma de implantação Balanceamento de carga Notas
No local no local MetalLB ou similar Ambos os gateways podem compartilhar um endereço.
Azure AKS AKS Balanceador de carga do Azure O ponto de extremidade de gerenciamento pode usar um IPv4 reservado.
Amazon EX EKS NLB interno (cliente), NLB voltado para a internet (gerenciamento) O gateway do cliente usa 196 portas TCP, portanto, verifique a cota do listener ou restrinja o gateway.ports. É necessário um nome de host de gerenciamento. eks.publicSubnetIds="subnet-a\,subnet-b" (duas ou mais Zonas de Disponibilidade).
Google GKE G.K.E. Balanceador de carga padrão Segue a configuração de endereço do cluster.
Red Hat OpenShift OpenShift Balanceador de carga padrão A conta de serviço precisa do qualquer fluido SCC

TLS e TLS mútuo

O TLS está desativado por padrão. Ative-o durante a instalação ou com melhoria do leme. NCache Utiliza o seu próprio certificado, a menos que você forneça um:

helm install ncache ... --set tls.enabled=true \
  --set-file tls.customCertificate=server.pem   # optional

Para TLS mútuoCrie um Segredo e aponte o gráfico para ele:

kubectl create secret generic ncache-tls-secret -n ncache \
  --from-file=server-certificate=server.pem \
  --from-file=client-certificate=client.pem \
  --from-file=issuer=ca.crt

helm install ncache ... --set tls.enabled=true --set tls.mutualEnabled=true \
  --set-string tls.secretName="ncache-tls-secret" \
  --set tls.protocolVersion=tls13   # tls12 (default) | tls13 | auto
options.TLSCertPath = "/certs/client.pem";
options.TLSCertPassword = "<password>";   // only if the key is encrypted

Para alternar entre tls12 e tls13 em um cluster em execução, defina primeiro como automático.

 

Parte B: Implantação com YAML

Para pipelines GitOps ou recursos personalizados, use os manifestos em Alachisoft/NCache-Kubernetes.

Envie o Implanta
ncache.yaml Servidor StatefulSet, RBAC, ConfigMap ncache-store, serviço ncache-cacheserver sem interface gráfica
client-gatewayservice.yaml gateway-cliente-ncache para clientes externos
serviço de gateway de gerenciamento.yaml gateway de gerenciamento de ncache para o Centro de Gerenciamento e Portal da Nuvem

Editar ncache.yaml antes de aplicar:

spec:
  replicas: 2
  template:
    spec:
      containers:
        - name: ncache
          image: alachisoft/ncache:<tag>
          env:
            - name: NC_LICENSE_KEY      # production license key
              value: ""
            - name: NC_LICENSE_ENV      # license environment name
              value: ""
            - name: NC_KEY              # evaluation key
              value: "<deployment-key>"
            - name: NC_START_DEFAULT_CACHE
              value: "true"
            - name: NC_ENABLE_TLS       # also NC_MUTUAL_TLS, NC_TLS_PROTOCOL_VERSION
              value: "false"

A antiafinidade de pods é necessária por padrão. Para clusters de desenvolvimento e teste, altere para o bloco preferencial comentado.

kubectl apply -f ncache.yaml
kubectl apply -f client-gatewayservice.yaml
kubectl apply -f mgmt-gatewayservice.yaml

Para gerenciar uma implantação YAML:

  • Defina updateStrategy.type: OnDelete.
  • Aplique as alterações e, em seguida, substitua os pods um de cada vez, começando pelo de número mais alto (kubectl delete pod ncache-1, Em seguida ncache-0Antes de cada substituição, confirme no Centro de Gerenciamento se o pod anterior foi sincronizado.
  • Configure os caches no Centro de Gerenciamento.
  • Não misture Helm e YAML nos mesmos recursos.

NCache Open Source

Envie o Implanta
ncache.yaml Conjunto de estados do servidor
Discoveryservice.yaml Sem cabeça servidor de cache serviço, para que os clientes encontrem servidores mesmo alterando os IPs dos pods
client-gatewayservice.yaml Porta do nó Portal para acesso e monitoramento externo ao cluster (opcional)

Precisa do Management Center, TLS, operações Helm ou atualizações de versão integradas?

 

Cache de cliente fora do processo

O cache do cliente armazena dados usados ​​com frequência no nó da sua aplicação. Ele funciona com todos os métodos de implantação. Habilite-o para cada cache individualmente (ativado por padrão para [métodos de implantação]). cache padrão), em seguida, implante o cliente DaemonSet:

--set 'caches[1].clientCache.enabled=true' --set 'caches[1].clientCache.isolationLevel=outproc'
			  
kubectl create namespace ncache-client
kubectl apply -n ncache-client -f ncache-client-outproc.yaml

Aponte seu aplicativo para o serviço de cliente local e agende-o em nós que executam um pod de cliente:

env:
  - name: NCACHE_CLIENT_HOST
    value: "ncache-client"
affinity:
  podAffinity:
    requiredDuringSchedulingIgnoredDuringExecution:
      - labelSelector: { matchLabels: { app: ncache-client } }
        topologyKey: kubernetes.io/hostname

O serviço usa Política de tráfego interno: LocalAssim, cada pod do aplicativo acessa apenas o cache do cliente do seu próprio nó. O cache do cliente não está disponível para armazenamentos Pub/Sub. Se os servidores usarem TLS, aplique as mesmas configurações de TLS à implantação do cliente.

 

Gestão e Monitoramento

Todo o gerenciamento e monitoramento de cache passa por NCache Centro de Gerenciamento: http://<management-gateway-endpoint>:9801, ou https://...:9802 Quando o HTTPS estiver configurado, encaminhe as requisições para a porta HTTP 9801 usando um balanceador de carga HTTPS, com sessões persistentes habilitadas.

Portos:

  • 9800: clientes
  • 9801-9802: Centro de Gestão
  • 9981-9989: RESP

O que fazer a seguir?

Perguntas Frequentes (FAQ)

Use o Helm, a menos que precise gerenciar os manifestos brutos manualmente. O Helm cuida de caches, licenciamento, TLS, escalonamento e atualizações de versão. Com YAML, você realiza essas etapas manualmente.

Ambos criam os mesmos objetos, mas não gerenciam os mesmos recursos. Reimplante usando o método desejado.

Sim, para versões secundárias e de correção, utiliza-se uma atualização contínua. As versões principais utilizam uma atualização offline, que implica em períodos de inatividade.

Atualizar implantação.chave Se houver alguma alteração, execute. kubectl rollout restart statefulset/ncache -n ncache.

Sim. Travas deslizantes portáteis NCache O código aberto é implantado com três arquivos YAML do mesmo repositório do GitHub.

© Copyright Alachisoft 2002 - . Todos os direitos reservados. NCache é uma marca registrada da Diyatech Corp.