¿Qué tal les parece?

Configuración

# Abre la configuración global ~/.gitconfig en el editor predeterminado
# para modificar las opciones
git config -e --global

# Establece el nombre y correo electrónico para los mensajes de commit
git config --global user.name "John Doe"
git config --global user.email "johndoe@example.com"

# Muestra todas las opciones de configuración.
git config --list

# Muestra la salida de los comandos con colores
git config --global color.diff auto
git config --global color.status auto
git config --global color.branch auto

GIT_AUTHOR_NAME, GIT_COMMITTER_NAME: Variables de entorno para modificar el nombre completo del committer (sobreescribe la configuración especificada a través de git config).

GIT_AUTHOR_EMAIL, GIT_COMMITTER_EMAIL: Variables de entorno para modificar el correo del committer (sobreescribe la configuración especificada a través de git config).

Inicializar repositorio

# Inicializa el repositorio git en la carpeta actual
git init

# Inicializa el repositorio para ser utilizado como servidor
git init --bare

Añadir/Eliminar archivos

# Agrega archivos al área de versionamiento para ser incluidos
# en el próximo commit
git add [ARCHIVO1] [ARCHIVO2] [ARCHIVO3] ...
git stage [ARCHIVO1] [ARCHIVO2] [ARCHIVO3] ...
# Ejemplos:
# git add archivo.php
# git add *.py

# Agrega carpetas al área de versionamiento para ser incluidos
# en el próximo commit
git add [CARPETA]
git stage [CARPETA]
# Ejemplos:
# git add .
# git add documentos/

# Muestra un modo interactivo para seleccionar las líneas de código
# que se deben agregar al área de versionamiento
git add -p
git stage --patch

# Muestra un modo interactivo para selecionar los archivos
# a incluir en el área de versionamiento
git add -i
git stage --interactive

# Remueve archivos del sistema de archivos y de la base de datos
git rm [ARCHIVO1] [ARCHIVO2] [ARCHIVO3] ...

# Remueve archivos sólo de la base de datos
git rm --cached [ARCHIVO1] [ARCHIVO2] [ARCHIVO3] ...

# Remueve archivos de la base de datos que hayan sido removidos del
# sistema de archivos (con rm, por ejemplo)
git rm $( git ls-files --deleted )

Registrar cambios

# Registra los cambios del área de versionamiento de los archivos
# -m especifica el mensaje descriptivo de los cambios
git commit [ARCHIVO1] [ARCHIVO2] [ARCHIVO3] ... [-m "MENSAJE"]

# Regista todos los cambios en el área de versionamiento
git commit -a

# Registra los cambios en modo verbose
git commit -v

# Permite corregir el mensaje del último commit
git commit --amend
 
# Permite corregir el mensaje del último commit incluyendo los cambios hechos a los archivos
git commit --amend [ARCHIVO1] [ARCHIVO2] [ARCHIVO3] ...

Información

# Muestra un resumen de todos los cambios realizados desde
# el último commit
git diff
 
# Muestra un resumen de los cambios realizados a un [ARCHIVO]
# en particular desde el último commit
git diff -- [ARCHIVO]
 
# Muestra los cambios versionados pero que no se les ha hecho commit
# (staging area)
git diff --cached

# Muestra el estado del versionamiento: archivos añadidos al área de
# versionamiento, archivos versionados con cambios y archivos sin versionar.
git status
 
# Muestra el registro de los commits hechos hasta el momento
git log
 
# Muestra el registro con los diffs completos en cada commit
git log -p
 
# Muestra el registro con colores
git log --color
 
# Muestra el registro en forma de gráfico
git log --graph
 
# Muestra el registro con la información de los tags
git log --decorate
 
# Muestra el registro con un resumen de los cambios hechos
# en cada commit
git log --stat
 
# Muestra los commits hechos por un autor en específico
git log --author=name@mail.com
 
# Muestra los commits hechos después de la fecha MM DD YYYY
git log --after="MM DD YYYY"
 
# Muestra los commits hechos antes de la fecha MM DD YYYY
git log --before="MM DD YYYY"
 
# Muestra los commits que han sido fusiones de ramas
git log --merges
 
# Muestra los commits en formato de una línea
git log --pretty=oneline
 
# Muestra los commits en formato:
git log --pretty=format:"%an %ad %h %s"
 
# Muestra los commits entre un rango de commits
git log [COMMIT]..[COMMIT]

# Muestra los commits que afectaron un [ARCHIVO], los más recientes primero
git whatchanged [ARCHIVO]

# Muestra los cambios (diff) introducidos en un commit específico
git show [COMMIT]

# Muestra los autores de cada línea en un archivo
git blame [ARCHIVO]
 
# Muestra los autores de cada línea en un archivo para un [COMMIT] específico
git blame [ARCHIVO] [COMMIT]

# Muestra una interfaz gráfica para git blame
# (necesita la instalación del paquete git-gui)
git gui blame [ARCHIVO]

# Muestra todos los archivos versionados
git ls-files

# Muestra todos los tags existentes en el repositorio remoto
git ls-remote [REMOTE]

Ramas, Fusiones y Etiquetas

# Muestra las ramas locales
git branch
 
# Muestra las ramas remotas
git branch -r
 
# Muestra las ramas locales y remotas
git branch -a

# Crea una [RAMA-NUEVA] a partir de la rama actual
git branch [RAMA-NUEVA]
 
# Crea una [RAMA-NUEVA] a partir de una [RAMA-EXISTENTE]
git branch [RAMA-NUEVA] [RAMA-EXISTENTE]

# Crea una [RAMA-NUEVA] en el [REPOSITORIO] a partir de una [RAMA-EXISTENTE]
git push [REPOSITORIO] [RAMA-EXISTENTE]:refs/heads/[RAMA-NUEVA]

# Crea una [RAMA-NUEVA] configurada para seguir una [RAMA-REMOTA]
git branch --track [RAMA-NUEVA] [RAMA-REMOTA]
# Ejemplo:
# git branch --track development origin/development

# Configura una [RAMA-EXISTENTE] para seguir una [RAMA-REMOTA]
git branch --set-upstream [RAMA-EXISTENTE] [RAMA-REMOTA]

# Elimina una [RAMA]
git branch -d [RAMA]
 
# Elimina una [RAMA] incluso si tiene datos no versionados
git branch -D [RAMA]
 
# Elimina una [RAMA] que fue creada para seguir una [RAMA-REMOTA]
git branch -r -d [RAMA]

# Cambia a la rama [RAMA]
git checkout [RAMA]

# Crea una [RAMA-NUEVA] a partir de una [RAMA-EXISTENTE] y luego se cambia a [RAMA-NUEVA]
git checkout -b [RAMA-NUEVA] [RAMA-EXISTENTE]

# Elimina una [RAMA] del [REPOSITORIO]
git push [REPOSITORIO] :[RAMA]

# Incluye un [ARCHIVO] desde una [RAMA] en la rama actual
git co [RAMA] [ARCHIVO]

# Muestra el contenido de un [ARCHIVO] de una [RAMA] diferente a la actual
git show [RAMA] -- [ARCHIVO]

# Muestra el contenido de un [ARCHIVO] en un [COMMIT] específico
git show [COMMIT]:[ARCHIVO]

# Fusiona una [RAMA] con la rama actual
git merge [RAMA]

# Fusiona una [RAMA] pero no hace commit
git merge [RAMA] --no-commit

# Fusiona una [RAMA] y en caso de haber conflictos, resolverlos dejando los
# cambios de la rama actual
git merge [RAMA] -X recursive -s ours
 
# Fusiona una [RAMA] y en caso de haber conflictos, resolverlos dejando los
# cambios de [RAMA]
git merge [RAMA] -X recursive -s theirs

# Abre un solucionador de conflictos interactivo en caso de una fusión fallida
git mergetool

# Muestra una lista de todas las etiquetas definidas en el repositorio.
git tag -l

# Crea una etiqueta [TAG] en el último commit
git tag [TAG]

# Elimina una etiqueta [TAG]
git tag -d [TAG]

Compartir

# Clona un repositorio git presente en [URL]
git clone [URL]

# Trae los cambios existentes en el [REPOSITORIO] sin fusionar los cambios
git fetch [REPOSITORIO]

# Fusiona los cambios existentes en el [REPOSITORIO] de la [RAMA]
git pull [REPOSITORIO] [RAMA]

# Envía los cambios de una [RAMA] al [REPOSITORIO]
git push [REPOSITORIO] [RAMA]

# Agrega un repositorio remoto [URL] bajo el pseudónimo [REPOSITORIO]
git remote add [REPOSITORIO] [URL]

# Muestra la información referente a un [REPOSITORIO]
git remote show [REPOSITORIO]

# Elimina un [REPOSITORIO] de la lista de repositorios disponibles
git remote rm [REPOSITORIO]

# Elimina una [RAMA] en el [REPOSITORIO]
git push [REPOSITORIO] :ref/heads/[RAMA]

# Crea una [RAMA] en el [REPOSITORIO]
git push [REPOSITORIO] [REPOSITORIO]:ref/heads/[RAMA]

# Reemplaza [RAMA] con [NUEVARAMA] en el [REPOSITORIO]
git push [REPOSITORIO] +[RAMA]:[NUEVARAMA]

Corrigiendo errores y manipulando historial

# Revierte un [COMMIT]
git revert [COMMIT]

# Trae el [ARCHIVO] desde un [COMMIT] previo al sistema de archivos actual
git checkout [COMMIT] [ARCHIVO]

# Remueve los archivos del area de versionamiento para el próximo commit
git reset HEAD [ARCHIVO1] [ARCHIVO2] [ARCHIVO3] ...

# Devuelve el estado del sistema de archivos hasta el último commit
git reset --hard

# Devuelve hasta el último commit, pero deja los archivos en el área de versionamiento
git reset --soft

# Trae el código de un [TAG] al área de versionamiento
git co [TAG]

# Obtiene los cambios introducidos por [COMMIT] y hace un nuevo commit
git cherry-pick [COMMIT]

# Permite fusionar los N últimos commits en uno solo
git rebase --interactive HEAD~N

Guardado temporal

# Guarda las modificaciones sin registrar en una base de datos temporal
# Permite realizar otras operaciones (git pull, git checkout, etc.) sin
# necesidad de hacer commit de los cambios
git stash
git stash save

# Restaura los cambios guardados en el último stash
git stash apply

# Restaura los cambios guardados en el último stash y lo remueve de la lista
git stash pop

# Muestra una lista de todos los stashes
git stash list

# Muestra el contenido de los cambios guardados en un [STASH]
git stash show [STASH] -p

# Elimina un [STASH]
git stash drop [STASH]

# Elimina todos los stashes
git stash clear

Submódulos

# Agrega el repositorio [URL] como submódulo en la [RUTA] dentro de
# un repositorio git existente
git add submodule [URL] [RUTA]

# Actualiza [e inicializa] el estado de los submódulos de un super-repo
git submodule update [--init]

# Ejecuta un [COMANDO] en cada uno de los submódulos
git submodulo foreach [COMANDO]

Eliminación de submódulos

1. Eliminar la línea correspondiente del archivo .gitmodules
2. Eliminar la sección pertinente de .git/config
3. Ejecutar git rm --cached [RUTA-AL-SUBMÓDULO] (sin barra al final)
4. Hacer commit y eliminar los archivos del submódulo

Actualización de submódulos

cd [RUTA-AL-SUBMODULO]
git pull [REPOSITORIO] [RAMA]
cd [RUTA-AL-SUPER-REPO]
git commit -a

Trabajando con parches

# Genera un parche a partir del último commit
git format-patch HEAD^

# Genera un parche a partir de un rango de commits
git format-patch [COMMIT]̣̣^..[COMMIT]

# Aplica un [PARCHE] generado por git format-patch
git am [PARCHE]

# Genera un [PARCHE] a partir de las diferencias entre el último commit
# y el estado actual (con formato compatible con la herramienta patch)
git diff --no-prefix > [PARCHE]

Archivos comprimidos

# Genera un archivo tar en [RUTA]
git archive master | tar -x -C [RUTA]

# Genera un archivo source.tar.bz2
git archive master | bzip2 > source.tar.bz2

# Genera un archivo source.zip del último commit
git archive -o source.zip HEAD

# Genera un archivo source.tar.gz a partir del tag [TAG]
git archive -o source.tar.gz [TAG]

Hacks

# Optimizar el repositorio para disminuir el tamaño
git gc --aggressive

# Comprime al máximo el repositorio
git repack -a -d --window=50 --depth=50 --window-memory=1024m

# Ignora [ARCHIVO] del versionamiento
echo "[ARCHIVO]" >> .gitignore

¡Espero que les sirva!

Durante sus ensayos, produjeron piezas interesantes que ahora traigo para ustedes en estas grabaciones demo, grabadas de un popular cassette de la época:

Además, los parches hacen que el desarrollo sea más fácil, porque en lugar de proporcionar un archivo completo, posiblemente compuesto por cientos o miles de líneas de código, el parche incluye (o remueve) sólo los cambios exactos que se hicieron. Esto tiene dos ventajas: ayuda a comprender más rápidamente el cambio que se está presentando y seguirá siendo válido en el futuro siempre y cuando no se cambien las líneas afectadas.

En la actualidad, un parche puede ser generado por diferentes herramientas, y puede tener varios formatos. Sin embargo, podemos decir que la mayoría tiene un aspecto parecido al que se presenta a continuación:

diff --git a/token_example/token_example.tokens.inc b/token_example/token_example.tokens.inc
index 585dcea..b06d9d6 100644
--- a/token_example/token_example.tokens.inc
+++ b/token_example/token_example.tokens.inc
@@ -13,8 +13,8 @@ function token_example_token_info() {
   // second is the user's default text format, which is itself a 'format' token
   // type so it can be used directly.
 
-  // This is a comment in the original file. It will be removed when the patch is applied.
+ // And here are lines we added when we were editing the file.
+ // They will replace the line above when the patch is applied.
$info['types']['format'] = array(
     'name' => t('Text formats'),
     'description' => t('Tokens related to text formats.'),

Para este ejemplo, en la parte superior se especifica el nombre del archivo que está siendo afectado. Las líneas adicionales se muestran con un ‘+‘, las líneas eliminadas se muestran con un ‘-‘, y las líneas sustituidas muestran como la antigua línea se elimina y se añade la nueva. Un mismo parche puede contener cambios a uno o más archivos.

Primeros pasos

Para efectos de este tutorial, necesitaremos instalar git para poder realizar las prácticas. En un Terminal de Root (Aplicaciones > Accesorios > Terminal de Root) ejecutamos:

aptitude install git-core diffutils quilt

Bien, supongamos que deseas colaborar con el Proyecto Aguilas para corregir un error presente en alguno de sus archivos. Lo primero que debemos hacer es bajar el código fuente de la aplicación. La forma de realizar esta tarea dependerá de la forma en que el autor distribuye el código fuente; es decir, podrías tener que descargar un archivo comprimido, clonarlo desde un repositorio de versionamiento o cualquier otra cosa. No te preocupes: un proyecto de código abierto siempre informa como se debe hacer para descargar el código fuente.

Para el caso de Aguilas, clonaremos el repositorio git con el siguiente comando en un Terminal de Usuario (Aplicaciones > Accesorios > Terminal):

git clone https://github.com/HuntingBears/aguilas.git

Normalmente, deberás descargar el código una sola vez. Sin embargo, siempre que desees volver a modificar algo, es buena idea “refrescar” (o “halar”) el código para descargar y actualizar posibles cambios. Recuerda que estás trabajando directamente sobre el código que proviene de los desarrolladores. No “refrescar” cada cierto tiempo implicaría trabajar con código desactualizado y posiblemente los parches generados no le servirán a los desarrolladores de la aplicación.

Para “refrescar” el código con git puedes utilizar los comandos que se encuentran más abajo (dentro de la carpeta donde se encuentra el código). Si el autor no utiliza git, deberás preguntarle como hacer para mantener actualizado tu código.

git checkout development
git pull origin development

development es la rama de desarrollo para el Proyecto Aguilas y contiene los cambios más recientes.

A continuación mostraremos tres formas de hacer parches para que tu decidas cual se ajusta más a tus gustos/necesidades:

Creando parches con git

Para crear parches con git, el código fuente debe estar versionado con git. Si te has clonado el código de Aguilas como te dijimos en la sección anterior, entonces tu código ya está versionado. En caso de que no esté versionado (por ejemplo si el código se distribuye a través de archivos comprimidos u otros sistemas de versionamiento), puedes versionarlo con los siguientes comandos:

git init
git add .
git commit -a -m "Commit inicial"

Bien, seguidamente crearemos una rama nueva para trabajar los cambios que deseamos hacer. Ejecuta los siguientes comandos:

git branch parche-ejemplo
git checkout parche-ejemplo

Ahora, haremos nuestras modificaciones en la rama que hemos creado. Las modificaciones dependerán mucho de lo que deseas hacer, normalmente uno revisa el sistema de tickets del proyecto para saber en cuales cosas puede ayudar. Para este ejemplo editaremos un solo archivo, pero podrías editar cuantos archivos necesites editar.

Supongamos que vamos a cambiar el autor del proyecto que se especifica en el archivo AUTHORS. Para ello ejecutamos nuestro editor de texto favorito y cambiamos el archivo para que en vez de mostrar esto:

Developers:
 
 * Luis Alejandro Martínez Faneyth (aka HuntingBears)
	- E-Mail: luis@huntingbears.com.ve
	- Blog: http://www.huntingbears.com.ve
	- Twitter/identi.ca: @LuisAlejandro

Muestre lo siguiente:

Developers:
 
 * El Chiguire Bipolar

Seguidamente, registramos los cambios en git:

git add .
git commit -a -m "[MENSAJE REPRESENTATIVO DE LOS CAMBIOS]"

Y estamos listos para generar el parche. El comando que se muestra a continuación, mostrará la diferencia entre la rama original (development) y la rama que hemos creado para los cambios (parche-ejemplo), eso lo escribiremos en un archivo .patch que finalmente es el que mandaremos a los desarrolladores.

git diff development parche-ejemplo > 01-cambiando-authors.patch

Si examinamos el archivo, veremos el contenido del parche.

diff --git a/AUTHORS b/AUTHORS
index 9c21371..6bc709c 100644
--- a/AUTHORS
+++ b/AUTHORS
@@ -1,6 +1,3 @@
 Developers:
 
- * Luis Alejandro Martínez Faneyth (aka HuntingBears)
-       - E-Mail: luis@huntingbears.com.ve
-       - Blog: http://www.huntingbears.com.ve
-       - Twitter/identi.ca: @LuisAlejandro
+ * El Chiguire Bipolar

Creando parches con quilt

Si no deseas utilizar git, puedes usar quilt, una herramienta especialmente diseñada para manejar parches.

Para empezar a trabajar con quilt debemos indicarle una carpeta de trabajo, donde se irán guardando los parches que hagamos. Para este ejemplo le diremos a quilt que utilice una carpeta de nombre “parches”, la cual será relativa a la carpeta del proyecto que estemos editando.

export QUILT_PATCHES="parches"

Seguidamente le diremos a quilt que deseamos crear un nuevo parche con la orden:

quilt new 01-cambiando-authors.patch

Ahora, editaremos el archivo AUTHORS de la misma forma que lo hicimos en la sección anterior, con la diferencia de que lo haremos con el siguiente comando:

quilt edit AUTHORS

Aparecerá un editor de texto que te permitirá cambiar el contenido del archivo. Cuando terminemos, guardamos y cerramos. Es posible editar más archivos con el mismo comando.

Finalmente, actualizamos la base de datos de parches y los “desaplicamos” para que aparezcan en la carpeta parches que especificamos al principio.

quilt refresh
quilt pop -a

Si examinamos el archivo, veremos lo siguiente:

Index: aguilas/AUTHORS
===================================================================
--- aguilas.orig/AUTHORS        2012-02-15 17:23:19.586781243 -0430
+++ aguilas/AUTHORS     2012-02-15 17:26:38.407767118 -0430
@@ -1,6 +1,3 @@
Developers:
 
- * Luis Alejandro Martínez Faneyth (aka HuntingBears)
-       - E-Mail: luis@huntingbears.com.ve
-       - Blog: http://www.huntingbears.com.ve
-       - Twitter/identi.ca: @LuisAlejandro
+ * El Chiguire Bipolar

Creando parches con diff

Si no deseas utilizar git o quilt, puedes usar diff, que es la herramienta básica para mostrar diferencias entre archivos (o grupos de archivos).

Primeramente debes hacer una copia de toda la carpeta que contiene el código:

cp -r aguilas aguilas.miscambios

Luego ingresamos a la carpeta copiada aguilas.miscambios y editamos el archivo AUTHORS con nuestro editor de texto favorito tal cual lo hicimos en los dos casos anteriores.

Para crear el parche 01-cambiando-authors.patch, ejecuta el siguiente comando en la carpeta donde se encuentra el proyecto original y el proyecto copia, es decir, el directorio superior:

diff -Naur aguilas aguilas.miscambios > 01-cambiando-authors.patch

Si examinamos el archivo, veremos lo siguiente:

diff -Naur aguilas/AUTHORS aguilas.miscambios/AUTHORS
--- aguilas/AUTHORS    2012-02-15 17:27:01.507881700 -0430
+++ aguilas.miscambios/AUTHORS    2012-02-15 17:35:27.830392408 -0430
@@ -1,6 +1,3 @@
Developers:
 
- * Luis Alejandro Martínez Faneyth (aka HuntingBears)
-    - E-Mail: luis@huntingbears.com.ve
-    - Blog: http://www.huntingbears.com.ve
-    - Twitter/identi.ca: @LuisAlejandro
+ * El Chiguire Bipolar

Espero que se de utilidad!

Los Administradores de Plataforma tienen un problema recurrente cada vez que les toca elegir cómo manejarán la gestión de sus usuarios en sus entornos de trabajo. El problema usualmente se hace mayor cuando varias aplicaciones forman parte de un mismo proyecto, y se necesita unificar la autenticación de los usuarios para mejorar la experiencia de uso.

Para solventar este problema se han desarrollado extensiones y plugins para las principales aplicaciones web como MediaWiki, Plone, WordPress, Drupal, TRAC, entre otros, que permiten sustituir su propio sistema de autenticación por uno externo basado en LDAP o Active Directory. Lamentablemente, la mayoría de estas extensiones adolecen de la flexibilidad y funcionalidad que un Administrador de Plataforma necesita para gestionar eficientemente los usuarios de sus aplicaciones. Incluso, la mayoría tiene graves problemas con los formatos de lectura y escritura de entradas, sin mencionar que no existe un esquema común entre las mencionadas extensiones, requiriendo un trabajo adicional de adecuación para que todas las aplicaciones hablen el mismo idioma. No existe, hasta ahora, una solución integral y directa al problema.

Es por eso que hoy quiero presentarles la primera versión estable de Aguilas (1.0.1), una aplicación en la que he venido trabajando para solventar el problema de gestión de usuarios en la Plataforma Tecnológica del Proyecto Canaima. Aguilas es una “Aplicación para la Gestión de Usuarios con Interfaz para LDAP Amigable y Segura” que está escrita en PHP, basada en los principios de simplicidad, usabilidad, y elegancia.

Como Administrador de Plataforma, podrás tener una base de datos centralizada con todos los usuarios de tu plataforma, a la cual podrás conectar todos los servicios que necesiten leer la lista de usuarios, teniendo la tranquilidad de que sólo Aguilas estará escribiendo tus usuarios, de forma semánticamente correcta y compatible con la mayoría de las aplicaciones que tienen autenticación con LDAP.

Con Aguilas tus usuarios serán capaces de:

• Crear cuentas de usuario en un servidor LDAP.
• Ver o modificar los atributos de usuario de una cuenta.
• Cambiar o reestablecer la contraseña de una cuenta
• Recordar el nombre de usuario en caso de olvido.
• Eliminar una cuenta de usuario.
• Listar todos los usuarios registrados.
• Buscar usuarios dentro de la base de datos.

¿Te interesa? ¡Sigue leyendo!

Aguilas está desarrollado bajo los principios y valores éticos del Software Libre. El código fuente está licenciado bajo GPL-3, es decir, es público para que lo uses, distribuyas, estudies y modifiques. El Proyecto Aguilas está disponible desde Gitorious, Github y Google Code, desde donde puedes encontrar aún más información.

Aguilas posee una amplia documentación (por ahora sólo en inglés), enfocada en fomentar la formación de una comunidad de desarrolladores que puedan mejorarla con sus aportes. Es una aplicación que pretende desarrollarse bajo un esquema colaborativo internacional, y distribuirse en la mayoría de las principales distribuciones GNU/Linux.

Características

En términos técnicos, podemos decir que Aguilas posee las siguientes características:

• Interfaz web agradable y moderna.
• Configuración asistida.
• Seguridad reforzada contra ataques de inyección SQL.
• Bloqueo de robots y spam mediante el uso de captchas.
• Permite el uso de servidores MYSQL/LDAP locales o remotos.
• Permite la adaptación y creación de nuevos temas visuales. Por defecto se incluye un tema al estilo Canaima y otro al estilo Debian.
• Soporte para encriptación de contraseña con algoritmos MD5, SHA y CRYPT.
• Soporte para conexiones TLS durante la autenticación con LDAP.

Instalación de dependencias

Aguilas requiere la instalación previa de ciertas aplicaciones para su correcto funcionamiento. Dependiendo de la configuración que más se adapte a tus necesidades, es posible que necesites instalar aplicaciones adicionales. Por ejemplo, Aguilas necesita un Servidor MYSQL, un Servidor LDAP y un Agente de Transporte de Correo (MTA). Deberás instalarlos junto con Aguilas sólo si planeas utilizar la misma computadora como servidor local. Es decir, si planeas utilizar servidores remotos, no es necesario instalarlos.

Si estás utilizando Debian o alguna distribución derivada como Canaima o Ubuntu, puedes instalar las dependencias a través de una terminal de root con el siguiente comando:

aptitude install apache2 php5 php5-gd php5-ldap php5-mcrypt php5-mysql php5-suhosin php5-cli que bash gettext python-sphinx icoutils python-docutils libmagickcore-extra imagemagick apache2 mysql-server postfix slapd

Si deseas encontrar mayor información acerca de como configurar Postfix (MTA), puedes echar un vistazo aquí.

Una vez satisfechas las dependencias, Aguilas se puede instalar de varias formas.

Instalar a través de un paquete debian

• Descarga el paquete debian desde el sitio de descargas del Proyecto Aguilas.
• Ejecuta el siguiente comando en una Terminal de Root:

dpkg -i /RUTA/AL/PAQUETE.DEB

• Responde las preguntas que se realizan con respecto a la ubicación de los servidores y las contraseñas de las cuentas administrativas.

Instalar desde el código fuente

•  Descarga el código fuente desde el sitio de descargas del Proyecto Aguilas. El código fuente se distribuye como un archivo comprimido con extensión orig.tar.gz.

• Descomprime el archivo con tu programa favorito. Para este ejemplo utilizaremos la aplicación “tar” desde un terminal de usuario:

tar -xvf /RUTA/AL/PAQUETE.ORIG.TAR.GZ

• En un terminal de usuario, accede a la carpeta recién descomprimida:

cd /RUTA/A/LA/CARPETA

• Luego, debemos configurar las fuentes con el siguiente comando:

make

A continuación se harán las siguientes preguntas para configurar automáticamente:

1. Nombre de la aplicación, por ejemplo: Gestión de Usuarios de la Plataforma Tecnológica
2. La persona o grupo responsable de la gestión de la aplicación, por ejemplo: Administradores de Canaima
3. La dirección de correo electrónico que aparecerá como remitente en todas las operaciones de e-mails a usuarios registrados, por ejemplo: aguilas@debian.org
4. La dirección de correo electrónico que desea utilizar para enviar informes de errores, por ejemplo: admins@debian.org
5. El idioma que desea ver en su solicitud (debe estar disponible en la carpeta “locale/”), por ejemplo: es_ES
6. El tema se aplica a la solicitud (debe estar disponible en la carpeta de temas), por ejemplo: debian
7. La dirección pública de la aplicación, por ejemplo: aguilas.debian.org
8. IP o el dominio del servidor donde se encuentra la base de datos MySQL, por ejemplo: localhost
9. Nombre de la base de datos MySQL (se creará si no existe), por ejemplo: aguilas
10. El usuario con permisos para leer y crear tablas en la base de datos, por ejemplo: root
11. Contraseña para el usuario de MySQL, por ejemplo: 123456
12. IP o el dominio del servidor donde se encuentra el servicio LDAP, por ejemplo: localhost
13. DN con privilegios de lectura y escritura en el servidor LDAP, por ejemplo: cn=admin,dc=nodomain
14. Contraseña para el DN escritor, por ejemplo: 123456
15. DN base para realizar búsquedas e incluir nuevos usuarios, por ejemplo: dc=nodomain

Si necesitas modificar alguno de estos parámetros en el futuro, puedes editar el archivo /usr/share/aguilas/setup/config.php en cualquier momento.

• Finalmente, obtenemos privilegios de superusuario, e instalamos Aguilas:

sudo make install

Contribuir

Nos apasiona ayudar a los usuarios de Aguilas a dar el salto para convertirse en miembros activos de la comunidad, así que hay muchas maneras en que puedes ayudar al desarrollo de Aguilas:

• Informa de los errores y solicita funcionalidades en nuestro sistema de tickets.
• Envia parches o pull requests.
• Únete a la lista de correo de Aguilas y comparte tus ideas sobre cómo mejorar Águilas. Estamos siempre abiertos a sugerencias.
• Mejora la documentación mediante la redacción de artículos nuevos o corrección los existentes.
• Traduce Aguilas a tu idioma local, al unirse a nuestro equipo de traducción.

Eso es todo lo que necesitas saber si te gustaría unirse a la comunidad el desarrollo de Águilas. El resto de la información la puedes leer en la documentación.

Soporte

Si necesitas ayuda, puedes recurrir a alguno de los siguientes medios:

• Documentación.
• Lista de Correo de Aguilas.
• Canal IRC de Aguilas.

Capturas de Pantalla