yadm - En ligne dans le Cloud

PROGRAMME:

Nom

yadm - Encore un autre gestionnaire de fichiers Dotfiles

SYNOPSIS

yamm commander [Options]

yamm git-commande-ou-alias [Options]

yamm initialiser [-f] [-w annuaire]

yamm cloner url [-f] [-w annuaire]

yamm config prénom [Plus-value]

yamm configuration [-e]

yamm liste [-a]

yamm crypter

yamm décrypter [-l]

yamm alt

yamm permanentes

DESCRIPTION

yamm est un outil permettant de gérer une collection de fichiers sur plusieurs ordinateurs, à l'aide d'un
référentiel Git partagé. En outre, yamm fournit une fonctionnalité pour sélectionner des versions alternatives
de fichiers en fonction du système d'exploitation ou du nom d'hôte. Dernièrement, yamm fournit la capacité de
gérer un sous-ensemble de fichiers sécurisés, qui sont cryptés avant d'être inclus dans le
dépôt.

COMMANDES

git-commande or git-alias
Toute commande non gérée en interne par yamm est passé à jet(1). Gite
les commandes ou les alias sont invoqués avec le yamm référentiel géré. Le travail
répertoire pour les commandes git sera le configuré arbre de travail (Généralement $ ACCUEIL).

Les fichiers dot sont gérés en utilisant la norme jet commandes ; ajouter, commettre, pousser, tirer, etc.

La config la commande n'est pas transmise directement. Utilisez plutôt le gitconfig
commande (voir ci-dessous).

alt Créez des liens symboliques pour tous les fichiers gérés correspondant aux règles de nommage décrites dans
la section SUPPLÉANTS. Il est généralement inutile d'exécuter cette commande, car yamm
traite automatiquement les alternatives par défaut. Ce comportement automatique peut être
désactivé en définissant la configuration yadm.auto-alt à "faux".

cloner url
Clonez un référentiel distant pour le suivi des dotfiles. Après le contenu de la télécommande
référentiel ont été récupérés, une "fusion" de origine / maître est tenté. S'il y a
sont des fichiers en conflit déjà présents dans le arbre de travail, cette fusion échouera et
à la place une "réinitialisation" de origine / maître sera fait. C'est à l'utilisateur de résoudre
ces conflits, mais si l'action souhaitée est d'avoir le contenu dans le
le référentiel écrase les fichiers existants, puis une "réinitialisation matérielle" devrait accomplir
que:

yadm réinitialiser --hard origin/master

Le référentiel est stocké dans $HOME/.yadm/repo.git. Par défaut, $ ACCUEIL sera utilisé
car arbre de travail, mais cela peut être annulé avec le -w option. yamm peuvent être
forcé d'écraser un référentiel existant en fournissant le -f option.

config Cette commande gère les configurations pour yamm. Cette commande fonctionne exactement comme ils le souhaitent
git-config(1) le fait. Voir la section CONFIGURATION pour plus de détails.

décrypter
Décrypter tous les fichiers stockés dans $HOME/.yadm/fichiers.gpg. Les fichiers décryptés seront
par rapport à la configuration arbre de travail (Généralement $ ACCUEIL). En utilisant le -l l'option sera
liste les fichiers stockés sans les extraire.

crypter
Crypter tous les fichiers correspondant aux modèles trouvés dans $HOME/.yadm/chiffrer. Voir l'
section CRYPTAGE pour plus de détails.

gitconfig
Passer les options au jet config commander. Depuis yamm utilise déjà le config commander
pour gérer ses propres configurations, cette commande est fournie comme moyen de changer
configurations du référentiel gérées par yamm. Un cas utile pourrait être de
configurer le référentiel afin que les fichiers non suivis soient affichés dans les commandes d'état. yamm
configure initialement son référentiel afin que les fichiers non suivis ne soient pas affichés. Si tu
souhaitez utiliser le comportement par défaut de git (pour afficher les fichiers et répertoires non suivis), vous
peut supprimer cette configuration.

yadm gitconfig --unset status.showUntrackedFiles

vous aider Imprimer un résumé de yamm les commandes.

init Initialisez un nouveau référentiel vide pour le suivi des dotfiles. Le référentiel est stocké
in $HOME/.yadm/repo.git. Par défaut, $ ACCUEIL sera utilisé comme arbre de travail, mais ça
peut être remplacé par le -w option. yamm peut être forcé d'écraser un existant
référentiel en fournissant le -f option.

liste Imprimer une liste des fichiers gérés par yammL’ -a l'option entraînera tous les fichiers gérés
être répertorié. Sinon, la liste n'inclura que les fichiers de la
répertoire ou ci-dessous.

permanentes Mettez à jour les autorisations comme décrit dans la section AUTORISATIONS. C'est généralement
inutile d'exécuter cette commande, car yamm traite automatiquement les autorisations en
défaut. Ce comportement automatique peut être désactivé en définissant la configuration
yadm.auto-perms à "faux".

version
Imprimer la version de yamm.

CONFIGURATION

yamm utilise un fichier de configuration nommé $HOME/.yadm/config. Ce fichier utilise le même format
as git-config(1). Vous pouvez également contrôler le contenu du fichier de configuration via le
yamm config commande (qui fonctionne exactement comme git-config). Par exemple, pour désactiver
alternatives, vous pouvez exécuter la commande :

yadm config yadm.auto-alt faux

Voici la liste complète des configurations prises en charge :

yadm.auto-alt
Désactivez le lien automatique décrit dans la section ALTERNATIVES. Si désactivé,
tu peux toujours courir yamm alt manuellement pour créer les liens alternatifs. Cette fonctionnalité est
activé par défaut.

yadm.auto-perms
Désactivez les modifications automatiques des autorisations décrites dans la section AUTORISATIONS. Si
désactivé, vous pouvez toujours exécuter yamm permanentes manuellement pour mettre à jour les autorisations. Cette
fonction est activée par défaut.

yadm.ssh-perms
Désactiver les modifications d'autorisation pour $ACCUEIL/.ssh/*. Cette fonctionnalité est activée par
défaut.

yadm.gpg-perms
Désactiver les modifications d'autorisation pour $HOME/.gnupg/*. Cette fonctionnalité est activée par
défaut.

SUPPLÉANTS

Lors de la gestion d'un ensemble de fichiers sur différents systèmes, il peut être utile d'avoir un
manière automatisée de choisir une version alternative d'un fichier pour un système d'exploitation différent,
hôte ou utilisateur. yamm implémente une fonctionnalité qui créera automatiquement un lien symbolique
à la version appropriée d'un fichier, tant que vous suivez une convention de nommage spécifique.
yamm peut détecter les fichiers dont les noms se terminent par :

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

S'il y a des fichiers gérés par yammréférentiel qui correspond à cette convention de nommage,
des liens symboliques seront créés pour la version la plus appropriée. C'est peut-être mieux
démontré par l'exemple. Supposons que les fichiers suivants sont gérés par yammle référentiel :

- $HOME/chemin/exemple.txt##
- $HOME/chemin/exemple.txt##Darwin
- $HOME/chemin/exemple.txt##Darwin.host1
- $HOME/chemin/exemple.txt##Darwin.host2
- $HOME/chemin/exemple.txt##Linux
- $HOME/chemin/exemple.txt##Linux.host1
- $HOME/chemin/exemple.txt##Linux.host2

Si vous utilisez un Macbook nommé "host2", yamm va créer un lien symbolique qui ressemble à
ce:

$HOME/chemin/exemple.txt -> $HOME/chemin/exemple.txt##Darwin.host2

Cependant, sur un autre Mackbook nommé "host3", yamm va créer un lien symbolique qui ressemble
comme ça:

$HOME/chemin/exemple.txt -> $HOME/chemin/exemple.txt##Darwin

Étant donné que le nom d'hôte ne correspond à aucun des fichiers gérés, la version la plus générique est
choisi.

S'il s'exécute sur un serveur Linux nommé "host4", le lien sera :

$HOME/chemin/exemple.txt -> $HOME/chemin/exemple.txt##Linux

En cas d'exécution sur un serveur Solaris, le lien utilise la version par défaut « ## » :

$HOME/chemin/exemple.txt -> $HOME/chemin/exemple.txt##

Si aucune version "##" n'existe et qu'aucun fichier ne correspond au système d'exploitation/nom d'hôte/utilisateur actuel, alors aucun lien
sera créé.

Le système d'exploitation est déterminé en exécutant ton nom -s, HOSTNAME en exécutant nom d'hôte -s, et USER en exécutant
id -u -n. yamm créera automatiquement ces liens par défaut. Cela peut être désactivé
en utilisant l' yadm.auto-alt configuration. Même s'ils sont désactivés, les liens peuvent être créés manuellement par
Running yamm alt.

ENCRYPTION

Il peut être utile de gérer des fichiers confidentiels, comme des clés SSH ou GPG, sur plusieurs
systèmes. Cependant, cela mettrait les données en texte brut dans un référentiel Git, qui souvent
réside sur un système public. yamm implémente une fonctionnalité qui peut faciliter le chiffrement
et décrypter un ensemble de fichiers afin que la version cryptée puisse être conservée dans Git
dépôt. Cette fonction ne fonctionnera que si le gpg(1) la commande est disponible.

Pour utiliser cette fonction, une liste de modèles doit être créée et enregistrée sous $HOME/.yadm/chiffrer.
Cette liste de modèles doit être relative à la configuration arbre de travail (Généralement $ ACCUEIL). Pour L
Exemple:

.ssh/*.clé
.gnupg/*.gpg

La yamm crypter La commande trouvera tous les fichiers correspondant aux modèles et demandera un
le mot de passe. Une fois le mot de passe confirmé, les fichiers correspondants seront cryptés et enregistrés sous
$HOME/.yadm/fichiers.gpg. Les patterns et files.gpg doivent être ajoutés au yamm dépôt
ils sont donc disponibles sur plusieurs systèmes.

Pour décrypter ces fichiers plus tard, ou sur un autre système, exécutez yamm décrypter et fournir le
mot de passe correct. Une fois les fichiers décryptés, les autorisations sont automatiquement mises à jour comme
décrit dans la section AUTORISATIONS.

REMARQUE: Il est recommandé d'utiliser un référentiel privé lors de la conservation de fichiers confidentiels,
même s'ils sont cryptés.

PERMISSIONS

Lorsque les fichiers sont extraits d'un référentiel Git, leurs autorisations initiales dépendent
sur l'umask de l'utilisateur. Cela peut entraîner des fichiers confidentiels avec des autorisations laxistes.

Pour éviter cela, yamm mettra automatiquement à jour les autorisations des fichiers confidentiels.
Les autorisations « groupe » et « autres » seront supprimées des fichiers suivants :

- $HOME/.yadm/fichiers.gpg

- Tous les fichiers correspondant aux modèles dans $HOME/.yadm/chiffrer

- Le répertoire et les fichiers SSH, .ssh/*

- Le répertoire et les fichiers GPG, .gnupg/*

yamm mettra automatiquement à jour les autorisations par défaut. Ceci peut être désactivé en utilisant le
yadm.auto-perms configuration. Même si désactivées, les autorisations peuvent être mises à jour manuellement par
Running yamm permanentes. Le traitement du répertoire SSH peut être désactivé à l'aide de la yadm.ssh-perms
configuration.

Utiliser yadm en ligne à l'aide des services onworks.net