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
setsustituye la lista entera. trueyfalseactivan y desactivan ajustes.- Cambiar un ajuste de
scheduleactualiza 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 editla 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 me@nas.local, 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.