Saltar al contenido principal

Web Service

Web Services son servicios que se ejecutan de forma continua y se encargan de gestionar interacciones basadas en HTTP, como servir páginas web, procesar solicitudes de API o administrar la autenticación de usuarios. En Kubernetes, cada Web Service se ejecuta en uno o varios pods que permanecen activos para responder a solicitudes externas en todo momento.

Preguntas Frecuentes​

¿Cuál es la diferencia entre los esquemas de servicio Público, Privado e Interno?​

  • Público: Accesible a través de Internet y abierto a cualquier persona.
  • Privado: Acceso restringido, disponible solo cuando se está conectado a la VPN.
  • Interno: Solo accesible dentro del mismo clúster de Kubernetes y se utiliza para la comunicación interna entre servicios.

¿Cómo configuro el auto-escalado para mi Web Service?​

Para habilitar el auto-escalado, puedes activar la opción Autoscaling y definir el Memory Target y el CPU Target. Estos objetivos determinan los umbrales de uso de recursos que desencadenan el auto-escalado. También debes especificar el número mínimo y máximo de réplicas que se deben mantener cuando el auto-escalado está habilitado.

¿Cuáles son los códigos de éxito predeterminados para un Web Service y puedo cambiarlos?​

El código de éxito predeterminado es el 200, que indica que el servicio está sano. Puedes cambiar este código según los requisitos de tu aplicación, ya que algunos servicios pueden devolver diferentes códigos de éxito dependiendo de las acciones específicas.

¿Qué pasa si mi verificación de salud falla repetidamente?​

Si la verificación de salud falla de manera consecutiva y alcanza el umbral de fallos (el valor predeterminado es 60), el servicio se marcará como no saludable, y Kubernetes podría reiniciar o terminar la instancia del servicio para intentar una recuperación.

¿Cómo puedo configurar la memoria y los ajustes de CPU para mi Web Service?​

Puedes configurar los valores CPU Min y CPU Max para establecer los recursos mínimos y máximos de CPU que cada instancia en tu clúster puede usar. De manera similar, puedes establecer Memory Min y Memory Max para la asignación de memoria por instancia.

¿Cuáles son algunas buenas prácticas al configurar un Web Service en SleakOps?​

  • Siempre establece un mínimo de 2 réplicas para evitar el tiempo de inactividad.
  • Asegúrate de que las rutas de verificación de salud y los códigos de éxito estén configurados correctamente para reflejar la verdadera salud de tu servicio.
  • Usa auto-escalado siempre que sea posible para optimizar los recursos dinámicamente según la demanda.
  • Revisa y ajusta adecuadamente los objetivos de memoria y uso de CPU para evitar sobrecargar tu infraestructura.

¿Qué debo hacer si mi servicio muestra tiempos de respuesta superiores a los 10 segundos?​

Los tiempos de respuesta largos pueden indicar problemas como limitaciones de recursos, ineficiencias en la aplicación o problemas de red. Deberías revisar los registros de tu servicio, asegurarte de que los recursos (CPU, memoria) estén asignados adecuadamente y revisar el código de la aplicación para posibles optimizaciones.

Como puedo desplegar mi sitio web estatico?​

Por el momento, Sleakops no ofrece soporte nativo para sitios estáticos. Sin embargo, puedes desplegarlos utilizando el mismo flujo que para otros sitios, contenedorizándolos con un servidor web como Nginx. A continuación, se muestra un ejemplo sencillo de un Dockerfile y su correspondiente nginx.conf para servir tu contenido estático.

FROM node:20.11.0-alpine AS base

WORKDIR /app

FROM base AS build

ARG BACKEND_URL

WORKDIR /app

COPY package.json package-lock.json ./

RUN npm install

COPY . ./

RUN npm run build

FROM nginx:1.25.3-alpine AS production

COPY --from=build /app/config/nginx.conf /etc/nginx/conf.d/default.conf
COPY --from=build /app/dist /usr/share/nginx/html

EXPOSE 80
CMD ["nginx", "-g", "daemon off;"]

Un ejemplo de config/nginx.conf:

server {
    listen 80;

    location = /health {
            access_log off;
            add_header 'Content-Type' 'application/json';
            return 200 '{"status":"OK"}';
    }

    location / {
        root /usr/share/nginx/html;
        index index.html index.htm;
        try_files $uri $uri/ /index.html =404;

        add_header Last-Modified $date_gmt;
        add_header Cache-Control 'no-store, no-cache';
        if_modified_since off;
        expires off;
        etag off;
    }
}

Utilizando este enfoque basado en Docker, puedes servir tu sitio estático con Nginx, todo dentro de un contenedor.

Añadir un Web Service para tu Proyecto​

1. Navegar a la sección de crear un Web Service​

En el Panel izquierdo, accede a Executions. Luego selecciona la pestaña Servicios Web y, en la esquina superior derecha, haz clic en el botón Crear.

executions-list

2. Selecciona un Proyecto y un Nombre para el Web Service​

Comienza con la información básica, completa estos atributos y haz clic en Siguiente para continuar.

AtributoDescripción
NombreIdentifica tu Web Service.
ProyectoSelecciona entre los proyectos existentes.
ComandoEl comando que ejecuta el servicio.
PuertoEl número de puerto donde se ejecuta el servicio. Predeterminado: 8000

Una vez completados estos atributos, haz clic en el botón Siguiente para continuar.

webservice-create-p1

3. Define la conexión​

Selecciona cómo será tu conexión y haz clic en Siguiente.

AtributoDescripción
Esquema de ServicioDefine la accesibilidad del servicio: público, privado o interno.
URLLa URL asignada al servicio según el entorno y la configuración del proyecto. Formato: name.myenv.sleakops.com.
webservice-create-p2

4. Especifica los ajustes de tu servicio​

Verás los siguientes atributos para especificar las condiciones.

webservice-create-p3
AtributoDescripción
RutaLa ruta donde Kubernetes verifica si el Web Service está operativo. Predeterminado: /
Código de ÉxitoEl código HTTP de éxito que indica la salud del servicio. Predeterminado: 200.
Retraso Inicial en SegundosNúmero de segundos después del inicio antes de que comiencen las verificaciones de salud. Predeterminado: 10.
Segundos de Tiempo de EsperaNúmero de segundos después del inicio antes de que comiencen las verificaciones de salud. Predeterminado: 1.
Segundos entre cada VerificaciónIntervalo (en segundos) entre cada prueba de verificación de salud. Predeterminado: 5.
Umbral de ÉxitosNúmero mínimo de éxitos consecutivos requeridos para que la prueba se considere exitosa después de fallar. Predeterminado: 1.
Umbral de FallosNúmero de fallos consecutivos antes de que la prueba se considere fallida. Predeterminado: 60.

Una vez completados estos atributos, haz clic en el botón Siguiente para continuar con el siguiente paso.

5. Finalizar la configuración​

Este paso describe los atributos clave para configurar los recursos de un Servicio Web en SleakOps, permitiendo una gestión flexible de CPU, memoria y comportamientos de escalado.

AtributoDescripción
CPU MinLa cantidad mínima de recursos de CPU asignados para cada instancia en el clúster. Esto garantiza que cada instancia siempre tenga esta cantidad de CPU disponible.
CPU MaxLa cantidad máxima de recursos de CPU que cada instancia en el clúster puede utilizar. Este límite ayuda a prevenir que una instancia consuma demasiada CPU.
Memory MinLa cantidad mínima de memoria asignada para cada instancia en el clúster. Esto garantiza que la instancia tenga suficiente memoria para operar eficientemente.
Memory MaxLa cantidad máxima de memoria que cada instancia en el clúster puede utilizar. Limita el uso de memoria para evitar que una sola instancia consuma recursos en exceso.
AutoscalingActivar o desactivar el auto-escalado. Cuando está habilitado, permite que el servicio ajuste el número de réplicas según la demanda y el uso de recursos.
CPU TargetEl porcentaje de uso de CPU que desencadena el auto-escalado. Si el uso supera este objetivo, se pueden desplegar réplicas adicionales para equilibrar la carga.
Memory TargetEl porcentaje de uso de memoria que activa el ajuste de auto-escalado. Cuando las instancias superan este objetivo, el sistema escala hacia arriba para acomodar la demanda.
Replicas MinEl número mínimo de réplicas que deben mantenerse cuando el auto-escalado está activo. Un mínimo de 2 réplicas garantiza alta disponibilidad y previene tiempos de inactividad.
Replicas MaxEl número máximo de réplicas que se pueden desplegar cuando el auto-escalado está habilitado. Establece un límite superior en el número de instancias para evitar la sobreasignación de recursos.
webservice-create-p4

Envía para crear y desplegar tu web service.