yadm - Online sa Cloud

PROGRAMA:

NAME

yadm - Isa Pang Dotfiles Manager

SINOPSIS

yadm utos [pagpipilian]

yadm git-command-or-alias [pagpipilian]

yadm sa loob [-f] [-w direktoryo]

yadm clone url [-f] [-w direktoryo]

yadm config pangalan [halaga]

yadm config [-e]

yadm listahan [-a]

yadm encrypt

yadm i-decrypt [-l]

yadm alt

yadm mga perms

DESCRIPTION

yadm ay isang tool para sa pamamahala ng isang koleksyon ng mga file sa maraming mga computer, gamit ang isang
nakabahaging Git repository. At saka, yadm ay nagbibigay ng tampok upang pumili ng mga kahaliling bersyon
ng mga file batay sa operating system o pangalan ng host. Panghuli, yadm nagbibigay ng kakayahan sa
pamahalaan ang isang subset ng mga secure na file, na naka-encrypt bago sila isama sa
imbakan.

UTOS

git-command or git-alias
Anumang utos na hindi panloob na pinangangasiwaan ng yadm ay ipinapasa sa pumunta(1). Git
ang mga utos o alyas ay ginagamit sa yadm pinamamahalaang imbakan. Ang pagtatrabaho
ang direktoryo para sa git command ay ang iko-configure trabaho-puno (Karaniwan ay $ HOME).

Ang mga dotfile ay pinamamahalaan sa pamamagitan ng paggamit ng pamantayan pumunta mga utos; idagdag, gumawa, itulak, paghila, Atbp

Ang config hindi direktang ipinapasa ang utos. Sa halip gamitin ang gitconfig
utos (tingnan sa ibaba).

alt Gumawa ng mga simbolikong link para sa anumang pinamamahalaang mga file na tumutugma sa mga panuntunan sa pagbibigay ng pangalan na inilalarawan
ang seksyong ALTERNATES. Karaniwang hindi kailangan na patakbuhin ang utos na ito, bilang yadm
awtomatikong nagproseso ng kahalili bilang default. Ang awtomatikong pag-uugali na ito ay maaaring
hindi pinagana sa pamamagitan ng pagtatakda ng configuration yadm.auto-alt sa "false".

clone url
I-clone ang isang malayuang imbakan para sa pagsubaybay sa mga dotfile. Matapos ang laman ng remote
imbakan ay nakuha, isang "pagsanib" ng pinanggalingan/panginoon ay tinangka. Kung meron
ay mga magkasalungat na file na naroroon na sa trabaho-puno, mabibigo ang pagsasanib na ito at
sa halip ay isang "reset" ng pinanggalingan/panginoon gagawin. Nasa gumagamit na ito upang malutas
ang mga salungatan na ito, ngunit kung ang nais na aksyon ay magkaroon ng mga nilalaman sa
i-overwrite ng repository ang mga umiiral na file, pagkatapos ay isang "hard reset" ang dapat magawa
na:

yadm reset --hard origin/master

Ang imbakan ay naka-imbak sa $HOME/.yadm/repo.git. Bilang default, $ HOME gagamitin
bilang trabaho-puno, ngunit maaari itong ma-override ng -w pagpipilian. yadm ay maaaring maging
pinilit na i-overwrite ang isang umiiral na imbakan sa pamamagitan ng pagbibigay ng -f pagpipilian.

config Pinamamahalaan ng command na ito ang mga configuration para sa yadm. Ang utos na ito ay gumagana nang eksakto sa kanilang paraan
git-config(1) ginagawa. Tingnan ang seksyong CONFIGURATION para sa higit pang mga detalye.

decrypt
I-decrypt ang lahat ng mga file na nakaimbak sa $HOME/.yadm/files.gpg. Ang mga file ay magiging decrypted
kaugnay sa na-configure trabaho-puno (Karaniwan ay $ HOME). Gamit ang -l kalooban ng pagpipilian
ilista ang mga file na nakaimbak nang hindi kinukuha ang mga ito.

encrypt
I-encrypt ang lahat ng mga file na tumutugma sa mga pattern na matatagpuan sa $HOME/.yadm/encrypt. Tingnan ang
Seksyon ng ENCRYPTION para sa higit pang mga detalye.

gitconfig
Ipasa ang mga opsyon sa pumunta config utos. Since yadm ginagamit na ang config utos
upang pamahalaan ang sarili nitong mga pagsasaayos, ang utos na ito ay ibinigay bilang isang paraan upang magbago
mga pagsasaayos ng repositoryo na pinamamahalaan ng yadm. Ang isang kapaki-pakinabang na kaso ay maaaring
i-configure ang repository upang ang mga hindi sinusubaybayang file ay ipinapakita sa mga utos ng katayuan. yadm
sa una ay kino-configure ang repository nito upang hindi maipakita ang mga hindi nasubaybayang file. kung ikaw
nais mong gamitin ang default na gawi ng git (upang ipakita ang mga hindi sinusubaybayang file at direktoryo), ikaw
maaaring alisin ang pagsasaayos na ito.

yadm gitconfig --unset status.showUntrackedFiles

Tulungan Mag-print ng buod ng yadm utos.

sa loob Magsimula ng bago, walang laman na repository para sa pagsubaybay sa mga dotfile. Ang imbakan ay naka-imbak
in $HOME/.yadm/repo.git. Bilang default, $ HOME ay gagamitin bilang ang trabaho-puno, pero ito
maaaring i-override sa -w pagpipilian. yadm maaaring piliting i-overwrite ang isang umiiral na
imbakan sa pamamagitan ng pagbibigay ng -f pagpipilian.

listahan Mag-print ng listahan ng mga file na pinamamahalaan ni yadm. ang -a ang opsyon ay magiging sanhi ng lahat ng pinamamahalaang file
upang mailista. Kung hindi, ang listahan ay magsasama lamang ng mga file mula sa kasalukuyang
direktoryo o sa ibaba.

mga perms I-update ang mga pahintulot gaya ng inilarawan sa seksyong MGA PAHINTULOT. Ito ay kadalasan
hindi kailangan upang patakbuhin ang utos na ito, bilang yadm awtomatikong nagpoproseso ng mga pahintulot sa pamamagitan ng
default. Maaaring i-disable ang awtomatikong gawi na ito sa pamamagitan ng pagtatakda ng configuration
yadm.auto-perms sa "false".

bersyon
I-print ang bersyon ng yadm.

Configuration

yadm gumagamit ng configuration file na pinangalanang $HOME/.yadm/config. Ang file na ito ay gumagamit ng parehong format
as git-config(1). Gayundin, maaari mong kontrolin ang mga nilalaman ng configuration file sa pamamagitan ng
yadm config command (na gumagana nang eksakto tulad ng git-config). Halimbawa, upang huwag paganahin
kahalili maaari mong patakbuhin ang utos:

yadm config yadm.auto-alt false

Ang sumusunod ay ang buong listahan ng mga sinusuportahang configuration:

yadm.auto-alt
Huwag paganahin ang awtomatikong pag-link na inilarawan sa seksyong ALTERNATES. Kung may kapansanan,
baka tumakbo ka pa yadm alt mano-mano upang lumikha ng mga kahaliling link. Ang tampok na ito ay
pinagana bilang default.

yadm.auto-perms
Huwag paganahin ang mga pagbabago sa awtomatikong pahintulot na inilarawan sa seksyong MGA PAHINTULOT. Kung
hindi pinagana, maaari ka pa ring tumakbo yadm mga perms manu-manong i-update ang mga pahintulot. Ito
Ang tampok ay pinagana bilang default.

yadm.ssh-perms
Huwag paganahin ang mga pagbabago sa pahintulot sa $HOME/.ssh/*. Ang tampok na ito ay pinagana ng
default.

yadm.gpg-perms
Huwag paganahin ang mga pagbabago sa pahintulot sa $HOME/.gnupg/*. Ang tampok na ito ay pinagana ng
default.

MGA HALILI

Kapag namamahala ng isang set ng mga file sa iba't ibang system, maaaring maging kapaki-pakinabang ang pagkakaroon ng isang
awtomatikong paraan ng pagpili ng kahaliling bersyon ng isang file para sa ibang operating system,
host, o user. yadm nagpapatupad ng feature na awtomatikong lilikha ng simbolikong link
sa naaangkop na bersyon ng isang file, hangga't sumusunod ka sa isang partikular na convention sa pagbibigay ng pangalan.
yadm maaaring makakita ng mga file na may mga pangalan na nagtatapos sa:

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

Kung mayroong anumang mga file na pinamamahalaan ng yadmAng repositoryo na tumutugma sa kombensyon ng pagbibigay ng pangalan na ito,
malilikha ang mga simbolikong link para sa pinakaangkop na bersyon. Ito ay maaaring pinakamahusay na
ipinakita sa pamamagitan ng halimbawa. Ipagpalagay na ang mga sumusunod na file ay pinamamahalaan ni yadmimbakan:

- $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

Kung tumatakbo sa isang Macbook na pinangalanang "host2", yadm ay lilikha ng simbolikong link na kamukha
ito:

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

Gayunpaman, sa isa pang Mackbook na pinangalanang "host3", yadm lilikha ng simbolikong link na mukhang
ganito:

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

Dahil ang hostname ay hindi tumutugma sa alinman sa mga pinamamahalaang file, ang mas generic na bersyon ay
napili.

Kung tumatakbo sa isang server ng Linux na pinangalanang "host4", ang link ay magiging:

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

Kung tumatakbo sa isang server ng Solaris, ginagamit ng link ang default na bersyong "##":

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

Kung walang bersyon na "##" at walang mga file na tumutugma sa kasalukuyang OS/HOSTNAME/USER, walang link
ay malilikha.

Natutukoy ang OS sa pamamagitan ng pagtakbo uname -s, HOSTNAME sa pamamagitan ng pagpapatakbo hostname -s, at USER sa pamamagitan ng pagtakbo
id -u -n. yadm ay awtomatikong gagawa ng mga link na ito bilang default. Ito ay maaaring hindi paganahin
gamit ang yadm.auto-alt pagsasaayos. Kahit na hindi pinagana, ang mga link ay maaaring manu-manong gawin ng
tumatakbo yadm alt.

ENCRYPTION

Maaari itong maging kapaki-pakinabang upang pamahalaan ang mga kumpidensyal na file, tulad ng mga SSH o GPG key, sa maramihang
mga sistema. Gayunpaman, ang paggawa nito ay maglalagay ng plain text data sa isang Git repository, na madalas
naninirahan sa isang pampublikong sistema. yadm nagpapatupad ng isang tampok na maaaring gawing madali ang pag-encrypt
at i-decrypt ang isang set ng mga file upang mapanatili ang naka-encrypt na bersyon sa Git
imbakan. Ang tampok na ito ay gagana lamang kung ang gpg(1) utos ay magagamit.

Upang magamit ang tampok na ito, isang listahan ng mga pattern ay dapat gawin at i-save bilang $HOME/.yadm/encrypt.
Ang listahan ng mga pattern na ito ay dapat na nauugnay sa na-configure trabaho-puno (Karaniwan ay $ HOME). Para sa
halimbawa:

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

Ang yadm encrypt hahanapin ng command ang lahat ng mga file na tumutugma sa mga pattern, at mag-prompt para sa a
password. Kapag nakumpirma na ang isang password, ie-encrypt at ise-save ang mga katugmang file bilang
$HOME/.yadm/files.gpg. Ang mga pattern at files.gpg ay dapat idagdag sa yadm repositoryo
kaya available ang mga ito sa maraming system.

Upang i-decrypt ang mga file na ito sa ibang pagkakataon, o sa isa pang system run yadm decrypt at ibigay ang
tamang password. Pagkatapos ma-decrypt ang mga file, awtomatikong ina-update ang mga pahintulot bilang
inilarawan sa seksyong MGA PAHINTULOT.

NOTA: Inirerekomenda na gumamit ka ng pribadong repositoryo kapag nagpapanatili ng mga kumpidensyal na file,
kahit na sila ay naka-encrypt.

PAHAYAG

Kapag ang mga file ay na-check out sa isang Git repository, ang kanilang mga paunang pahintulot ay nakasalalay
sa umask ng gumagamit. Maaari itong magresulta sa mga kumpidensyal na file na may mahinang mga pahintulot.

Upang maiwasan ito, yadm ay awtomatikong ia-update ang mga pahintulot ng mga kumpidensyal na file.
Ang mga pahintulot ng "grupo" at "iba pa" ay aalisin sa mga sumusunod na file:

- $HOME/.yadm/files.gpg

- Lahat ng mga file na tumutugma sa mga pattern sa $HOME/.yadm/encrypt

- Ang SSH na direktoryo at mga file, .ssh/*

- Ang direktoryo at mga file ng GPG, .gnupg/*

yadm ay awtomatikong mag-a-update ng mga pahintulot bilang default. Ito ay maaaring hindi paganahin gamit ang
yadm.auto-perms pagsasaayos. Kahit na hindi pinagana, ang mga pahintulot ay maaaring manu-manong i-update ng
tumatakbo yadm mga perms. Maaaring hindi paganahin ang pagpoproseso ng direktoryo ng SSH gamit ang yadm.ssh-perms
pagsasaayos.

Gamitin ang yadm online gamit ang mga serbisyo ng onworks.net