yadm - Online în cloud

PROGRAM:

NUME

yadm - Un alt manager Dotfiles

REZUMAT

yadm comandă [Opțiuni]

yadm git-command-or-alias [Opțiuni]

yadm init [-f] [-w director]

yadm clona url [-f] [-w director]

yadm config nume [valoare]

yadm config [-e]

yadm lista [-a]

yadm criptați

yadm decripta [-l]

yadm vechi

yadm perm

DESCRIERE

yadm este un instrument pentru gestionarea unei colecții de fișiere pe mai multe computere, folosind un
depozitul Git partajat. În plus, yadm oferă o funcție pentru a selecta versiuni alternative
de fișiere bazate pe sistemul de operare sau numele gazdei. În cele din urmă, yadm oferă capacitatea de a
gestionați un subset de fișiere securizate, care sunt criptate înainte de a fi incluse în
repertoriu.

COMANDE

comanda git or git-alias
Orice comandă care nu este gestionată intern de yadm este trecut prin la merge(1). Git
comenzile sau aliasurile sunt invocate cu yadm depozit gestionat. Lucrul
directorul pentru comenzile git va fi configurat copac de lucru (De obicei $ ACASĂ).

Dotfiles sunt gestionate folosind standard merge comenzi; adăuga, comite, împinge, trage, Etc

config comanda nu este transmisă direct. În schimb, utilizați gitconfig
comanda (vezi mai jos).

vechi Creați legături simbolice pentru orice fișiere gestionate care se potrivesc cu regulile de denumire descrise în
secțiunea ALTERNATE. De obicei, nu este necesar să rulați această comandă, ca yadm
procesează automat alternative în mod implicit. Acest comportament automat poate fi
dezactivat prin setarea configurației yadm.auto-alt la „fals”.

clona url
Clonează un depozit de la distanță pentru urmărirea fișierelor punct. După conținutul telecomenzii
depozitul a fost preluat, o „fusionare” a origine/stăpân se încearcă. În cazul în care există
sunt fișiere conflictuale deja prezente în copac de lucru, această fuziune va eșua și
în schimb o „resetare” a origine/stăpân se va face. Este la latitudinea utilizatorului să rezolve
aceste conflicte, dar dacă acțiunea dorită este de a avea conținutul în
depozitul suprascrie fișierele existente, apoi ar trebui să se realizeze o „resetare completă”.
că:

yadm reset --hard origine/master

Depozitul este stocat în $HOME/.yadm/repo.git. În mod implicit, $ ACASĂ va fi folosit
ca copac de lucru, dar acest lucru poate fi înlocuit cu -w opțiune. yadm poate fi
forțat să suprascrie un depozit existent prin furnizarea -f opțiune.

config Această comandă gestionează configurațiile pentru yadm. Această comandă funcționează exact în felul ei
git-config(1) face. Consultați secțiunea CONFIGURARE pentru mai multe detalii.

decripta
Decriptați toate fișierele stocate în $HOME/.yadm/files.gpg. Fișierele decriptate vor fi
raportat la configurat copac de lucru (De obicei $ ACASĂ). Folosind -l opțiunea va
enumerați fișierele stocate fără a le extrage.

criptați
Criptați toate fișierele care se potrivesc cu modelele găsite în $HOME/.yadm/encrypt. Vezi
Secțiunea CRIPTARE pentru mai multe detalii.

gitconfig
Treceți opțiuni la merge config comanda. De cand yadm folosește deja config comandă
pentru a-și gestiona propriile configurații, această comandă este oferită ca o modalitate de modificare
configurații ale depozitului gestionat de yadm. Un caz util ar putea fi
configurați depozitul astfel încât fișierele neurmărite să fie afișate în comenzile de stare. yadm
își configurează inițial depozitul astfel încât fișierele neurmărite să nu fie afișate. daca tu
doriți să utilizați comportamentul git implicit (pentru a afișa fișiere și directoare neurmărite), dvs
poate elimina această configurație.

yadm gitconfig --unset status.showUntrackedFiles

ajutor Tipăriți un rezumat al yadm comenzi.

înăuntru Inițializați un nou depozit gol pentru urmărirea fișierelor cu puncte. Depozitul este stocat
in $HOME/.yadm/repo.git. În mod implicit, $ ACASĂ va fi folosit ca copac de lucru, dar asta
poate fi înlocuit cu -w opțiune. yadm poate fi forțat să suprascrie un existent
depozit prin furnizarea -f opțiune.

listă Tipăriți o listă de fișiere gestionate de yadm. -a opțiunea va provoca toate fișierele gestionate
a fi listat. În caz contrar, lista va include numai fișierele din cea curentă
director sau mai jos.

perm Actualizați permisiunile așa cum este descris în secțiunea PERMISIUNI. De obicei este
nu este necesar să rulați această comandă, așa cum yadm procesează automat permisiunile prin
Mod implicit. Acest comportament automat poate fi dezactivat prin setarea configurației
yadm.auto-perms la „fals”.

versiune
Tipăriți versiunea de yadm.

CONFIGURARE

yadm folosește un fișier de configurare numit $HOME/.yadm/config. Acest fișier folosește același format
as git-config(1). De asemenea, puteți controla conținutul fișierului de configurare prin intermediul
yadm config comanda (care funcționează exact ca git-config). De exemplu, pentru a dezactiva
alternative puteți rula comanda:

yadm config yadm.auto-alt false

Următoarea este lista completă a configurațiilor acceptate:

yadm.auto-alt
Dezactivați legătura automată descrisă în secțiunea ALTERNATE. Dacă este dezactivat,
mai poți fugi yadm vechi manual pentru a crea legăturile alternative. Această caracteristică este
activat implicit.

yadm.auto-perms
Dezactivați modificările automate ale permisiunilor descrise în secțiunea PERMISIUNI. Dacă
dezactivat, este posibil să rulați în continuare yadm perm manual pentru a actualiza permisiunile. Acest
caracteristica este activată în mod implicit.

yadm.ssh-perms
Dezactivați modificarea permisiunii la $HOME/.ssh/*. Această caracteristică este activată de
Mod implicit.

yadm.gpg-perms
Dezactivați modificarea permisiunii la $HOME/.gnupg/*. Această caracteristică este activată de
Mod implicit.

ALTERNATE

Când gestionați un set de fișiere pe diferite sisteme, poate fi util să aveți un
mod automat de a alege o versiune alternativă a unui fișier pentru un alt sistem de operare,
gazdă sau utilizator. yadm implementează o caracteristică care va crea automat o legătură simbolică
la versiunea corespunzătoare a unui fișier, atâta timp cât respectați o convenție specifică de denumire.
yadm poate detecta fișiere cu nume care se termină în:

## or ##OS or ##OS.HOSTNAME or ##OS.HOSTNAME.USER

Dacă există fișiere gestionate de yadmdepozitul care corespunde acestei convenții de denumire,
se vor crea legături simbolice pentru cea mai potrivită versiune. Acesta poate fi cel mai bine
demonstrat prin exemplu. Să presupunem că următoarele fișiere sunt gestionate de yadmdepozitul lui:

- $HOME/path/example.txt##
- $HOME/path/example.txt##Darwin
- $HOME/path/example.txt##Darwin.host1
- $HOME/path/example.txt##Darwin.host2
- $HOME/path/example.txt##Linux
- $HOME/path/example.txt##Linux.host1
- $HOME/path/example.txt##Linux.host2

Dacă rulați pe un Macbook numit „host2”, yadm va crea o legătură simbolică care arată ca
acest:

$HOME/cale/example.txt -> $HOME/cale/example.txt##Darwin.host2

Cu toate acestea, pe un alt Mackbook numit „gazdă3”, yadm va crea o legătură simbolică care arată
asa:

$HOME/cale/example.txt -> $HOME/cale/example.txt##Darwin

Deoarece numele de gazdă nu se potrivește cu niciunul dintre fișierele gestionate, versiunea mai generică este
ales.

Dacă rulează pe un server Linux numit „host4”, linkul va fi:

$HOME/cale/example.txt -> $HOME/cale/example.txt##Linux

Dacă rulează pe un server Solaris, legătura utilizează versiunea implicită „##”:

$HOME/cale/example.txt -> $HOME/path/example.txt##

Dacă nu există nicio versiune „##” și niciun fișier nu se potrivește cu OS/HOSTNAME/USER curent, atunci nicio legătură
va fi creat.

Sistemul de operare este determinat de rulare uname -s, HOSTNAME prin rulare nume de gazdă -s, și USER prin rulare
id -u -n. yadm va crea automat aceste link-uri în mod implicit. Aceasta poate fi dezactivată
folosind yadm.auto-alt configurație. Chiar dacă sunt dezactivate, linkurile pot fi create manual de
funcţionare yadm vechi.

CRIPTARE

Poate fi util să gestionați fișiere confidențiale, cum ar fi cheile SSH sau GPG, pe mai multe
sisteme. Cu toate acestea, acest lucru ar pune datele text simplu într-un depozit Git, ceea ce adesea
rezidă într-un sistem public. yadm implementează o caracteristică care poate facilita criptarea
și decriptați un set de fișiere, astfel încât versiunea criptată să poată fi menținută în Git
repertoriu. Această caracteristică va funcționa numai dacă GPG(1) comanda este disponibilă.

Pentru a utiliza această caracteristică, o listă de modele trebuie creată și salvată ca $HOME/.yadm/encrypt.
Această listă de modele ar trebui să fie relativă la configurată copac de lucru (De obicei $ ACASĂ). Pentru
exemplu:

.ssh/*.key
.gnupg/*.gpg

yadm criptați comanda va găsi toate fișierele care se potrivesc cu modelele și va solicita a
parola. Odată ce parola a fost confirmată, fișierele care se potrivesc vor fi criptate și salvate ca
$HOME/.yadm/files.gpg. Modelele și fișierele.gpg ar trebui adăugate la yadm depozit
deci sunt disponibile pe mai multe sisteme.

Pentru a decripta aceste fișiere mai târziu, sau pe alt sistem rulați yadm decripta și furnizați
parola corecta. După ce fișierele sunt decriptate, permisiunile sunt actualizate automat ca
descrise în secțiunea PERMISIUNI.

NOTĂ: Este recomandat să utilizați un depozit privat atunci când păstrați fișiere confidențiale,
chiar dacă sunt criptate.

PERMISIUNI

Când fișierele sunt extrase dintr-un depozit Git, permisiunile lor inițiale sunt dependente
pe umasca utilizatorului. Acest lucru poate duce la fișiere confidențiale cu permisiuni laxe.

Pentru a preveni acest lucru, yadm va actualiza automat permisiunile fișierelor confidențiale.
Permisiunile „grup” și „altele” vor fi eliminate din următoarele fișiere:

- $HOME/.yadm/files.gpg

- Toate fișierele care se potrivesc cu modele în $HOME/.yadm/encrypt

- Directorul și fișierele SSH, .ssh/*

- Directorul și fișierele GPG, .gnupg/*

yadm va actualiza automat permisiunile în mod implicit. Acest lucru poate fi dezactivat folosind
yadm.auto-perms configurație. Chiar dacă sunt dezactivate, permisiunile pot fi actualizate manual de
funcţionare yadm perm. Procesarea directorului SSH poate fi dezactivată utilizând yadm.ssh-perms
configurare.

Utilizați yadm online folosind serviciile onworks.net