The Ops Community ⚙️: jose luis pujol

🔍📚 ¿Qué es eso de "Full Text Search" en PostgreSQL? ¡Te lo explicamos con flow!

jose luis pujol — Fri, 14 Mar 2025 20:17:09 +0000

¿Cansado de hacer búsquedas con LIKE y que no encuentres ni el nombre de tu gato? 😿 Pues prepárate, porque llega la joya de la corona en el mundo de las búsquedas: ¡Full Text Search (FTS)! 🎯✨

Full Text Search es ese superpoder que permite encontrar documentos o registros que contienen ciertas palabras o frases, aunque no coincidan exactamente con lo que escribiste 🙃. Es como decirle a PostgreSQL: “🧠 piensa un poco y búscame esto bien, no seas literal…”

A diferencia de las búsquedas básicas (LIKE '%algo%'), FTS tiene en cuenta:

🧬 La morfología del lenguaje (sí, PostgreSQL no solo sabe SQL, también sabe idiomas 🤓).
🕳️ Las palabras vacías (esas como “el”, “de”, “y”, que no aportan mucho pero siempre están) (stop words).
🏆 La relevancia: ordena los resultados según qué tan bien encajan con lo que pediste, como un buen DJ ordenando temazos en una playlist 🎶.

Y lo mejor de todo… ¡esto ya viene incorporado en PostgreSQL! 🐘✨

Incluye:

Tipos de datos especiales (tsvector y tsquery) 🔠
Funciones mágicas como to_tsvector, to_tsquery, plainto_tsquery 🪄
Y hasta índices GIN/GiST para que todo vaya como un cohete 🚀💨

Perfecto para:

📝 Blogs
🛍️ Tiendas online
📂 Documentos
Y cualquier proyecto donde buscar texto no sea un drama sino una experiencia ✨

🏆 Componentes principales:

📌 tsvector: es una estructura que almacena el texto en forma de léxemas (tokens), teniendo en cuenta sus posiciones. Por ejemplo, el texto "PostgreSQL es la mejor base de datos" se transforma en: 'bas':5 'dat':7 'mejor':4 'postgresql':1. Es básicamente un diccionario indexado que contiene todas las palabras en su forma normalizada, excluyendo las llamadas palabras vacías (preposiciones, conjunciones, etc., según el idioma elegido).
📌 tsquery: representa la consulta de búsqueda que se comparan contra tsvector.
📌 Operador @@: compara un tsvector con un tsquery para ver si hay coincidencia.
📌 ts_rank: calcula la relevancia de la coincidencia. Se puede usar para ordenar los resultados (ORDER BY rank DESC).
📌 ts_rank_cd: similar a ts_rank, pero también tiene en cuenta la densidad, es decir, cuán cerca están las palabras del término buscado dentro del texto. Es útil cuando importa que las palabras estén próximas entre sí.

Para acelerar FTS(Full Text Search), se pueden usar los índices GIN o GiST.

1️⃣ Configurar Full Text Search:

Creamos una tabla con datos de texto:

CREATE TABLE articles (
    article_id SERIAL PRIMARY KEY,
    title TEXT,
    content TEXT,
    content_tsvector TSVECTOR
    publication_date DATE
);

content_tsvector almacenará la versión procesada del contenido para búsquedas rápidas

Datos de ejemplo:

INSERT INTO articles (title, content, publication_date) VALUES
('Introducción a PostgreSQL', 'PostgreSQL es una base de datos relacional de código abierto, ideal para proyectos pequeños y grandes.', '2024-12-15'),
('Guía avanzada de búsqueda de texto completo', 'La búsqueda de texto completo permite encontrar información relevante en grandes volúmenes de texto.', '2025-01-10'),
('PostgreSQL y su integración con otras herramientas', 'Descubre cómo PostgreSQL se integra con herramientas modernas de análisis y visualización.', '2024-11-05'),
('Optimización de consultas SQL', 'Aprende a optimizar tus consultas SQL para mejorar el rendimiento en bases de datos grandes.', '2023-09-01'),
('Toguapo y el mundo del desarrollo backend', 'Toguapo comparte su experiencia con PostgreSQL y cómo mejorar el backend de tus aplicaciones.', '2025-02-18'),
('Tutorial: Full Text Search con PostgreSQL', 'Este tutorial muestra paso a paso cómo implementar búsquedas rápidas y precisas usando FTS.', '2025-01-20'),
('Comparativa entre Elasticsearch y PostgreSQL FTS', 'Aunque PostgreSQL tiene FTS integrado, Elasticsearch ofrece más flexibilidad en algunos escenarios.', '2023-12-01'),
('Cómo hacer búsquedas más precisas en contenido textual', 'Usar ts_rank y ts_headline mejora la experiencia de búsqueda y permite ordenar por relevancia.', '2024-06-11'),
('Gestión documental con PostgreSQL', 'Una solución práctica para gestionar documentos, aplicar búsquedas por texto y clasificar resultados.', '2025-02-01'),
('Novedades en PostgreSQL 16', 'La versión 16 de PostgreSQL incluye mejoras en rendimiento, FTS y más funciones analíticas.', '2024-10-10'),
('Viaje gastronómico por España', 'Exploramos los sabores auténticos del norte de España, desde pintxos hasta mariscos.', '2025-01-22'),
('Cómo cuidar tus plantas en casa', 'Consejos prácticos para mantener tus plantas saludables todo el año.', '2023-08-15'),
('Tendencias de moda 2025', 'Descubre los colores, estilos y tejidos que marcarán tendencia este año.', '2025-01-05'),
('Guía básica de fotografía para principiantes', 'Aprende sobre composición, luz y enfoque en tus primeras fotos.', '2024-05-30');

Rellenamos el tsvector usando la función to_tsvector que convierte texto a tsvector, haciéndolo buscable.

Ejemplo:

UPDATE articles
SET content_tsvector = to_tsvector('spanish', content);

Aquí, 'spanish' indica que se usa la morfología del idioma eh!pañol, procesa el contenido y lo convierte en un tsvector buscable.

Para mejorar el rendimiento de búsqueda, creamos un índice GIN sobre la columna tsvector.

Ejemplo:

CREATE INDEX idx_content_tsvector ON articles USING gin(content_tsvector);

Este índice mejora el rendimiento de las búsquedas, especialmente con grandes volúmenes de datos.

¡Y listo! Ya podemos usar FTS en nuestra tabla 😁

Ejemplos de consultas

✅ Buscar una palabra:

SELECT title
FROM articles
WHERE content_tsvector @@ to_tsquery('spanish', 'postgresql');

Esta consulta busca el término "postgresql" en el campo content_tsvector.

✅ Buscar una frase

SELECT title, content 
FROM articles 
WHERE content_tsvector @@ to_tsquery('spanish', 'postgresql & toguapo');

Este ejemplo busca artículos que contengan tanto "postgresql" como "toguapo".

✅ Resaltar Resultados de Búsqueda:

La función ts_headline resalta los términos buscados en los resultados.

Ejemplo:

SELECT title, ts_headline('spanish', content, to_tsquery('full & text & search')) AS preview
FROM articles
WHERE content_tsvector @@ to_tsquery('spanish', 'full & text & search');

Esto resalta las ocurrencias de "full text search" en una vista previa del contenido.

✅ Clasificar Resultados por Relevancia:

Usa ts_rank o ts_rank_cd para clasificar los resultados según su relevancia con respecto a la consulta.

Ejemplo:

SELECT title, ts_rank(content_tsvector, to_tsquery('postgresql')) AS rank
FROM articles
WHERE content_tsvector @@ to_tsquery('postgresql')
ORDER BY rank DESC;

Esto ordena los artículos según su relevancia con el término "postgresql".

✅ Combinar Full Text Search con Filtros SQL:
Puedes combinar búsqueda de texto completo con otras condiciones SQL.

Ejemplo:

SELECT title
FROM articles
WHERE content_tsvector @@ to_tsquery('postgresql')
AND publication_date > '2025-01-01';

Esto busca artículos que contengan "database" y que hayan sido publicados después del 1 de enero de 2025.

✅ Búsqueda de Frases con plainto_tsquery:
Si deseas que un término de búsqueda sea tratado como una frase completa, plainto_tsquery lo convierte en un tsquery.

Ejemplo:

SELECT title
FROM articles
WHERE content_tsvector @@ plainto_tsquery('spanish', 'full text search');

Esta consulta busca la frase exacta "full text search".

✅ Agregar Triggers para Actualización Automática:

Para mantener content_tsvector actualizado al cambiar el contenido, se puede usar un trigger.

CREATE FUNCTION update_tsvector() RETURNS TRIGGER AS $$
BEGIN
    NEW.content_tsvector := to_tsvector('spanish', NEW.content);
    RETURN NEW;
END;
$$ LANGUAGE plpgsql;

CREATE TRIGGER tsvectorupdate 
BEFORE INSERT OR UPDATE ON articles 
FOR EACH ROW EXECUTE FUNCTION update_tsvector();

Este trigger actualiza automáticamente content_tsvector cuando el contenido cambia.

Debug nodos kubernetes

jose luis pujol — Mon, 01 Jan 2024 00:19:21 +0000

Los nodos son un componente vital de un clúster de Kubernetes y son responsables de ejecutar las pods. Dependiendo de la configuración de tu clúster, un nodo puede ser una máquina física o virtual.
Un clúster típicamente tiene uno o varios nodos, los cuales son gestionados por el control plane.
Debido a que los nodos realizan la mayor parte del trabajo de la gestión de carga, es importante asegurarse de que todos tus nodos estén funcionando correctamente. El comando kubectl get nodes se utiliza para verificar el estado de tus nodos.

NAME           STATUS   ROLES           AGE     VERSION
controlplane   Ready    control-plane   2d11h   v1.29.0
node01         Ready    <none>          2d10h   v1.29.0

Un nodo con un estado NotReady significa que no se puede utilizar para ejecutar una pod debido a un problema interno.
Posibles razones por las cuales un nodo puede entrar en el estado NotReady y cómo depurarlo.

Estados

Antes de programar un pod en un nodo, Kubernetes verifica si el nodo es capaz de ejecutar la pod o no. La columna STATUS en la salida de kubectl get nodes representa el estado.

NAME           STATUS   ROLES           AGE     VERSION
controlplane   Ready    control-plane   2d10h   v1.29.0
node01         Ready    <none>          2d10h   v1.29.0

Los posibles valores en STATUS son:

Ready: El nodo está listo para aceptar pods.
NotReady: El nodo ha encontrado algún problema y no se puede programar un pod en él.
SchedulingDisabled: El nodo está marcado como no programable. Esta marca se puede realizar mediante el comando kubectl cordon.
Unknown: El nodo no es alcanzable por el control plane.

Tener un nodo en estado NotReady significa que el nodo está sin usar y sin participar en la ejecución de pods.

Posibles causas del estado NotReady:

Escasez de recursos. Para operar normalmente, un nodo debe tener suficiente espacio en disco, memoria y capacidad de procesamiento. Si un nodo tiene poco espacio en disco o la memoria disponible es baja, entrará en el estado NotReady. Si hay demasiados procesos ejecutándose en el nodo, también cambiará al estado "NotReady".
Configuración de red incorrecta. Si la red no se ha configurado correctamente en el nodo, el nodo no podrá comunicarse con el nodo maestro y se mostrará como NotReady.
Problemas con el proceso kubelet. Kubelet es un componente esencial de Kubernetes y opera en cada nodo del clúster como un agente. Su papel principal es servir de enlace entre el nodo y la API de Kubernetes. Kubelet informa a la API de Kubernetes sobre el estado del nodo, incluyendo detalles como los recursos disponibles y la salud general del nodo. Además, Kubelet registra el nodo en el clúster de Kubernetes, permitiendo que el nodo sea reconocido y utilizado para desplegar aplicaciones. Si Kubelet se bloquea o se detiene por alguna razón, su comunicación con la API de Kubernetes se interrumpe. Esto impide que el nodo informe de su estado y reciba instrucciones de la API. Como resultado, el nodo se marca con el estado NotReady, lo que indica que NO está preparado para recibir nuevas cargas de trabajo hasta que se resuelva el problema de Kubelet.
Problemas con Kube-proxy. Kube-proxy es un componente de Kubernetes y opera en cada nodo como un proxy. Mantiene las reglas de red que facilitan la comunicación con los pods, tanto interna como externamente. Si kube-proxy se bloquea o se detiene, el nodo se marca como NotReady.
Problemas específicos del proveedor cloud. Supongamos que estás utilizando una solución alojada en la nube como GKE, EKS, AKS, .... En ese caso, algunos problemas específicos del proveedor pueden estar impidiendo que tus nodos funcionen normalmente y se comuniquen con el control plane. Estos problemas podrían ser por una configuración incorrecta de IAM, por reglas de red mal configuradas, etc.

Debug del estado `NotReady` mas detallado

El estado NotReady puede ser causado por una multitud de problemas. Es esencial entender que la forma de solucionar estos problemas depende de la causa exacta y de la configuración del clúster.
No hay soluciones universales. Pero, una vez que identifiques la causa raíz, debería ser más fácil resolverla.

Problemas Kube-Proxy

Asegúrate que cada nodo tenga un pod kube-proxy y esté en el estado "Running".

kubectl get pods -n kube-system -o wide

resultado:

NAME                                      READY   STATUS    RESTARTS        AGE     IP            NODE           NOMINATED NODE   READINESS GATES
calico-kube-controllers-9d57d8f49-8smt7   1/1     Running   3 (4h30m ago)   2d10h   192.168.0.2   controlplane   <none>           <none>
canal-mpvd7                               2/2     Running   2 (4h30m ago)   2d10h   172.30.2.2    node01         <none>           <none>
canal-t59ms                               2/2     Running   2 (4h30m ago)   2d10h   172.30.1.2    controlplane   <none>           <none>
coredns-86b698fbb6-7dhfx                  1/1     Running   1 (4h30m ago)   2d10h   192.168.1.2   node01         <none>           <none>
coredns-86b698fbb6-c7h4v                  1/1     Running   1 (4h30m ago)   2d10h   192.168.1.3   node01         <none>           <none>
etcd-controlplane                         1/1     Running   2 (4h30m ago)   2d10h   172.30.1.2    controlplane   <none>           <none>
kube-apiserver-controlplane               1/1     Running   2 (4h30m ago)   2d10h   172.30.1.2    controlplane   <none>           <none>
kube-controller-manager-controlplane      1/1     Running   2 (4h30m ago)   2d10h   172.30.1.2    controlplane   <none>           <none>
kube-proxy-4rlmh                          1/1     Running   2 (4h30m ago)   2d10h   172.30.1.2    controlplane   <none>           <none>
kube-proxy-8whxf                          1/1     Running   1 (4h30m ago)   2d10h   172.30.2.2    node01         <none>           <none>
kube-scheduler-controlplane               1/1     Running   2 (4h30m ago)   2d10h   172.30.1.2    controlplane   <none>           <none>

o más especifico para todos los kubeproxy:

kubectl get pods -n kube-system -o wide | grep kube-proxy

NAME                                      READY   STATUS    RESTARTS        AGE     IP            NODE           NOMINATED NODE   READINESS GATES
kube-proxy-4rlmh                          1/1     Running   2 (4h31m ago)   2d10h   172.30.1.2    controlplane   <none>           <none>
kube-proxy-8whxf                          1/1     Running   1 (4h31m ago)   2d10h   172.30.2.2    node01         <none>           <none>

Si alguno de los pods kube-proxy se encuentra en un estado diferente a Running, utiliza el siguiente comando para obtener más información:

kubectl describe pod POD_KUBEPROXY_EN_ESTADO_NO_RUNNING -n kube-system

La sección de "Events" registra diversos eventos en el pod, y podría ser un excelente lugar para comenzar a buscar cualquier inconveniente.

Puedes acceder a los logs del pod ejecutando el siguiente comando:

kubectl logs POD_KUBEPROXY_EN_ESTADO_NO_RUNNING -n kube-system

Si el nodo que no esta Ready NO tiene pod kube-proxy, entonces debes inspeccionar el daemonset kube-proxy.
Un daemonset es una forma de asegurar que todos los nodos en un clúster tengan una copia de un pod corriendo, el daemonset se encarga automáticamente de asegurar que haya una copia de ese pod en cada nodo del clúster.

kubectl describe daemonset kube-proxy -n kube-system

resultado:

Name:           kube-proxy
Selector:       k8s-app=kube-proxy
Node-Selector:  kubernetes.io/os=linux
Labels:         k8s-app=kube-proxy
Annotations:    deprecated.daemonset.template.generation: 1
Desired Number of Nodes Scheduled: 2
Current Number of Nodes Scheduled: 2
Number of Nodes Scheduled with Up-to-date Pods: 2
Number of Nodes Scheduled with Available Pods: 2
Number of Nodes Misscheduled: 0
Pods Status:  2 Running / 0 Waiting / 0 Succeeded / 0 Failed
Pod Template:
  Labels:           k8s-app=kube-proxy
  Service Account:  kube-proxy
  Containers:
   kube-proxy:
    Image:      registry.k8s.io/kube-proxy:v1.29.0
    Port:       <none>
    Host Port:  <none>
    Command:
      /usr/local/bin/kube-proxy
      --config=/var/lib/kube-proxy/config.conf
      --hostname-override=$(NODE_NAME)
    Environment:
      NODE_NAME:   (v1:spec.nodeName)
    Mounts:
      /lib/modules from lib-modules (ro)
      /run/xtables.lock from xtables-lock (rw)
      /var/lib/kube-proxy from kube-proxy (rw)
  Volumes:
   kube-proxy:
    Type:      ConfigMap (a volume populated by a ConfigMap)
    Name:      kube-proxy
    Optional:  false
   xtables-lock:
    Type:          HostPath (bare host directory volume)
    Path:          /run/xtables.lock
    HostPathType:  FileOrCreate
   lib-modules:
    Type:               HostPath (bare host directory volume)
    Path:               /lib/modules
    HostPathType:       
  Priority Class Name:  system-node-critical
Events:                 <none>

Problemas Recursos

El siguiente comando sirve para obtener información detallada sobre un nodo:

kubectl describe node NODO_NOT_READY

resultado:

Name:               node01
Roles:              <none>
Labels:             beta.kubernetes.io/arch=amd64
                    beta.kubernetes.io/os=linux
                    kubernetes.io/arch=amd64
                    kubernetes.io/hostname=node01
                    kubernetes.io/os=linux
Annotations:        flannel.alpha.coreos.com/backend-data: {"VNI":1,"VtepMAC":"f6:5a:70:e7:20:39"}
                    flannel.alpha.coreos.com/backend-type: vxlan
                    flannel.alpha.coreos.com/kube-subnet-manager: true
                    flannel.alpha.coreos.com/public-ip: 172.30.2.2
                    kubeadm.alpha.kubernetes.io/cri-socket: unix:///var/run/containerd/containerd.sock
                    node.alpha.kubernetes.io/ttl: 0
                    projectcalico.org/IPv4Address: 172.30.2.2/24
                    projectcalico.org/IPv4IPIPTunnelAddr: 192.168.1.1
                    volumes.kubernetes.io/controller-managed-attach-detach: true
[...]
Conditions:
  Type                 Status  LastHeartbeatTime                 LastTransitionTime                Reason                       Message
  ----                 ------  -----------------                 ------------------                ------                       -------
  NetworkUnavailable   False   Sun, 31 Dec 2023 18:57:52 +0000   Sun, 31 Dec 2023 18:57:52 +0000   FlannelIsUp                  Flannel is running on this node
  MemoryPressure       False   Sun, 31 Dec 2023 23:37:39 +0000   Fri, 29 Dec 2023 13:10:41 +0000   KubeletHasSufficientMemory   kubelet has sufficient memory available
  DiskPressure         False   Sun, 31 Dec 2023 23:37:39 +0000   Fri, 29 Dec 2023 13:10:41 +0000   KubeletHasNoDiskPressure     kubelet has no disk pressure
  PIDPressure          False   Sun, 31 Dec 2023 23:37:39 +0000   Fri, 29 Dec 2023 13:10:41 +0000   KubeletHasSufficientPID      kubelet has sufficient PID available
  Ready                True    Sun, 31 Dec 2023 23:37:39 +0000   Fri, 29 Dec 2023 13:10:50 +0000   KubeletReady                 kubelet is posting ready status. AppArmor enabled
Addresses:
  InternalIP:  172.30.2.2
  Hostname:    node01
Capacity:
  cpu:                1
  ephemeral-storage:  20134592Ki
  hugepages-2Mi:      0
  memory:             2030940Ki
  pods:               110
Allocatable:
  cpu:                1
  ephemeral-storage:  19586931083
  hugepages-2Mi:      0
  memory:             1928540Ki
  pods:               110
System Info:
  Machine ID:                 388a2d0f867a4404bc12a0093bd9ed8d
  System UUID:                1d3e87e7-ec41-400e-9e8a-9fbba2d3adc8
  Boot ID:                    0f813b78-e5d3-4cca-b969-763745e13991
  Kernel Version:             5.4.0-131-generic
  OS Image:                   Ubuntu 20.04.5 LTS
  Operating System:           linux
  Architecture:               amd64
  Container Runtime Version:  containerd://1.6.12
  Kubelet Version:            v1.29.0
  Kube-Proxy Version:         v1.29.0
PodCIDR:                      192.168.1.0/24
PodCIDRs:                     192.168.1.0/24
Non-terminated Pods:          (4 in total)
  Namespace                   Name                        CPU Requests  CPU Limits  Memory Requests  Memory Limits  Age
  ---------                   ----                        ------------  ----------  ---------------  -------------  ---
  kube-system                 canal-mpvd7                 25m (2%)      0 (0%)      0 (0%)           0 (0%)         2d10h
  kube-system                 coredns-86b698fbb6-7dhfx    50m (5%)      0 (0%)      50Mi (2%)        170Mi (9%)     2d10h
  kube-system                 coredns-86b698fbb6-c7h4v    50m (5%)      0 (0%)      50Mi (2%)        170Mi (9%)     2d10h
  kube-system                 kube-proxy-8whxf            0 (0%)        0 (0%)      0 (0%)           0 (0%)         2d10h
Allocated resources:
  (Total limits may be over 100 percent, i.e., overcommitted.)
  Resource           Requests    Limits
  --------           --------    ------
  cpu                125m (12%)  0 (0%)
  memory             100Mi (5%)  340Mi (18%)
  ephemeral-storage  0 (0%)      0 (0%)
  hugepages-2Mi      0 (0%)      0 (0%)
Events:              <none>

En la sección Conditions muestra si el nodo se está quedando sin recursos o no. Posibles estados:

MemoryPressure: Si es Verdadero, indica que el nodo se está quedando sin memoria.
DiskPressure: Si es Verdadero, indica que al nodo le falta espacio.
PIDPressure: Si es Verdadero, indica que hay demasiados procesos en ejecución en el nodo.
NetworkUnavailable: Si es Verdadero, indica que la red del nodo no está configurada correctamente.
Ready: Un valor Falso en este campo es equivalente al estado NotReady. Si el controlador del nodo no ha tenido noticias del node-monitor-grace-period (por defecto, 40 segundos), el valor será Unknown.

Si alguna de las primeras cuatro condiciones es Verdadera, habrás identificado el problema.

Problemas Kubelet

Si todos los campos de Conditions estan en Unknown, podría indicar que kubelet esta caido.

Para realizar debug, primero accede por SSH al nodo y verifica el estado del proceso kubelet.
Si se está ejecutando como un servicio de systemd, utiliza el siguiente comando:

systemctl status kubelet

resultado:

● kubelet.service - kubelet: The Kubernetes Node Agent
     Loaded: loaded (/lib/systemd/system/kubelet.service; enabled; vendor preset: enabled)
    Drop-In: /usr/lib/systemd/system/kubelet.service.d
             └─10-kubeadm.conf
     Active: active (running) since Sun 2023-12-31 18:56:43 UTC; 4h 48min ago
       Docs: https://kubernetes.io/docs/
   Main PID: 1650 (kubelet)
      Tasks: 11 (limit: 2338)
     Memory: 61.6M
     CGroup: /system.slice/kubelet.service
             └─1650 /usr/bin/kubelet --bootstrap-kubeconfig=/etc/kubernetes/bootstrap-kubelet.conf --kubeconfig=/etc/kubernetes/kubelet.conf --config=/var/>

Si el campo Active muestra "inactive (dead)", significa que el proceso kubelet se ha detenido.

Para descubrir la posible razón del fallo, verifica los logs con el siguiente comando:

journalctl -u kubelet

Una vez que has realizado fix, reinicia el kubelet con:

systemctl restart kubelet

Problemas conectividad

Si Conditions muestra NetworkUnavailable, indica un problema en la comunicación de red entre el nodo y la API Kubernetes.

Algunas posibles soluciones:

Si el nodo está configurado para usar un proxy, verifica que el proxy permita el acceso a los endpoints de la API Kubernetes.
Asegúrate de que las tablas de enrutamiento estén configuradas adecuadamente para evitar bloquear la comunicación con la API Kubernetes.

Para obtener la dirección de la API, ejecuta:

kubectl cluster-info

resultado:

Kubernetes control plane is running at https://172.30.1.2:6443
CoreDNS is running at https://172.30.1.2:6443/api/v1/namespaces/kube-system/services/kube-dns:dns/proxy

Puedes ejecutar el siguiente comando desde dentro del nodo para verificar que pueda alcanzar el servidor API:

nc -vz IP_CONTROL_PLANE_O_ENDPOINT PUERTO

resultado:

Connection to 172.30.1.2 6443 port [tcp/*] succeeded!

Si el resultado es succeeded, la comunicacion de red funciona correctamente.

Despliegue Kubernetes cluster y LoadBalancer en DO con terraform desde github self-runner

jose luis pujol — Mon, 27 Jun 2022 09:55:00 +0000

diferentes runners segun el entorno: https://jonico.github.io/awesome-runners/
aspectos de seguridad: https://github.com/dduzgun-security/github-self-hosted-runners

Link directo a los runners:
https://github.com/sosan/TU_REPO/actions/runners

Esta en Settings -> Actions/Runners

click boton New self hosted runner
copiamos el token del self runner AAPYBGPKXXXQ3UMKEO5QECBGxXXXXXXXXC3CXCH4I(ejemplo)

En el vps, tenemos montado un docker sin rootless (TODO: rootless)

NOTA: si seguimos las instrucciones del github, se ejecutara un runner, y cuando queramos borrarlo podemos ir al github y click boton borrar y se borraran los servicios del vps referentes al github runner

usando imagen https://hub.docker.com/r/myoung34/github-runner

Config basica runner:

docker run -d --restart always --name github-runner \
  -e REPO_URL="https://github.com/sosan/github-self-runner-digitalocean" \
  -e RUNNER_NAME="linux-terraform" \
  -e RUNNER_TOKEN="AAPYBGPKQXXXXXXX3UMKEO5QECBGC3CXCH4I" \
  -e RUNNER_WORKDIR="/tmp/github-self-runner-digitalocean" \
  -v /tmp/github-self-runner-digitalocean:/tmp/github-self-runner-digitalocean \
  -v /var/run/docker.sock:/var/run/docker.sock \
  myoung34/github-runner:latest

docker logs github-runner

muestra:

# Authentication
√ Connected to GitHub
# Runner Registration
√ Runner successfully added
√ Runner connection is good
# Runner settings
√ Settings Saved.
√ Connected to GitHub
Current runner version: '2.294.0'
2022-06-26 15:58:21Z: Listening for Jobs

en el github seccion actions/runners tendria que poner idle

mas info:
https://docs.github.com/en/actions/hosting-your-own-runners/adding-self-hosted-runners#adding-a-self-hosted-runner-to-a-repository

Desde github añadimos un token llamado: DIGITALOCEAN_ACCESS_TOKEN con el PAT de digitalocean

DIGITALOCEAN_ACCESS_TOKEN=dop_v1_d8eeed703665XXXXXXXXXXX18d0021319XXXXXXXXX(ejemplo)

Imagen despliegue:

Mejoras TODO:

Despligue desde merge-pull-request
Rootless docker

Codigo fuente:
https://github.com/sosan/github-self-runner-digitalocean

The Ops Community ⚙️: jose luis pujol

🔍📚 ¿Qué es eso de "Full Text Search" en PostgreSQL? ¡Te lo explicamos con flow!

🏆 Componentes principales:

1️⃣ Configurar Full Text Search:

Ejemplos de consultas

Debug nodos kubernetes

Estados

Debug del estado NotReady mas detallado

Problemas Kube-Proxy

Problemas Recursos

Problemas Kubelet

Problemas conectividad

Despliegue Kubernetes cluster y LoadBalancer en DO con terraform desde github self-runner

Debug del estado `NotReady` mas detallado