Comandos do ERPC CLI
Todos os grupos de comandos do ERPC CLI em uma tabela, as opções que funcionam em todos os comandos e os códigos de saída com que um script pode contar.
Esta página descreve o ERPC CLI
v0.1.0-rc.4, uma versão de pré-lançamento.Grupos de comandos
Execute qualquer grupo de comandos sem verbo, como
erpc validator ou erpc worker, para listar os seus verbos.Opções globais
--jsongera uma saída legível por máquina:erpc --json <command>.ERPC_JSON=truetem o mesmo efeito. Nos comandos de nó,--jsontem de vir antes do comando.--langdefine o idioma em que o erpc fala:en,ja,zhouru. Sem ele, o erpc usa a configuraçãolocalee, na falta dela, o idioma do sistema.
Erros e códigos de saída
Uma falha tem a mesma forma em todos os lugares: uma linha
error: que diz o que deu errado e, quando houver, uma linha hint: que diz o que fazer em seguida. Com --json, uma falha é um único objeto na saída padrão, {"error": {"code", "exit", "message", "hint"}}. Dois casos, em vez disso, imprimem a mensagem do próprio clap e saem com status 2: uma linha de comando que o clap não consegue interpretar em um terminal, e um argumento que o verbo de uma árvore de nós (erpc validator, rpc, node) não aceita, mesmo com --json. Um campo details só aparece quando um comando tem mais a dizer a um script sobre o que fez antes de falhar, e nunca em um terminal.Quando é interrompido por Ctrl-C (ou SIGTERM, SIGHUP), o erpc termina pelo próprio sinal, então um loop em um script também para. Um código publicado mantém o seu nome e o seu status de saída, e um código nunca é reutilizado.
Armazenamento e backups
bash
O
erpc storage buy compra um plano do ERPC Global Storage, pago com ERPC Credit. Os planos e os preços estão em Preços.erpc storage
- O
erpc storage putcriptografa um arquivo nesta máquina antes que qualquer parte dele seja enviada, a menos que--no-encryptseja informado. A ERPC armazena apenas os bytes criptografados e nunca guarda a chave. Oerpc storage getdetecta um arquivo criptografado e o descriptografa. - Há uma chave de armazenamento por conta, guardada no local de armazenamento que o
erpc loginescolheu. O erpc não a guarda no keyring do kernel Linux, que se perde ao reiniciar: faça login com--store 1passwordou--store file, ou use--no-encrypt. Com o localfile, a chave fica em~/.erpc/storage-key(modo 0600), sem criptografia. O--no-encryptfaz o upload do arquivo que você está enviando do jeito que está, sem criptografia. - Perder a chave de armazenamento significa perder todos os arquivos criptografados com ela, e a ERPC não consegue recuperá-la.
erpc storage key export --showimprime a chave para que uma cópia possa ser guardada longe da máquina, eerpc storage key importa recebe de volta em outra máquina. - O caminho em que um arquivo é armazenado, e o seu tamanho, ficam visíveis para a ERPC.
erpc storage keys listmostra as chaves de acesso ao armazenamento, eerpc storage keys revoke <n>revoga uma delas.
erpc backup
O
erpc backup faz backup de uma máquina no ERPC Global Storage com o restic. Os arquivos são criptografados na sua máquina antes de saírem dela, e a ERPC nunca guarda uma senha que abra os backups.- Cada máquina recebe uma chave append-only, que não pode excluir os seus próprios backups. A máquina em que você executou
erpc backup inittambém guarda as chaves que podem excluí-los, então a proteção só vale em uma máquina que não guarde nem a sessão do erpc nem os segredos de backup da conta. - Guarde uma cópia de
erpc backup password --showlonge das máquinas. Perder a senha mestra e obackup.envde todas as máquinas significa perder os backups. - Um backup deixa de fora arquivos de chave conhecidos e segredos do sistema, como
.ssh/id_*,.config/solana/id.json, a sessão do erpc e as chaves de host SSH. Material de chave com outro nome ou em outro lugar entra no backup como qualquer outro arquivo: deixe-o de fora com--exclude. - O erpc instala o restic 0.19.1 e verifica tanto o arquivo compactado quanto o programa com digests SHA-256 compilados no erpc.
- Agendamento: no Linux,
sudo erpc backup inite depoissudo erpc backup schedule daily. No macOS,erpc backup schedule daily ~/Documents; a tarefa roda como você, enquanto você estiver com a sessão iniciada. - Os backups vão para a região padrão da conta. O
erpc backuproda na máquina da qual faz backup; o servidor de um worker é configurado comerpc worker backup on, em vez disso (Fazer backup do estado da aplicação).