Ajustes

Frost guarda sus ajustes en config.toml, dentro de su carpeta de configuración. Puedes cambiarlos con frost init, frost config set o frost config edit, o en cualquier editor de texto.

#Leer y cambiar ajustes

Comando Qué hace
frost config Muestra todos los ajustes. Las credenciales se ocultan salvo que añadas --show-secrets
frost config get <key> Muestra un ajuste. Las listas muestran un elemento por línea
frost config set <key> <value...> Cambia un ajuste y muestra qué ha cambiado
frost config edit [editor] Abre config.toml en un editor

Por ejemplo:

frost config get schedule.every
frost config set schedule.every 6h
frost config set paths ~/Documents ~/Pictures
  • Una lista recibe un valor por elemento, y set sustituye la lista entera.
  • true y false activan y desactivan ajustes.
  • Cambiar un ajuste de schedule actualiza la tarea programada al momento. En macOS y Windows, un cambio hecho mientras se ejecuta una copia programada se aplica en cuanto esa copia termina, así que no se interrumpe.
  • Si cambias dónde está tu almacenamiento, Frost comprueba la nueva ubicación antes de guardarla. Consulta Mover tus copias de seguridad.

#Editar el archivo

frost config edit

Frost abre una copia de config.toml en el editor que indiques, o en $VISUAL o $EDITOR, o si no en nano, vim o vi. En Windows, la alternativa es el Bloc de notas. Al cerrar el editor, Frost enumera lo que has cambiado y guarda la copia cuando escribes yes.

Si el archivo no se puede interpretar, Frost te señala el problema y te ofrece abrirlo de nuevo, así que una errata no puede estropear tus copias programadas. Los ajustes desconocidos cuentan como errores, así que un nombre mal escrito no pasa desapercibido.

#Editarlo tú mismo

También puedes abrir config.toml en cualquier editor de texto y guardarlo. Frost lo lee cada vez que se ejecuta, así que la mayoría de los cambios se aplican desde la siguiente ejecución. Dos tipos de cambio necesitan un paso más, que Frost da la próxima vez que ejecutes cualquier comando de Frost:

  • Si cambias la programación, Frost actualiza la tarea programada y lo indica con "config.toml changed. Scheduled job updated" (config.toml cambió; tarea programada actualizada). En Linux, la siguiente copia programada también lo hace. Un cambio hecho mientras se ejecuta una copia programada espera a que termine, igual que con frost config set.
  • Una nueva ubicación de almacenamiento recibe las mismas comprobaciones que con frost config edit la primera vez que Frost la usa. Cualquier problema aparece como aviso.

Nada comprueba el archivo antes de que lo guardes. Si no se puede interpretar, los comandos de Frost lo indican hasta que lo arregles.

#Todos los ajustes

Clave Valor predeterminado Significado
paths Las carpetas que se respaldan
exclude .DS_Store, Thumbs.db, *.tmp, *.swp, node_modules, .cache Nombres y patrones que se excluyen. Consulta Excluir archivos
schedule.enabled true Hacer copias automáticamente
schedule.every daily hourly, 2h, 3h, 4h, 6h, 8h, 12h, daily o weekly
schedule.time 15:00 La hora de las copias, en formato de 24 horas. Consulta Copias de seguridad automáticas
schedule.day sunday El día de las copias semanales, de sunday a saturday
schedule.catch_up true Hace una copia cuando tu equipo vuelve tras perderse una. false se salta las copias perdidas
verify.sample 20 Cuántos fragmentos descarga la comprobación aleatoria. 0 la desactiva
update.auto true Instalar versiones nuevas después de las copias programadas. false solo te avisa de ellas
storage.backend permafrost, s3, sftp para Servidor propio, o local para un disco local
storage.sftp.host La dirección SSH de tu servidor, como [email protected], o un Host de tu configuración de SSH
storage.sftp.port 0 El puerto SSH del servidor. 0 usa el puerto de tu configuración de SSH, o el 22
storage.sftp.path frost La carpeta del servidor. Una ruta relativa empieza en tu carpeta personal del servidor
storage.local.path La ruta completa de la carpeta en un disco
storage.permafrost.url Vacío para el servidor predeterminado, https://permafrost.wihiaawb.com. Si no, una dirección https://, o http:// para un servidor en tu propio equipo
storage.permafrost.token Tu clave de acceso de Permafrost
storage.s3.endpoint Como s3.us-east-1.amazonaws.com. También vale una dirección completa https://, y una http:// desactiva TLS
storage.s3.region Vacío si tu servidor o proveedor no usa regiones
storage.s3.bucket El nombre del bucket. Ya tiene que existir
storage.s3.prefix frost La carpeta del bucket que contiene tus copias. Vacío para la raíz del bucket
storage.s3.access_key_id Tu ID de clave de acceso
storage.s3.secret_access_key Tu clave de acceso secreta
storage.s3.insecure false Usar HTTP sin cifrar cuando el endpoint no tiene esquema. Solo para pruebas locales

#Variables de entorno

Variable Sustituye a
FROST_S3_ACCESS_KEY_ID o AWS_ACCESS_KEY_ID storage.s3.access_key_id
FROST_S3_SECRET_ACCESS_KEY o AWS_SECRET_ACCESS_KEY storage.s3.secret_access_key
FROST_PERMAFROST_TOKEN storage.permafrost.token
FROST_CONFIG_DIR La carpeta de configuración, como --config-dir
FROST_CACHE_DIR La carpeta de caché

Frost nunca escribe en config.toml los valores que vienen del entorno. Las copias programadas no ven las variables que defines en tu shell, así que siguen necesitando las credenciales en config.toml.