yadm — online w chmurze

PROGRAM:

IMIĘ

yadm - kolejny menedżer plików Dotfile

STRESZCZENIE

jadm komenda [Opcje]

jadm git-polecenie lub alias [Opcje]

jadm w tym [-f] [-w katalog]

jadm klonować url [-f] [-w katalog]

jadm config Nazwa [wartość]

jadm konfiguracja [-e]

jadm lista [-a]

jadm Szyfrowanie

jadm odszyfrować [-l]

jadm alt

jadm perms

OPIS

jadm to narzędzie do zarządzania kolekcją plików na wielu komputerach za pomocą
współdzielone repozytorium Git. Ponadto, jadm udostępnia funkcję wyboru alternatywnych wersji
plików na podstawie systemu operacyjnego lub nazwy hosta. W końcu, jadm zapewnia zdolność do
zarządzać podzbiorem bezpiecznych plików, które są zaszyfrowane, zanim zostaną włączone do
magazyn.

POLECENIA

polecenie git or git-alias
Każde polecenie nie obsługiwane wewnętrznie przez jadm jest przekazywany do odrzutowiec(1). Gita
polecenia lub aliasy są wywoływane z jadm zarządzane repozytorium. Pracować
katalog dla poleceń git będzie skonfigurowany drzewo pracy (Zwykle $ HOME).

Dotfiles są zarządzane przy użyciu standardowego odrzutowiec polecenia; Dodaj, popełnić, naciskać, Ciągnąć, itp.

Połączenia config polecenie nie jest przekazywane bezpośrednio. Zamiast tego użyj gitconfig
polecenie (patrz poniżej).

alt Utwórz dowiązania symboliczne dla dowolnych zarządzanych plików zgodnych z regułami nazewnictwa opisanymi w
sekcja ALTERNATY. Zwykle nie jest konieczne uruchamianie tego polecenia, ponieważ jadm
automatycznie przetwarza alternatywy domyślnie. To automatyczne zachowanie może być
wyłączone przez ustawienie konfiguracji yadm.auto-alt na „fałsz”.

klonować url
Sklonuj zdalne repozytorium do śledzenia plików dot. Po zawartości pilota
repozytorium zostały pobrane, „scalanie” pochodzenie/master podjęto próbę. Jezeli tam
czy pliki powodujące konflikt są już obecne w drzewo pracy, to połączenie się nie powiedzie i
zamiast tego „reset” pochodzenie/master zostanie wykonana. Rozwiązanie należy do użytkownika
te konflikty, ale jeśli pożądanym działaniem jest posiadanie zawartości w
repozytorium nadpisuje istniejące pliki, a następnie powinien wykonać „twardy reset”
że:

Yadm reset -- twardy początek/master

Repozytorium jest przechowywane w $HOME/.yadm/repo.git. Domyślnie, $ HOME będzie użyty
jak drzewo pracy, ale można to zmienić za pomocą -w opcja. jadm może być
zmuszony do nadpisania istniejącego repozytorium poprzez podanie -f opcja.

config To polecenie zarządza konfiguracjami dla jadm. To polecenie działa dokładnie w ten sposób
git-config(1) tak. Więcej szczegółów w sekcji KONFIGURACJA.

odszyfrować
Odszyfruj wszystkie pliki przechowywane w $HOME/.yadm/files.gpg. Odszyfrowane pliki będą
w stosunku do skonfigurowanego drzewo pracy (Zwykle $ HOME). Używając -l opcja będzie
wyświetl listę przechowywanych plików bez ich wyodrębniania.

Szyfrowanie
Zaszyfruj wszystkie pliki pasujące do wzorców znalezionych w $HOME/.yadm/encrypt. Zobacz
Sekcja SZYFROWANIE po więcej szczegółów.

gitconfig
Przekaż opcje do odrzutowiec config Komenda. Odkąd jadm już używa config komenda
aby zarządzać własnymi konfiguracjami, ta komenda jest dostarczana jako sposób na zmianę
konfiguracje repozytorium zarządzanego przez jadm. Jednym z przydatnych przypadków może być:
skonfigurować repozytorium tak, aby nieśledzone pliki były wyświetlane w poleceniach statusu. jadm
początkowo konfiguruje swoje repozytorium tak, aby nieśledzone pliki nie były wyświetlane. Jeśli ty
chcesz użyć domyślnego zachowania git (aby pokazać nieśledzone pliki i katalogi), ty
może usunąć tę konfigurację.

yadm gitconfig --unset status.showUntrackedFiles

pomoc Wydrukuj podsumowanie jadm Polecenia.

startowych Zainicjuj nowe, puste repozytorium do śledzenia plików dot. Repozytorium jest przechowywane
in $HOME/.yadm/repo.git. Domyślnie, $ HOME będzie używany jako drzewo pracy, ale to
można nadpisać za pomocą -w opcja. jadm można zmusić do zastąpienia istniejącego
repozytorium, udostępniając -f opcja.

podstęp Wydrukuj listę plików zarządzanych przez jadm, -a opcja spowoduje, że wszystkie zarządzane pliki
być wymienionym. W przeciwnym razie lista będzie zawierać tylko pliki z bieżącego
katalogu lub poniżej.

perms Zaktualizuj uprawnienia zgodnie z opisem w sekcji ZEZWOLENIA. Zazwyczaj tak jest
nie trzeba uruchamiać tego polecenia, ponieważ jadm automatycznie przetwarza uprawnienia przez
domyślny. To automatyczne zachowanie można wyłączyć, ustawiając konfigurację
yadm.auto-perms na „fałsz”.

wersja
Wydrukuj wersję jadm.

KONFIGURACJA

jadm używa pliku konfiguracyjnego o nazwie $HOME/.yadm/config. Ten plik używa tego samego formatu
as git-config(1). Możesz także kontrolować zawartość pliku konfiguracyjnego za pomocą
jadm config polecenie (które działa dokładnie tak, jak git-config). Na przykład, aby wyłączyć
alternatywy, możesz uruchomić polecenie:

konfiguracja yadm yadm.auto-alt fałsz

Poniżej znajduje się pełna lista obsługiwanych konfiguracji:

yadm.auto-alt
Wyłącz automatyczne łączenie opisane w sekcji ALTERNATY. Jeśli wyłączone,
nadal możesz biec jadm alt ręcznie, aby utworzyć alternatywne łącza. Ta funkcja to
domyślnie włączone.

yadm.auto-perms
Wyłącz automatyczne zmiany uprawnień opisane w sekcji ZEZWOLENIA. Gdyby
wyłączone, nadal możesz biec jadm perms ręcznie, aby zaktualizować uprawnienia. Ten
funkcja jest domyślnie włączona.

yadm.ssh-perms
Wyłącz zmiany uprawnień do $HOME/.ssh/*. Ta funkcja jest włączona przez
domyślna.

yadm.gpg-perms
Wyłącz zmiany uprawnień do $HOME/.gnupg/*. Ta funkcja jest włączona przez
domyślna.

ALTERNATY

Zarządzając zbiorem plików w różnych systemach, przydatne może być posiadanie
automatyczny sposób wyboru alternatywnej wersji pliku dla innego systemu operacyjnego,
host lub użytkownik. jadm implementuje funkcję, która automatycznie utworzy dowiązanie symboliczne
do odpowiedniej wersji pliku, o ile przestrzegasz określonej konwencji nazewnictwa.
jadm potrafi wykryć pliki o nazwach kończących się na:

## or ##OS or ##OS.NAZWAHOSTA or ##OS.NAZWAHOSTA.UŻYTKOWNIK

Jeśli istnieją jakieś pliki zarządzane przez jadmrepozytorium zgodne z tą konwencją nazewnictwa,
dowiązania symboliczne zostaną utworzone dla najbardziej odpowiedniej wersji. To może najlepiej być
zademonstrowane na przykładzie. Załóżmy, że następujące pliki są zarządzane przez jadmrepozytorium:

- $HOME/ścieżka/przykład.txt##
- $HOME/ścieżka/przykład.txt##Darwin
- $HOME/ścieżka/przykład.txt##Darwin.host1
- $HOME/ścieżka/przykład.txt##Darwin.host2
- $HOME/ścieżka/przykład.txt##Linux
- $HOME/ścieżka/przykład.txt##Linux.host1
- $HOME/ścieżka/przykład.txt##Linux.host2

Jeśli działa na Macbooku o nazwie „host2”, jadm utworzy dowiązanie symboliczne, które wygląda jak
to:

$HOME/ścieżka/przykład.txt -> $HOME/ścieżka/przykład.txt##Darwin.host2

Jednak na innym Mackbooku o nazwie „host3”, jadm utworzy dowiązanie symboliczne, które wygląda
lubię to:

$HOME/ścieżka/przykład.txt -> $HOME/ścieżka/przykład.txt##Darwin

Ponieważ nazwa hosta nie pasuje do żadnego z zarządzanych plików, bardziej ogólna wersja to
wybrany.

Jeśli działa na serwerze Linux o nazwie „host4”, link będzie wyglądał następująco:

$HOME/ścieżka/przykład.txt -> $HOME/ścieżka/przykład.txt##Linux

Jeśli działa na serwerze Solaris, łącze używa domyślnej wersji „##”:

$HOME/ścieżka/przykład.txt -> $HOME/ścieżka/przykład.txt##

Jeśli nie istnieje wersja "##" i żadne pliki nie pasują do bieżącego systemu operacyjnego/NAZWY HOSTA/UŻYTKOWNIKA, to nie ma linku
zostanie utworzona.

System operacyjny jest określany przez uruchomienie uname -s, NAZWA HOSTA, uruchamiając hosta -si USER przez uruchomienie
id -u -n. jadm automatycznie utworzy te linki domyślnie. Można to wyłączyć
używając yadm.auto-alt konfiguracja. Nawet jeśli wyłączone, linki mogą być tworzone ręcznie przez
bieganie jadm alt.

SZYFROWANIE

Przydatne może być zarządzanie poufnymi plikami, takimi jak klucze SSH lub GPG, w wielu
systemy. Jednak zrobienie tego spowodowałoby umieszczenie zwykłych danych tekstowych w repozytorium Git, co często
znajduje się w systemie publicznym. jadm implementuje funkcję, która może ułatwić szyfrowanie
i odszyfruj zestaw plików, aby zaszyfrowana wersja mogła być przechowywana w Git
magazyn. Ta funkcja będzie działać tylko wtedy, gdy Gpg(1) polecenie jest dostępne.

Aby skorzystać z tej funkcji, należy utworzyć i zapisać listę wzorów jako $HOME/.yadm/encrypt.
Ta lista wzorców powinna odnosić się do skonfigurowanych drzewo pracy (Zwykle $ HOME). Dla
przykład:

.ssh/*.klucz
.gnupg/*.gpg

Połączenia jadm Szyfrowanie polecenie wyszuka wszystkie pliki pasujące do wzorców i poprosi o
hasło. Po potwierdzeniu hasła pasujące pliki zostaną zaszyfrowane i zapisane jako
$HOME/.yadm/files.gpg. Wzory i pliki.gpg należy dodać do jadm składnica
dzięki czemu są dostępne w wielu systemach.

Aby odszyfrować te pliki później lub na innym uruchomieniu systemu jadm odszyfrować i podaj
poprawne hasło. Po odszyfrowaniu plików uprawnienia są automatycznie aktualizowane jako
opisane w sekcji ZEZWOLENIA.

UWAGA: Zaleca się korzystanie z prywatnego repozytorium przy przechowywaniu poufnych plików,
mimo że są zaszyfrowane.

ZEZWOLENIA

Kiedy pliki są pobierane z repozytorium Git, ich początkowe uprawnienia są zależne
na umask użytkownika. Może to skutkować powstaniem poufnych plików z niepełnymi uprawnieniami.

Aby temu zapobiec, jadm automatycznie zaktualizuje uprawnienia do poufnych plików.
Uprawnienia „grupa” i „inne” zostaną usunięte z następujących plików:

- $HOME/.yadm/files.gpg

- Wszystkie pliki pasujące do wzorców w $HOME/.yadm/encrypt

- Katalog i pliki SSH, .ssh/*

- Katalog i pliki GPG, .gnupg/*

jadm domyślnie automatycznie zaktualizuje uprawnienia. Można to wyłączyć za pomocą
yadm.auto-perms konfiguracja. Nawet jeśli są wyłączone, uprawnienia można aktualizować ręcznie przez
bieganie jadm perms. Przetwarzanie katalogu SSH można wyłączyć za pomocą yadm.ssh-perms
konfiguracja.

Korzystaj z yadm online za pomocą usług onworks.net