Opciones / Configuración
Esta sección aborda todas las opciones configurables por el usuario para faucet.
Opciones Globales
Estas opciones se pueden usar con los subcomandos start
y router
.
Host
- CLI:
--host
- Entorno:
FAUCET_HOST
- Por defecto:
127.0.0.1:3838
La dirección y puerto para vincular el servidor faucet. Si se ejecuta en un
contenedor, esto debería configurarse como 0.0.0.0:3838
para permitir el
acceso externo.
IP From (Cómo determinar la IP del cliente)
- CLI:
--ip-from
o-i
- Entorno:
FAUCET_IP_FROM
- Por defecto:
client
- Valores posibles:
client
x-forwarded-for
x-real-ip
Cómo determinar la IP del cliente. Se utiliza para determinar la IP para la
estrategia IP Hash y para el logging de solicitudes HTTP. Si está ejecutando
faucet directamente para usuarios finales, debe utilizar client
. Si está
ejecutando faucet detrás de un proxy inverso como nginx, debe utilizar
x-forwarded-for
o x-real-ip
.
Nota: Si está ejecutando faucet detrás de un proxy inverso, asegúrese de configurar correctamente el encabezado
X-Forwarded-For
oX-Real-IP
en la configuración de su proxy inverso.
Rscript (Definir el binario/ejecutable de Rscript
)
- CLI:
--rscript
o-r
- Entorno:
FAUCET_RSCRIPT
- Por defecto:
Rscript
Esta opción es útil si tiene varias versiones de R instaladas en su sistema y
necesita especificar una versión específica de Rscript
para ejecutar su
aplicación. También puede ser útil en plataformas como Windows donde el
ejecutable de Rscript
no está en el PATH
.
Quarto (Definir el binario/ejecutable de quarto
)
- CLI:
--quarto
o-q
- Entorno:
FAUCET_QUARTO
- Por defecto:
quarto
El binario/ejecutable de quarto
a utilizar. Esto es útil si tiene
varias versiones de Quarto instaladas o si no está en su $PATH
.
Nivel de Logging (FAUCET_LOG)
- Entorno:
FAUCET_LOG
- Por defecto:
INFO
- Valores posibles:
ERROR
WARN
INFO
DEBUG
TRACE
El nivel de logging a utilizar. Consulte la sección logging
para obtener más información. Nota: Esta variable de entorno sigue funcionando, pero
para nuevas aplicaciones generalmente se prefiere configurar el logging mediante un
archivo de configuración del logger o configuraciones específicas de la biblioteca.
Las opciones de CLI --log-file
y --max-log-file-size
proporcionan un control más
directo sobre el logging a archivos.
Log File (Redirigir logging a un archivo)
- CLI:
--log-file
o-l
- Entorno:
FAUCET_LOG_FILE
- Por defecto:
None
Si utilizas esta varible se deshabilitará el color en la consola y todo el output será redirigido al archivo especificado. Se añadirá al final del archivo si ya existe.
Max Log File Size (Tamaño máximo del archivo de log)
- CLI:
--max-log-file-size
o-m
- Entorno:
FAUCET_MAX_LOG_FILE_SIZE
- Por defecto:
None
El tamaño máximo del archivo de log antes de su rotación (ej. 10M, 1GB).
Requiere que log-file
esté configurado.
Shutdown (Apagado)
- CLI:
--shutdown
- Entorno:
FAUCET_SHUTDOWN
- Por defecto:
immediate
- Valores posibles:
immediate
graceful
La estrategia que debería utilizar faucet para apagarse. immediate
apaga el servidor interrumpiendo cualquier conexión active. graceful
espera a que no existan conexiones activas para apagarse.
Telemetría: Cadena de Conexión PostgreSQL
- CLI:
--pg-con-string
- Entorno:
FAUCET_TELEMETRY_POSTGRES_STRING
- Por defecto:
None
Cadena de conexión a una base de datos PostgreSQL para guardar eventos HTTP. Si se proporciona, faucet intentará registrar eventos HTTP en esta base de datos.
Telemetría: Namespace
- CLI:
--telemetry-namespace
- Entorno:
FAUCET_TELEMETRY_NAMESPACE
- Por defecto:
faucet
Namespace bajo el cual se guardan los eventos HTTP en PostgreSQL.
Telemetría: Versión
- CLI:
--telemetry-version
- Entorno:
FAUCET_TELEMETRY_VERSION
- Por defecto:
None
Representa la versión del código fuente del servicio en ejecución. Esto es útil para filtrar datos de telemetría.
Opciones del Subcomando start
Estas opciones son específicas del subcomando start
, utilizado para ejecutar un servidor faucet estándar.
Workers
- CLI:
--workers
o-w
- Entorno:
FAUCET_WORKERS
- Por defecto: El número de CPUs disponibles para el proceso
La cantidad de procesos de trabajo a crear. En una carga de trabajo ligada a la CPU, esto debería configurarse al número de CPUs disponibles para el proceso. En una carga de trabajo ligada a I/O, podría configurarse a un número mayor.
Strategy (Estrategia)
- CLI:
--strategy
o-s
- Entorno:
FAUCET_STRATEGY
- Por defecto:
round-robin
- Valores posibles:
round-robin
ip-hash
cookie-hash
La estrategia para el equilibrio de carga. La elección de la estrategia depende de su carga de trabajo.
Round Robin
Round Robin es una estrategia de equilibrio de carga muy ligera y simple. Distribuye las solicitudes a los trabajadores de manera circular. Puede ser una buena estrategia para la mayoría de las cargas de trabajo, ya que es muy simple y tiene muy poco sobrecosto.
NO debe usar Round Robin si el servidor es persistente, ya que no garantizará que las solicitudes del mismo cliente se dirijan al mismo trabajador. Si necesita un estado persistente, utilice IP Hash o Cookie Hash.
Si un trabajador muere, las solicitudes que se dirigieron a él continuarán al próximo trabajador disponible que esté vivo.
IP Hash
IP Hash es una estrategia más compleja que garantiza que las solicitudes del
mismo cliente se dirijan al mismo trabajador. Esto es útil para servidores
persistentes, como las aplicaciones Shiny. IP Hash se aplica en aplicaciones Shiny
si la estrategia está configurada en auto
.
Si un trabajador muere, las solicitudes se retendrán hasta que el trabajador vuelva a estar en línea. Esto significa que la latencia puede aumentar si un trabajador muere.
Cookie Hash
Cookie Hash utiliza una cookie para identificar al trabajador al que se enviará la solicitud. Esto es útil para sesiones persistentes (sticky sessions) desde la misma red, incluso si los clientes están detrás de un NAT o comparten la misma dirección IP.
Type (Tipo de servidor)
- CLI:
--type
o-t
- Entorno:
FAUCET_TYPE
- Por defecto:
auto
- Valores posibles:
auto
plumber
shiny
quarto-shiny
El tipo de servidor a ejecutar. Se utiliza para determinar la estrategia correcta a utilizar y cómo crear los trabajadores.
Auto
Auto intentará determinar el tipo de servidor según el contenido del
directorio especificado por --dir
.
- Si el directorio contiene un archivo plumber.R
o entrypoint.R
, se asumirá que es un servidor Plumber.
- Si el directorio contiene un archivo app.R
, o ambos server.R
y ui.R
, se asumirá que es una aplicación Shiny.
- Si se proporciona un archivo .qmd
a través del argumento --qmd
, o si FAUCET_QMD
está configurado, se asumirá que es una aplicación Quarto Shiny.
De lo contrario, faucet terminará con un error.
Plumber
Ejecuta el servidor como una API Plumber. La estrategia por defecto es round-robin
.
Shiny
Ejecuta el servidor como una aplicación Shiny. La estrategia por defecto es ip-hash
.
Quarto Shiny
Ejecuta el servidor como una aplicación Quarto Shiny. La estrategia por defecto es ip-hash
.
Requiere la opción --qmd
para especificar el documento Quarto.
Directory (Directorio de trabajo)
- CLI:
--dir
o-d
- Entorno:
FAUCET_DIR
- Por defecto:
.
El directorio desde el cual ejecutar el servidor. Debería ser el directorio que
contiene el contenido de plumber.R
o la aplicación Shiny.
App Directory (appDir
de Shiny)
- CLI:
--app-dir
o-a
- Entorno:
FAUCET_APP_DIR
- Por defecto:
None
Argumento pasado como appDir
al ejecutar aplicaciones Shiny. Esto permite
especificar un subdirectorio dentro de la ruta --dir
como la raíz para la aplicación Shiny.
QMD (Documento Quarto)
- CLI:
--qmd
- Entorno:
FAUCET_QMD
- Por defecto:
None
Ruta al archivo .qmd
de Quarto Shiny. Esto es necesario cuando type
está configurado
como quarto-shiny
, o cuando type
es auto
y se pretende ejecutar una aplicación Quarto Shiny.
Opciones del Subcomando router
Estas opciones son específicas del subcomando router
, utilizado para ejecutar faucet en modo router (experimental).
Config File (Archivo de configuración)
- CLI:
--conf
o-c
- Entorno:
FAUCET_ROUTER_CONF
- Por defecto:
./frouter.toml
Ruta al archivo de configuración TOML del router.