Configurando o Redis usando um ConfigMap

Esta página fornece um exemplo prático de como configurar o Redis usando um ConfigMap e baseia-se na tarefa Configurar um Pod para usar um ConfigMap.

Objetivos

• Criar um ConfigMap com valores de configuração para o Redis.
• Criar um Pod do Redis que monte e use o ConfigMap criado.
• Verificar se a configuração foi aplicada corretamente.

Antes de você começar

Você precisa ter um cluster do Kubernetes e a ferramenta de linha de comando kubectl deve estar configurada para se comunicar com seu cluster. É recomendado executar esse tutorial em um cluster com pelo menos dois nós que não estejam atuando como hosts de camada de gerenciamento. Se você ainda não possui um cluster, pode criar um usando o minikube ou pode usar um dos seguintes ambientes:

• iximiuz Labs
• Killercoda
• KodeKloud
• Play with Kubernetes

Para verificar a versão, digite kubectl version.

• O exemplo mostrado nesta página funciona com kubectl 1.14 ou superior.
• Entenda Configurar um Pod para usar um ConfigMap.

Exemplo prático: Configurando o Redis usando um ConfigMap

Siga os passos abaixo para configurar um cache Redis usando dados armazenados em um ConfigMap.

Primeiro, crie um ConfigMap com um bloco de configuração vazio:

cat <<EOF >./example-redis-config.yaml apiVersion: v1 kind: ConfigMap metadata:  name: example-redis-config data:  redis-config: "" EOF 

Aplique o ConfigMap criado acima, juntamente com o manifesto de Pod Redis:

kubectl apply -f example-redis-config.yaml kubectl apply -f https://raw.githubusercontent.com/kubernetes/website/main/content/en/examples/pods/config/redis-pod.yaml 

Examine o conteúdo do manifesto do Pod Redis e observe o seguinte:

• Um volume chamado config é criado em spec.volumes[1]
• A key e o path em spec.volumes[1].configMap.items[0] expõem a chave redis-config do ConfigMap example-redis-config como um arquivo chamado redis.conf no volume config.
• O volume config é então montado em /redis-master por spec.containers[0].volumeMounts[1].

O efeito final é expor os dados de data.redis-config do ConfigMap example-redis-config acima como /redis-master/redis.conf dentro do Pod.

pods/config/redis-pod.yaml

apiVersion: v1 kind: Pod metadata:  name: redis spec:  containers:  - name: redis  image: redis:8.0.2  command:  - redis-server  - "/redis-master/redis.conf"  env:  - name: MASTER  value: "true"  ports:  - containerPort: 6379  resources:  limits:  cpu: "0.1"  volumeMounts:  - mountPath: /redis-master-data  name: data  - mountPath: /redis-master  name: config  volumes:  - name: data  emptyDir: {}  - name: config  configMap:  name: example-redis-config  items:  - key: redis-config  path: redis.conf 

Examine os objetos criados:

kubectl get pod/redis configmap/example-redis-config 

Você deverá ver a seguinte saída:

NAME READY STATUS RESTARTS AGE pod/redis 1/1 Running 0 8s NAME DATA AGE configmap/example-redis-config 1 14s 

Lembre-se de que deixamos a chave redis-config no ConfigMap example-redis-config em branco:

kubectl describe configmap/example-redis-config 

Você deverá ver uma chave redis-config vazia:

Name: example-redis-config Namespace: default Labels: <none> Annotations: <none>  Data ==== redis-config: 

Use kubectl exec para entrar no pod e executar a ferramenta redis-cli para verificar a configuração atual:

kubectl exec -it redis -- redis-cli 

Verifique maxmemory:

127.0.0.1:6379> CONFIG GET maxmemory 

Ele deve mostrar o valor padrão 0:

1) "maxmemory" 2) "0" 

Da mesma forma, verifique maxmemory-policy:

127.0.0.1:6379> CONFIG GET maxmemory-policy 

O que também deve retornar seu valor padrão noeviction:

1) "maxmemory-policy" 2) "noeviction" 

Agora, vamos adicionar alguns valores de configuração ao ConfigMap example-redis-config:

pods/config/example-redis-config.yaml

apiVersion: v1 kind: ConfigMap metadata:  name: example-redis-config data:  redis-config: |  maxmemory 2mb  maxmemory-policy allkeys-lru 

Aplique o ConfigMap atualizado:

kubectl apply -f example-redis-config.yaml 

Confirme que o ConfigMap foi atualizado:

kubectl describe configmap/example-redis-config 

Você deverá ver os valores de configuração que acabamos de adicionar:

Name: example-redis-config Namespace: default Labels: <none> Annotations: <none>  Data ==== redis-config: ---- maxmemory 2mb maxmemory-policy allkeys-lru 

Verifique novamente o Pod Redis usando redis-cli via kubectl exec para confirmar se a configuração foi aplicada:

kubectl exec -it redis -- redis-cli 

Verifique maxmemory:

127.0.0.1:6379> CONFIG GET maxmemory 

Ele permanece no valor padrão de 0:

1) "maxmemory" 2) "0" 

Da mesma forma, maxmemory-policy permanece com a configuração padrão noeviction:

127.0.0.1:6379> CONFIG GET maxmemory-policy 

Retorna:

1) "maxmemory-policy" 2) "noeviction" 

Os valores de configuração não mudaram porque o Pod precisa ser reiniciado para carregar os valores atualizados dos ConfigMaps associados. Vamos excluir e recriar o Pod:

kubectl delete pod redis kubectl apply -f https://raw.githubusercontent.com/kubernetes/website/main/content/en/examples/pods/config/redis-pod.yaml 

Agora verifique os valores de configuração mais uma vez:

kubectl exec -it redis -- redis-cli 

Verifique maxmemory:

127.0.0.1:6379> CONFIG GET maxmemory 

Ele agora deve retornar o valor atualizado de 2097152:

1) "maxmemory" 2) "2097152" 

Da mesma forma, maxmemory-policy também foi atualizado:

127.0.0.1:6379> CONFIG GET maxmemory-policy 

Ele agora reflete o valor desejado de allkeys-lru:

1) "maxmemory-policy" 2) "allkeys-lru" 

Limpe o ambiente excluindo os recursos criados:

kubectl delete pod/redis configmap/example-redis-config 

Próximos passos

• Aprenda mais sobre ConfigMaps.
• Veja um exemplo de como atualizar configuração usando ConfigMap.