yadm: en línea en la nube

PROGRAMA:

NOMBRE

yadm: otro administrador de archivos de puntos

SINOPSIS

Yadm comando [opciones]

Yadm git-comando-o-alias [opciones]

Yadm en eso [-f] [-w directorio]

Yadm clonar url [-f] [-w directorio]

Yadm config nombre [propuesta de]

Yadm configuración [-e]

Yadm lista [-a]

Yadm cifrar

Yadm desencriptar [-l]

Yadm alt

Yadm perms

DESCRIPCIÓN

Yadm es una herramienta para administrar una colección de archivos en varias computadoras, usando un
repositorio compartido de Git. Además, Yadm proporciona una función para seleccionar versiones alternativas
de archivos basados ​​en el sistema operativo o el nombre de host. Finalmente, Yadm proporciona la capacidad de
administrar un subconjunto de archivos seguros, que se cifran antes de que se incluyan en el
repositorio.

COMANDOS

comando git or alias-git
Cualquier comando no manejado internamente por Yadm se pasa a través de git(1). git
Los comandos o alias se invocan con el Yadm repositorio gestionado. El trabajo
directorio para los comandos git será el configurado árbol de trabajo (Por lo general $ HOME).

Los archivos de puntos se gestionan mediante el uso estándar git comandos; add, hacer, empuje, recogida , etc.

Los config El comando no se transmite directamente. En su lugar use el gitconfig
comando (ver más abajo).

alt Cree enlaces simbólicos para cualquier archivo administrado que coincida con las reglas de nomenclatura descritas en
la sección ALTERNOS. Por lo general, no es necesario ejecutar este comando, ya que Yadm
procesa automáticamente las alternativas por defecto. Este comportamiento automático puede ser
desactivado estableciendo la configuración yadm.auto-alt a "falso".

clonar url
Clone un repositorio remoto para rastrear archivos de puntos. Después del contenido del control remoto
se ha obtenido el repositorio, una "combinación" de origen / maestro se intenta. Sí hay
hay archivos conflictivos ya presentes en el árbol de trabajo, esta fusión fallará y
en lugar de un "reinicio" de origen / maestro se hará. Depende del usuario resolver
estos conflictos, pero si la acción deseada es tener el contenido en el
repositorio sobrescribe los archivos existentes, luego un "restablecimiento completo" debería realizarse
que:

yadm reset - origen duro / maestro

El repositorio se almacena en $ HOME / .yadm / repo.git. Por defecto, $ HOME se utilizará
como el árbol de trabajo, pero esto se puede anular con el -w . Yadm puede ser
forzado a sobrescribir un repositorio existente proporcionando el -f .

config Este comando gestiona configuraciones para Yadm. Este comando funciona exactamente de la manera
git-config(1) lo hace. Consulte la sección CONFIGURACIÓN para obtener más detalles.

descifrar
Descifre todos los archivos almacenados en $ INICIO / .yadm / files.gpg. Los archivos descifrados serán
relativo al configurado árbol de trabajo (Por lo general $ HOME). Utilizando la -l la opción será
enumerar los archivos almacenados sin extraerlos.

cifrar
Cifre todos los archivos que coincidan con los patrones que se encuentran en $ INICIO / .yadm / encriptar. Consulte las
Sección CIFRADO para más detalles.

gitconfig
Pasar opciones al git config mando. Ya que Yadm ya usa el config comando
para administrar sus propias configuraciones, este comando se proporciona como una forma de cambiar
configuraciones del repositorio gestionadas por Yadm. Un caso útil podría ser
configure el repositorio para que los archivos sin seguimiento se muestren en los comandos de estado. Yadm
configura inicialmente su repositorio para que no se muestren los archivos sin seguimiento. Si tu
desea usar el comportamiento predeterminado de git (para mostrar archivos y directorios sin seguimiento),
puede eliminar esta configuración.

yadm gitconfig --unset status.showUntrackedFiles

ayuda Imprima un resumen de Yadm comandos.

init Inicialice un repositorio nuevo y vacío para rastrear archivos de puntos. El repositorio está almacenado
in $ HOME / .yadm / repo.git. Por defecto, $ HOME será utilizado como el árbol de trabajo, pero esto
se puede anular con el -w . Yadm puede ser forzado a sobrescribir un existente
repositorio proporcionando el -f .

lista Imprima una lista de archivos administrados por Yadm. -a la opción hará que todos los archivos administrados
Encontrarse dentro de la lista. De lo contrario, la lista solo incluirá archivos del actual
directorio o debajo.

perms Actualice los permisos como se describe en la sección PERMISOS. Es usual
innecesario ejecutar este comando, ya que Yadm procesa automáticamente los permisos por
defecto. Este comportamiento automático se puede desactivar configurando la configuración
yadm.auto-perms a "falso".

versión
Imprime la versión de Yadm.

CONFIGURACIÓN

Yadm usa un archivo de configuración llamado $ INICIO / .yadm / config. Este archivo usa el mismo formato
as git-config(1). Además, puede controlar el contenido del archivo de configuración a través del
Yadm config comando (que funciona exactamente como git-config). Por ejemplo, para deshabilitar
alternativos puede ejecutar el comando:

yadm config yadm.auto-alt falso

La siguiente es la lista completa de configuraciones compatibles:

yadm.auto-alt
Desactive la vinculación automática descrita en la sección ALTERNATIVAS. Si está deshabilitado,
todavía puedes correr Yadm alt manualmente para crear los enlaces alternativos. Esta característica es
habilitado por defecto.

yadm.auto-perms
Desactive los cambios automáticos de permisos descritos en la sección PERMISOS. Si
inhabilitado, aún puede ejecutar Yadm perms manualmente para actualizar los permisos. Esta
La función está habilitada de forma predeterminada.

yadm.ssh-perms
Deshabilite los cambios de permiso a $ INICIO / .ssh / *. Esta función está habilitada por
predeterminada.

yadm.gpg-perms
Deshabilite los cambios de permiso a $ INICIO / .gnupg / *. Esta función está habilitada por
predeterminada.

ALTERNOS

Al administrar un conjunto de archivos en diferentes sistemas, puede ser útil tener un
forma automatizada de elegir una versión alternativa de un archivo para un sistema operativo diferente,
host o usuario. Yadm implementa una función que creará automáticamente un enlace simbólico
a la versión apropiada de un archivo, siempre que siga una convención de nomenclatura específica.
Yadm puede detectar archivos con nombres que terminan en:

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

Si hay archivos gestionados por YadmRepositorio que coincida con esta convención de nomenclatura,
Se crearán enlaces simbólicos para la versión más adecuada. Esto puede ser mejor
demostrado con el ejemplo. Suponga que los siguientes archivos son administrados por YadmRepositorio de:

- $ INICIO / ruta / ejemplo.txt ##
- $ INICIO / ruta / ejemplo.txt ## Darwin
- $ INICIO / ruta / ejemplo.txt ## Darwin.host1
- $ INICIO / ruta / ejemplo.txt ## Darwin.host2
- $ INICIO / ruta / ejemplo.txt ## Linux
- $ INICIO / ruta / ejemplo.txt ## Linux.host1
- $ INICIO / ruta / ejemplo.txt ## Linux.host2

Si se ejecuta en una Macbook llamada "host2", Yadm creará un enlace simbólico que se parece a
modo:

$ INICIO / ruta / ejemplo.txt -> $ INICIO / ruta / ejemplo.txt ## Darwin.host2

Sin embargo, en otro Mackbook llamado "host3", Yadm creará un enlace simbólico que se ve
Me gusta esto:

$ INICIO / ruta / ejemplo.txt -> $ INICIO / ruta / ejemplo.txt ## Darwin

Dado que el nombre de host no coincide con ninguno de los archivos administrados, la versión más genérica es
elegido.

Si se ejecuta en un servidor Linux llamado "host4", el enlace será:

$ INICIO / ruta / ejemplo.txt -> $ HOME / ruta / ejemplo.txt ## Linux

Si se ejecuta en un servidor Solaris, el enlace usa la versión predeterminada "##":

$ INICIO / ruta / ejemplo.txt -> $ INICIO / ruta / ejemplo.txt ##

Si no existe la versión "##" y ningún archivo coincide con el SO / HOSTNAME / USER actual, no hay vínculo
se creará.

El sistema operativo se determina ejecutando uname -s, HOSTNAME ejecutando hostname -sy USUARIO ejecutando
id -u -n. Yadm creará automáticamente estos enlaces de forma predeterminada. Esto se puede deshabilitar
usando el yadm.auto-alt configuración. Incluso si está deshabilitado, los enlaces se pueden crear manualmente mediante
correr Yadm alt.

ENCRYPTION

Puede ser útil administrar archivos confidenciales, como claves SSH o GPG, en múltiples
sistemas. Sin embargo, hacerlo pondría datos de texto sin formato en un repositorio de Git, que a menudo
reside en un sistema público. Yadm implementa una función que puede facilitar el cifrado
y descifrar un conjunto de archivos para que la versión cifrada se pueda mantener en Git
repositorio. Esta función solo funcionará si el gpg(1) comando está disponible.

Para utilizar esta función, se debe crear una lista de patrones y guardarla como $ INICIO / .yadm / encriptar.
Esta lista de patrones debe ser relativa a la configurada árbol de trabajo (Por lo general $ HOME). por
ejemplo:

.ssh / *. clave
.gnupg / *. gpg

Los Yadm cifrar El comando encontrará todos los archivos que coincidan con los patrones y solicitará un
contraseña. Una vez que se haya confirmado una contraseña, los archivos coincidentes se cifrarán y guardarán como
$ INICIO / .yadm / files.gpg. Los patrones y archivos.gpg deben agregarse al Yadm repositorio
por lo que están disponibles en varios sistemas.

Para descifrar estos archivos más tarde, o en otro sistema, ejecute Yadm descifrar y proporcionar el
contraseña correcta. Una vez descifrados los archivos, los permisos se actualizan automáticamente como
descrito en la sección PERMISOS.

NOTA: Se recomienda que utilice un repositorio privado cuando mantenga archivos confidenciales,
aunque estén encriptados.

Los permisos

Cuando los archivos se extraen de un repositorio de Git, sus permisos iniciales dependen
en la umask del usuario. Esto puede resultar en archivos confidenciales con permisos laxos.

Para prevenir esto, Yadm actualizará automáticamente los permisos de los archivos confidenciales.
Los permisos de "grupo" y "otros" se eliminarán de los siguientes archivos:

- $ INICIO / .yadm / files.gpg

- Todos los archivos coinciden con patrones en $ INICIO / .yadm / encriptar

- El directorio y los archivos SSH, .ssh / *

- El directorio y los archivos de GPG, .gnupg / *

Yadm actualizará automáticamente los permisos de forma predeterminada. Esto se puede desactivar usando el
yadm.auto-perms configuración. Incluso si está deshabilitado, los permisos se pueden actualizar manualmente
correr Yadm perms. El procesamiento del directorio SSH se puede deshabilitar usando el yadm.ssh-perms
configuración.

Use yadm en línea usando los servicios de onworks.net