yadm - Online nel cloud

PROGRAMMA:

NOME

yadm - Ancora un altro Dotfile Manager

SINOSSI

yadm command [Opzioni]

yadm git-comando-o-alias [Opzioni]

yadm dentro [-f] [-w elenco]

yadm clonare URL [-f] [-w elenco]

yadm config Nome [APPREZZIAMO]

yadm configurazione [-e]

yadm elenco [-a]

yadm cifrare

yadm decifrare [-l]

yadm alt

yadm permanenti

DESCRIZIONE

yadm è uno strumento per gestire una raccolta di file su più computer, utilizzando a
repository Git condiviso. Inoltre, yadm fornisce una funzione per selezionare versioni alternative
di file in base al sistema operativo o al nome host. Infine, yadm fornisce la capacità di
gestire un sottoinsieme di file protetti, che vengono crittografati prima di essere inclusi nel
repository.

COMANDI

git-comando or alias git
Qualsiasi comando non gestito internamente da yadm è passato a git(1). Idiota
i comandi o gli alias vengono invocati con il yadm archivio gestito. Il lavoro
la directory per i comandi git sarà quella configurata albero-lavoro (Solitamente $ HOME).

I dotfile sono gestiti utilizzando standard git comandi; aggiungere, commettere, spingere, tirare, ecc.

I config comando non viene passato direttamente. Usa invece il gitconfig
comando (vedi sotto).

alt Crea collegamenti simbolici per tutti i file gestiti che corrispondono alle regole di denominazione descritte in
la sezione ALTERNATI. Di solito non è necessario eseguire questo comando, in quanto yadm
elabora automaticamente le alternative per impostazione predefinita. Questo comportamento automatico può essere
disabilitato impostando la configurazione yadm.auto-alt a "falso".

clonare URL
Clona un repository remoto per tenere traccia dei dotfile. Dopo il contenuto del telecomando
repository sono stati recuperati, una "unione" di origine/maestro è tentato. Se ci
sono file in conflitto già presenti nel albero-lavoro, questa unione fallirà e
invece un "reset" di origine/maestro sarà fatto. Spetta all'utente risolvere
questi conflitti, ma se l'azione desiderata è quella di avere i contenuti nella
repository sovrascrive i file esistenti, quindi dovrebbe essere eseguito un "hard reset"
che:

yadm reset --hard origin/master

Il repository è archiviato in $HOME/.yadm/repo.git. Di default, $ HOME sarà usato
la albero-lavoro, ma questo può essere sovrascritto con il -w opzione. yadm può essere
costretto a sovrascrivere un repository esistente fornendo il -f opzione.

config Questo comando gestisce le configurazioni per yadm. Questo comando funziona esattamente come loro
git-config(1) fa. Vedere la sezione CONFIGURAZIONE per maggiori dettagli.

decifrare
Decifra tutti i file archiviati in $HOME/.yadm/files.gpg. I file decifrati saranno
rispetto al configurato albero-lavoro (Solitamente $ HOME). Usando il -l l'opzione sarà
elenca i file memorizzati senza estrarli.

cifrare
Cripta tutti i file che corrispondono ai modelli trovati in $HOME/.yadm/crittografa. Vedere il
CRITTOGRAFIA per maggiori dettagli.

gitconfig
Passa le opzioni al git config comando. Da quando yadm usa già il config command
per gestire le proprie configurazioni, questo comando è fornito come un modo per cambiare
configurazioni del repository gestito da yadm. Un caso utile potrebbe essere quello di
configurare il repository in modo che i file non tracciati vengano visualizzati nei comandi di stato. yadm
configura inizialmente il suo repository in modo che i file non tracciati non vengano visualizzati. Se tu
desideri utilizzare il comportamento git predefinito (per mostrare file e directory non tracciati), tu
può rimuovere questa configurazione.

yadm gitconfig --unset status.showUntrackedFiles

Aiuto Stampa un riepilogo di yadm comandi.

init Inizializza un nuovo repository vuoto per tenere traccia dei dotfile. Il repository è archiviato
in $HOME/.yadm/repo.git. Di default, $ HOME sarà usato come albero-lavoro, ma questo
può essere sovrascritto con il -w opzione. yadm può essere forzato a sovrascrivere un esistente
repository fornendo il -f opzione.

stratagemma Stampa un elenco di file gestiti da yadm. -a l'opzione causerà tutti i file gestiti
da elencare. In caso contrario, l'elenco includerà solo i file dell'attuale
directory o sotto.

permanenti Aggiorna le autorizzazioni come descritto nella sezione AUTORIZZAZIONI. Di solito è
non è necessario eseguire questo comando, in quanto yadm elabora automaticamente le autorizzazioni da
predefinito. Questo comportamento automatico può essere disabilitato impostando la configurazione
yadm.auto-perms a "falso".

versione
Stampa la versione di yadm.

CONFIGURAZIONE

yadm usa un file di configurazione chiamato $HOME/.yadm/config. Questo file usa lo stesso formato
as git-config(1). Inoltre, puoi controllare il contenuto del file di configurazione tramite il
yadm config comando (che funziona esattamente come git-config). Ad esempio, per disabilitare
alternative puoi eseguire il comando:

yadm config yadm.auto-alt falso

Di seguito è riportato l'elenco completo delle configurazioni supportate:

yadm.auto-alt
Disabilitare il collegamento automatico descritto nella sezione ALTERNATIVI. Se disabilitato,
potresti ancora correre yadm alt manualmente per creare i collegamenti alternativi. Questa funzione è
abilitato per impostazione predefinita.

yadm.auto-perms
Disabilitare le modifiche automatiche ai permessi descritte nella sezione AUTORIZZAZIONI. Se
disabilitato, puoi ancora correre yadm permanenti manualmente per aggiornare le autorizzazioni. Questo
la funzione è abilitata per impostazione predefinita.

yadm.ssh-permanenti
Disabilita le modifiche ai permessi in $HOME/.ssh/*. Questa funzione è abilitata da
predefinito.

yadm.gpg-perms
Disabilita le modifiche ai permessi in $HOME/.gnupg/*. Questa funzione è abilitata da
predefinito.

ALTERNATIVI

Quando si gestisce un insieme di file su sistemi diversi, può essere utile disporre di un
modo automatizzato di scegliere una versione alternativa di un file per un diverso sistema operativo,
host o utente. yadm implementa una funzionalità che creerà automaticamente un collegamento simbolico
alla versione appropriata di un file, purché si segua una convenzione di denominazione specifica.
yadm può rilevare file con nomi che terminano con:

## or ##sistema operativo or ##OS.NOME HOST or ##OS.NOMEHOST.UTENTE

Se ci sono file gestiti da yadm's repository che corrispondono a questa convenzione di denominazione,
verranno creati collegamenti simbolici per la versione più appropriata. Questo potrebbe essere meglio
dimostrato con l'esempio. Supponiamo che i seguenti file siano gestiti da yadmdeposito di:

- $HOME/percorso/esempio.txt##
- $HOME/percorso/esempio.txt##Darwin
- $HOME/percorso/esempio.txt##Darwin.host1
- $HOME/percorso/esempio.txt##Darwin.host2
- $HOME/percorso/esempio.txt##Linux
- $HOME/percorso/esempio.txt##Linux.host1
- $HOME/percorso/esempio.txt##Linux.host2

Se in esecuzione su un Macbook denominato "host2", yadm creerà un collegamento simbolico che assomiglia a
Questo:

$HOME/percorso/esempio.txt -> $HOME/percorso/esempio.txt##Darwin.host2

Tuttavia, su un altro Mackbook chiamato "host3", yadm creerà un collegamento simbolico che sembra
come questo:

$HOME/percorso/esempio.txt -> $HOME/percorso/esempio.txt##Darwin

Poiché il nome host non corrisponde a nessuno dei file gestiti, la versione più generica è
scelto.

Se è in esecuzione su un server Linux denominato "host4", il collegamento sarà:

$HOME/percorso/esempio.txt -> $HOME/percorso/esempio.txt##Linux

Se è in esecuzione su un server Solaris, il collegamento utilizza la versione predefinita "##":

$HOME/percorso/esempio.txt -> $HOME/percorso/esempio.txt##

Se non esiste una versione "##" e nessun file corrisponde all'attuale OS/HOSTNAME/USER, allora nessun collegamento
sarà creato.

Il sistema operativo è determinato dall'esecuzione uname -s, HOSTNAME eseguendo hostname -se USER eseguendo
id -u -n. yadm creerà automaticamente questi collegamenti per impostazione predefinita. Questo può essere disabilitato
usando il yadm.auto-alt configurazione. Anche se disabilitati, i collegamenti possono essere creati manualmente da
running yadm alt.

CRITTOGRAFIA

Può essere utile gestire file riservati, come chiavi SSH o GPG, su più
sistemi. Tuttavia, così facendo metteresti i dati di testo normale in un repository Git, che spesso
risiede in un sistema pubblico. yadm implementa una funzionalità che può semplificare la crittografia
e decrittografare un insieme di file in modo che la versione crittografata possa essere mantenuta in Git
deposito. Questa funzione funzionerà solo se il gpg(1) il comando è disponibile.

Per utilizzare questa funzione, è necessario creare un elenco di modelli e salvarlo come $HOME/.yadm/crittografa.
Questo elenco di modelli dovrebbe essere relativo al configurato albero-lavoro (Solitamente $ HOME). Per
esempio:

.ssh/*.chiave
.gnupg/*.gpg

I yadm cifrare Il comando troverà tutti i file che corrispondono ai modelli e richiederà a
parola d'ordine. Una volta confermata la password, i file corrispondenti verranno crittografati e salvati come
$HOME/.yadm/files.gpg. I pattern e files.gpg dovrebbero essere aggiunti a yadm deposito
quindi sono disponibili su più sistemi.

Per decifrare questi file in un secondo momento o su un altro sistema esegui yadm decifrare e fornire il file
password corretta. Dopo che i file sono stati decifrati, le autorizzazioni vengono aggiornate automaticamente come
descritto nella sezione AUTORIZZAZIONI.

NOTA: Si consiglia di utilizzare un repository privato quando si conservano file riservati,
anche se sono criptati.

PERMESSI

Quando i file vengono estratti da un repository Git, le loro autorizzazioni iniziali dipendono
sulla umask dell'utente. Ciò può comportare file riservati con permessi lassisti.

Per evitare ciò, yadm aggiornerà automaticamente i permessi dei file riservati.
I permessi "gruppo" e "altri" verranno rimossi dai seguenti file:

- $HOME/.yadm/files.gpg

- Tutti i file che corrispondono ai modelli in $HOME/.yadm/crittografa

- La directory e i file SSH, .ssh/*

- La directory e i file GPG, .gnupg/*

yadm aggiornerà automaticamente le autorizzazioni per impostazione predefinita. Questo può essere disabilitato usando il
yadm.auto-perms configurazione. Anche se disabilitati, i permessi possono essere aggiornati manualmente da
running yadm permanenti. L'elaborazione della directory SSH può essere disabilitata utilizzando il yadm.ssh-permanenti
configurazione.

Usa yadm online utilizzando i servizi onworks.net