Comandos de ERPC CLI
Todos los grupos de comandos de ERPC CLI en una tabla, las opciones que funcionan en todos los comandos y los códigos de salida en los que puede confiar un script.
Esta página describe ERPC CLI
v0.1.0-rc.4, una versión preliminar.Grupos de comandos
Ejecuta cualquier grupo de comandos sin verbo, como
erpc validator o erpc worker, para ver la lista de sus verbos.Opciones globales
--jsonda una salida legible por máquina:erpc --json <command>.ERPC_JSON=truetiene el mismo efecto. En los comandos de nodo,--jsontiene que ir antes del comando.--langestablece el idioma en el que habla erpc:en,ja,zhoru. Sin esta opción, erpc usa el ajustelocaley, si no lo hay, el idioma del sistema.
Errores y códigos de salida
Un fallo se lee igual en todas partes: una línea
error: que dice qué salió mal y una línea hint: que dice qué hacer a continuación, cuando la hay. Con --json, un fallo es un único objeto en la salida estándar, {"error": {"code", "exit", "message", "hint"}}. En dos casos se imprime en su lugar el mensaje propio de clap y el estado de salida es 2: una línea de comandos que clap no puede analizar en un terminal, y un argumento que el verbo de un árbol de nodos (erpc validator, rpc, node) no acepta, incluso con --json. Un campo details aparece solo cuando un comando tiene algo más que decir a un script sobre lo que hizo antes de fallar, y nunca en un terminal.Si se detiene con Ctrl-C (o SIGTERM, SIGHUP), erpc termina por la propia señal, así que un bucle de un script también se detiene. Un código publicado conserva su nombre y su estado de salida, y un código nunca se reutiliza.
Almacenamiento y copias de seguridad
bash
erpc storage buy compra un plan de ERPC Global Storage, que se paga con ERPC Credit. Los planes y los precios están en la página Precios.erpc storage
erpc storage putcifra un archivo en esta máquina antes de enviar ninguna parte de él, salvo que se indique--no-encrypt. ERPC solo almacena los bytes cifrados y nunca tiene la clave.erpc storage getdetecta un archivo cifrado y lo descifra.- Hay una clave de almacenamiento por cuenta, guardada en el almacén que eligió
erpc login. erpc no la guarda en el keyring del kernel de Linux, que se pierde al reiniciar: inicia sesión con--store 1passwordo--store file, o usa--no-encrypt. Con el almacénfile, la clave está en~/.erpc/storage-key(modo 0600), sin cifrar.--no-encryptsube el archivo que envías tal cual, sin cifrar. - Si pierdes la clave de almacenamiento, pierdes todos los archivos cifrados con ella, y ERPC no puede recuperarla.
erpc storage key export --showmuestra la clave para que se pueda guardar una copia lejos de la máquina, yerpc storage key importla vuelve a cargar en otra máquina. - La ruta bajo la que se almacena un archivo, y su tamaño, son visibles para ERPC.
erpc storage keys listmuestra las claves de acceso al almacenamiento, yerpc storage keys revoke <n>revoca una.
erpc backup
erpc backup hace una copia de seguridad de una máquina en ERPC Global Storage con restic. Los archivos se cifran en tu máquina antes de salir de ella, y ERPC nunca tiene una contraseña que abra las copias de seguridad.- Cada máquina recibe una clave de solo adición que no puede eliminar sus propias copias de seguridad. La máquina en la que ejecutaste
erpc backup inittambién tiene las claves que sí pueden, así que la protección solo se mantiene en una máquina que no guarde ni la sesión de erpc ni los secretos de copia de seguridad de la cuenta. - Guarda una copia de
erpc backup password --showlejos de las máquinas. Si pierdes la contraseña maestra y elbackup.envde todas las máquinas, pierdes las copias de seguridad. - Una copia de seguridad excluye los archivos de claves conocidos y los secretos del sistema, como
.ssh/id_*,.config/solana/id.json, la sesión de erpc y las claves de host SSH. El material de claves con otro nombre o en otro lugar se copia como cualquier otro archivo: exclúyelo con--exclude. - erpc instala restic 0.19.1 y comprueba tanto el archivo comprimido como el programa con resúmenes SHA-256 compilados en erpc.
- Programación: en Linux,
sudo erpc backup inity despuéssudo erpc backup schedule daily. En macOS,erpc backup schedule daily ~/Documents; la tarea se ejecuta con tu usuario, mientras tengas la sesión iniciada. - Las copias de seguridad van a la región predeterminada de la cuenta.
erpc backupse ejecuta en la máquina de la que hace la copia; el servidor de un worker se configura en su lugar conerpc worker backup on(Hacer una copia de seguridad de los datos de estado de la aplicación).