Tuist

Castellano (Spanish)

English
한국어 (Korean)
日本語 (Japanese)
Русский (Russian)
Português (Portuguese)
العربية (Arabic)
中文 (Chinese)
Polski (Polish)
廣東話 (Cantonese)

Castellano (Spanish)

English
한국어 (Korean)
日本語 (Japanese)
Русский (Russian)
Português (Portuguese)
العربية (Arabic)
中文 (Chinese)
Polski (Polish)
廣東話 (Cantonese)

Appearance

Traducción 🌍

Traduce o mejora la traducción de esta página.

Contribuye

Instalación de autoalojamiento ​

Ofrecemos una versión autoalojada del servidor Tuist para organizaciones que requieren un mayor control sobre su infraestructura. Esta versión te permite alojar Tuist en tu propia infraestructura, garantizando que tus datos permanezcan seguros y privados.

::: aviso SE REQUIERE LICENCIA

El autoalojamiento de Tuist requiere una licencia de pago legalmente válida. La versión local de Tuist sólo está disponible para organizaciones con el plan Enterprise. Si estás interesado en esta versión, ponte en contacto con [email protected].

:::

Liberar cadencia ​

Publicamos nuevas versiones de Tuist continuamente, a medida que nuevos cambios liberables aterrizan en main. Seguimos semantic versioning para asegurar un versionado y compatibilidad predecibles.

El componente principal se utiliza para señalar cambios de última hora en el servidor Tuist que requerirán coordinación con los usuarios locales. No esperes que lo utilicemos, y en caso de que fuera necesario, ten por seguro que trabajaremos contigo para que la transición sea fluida.

Despliegue continuo ​

Te recomendamos encarecidamente que configures un sistema de despliegue continuo que despliegue automáticamente la última versión de Tuist todos los días. De este modo, siempre tendrás acceso a las últimas funciones, mejoras y actualizaciones de seguridad.

Este es un ejemplo de flujo de trabajo de Acciones de GitHub que comprueba y despliega nuevas versiones diariamente:

yaml
name: Update Tuist Server
on:
  schedule:
    - cron: '0 3 * * *' # Run daily at 3 AM UTC
  workflow_dispatch: # Allow manual runs

jobs:
  update:
    runs-on: ubuntu-latest
    steps:
      - name: Check and deploy latest version
        run: |
          # Your deployment commands here
          # Example: docker pull ghcr.io/tuist/tuist:latest
          # Deploy to your infrastructure

Requisitos de tiempo de ejecución ​

Esta sección describe los requisitos para alojar el servidor Tuist en tu infraestructura.

Matriz de compatibilidad ​

El servidor Tuist ha sido probado y es compatible con las siguientes versiones mínimas:

ComponenteVersión mínimaNotas
PostgreSQL15Con la extensión TimescaleDB
TimescaleDB2.16.1Extensión PostgreSQL necesaria (obsoleta)
ClickHouse25Necesario para el análisis

::: advertencia DEPRECACIÓN TIMESCALEDB

TimescaleDB es actualmente una extensión PostgreSQL necesaria para el servidor Tuist, utilizada para el almacenamiento y consulta de datos de series temporales. Sin embargo, TimescaleDB está obsoleto y se eliminará como dependencia necesaria en un futuro próximo a medida que migremos toda la funcionalidad de series temporales a ClickHouse. Por ahora, asegúrese de que su instancia PostgreSQL tiene TimescaleDB instalado y habilitado.

:::

Ejecutar imágenes virtualizadas con Docker ​

Distribuimos el servidor como una imagen Docker a través del Registro de contenedores de GitHub.

Para ejecutarlo, su infraestructura debe soportar la ejecución de imágenes Docker. Tenga en cuenta que la mayoría de los proveedores de infraestructura lo admiten porque se ha convertido en el contenedor estándar para distribuir y ejecutar software en entornos de producción.

Base de datos Postgres ​

Además de ejecutar las imágenes Docker, necesitarás una base de datos Postgres con la extensión TimescaleDB para almacenar datos relacionales y de series temporales. La mayoría de los proveedores de infraestructura incluyen bases de datos Postgres en su oferta (por ejemplo, AWS y Google Cloud).

Se requiere la extensión TimescaleDB: Tuist requiere la extensión TimescaleDB para el almacenamiento y consulta eficiente de datos de series temporales. Esta extensión se utiliza para eventos de comandos, análisis y otras funciones basadas en el tiempo. Asegúrate de que tu instancia PostgreSQL tiene TimescaleDB instalado y habilitado antes de ejecutar Tuist.

MIGRACIONES

El punto de entrada de la imagen Docker ejecuta automáticamente cualquier migración de esquema pendiente antes de iniciar el servicio. Si las migraciones fallan debido a que falta una extensión de TimescaleDB, tendrás que instalarla primero en tu base de datos.

Base de datos ClickHouse ​

Tuist utiliza ClickHouse para almacenar y consultar grandes cantidades de datos analíticos. ClickHouse es necesario para funciones como build insights y será la principal base de datos de series temporales a medida que vayamos eliminando TimescaleDB. Puedes elegir entre alojar ClickHouse tú mismo o utilizar su servicio alojado.

MIGRACIONES

El punto de entrada de la imagen Docker ejecuta automáticamente cualquier migración de esquema ClickHouse pendiente antes de iniciar el servicio.

Almacenamiento ​

También necesitarás una solución para almacenar archivos (p. ej., binarios de frameworks y bibliotecas). Actualmente admitimos cualquier almacenamiento compatible con S3.

Configuración ​

La configuración del servicio se realiza en tiempo de ejecución a través de variables de entorno. Dada la naturaleza sensible de estas variables, aconsejamos encriptarlas y almacenarlas en soluciones seguras de gestión de contraseñas. Ten por seguro que Tuist maneja estas variables con sumo cuidado, asegurándose de que nunca se muestren en los registros.

COMPROBACIONES DE LANZAMIENTO

Las variables necesarias se verifican al inicio. Si falta alguna, el lanzamiento fallará y el mensaje de error detallará las variables ausentes.

Configuración de la licencia ​

Como usuario local, recibirás una clave de licencia que deberás exponer como variable de entorno. Esta clave se utiliza para validar la licencia y garantizar que el servicio se ejecuta dentro de los términos del acuerdo.

Variable de entornoDescripciónRequeridoPor defectoEjemplo
TUIST_LICENSELa licencia proporcionada tras la firma del acuerdo de nivel de servicioSí.******
TUIST_LICENCIA_CERTIFICADO_BASE64Alternativa excepcional a TUIST_LICENSE. Certificado público codificado en base64 para la validación de licencias offline en entornos con cortafuegos donde el servidor no puede contactar con servicios externos. Utilizar únicamente cuando TUIST_LICENSE no pueda utilizarse.Sí.LS0tLS1CRUdJTiBDRVJUSUZJQ0FURS0tLS0t...

* Se debe proporcionar TUIST_LICENSE o TUIST_LICENSE_CERTIFICATE_BASE64, pero no ambos. Utilice TUIST_LICENSE para implementaciones estándar.

::: advertencia FECHA DE CADUCIDAD

Las licencias tienen fecha de caducidad. Los usuarios recibirán un aviso al utilizar los comandos de Tuist que interactúan con el servidor si la licencia caduca en menos de 30 días. Si estás interesado en renovar tu licencia, ponte en contacto con [email protected].

:::

Configuración del entorno base ​

Variable de entornoDescripciónRequeridoPor defectoEjemplo
TUIST_APP_URLLa URL base para acceder a la instancia desde InternetSíhttps://tuist.dev
TUIST_SECRET_KEY_BASELa clave que se utilizará para cifrar la información (por ejemplo, las sesiones en una cookie)Síc5786d9f869239cbddeca645575349a570ffebb332b64400c37256e1c9cb7ec831345d03dc0188edd129d09580d8cbf3ceaf17768e2048c037d9c31da5dcacfa
TUIST_SECRET_KEY_PASSWORDPepper para generar contraseñas con hashNoTUIST_SECRET_KEY_BASE
TUIST_SECRET_KEY_TOKENSClave secreta para generar fichas aleatoriasNoTUIST_SECRET_KEY_BASE
TUIST_SECRET_KEY_ENCRYPTIONClave de 32 bytes para el cifrado AES-GCM de datos confidencialesNoTUIST_SECRET_KEY_BASE
TUIST_USE_IPV6Cuando 1 configura la aplicación para utilizar direcciones IPv6No01
TUIST_LOG_LEVELNivel de registro de la aplicaciónNoinformaciónNiveles de registro
TUIST_GITHUB_APP_NAMELa versión URL del nombre de tu aplicación GitHubNomi-app
TUIST_GITHUB_APP_PRIVATE_KEY_BASE64La clave privada codificada en base64 utilizada para que la aplicación de GitHub desbloquee funciones adicionales como la publicación automática de comentarios de relaciones públicas.NoLS0tLS1CRUdJTiBSU0EgUFJVkFUR...
TUIST_GITHUB_APP_PRIVATE_KEYLa clave privada utilizada por la aplicación de GitHub para desbloquear funciones adicionales como la publicación automática de comentarios PR. Recomendamos utilizar la versión codificada en base64 para evitar problemas con caracteres especiales.No-----BEGIN RSA...
TUIST_OPS_USER_HANDLESUna lista separada por comas de los nombres de usuario que tienen acceso a las URL de las operaciones.Nousuario1,usuario2
TUIST_WEBHabilitar el punto final del servidor webNo11 o 0

Configuración de la base de datos ​

Las siguientes variables de entorno se utilizan para configurar la conexión a la base de datos:

Variable de entornoDescripciónRequeridoPor defectoEjemplo
URL_BASE_DE_DATOSLa URL para acceder a la base de datos Postgres. Tenga en cuenta que la URL debe contener la información de autenticaciónSípostgres://username:[email protected]/production
TUIST_CLICKHOUSE_URLLa URL para acceder a la base de datos de ClickHouse. Tenga en cuenta que la URL debe contener la información de autenticaciónNohttp://username:[email protected]/production
TUIST_UTILIZAR_SSL_PARA_BASE_DE_DATOSCuando es verdadero, utiliza SSL para conectarse a la base de datosNo11
TUIST_DATABASE_POOL_SIZEEl número de conexiones a mantener abiertas en el pool de conexiones.No1010
TUIST_DATABASE_QUEUE_TARGETEl intervalo (en milisegundos) para comprobar si todas las conexiones retiradas del pool tardaron más que el intervalo de cola (Más información)No300300
TUIST_DATABASE_QUEUE_INTERVALEl tiempo umbral (en milisegundos) en la cola que el pool utiliza para determinar si debe empezar a descartar nuevas conexiones (Más información)No10001000
TUIST_CLICKHOUSE_FLUSH_INTERVAL_MSIntervalo de tiempo en milisegundos entre las descargas del búfer ClickHouseNo50005000
TUIST_CLICKHOUSE_MAX_BUFFER_SIZETamaño máximo del búfer ClickHouse en bytes antes de forzar un vaciadoNo10000001000000
TUIST_CLICKHOUSE_BUFFER_POOL_SIZENúmero de procesos de buffer ClickHouse a ejecutarNo55

Configuración del entorno de autenticación ​

Facilitamos la autenticación a través de proveedores de identidad (IdP). Para utilizarlo, asegúrate de que todas las variables de entorno necesarias para el proveedor elegido están presentes en el entorno del servidor. Si faltan variables, hará que Tuist eluda a ese proveedor.

GitHub ​

Recomendamos autenticarse usando una GitHub App pero también puedes usar la OAuth App. Asegúrate de incluir todas las variables de entorno esenciales especificadas por GitHub en el entorno del servidor. La ausencia de variables hará que Tuist pase por alto la autenticación de GitHub. Para configurar correctamente la app de GitHub:

  • En la configuración general de la aplicación de GitHub:
    • Copie el ID de cliente de `` y establézcalo como TUIST_GITHUB_APP_CLIENT_ID
    • Crea y copia un nuevo secreto de cliente `` y establécelo como TUIST_GITHUB_APP_CLIENT_SECRET
    • Establezca la URL de devolución de llamada `` como http://YOUR_APP_URL/users/auth/github/callback. YOUR_APP_URL también puede ser la dirección IP de su servidor.
  • Se requieren los siguientes permisos:
    • Repositorios:
      • Pull requests: Lectura y escritura
    • Cuentas:
      • Direcciones de correo electrónico: Sólo lectura

En la sección Permisos y eventos's Permisos de cuenta, establezca el permiso Direcciones de correo electrónico en Sólo lectura.

A continuación, tendrás que exponer las siguientes variables de entorno en el entorno donde se ejecuta el servidor Tuist:

Variable de entornoDescripciónRequeridoPor defectoEjemplo
TUIST_GITHUB_APP_CLIENT_IDID de cliente de la aplicación GitHubSíIv1.a629723000043722
TUIST_GITHUB_APP_CLIENT_SECRETEl secreto de cliente de la aplicaciónSí232f972951033b89799b0fd24566a04d83f44ccc

Google ​

Puedes configurar la autenticación con Google utilizando OAuth 2. Para ello, necesitarás crear una nueva credencial de tipo OAuth client ID. Cuando crees las credenciales, selecciona "Aplicación Web" como tipo de aplicación, nómbrala Tuist, y establece el URI de redirección en {base_url}/users/auth/google/callback donde base_url es la URL en la que se ejecuta tu servicio alojado. Una vez creada la aplicación, copia el ID y el secreto del cliente y establécelos como variables de entorno GOOGLE_CLIENT_ID y GOOGLE_CLIENT_SECRET respectivamente.

ESCUADRAS DE CONSENTIMIENTO

Puede que necesites crear una pantalla de consentimiento. Cuando lo hagas, asegúrate de añadir los ámbitos userinfo.email y openid y marca la aplicación como interna.

Okta ​

Puedes habilitar la autenticación con Okta a través del protocolo OAuth 2.0. Tendrás que crear una app en Okta siguiendo estas instrucciones.

Deberá configurar las siguientes variables de entorno una vez que obtenga el id de cliente y el secreto durante la configuración de la aplicación Okta:

Variable de entornoDescripciónRequeridoPor defectoEjemplo
TUIST_OKTA_1_CLIENT_IDEl ID de cliente para autenticarse contra Okta. El número debe ser el ID de su organizaciónSí
TUIST_OKTA_1_CLIENT_SECRETEl secreto del cliente para autenticarse contra OktaSí

El número 1 debe sustituirse por el ID de su organización. Normalmente será el 1, pero compruébelo en su base de datos.

Configuración del entorno de almacenamiento ​

Tuist necesita almacenamiento para albergar los artefactos cargados a través de la API.** Para que Tuist funcione con eficacia, es esencial configurar una de las soluciones de almacenamiento compatibles en **.

Almacenes compatibles con S3 ​

Puede utilizar cualquier proveedor de almacenamiento compatible con S3 para almacenar artefactos. Las siguientes variables de entorno son necesarias para autenticar y configurar la integración con el proveedor de almacenamiento:

Variable de entornoDescripciónRequeridoPor defectoEjemplo
TUIST_S3_ACCESS_KEY_ID o AWS_ACCESS_KEY_IDEl ID de la clave de acceso para autenticar contra el proveedor de almacenamientoSíAKIAIOSFOD
TUIST_S3_SECRET_ACCESS_KEY o AWS_SECRET_ACCESS_KEYLa clave de acceso secreta para autenticarse contra el proveedor de almacenamientoSíwJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
TUIST_S3_REGION o AWS_REGIONLa región donde se encuentra el cuboNoautous-oeste-2
TUIST_S3_ENDPOINT o AWS_ENDPOINTEl punto final del proveedor de almacenamientoSíhttps://s3.us-west-2.amazonaws.com
TUIST_S3_BUCKET_NAMEEl nombre del cubo donde se almacenarán los artefactosSítuist-artifacts
TUIST_S3_CA_CERT_PEMCertificado CA codificado PEM para verificar conexiones HTTPS S3. Resulta útil para entornos con air-gap con certificados autofirmados o autoridades de certificación internas.NoPaquete CA del sistema-----BEGIN CERTIFICATE-----\n...\n-----END CERTIFICATE-----
TUIST_S3_CONNECT_TIMEOUTEl tiempo de espera (en milisegundos) para establecer una conexión con el proveedor de almacenamiento.No30003000
TUIST_S3_RECEIVE_TIMEOUTEl tiempo de espera (en milisegundos) para recibir datos del proveedor de almacenamiento.No50005000
TUIST_S3_POOL_TIMEOUTEl tiempo de espera (en milisegundos) para el grupo de conexiones al proveedor de almacenamiento. Utilice infinity para no tener tiempo de espera.No50005000
TUIST_S3_POOL_MAX_IDLE_TIMEEl tiempo máximo de inactividad (en milisegundos) para las conexiones en el pool. Utilice infinity para mantener las conexiones vivas indefinidamente.Noinfinito60000
TUIST_S3_POOL_SIZENúmero máximo de conexiones por poolNo500500
TUIST_S3_POOL_COUNTNúmero de grupos de conexiones que se van a utilizarNoNúmero de programadores del sistema4
TUIST_S3_PROTOCOLOEl protocolo a utilizar cuando se conecta al proveedor de almacenamiento (http1 o http2)Nohttp1http1
TUIST_S3_VIRTUAL_HOSTSi la URL debe construirse con el nombre del cubo como subdominio (host virtual).Nofalso1

autenticación AWS con Web Identity Token desde variables de entorno

Si tu proveedor de almacenamiento es AWS y quieres autenticarte usando un token de identidad web, puedes establecer la variable de entorno TUIST_S3_AUTHENTICATION_METHOD a aws_web_identity_token_from_env_vars, y Tuist usará ese método usando las variables de entorno convencionales de AWS.

Almacenamiento en la nube de Google ​

Para Google Cloud Storage, siga estos documentos para obtener el par AWS_ACCESS_KEY_ID y AWS_SECRET_ACCESS_KEY. El AWS_ENDPOINT debe establecerse en https://storage.googleapis.com. Otras variables de entorno son las mismas que para cualquier otro almacenamiento compatible con S3.

Configuración del correo electrónico ​

Tuist requiere la funcionalidad de correo electrónico para la autenticación de usuarios y las notificaciones de transacciones (por ejemplo, restablecimiento de contraseñas, notificaciones de cuentas). Actualmente, sólo admite Mailgun como proveedor de correo electrónico.

Variable de entornoDescripciónRequeridoPor defectoEjemplo
TUIST_MAILGUN_API_KEYLa clave API para autenticarse con MailgunSí.clave-1234567890abcdef
TUIST_MAILING_DOMAINDominio desde el que se enviarán los correos electrónicosSí.mg.tuist.io
TUIST_MAILING_FROM_ADDRESSLa dirección de correo electrónico que aparecerá en el campo "De".Sí.[email protected]
TUIST_MAILING_REPLY_TO_ADDRESSDirección de respuesta opcional para las respuestas de los usuariosNo[email protected]
TUIST_SKIP_EMAIL_CONFIRMATIONOmitir la confirmación por correo electrónico para el registro de nuevos usuarios. Cuando se activa, los usuarios son confirmados automáticamente y pueden iniciar sesión inmediatamente después del registro.Notrue si el correo electrónico no está configurado, false si el correo electrónico está configuradoverdadero, falso, 1, 0

* Las variables de configuración de correo electrónico sólo son necesarias si desea enviar correos electrónicos. Si no se configuran, la confirmación por correo electrónico se omite automáticamente

SOPORTE SMTP

El soporte SMTP genérico no está disponible actualmente. Si necesita soporte SMTP para su implantación local, póngase en contacto con [email protected] para hablar de sus necesidades.

DESPLAZAMIENTOS AÉREOS

En las instalaciones locales sin acceso a Internet ni configuración del proveedor de correo electrónico, la confirmación por correo electrónico se omite automáticamente por defecto. Los usuarios pueden iniciar sesión inmediatamente después de registrarse. Si tiene configurado el correo electrónico pero desea omitir la confirmación, configure TUIST_SKIP_EMAIL_CONFIRMATION=true. Para requerir confirmación por email cuando el email está configurado, establece TUIST_SKIP_EMAIL_CONFIRMATION=false.

Configuración de la plataforma Git ​

Tuist puede integrarse con plataformas Git para proporcionar funciones extra como la publicación automática de comentarios en tus pull requests.

GitHub ​

Necesitarás crear una app GitHub. Puedes reutilizar la que creaste para la autenticación, a menos que hayas creado una app GitHub OAuth. En la sección Permisos y eventos's Permisos de repositorio, necesitarás establecer adicionalmente el permiso Pull requests a Lectura y escritura.

Además de TUIST_GITHUB_APP_CLIENT_ID y TUIST_GITHUB_APP_CLIENT_SECRET, necesitarás las siguientes variables de entorno:

Variable de entornoDescripciónRequeridoPor defectoEjemplo
TUIST_GITHUB_APP_PRIVATE_KEYLa clave privada de la aplicación GitHubSí-----EMPEZAR CLAVE PRIVADA RSA-----...

Pruebas locales ​

Proporcionamos una configuración completa de Docker Compose que incluye todas las dependencias necesarias para probar el servidor Tuist en su máquina local antes de desplegarlo en su infraestructura:

  • PostgreSQL 15 con extensión TimescaleDB 2.16 (obsoleta)
  • ClickHouse 25 para análisis
  • ClickHouse Keeper para la coordinación
  • MinIO para almacenamiento compatible con S3
  • Redis para el almacenamiento persistente de KV entre despliegues (opcional)
  • pgweb para la administración de bases de datos

::: peligro se requiere licencia

Una variable de entorno TUIST_LICENSE válida es legalmente necesaria para ejecutar el servidor Tuist, incluyendo las instancias de desarrollo local. Si necesitas una licencia, ponte en contacto con [email protected].

:::

Inicio rápido:

  1. Descargue los archivos de configuración:

    bash
    curl -O https://docs.tuist.io/server/self-host/docker-compose.yml
curl -O https://docs.tuist.io/server/self-host/clickhouse-config.xml
curl -O https://docs.tuist.io/server/self-host/clickhouse-keeper-config.xml
curl -O https://docs.tuist.io/server/self-host/.env.example

  2. Configurar variables de entorno:

    bash
    cp .env.example .env
# Edit .env and add your TUIST_LICENSE and authentication credentials

  3. Inicie todos los servicios:

    bash
    docker compose up -d
# or with podman:
podman compose up -d

  4. Acceda al servidor en http://localhost:8080

Puntos finales de servicio:

Comandos comunes:

Compruebe el estado del servicio:

bash
docker compose ps
# or: podman compose ps

Ver registros:

bash
docker compose logs -f tuist

Detener los servicios:

bash
docker compose down

Reinicia todo (borra todos los datos):

bash
docker compose down -v

Archivos de configuración:

Despliegue ​

La imagen Docker oficial de Tuist está disponible en:

ghcr.io/tuist/tuist

Extracción de la imagen Docker ​

Puede recuperar la imagen ejecutando el siguiente comando:

bash
docker pull ghcr.io/tuist/tuist:latest

O sacar una versión específica:

bash
docker pull ghcr.io/tuist/tuist:0.1.0

Despliegue de la imagen Docker ​

El proceso de despliegue de la imagen Docker variará en función del proveedor de nube elegido y del enfoque de despliegue continuo de su organización. Dado que la mayoría de las soluciones y herramientas en la nube, como Kubernetes, utilizan imágenes Docker como unidades fundamentales, los ejemplos de esta sección deberían ajustarse bien a su configuración actual.

::: advertencia

Si su proceso de despliegue necesita validar que el servidor está en funcionamiento, puede enviar una solicitud HTTP GET a /ready y confirmar un código de estado 200 en la respuesta.

:::

Fly ​

Para desplegar la aplicación en Fly, necesitará un archivo de configuración fly.toml. Considere la posibilidad de generarlo dinámicamente dentro de su canal de despliegue continuo (CD). A continuación se muestra un ejemplo de referencia para su uso:

toml
app = "tuist"
primary_region = "fra"
kill_signal = "SIGINT"
kill_timeout = "5s"

[experimental]
  auto_rollback = true

[env]
  # Your environment configuration goes here
  # Or exposed through Fly secrets

[processes]
  app = "/usr/local/bin/hivemind /app/Procfile"

[[services]]
  protocol = "tcp"
  internal_port = 8080
  auto_stop_machines = false
  auto_start_machines = false
  processes = ["app"]
  http_options = { h2_backend = true }

  [[services.ports]]
    port = 80
    handlers = ["http"]
    force_https = true

  [[services.ports]]
    port = 443
    handlers = ["tls", "http"]
  [services.concurrency]
    type = "connections"
    hard_limit = 100
    soft_limit = 80

  [[services.http_checks]]
    interval = 10000
    grace_period = "10s"
    method = "get"
    path = "/ready"
    protocol = "http"
    timeout = 2000
    tls_skip_verify = false
    [services.http_checks.headers]

[[statics]]
  guest_path = "/app/public"
  url_prefix = "/"

A continuación, puede ejecutar fly launch --local-only --no-deploy para lanzar la aplicación. En despliegues posteriores, en lugar de ejecutar fly launch --local-only, tendrás que ejecutar fly deploy --local-only. Fly.io no permite extraer imágenes Docker privadas, por lo que necesitamos usar la bandera --local-only.

Métricas de Prometheus ​

Tuist expone las métricas de Prometheus en /metrics para ayudarte a monitorizar tu instancia autoalojada. Estas métricas incluyen:

Métricas del cliente HTTP de Finch ​

Tuist utiliza Finch como cliente HTTP y expone métricas detalladas sobre las peticiones HTTP:

Solicitar métricas ​

  • tuist_prom_ex_finch_request_count_total - Número total de solicitudes de Finch (contador)
    • Etiquetas: finch_name, método, esquema, host, puerto, estado
  • tuist_prom_ex_finch_request_duration_milliseconds - Duración de las solicitudes HTTP (histograma)
    • Etiquetas: finch_name, método, esquema, host, puerto, estado
    • Cubos: 10ms, 50ms, 100ms, 250ms, 500ms, 1s, 2.5s, 5s, 10s
  • tuist_prom_ex_finch_request_exception_count_total - Número total de excepciones de solicitud de Finch (contador)
    • Etiquetas: finch_name, method, scheme, host, port, kind, reason

Métricas de cola de la agrupación de conexiones ​

  • tuist_prom_ex_finch_queue_duration_milliseconds - Tiempo de espera en la cola del pool de conexiones (histograma)
    • Etiquetas: finch_name, scheme, host, port, pool
    • Cubos: 1ms, 5ms, 10ms, 25ms, 50ms, 100ms, 250ms, 500ms, 1s
  • tuist_prom_ex_finch_queue_idle_time_milliseconds - Tiempo que la conexión pasó inactiva antes de ser utilizada (histograma)
    • Etiquetas: finch_name, scheme, host, port, pool
    • Cubos: 10ms, 50ms, 100ms, 250ms, 500ms, 1s, 5s, 10s
  • tuist_prom_ex_finch_queue_exception_count_total - Número total de excepciones en la cola de Finch (contador)
    • Etiquetas: finch_name, scheme, host, port, kind, reason

Métricas de conexión ​

  • tuist_prom_ex_finch_connect_duration_milliseconds - Tiempo empleado en establecer una conexión (histograma)
    • Etiquetas: finch_name, scheme, host, port, error
    • Cubos: 10ms, 50ms, 100ms, 250ms, 500ms, 1s, 2.5s, 5s
  • tuist_prom_ex_finch_connect_count_total - Número total de intentos de conexión (contador)
    • Etiquetas: finch_name, scheme, host, port

Enviar métricas ​

  • tuist_prom_ex_finch_send_duration_milliseconds - Tiempo empleado en enviar la solicitud (histograma)
    • Etiquetas: finch_name, método, esquema, host, puerto, error
    • Cubos: 1ms, 5ms, 10ms, 25ms, 50ms, 100ms, 250ms, 500ms, 1s
  • tuist_prom_ex_finch_send_idle_time_milliseconds - Tiempo de inactividad de la conexión antes del envío (histograma)
    • Etiquetas: finch_name, método, esquema, host, puerto, error
    • Cubos: 1ms, 5ms, 10ms, 25ms, 50ms, 100ms, 250ms, 500ms

Todas las métricas de histograma ofrecen las variantes _bucket, _sum, y _count para un análisis detallado.

Otras métricas ​

Además de las métricas de Finch, Tuist expone métricas para:

  • Rendimiento de la máquina virtual BEAM
  • Métricas de lógica empresarial personalizadas (almacenamiento, cuentas, proyectos, etc.)
  • Rendimiento de la base de datos (cuando se utiliza la infraestructura alojada en Tuist)

Operaciones ​

Tuist proporciona un conjunto de utilidades en /ops/ que puedes utilizar para gestionar tu instancia.

::: advertencia Autorización

Sólo las personas cuyos handles aparecen en la lista de la variable de entorno TUIST_OPS_USER_HANDLES pueden acceder a los endpoints /ops/.

:::

  • Errores (/ops/errors): Puedes ver errores inesperados que ocurrieron en la aplicación. Esto es útil para depurar y entender lo que salió mal y podríamos pedirle que comparta esta información con nosotros si se enfrenta a problemas.
  • Panel de control (/ops/dashboard): Puedes ver un panel de control que proporciona información sobre el rendimiento y la salud de la aplicación (por ejemplo, consumo de memoria, procesos en ejecución, número de peticiones). Este panel puede ser muy útil para saber si el hardware que estás utilizando es suficiente para soportar la carga.

Released under the MIT License.

Copyright © 2024-present Tuist GmbH