Referencia de la CLI

El binario cs-routeros-bouncer tiene una superficie de comandos reducida: ejecuta el bouncer, imprime información de versión/ayuda o realiza tareas de instalación/eliminación de systemd.

Ejecutar el bouncer

Ejecútalo con un archivo de configuración:

cs-routeros-bouncer -c /etc/cs-routeros-bouncer/cs-routeros-bouncer.yaml

Flags de ejecución:

Flag	Descripción
`-c`	Ruta al archivo de configuración YAML
`-version`	Imprime la versión, el commit y la fecha de compilación

Cuando se omite -c, el binario comprueba /etc/cs-routeros-bouncer/config.yaml en cada ejecución y lo usa si ese archivo existe. El orden de resolución es: una ruta -c explícita tiene prioridad, después la ruta implícita /etc/cs-routeros-bouncer/config.yaml y, si ese archivo no existe, el bouncer arranca en modo solo entorno (variables de entorno más los valores por defecto integrados). Este comportamiento está integrado en el binario, así que se aplica siempre que arranque sin -c — incluida la imagen Docker, cuyo entrypoint no pasa ninguno. La unidad systemd que escribe setup siempre pasa un -c explícito, así que nunca llega a la ruta implícita.

Ten en cuenta que la ruta implícita es config.yaml, mientras que setup escribe su configuración de ejemplo como cs-routeros-bouncer.yaml y se la pasa al servicio con un -c explícito.

`version`

Imprime la información de compilación:

cs-routeros-bouncer version

La forma con flag también está soportada:

cs-routeros-bouncer -version

`setup`

Instala el binario actual como un servicio de systemd:

sudo ./cs-routeros-bouncer setup

Qué hace:

Copia el binario a la ruta de instalación seleccionada.
Crea el directorio de configuración.
Escribe una configuración de ejemplo si no existe ya una.
Escribe /etc/systemd/system/cs-routeros-bouncer.service.
Ejecuta systemctl daemon-reload, habilita el servicio y lo inicia.

Flags:

Flag	Valor por defecto	Descripción
`-bin`	`/usr/local/bin/cs-routeros-bouncer`	Ruta de instalación del binario
`-config-dir`	`/etc/cs-routeros-bouncer`	Directorio para los archivos de configuración

Ejemplo con rutas personalizadas:

sudo ./cs-routeros-bouncer setup \
  -bin /opt/cs-routeros-bouncer/cs-routeros-bouncer \
  -config-dir /etc/cs-routeros-bouncer

`uninstall`

Detiene y elimina el servicio de systemd y el binario instalado:

sudo cs-routeros-bouncer uninstall

Flags:

Flag	Valor por defecto	Descripción
`-bin`	`/usr/local/bin/cs-routeros-bouncer`	Ruta del binario instalado a eliminar
`-config-dir`	`/etc/cs-routeros-bouncer`	Directorio de configuración a eliminar con `-purge`
`-purge`	`false`	Elimina también el directorio de configuración configurado

Por defecto, uninstall conserva los archivos de configuración. Si la instalación usó un -bin o -config-dir personalizado, pasa los mismos valores a uninstall para que se eliminen el binario y el directorio de configuración correctos.

Elimina también los archivos de configuración:

sudo cs-routeros-bouncer uninstall -purge

Purga una ruta de instalación personalizada:

sudo cs-routeros-bouncer uninstall \
  -bin /opt/cs-routeros-bouncer/cs-routeros-bouncer \
  -config-dir /opt/cs-routeros-bouncer/config \
  -purge

`help`

Imprime la información de uso:

cs-routeros-bouncer help

Los flags de ayuda habituales también están soportados:

cs-routeros-bouncer -h
cs-routeros-bouncer --help