Congurar un proyecto con Git - WikiSalud

http://wiki.salud.gob.sv/mediawiki/index.php?titl...

Congurar un proyecto con Git

De WikiSalud

Contenido
1
2
3
4
5

Generar clave id_rsa.pub

Instalacin de Git
Conguracin de Git
Clonar proyecto vaco para crear la conrmacin inicial
Clonar proyecto Symfony congurado previamente
5.1 Modicaciones para hacer funcionar un proyecto Symfony
5.2 Conrmacin inicial en la nueva rama
6 Creando proyecto NetBeans

Generar clave id_rsa.pub

Para conectarse al servidor Git del MINSAL se realizar por conexin ssh. Lo primero que debe realizarse es la comprobacin de la llave id_rsa.pub, como
usuario normal ejecutar la siguiente sentencia.
ls .ssh

Pueden resultar dos opciones:

Que no encuentre la carpeta y genere el siguiente mensaje:

Que muestre el contenido de la carpeta, lo que indica que no debe de realizar los siguientes pasos.
La llave id_rsa.pub es el identicador de la clave RSA pblica que permite conectarse va shh sin escribir contrasea mientras el equipo que permita la
conexin se le halla establecido esta clave pblica.
Para poder generar tanto la clave pblica y privada se debe de ejecutar en consola como usuario normal
ssh-keygen -t rsa

Lo primero que pregunta es el lugar en donde se quieren crear estas llaves. Por defecto se colocar en el home del usuario que esta generando dichas
llaves. Como se muestra en la siguiente gura:

Luego pedir que se ingrese una contrasea para la conexin; en este caso no le daremos contrasea as que presionamos enter tanto para la peticin como
para la conrmacin.

A continuacin se realizar la revisin del archivo id_rsa.pub, para ello ejecutar la siguiente sentencia en la consola:
cat .ssh/id_rsa.pub

Deber aparecer algo similiar a la imagen que se presenta a continuacin:

Y deber aparecer una secuencia de letras, numeros y simbolos parecidos a los que se muestran en la imagen anterior. Ahora se debe cambiar el nombre de
la maquina y del usuario que aparecen en este archivo, que es el que se representa Usuario@Maquina; cabiar dicho nombre por un correo.

1 of 8

09/10/14 10:33

Congurar un proyecto con Git - WikiSalud

http://wiki.salud.gob.sv/mediawiki/index.php?titl...

Luego de guardar los cambios al archivo, enviar este archivo al administrador de los servidores para que este pueda agregar nuestra llave y nos permita
escribir en dicho servidor.

Instalacin de Git
Vericar que se tienen los repositorios y el sistema actualizado. Luego, como usuario root ejecutar la siguiente instruccin.
aptitude install git kdiff3 qgit

Conguracin de Git
Para congurar el usuario git, como usuario normal escribir en consola:
git
git
git
git
git

config
config
config
config
config

--global
--global
--global
--global
--global

user.name "Nombre de la persona"

user.email correoElectronico
color.ui true
merge.tool kdiff3
core.editor vim # Slo en el caso que se desee que VIM sea el editor predeterminado.

Para estar seguro de lo que se agrego ejecutar:

git config --list

Clonar proyecto vaco para crear la conrmacin inicial

El administrador del proyecto debe de haber creado previamente un proyecto git vaco sin ningn archivo; ahora se debe clonar dicho proyecto en el
directorio en el que se quiere guardar este proyecto. Ejecutar desde consola:
git clone git@git.salud.gob.sv:nombreProyecto.git

Crear el .gitignore para excluir archivos como la conexin a la base de datos, cache, logs, por mencionar algunos. Si es un proyecto Symfony se puede
utilizar el siguiente archivo .gitignore:
# Archivos de respaldo
*~
.*.kate-swp #kate
.*.swp #VIM
# Archivo de configuracin de la personalizacin del comportamiento del directorio para KDE
.directory
# Bootstrap
app/bootstrap*
# Directorios de Symfony
vendor/*
*/logs/*
*/cache/*
web/uploads/*
web/bundles/*
# Archivos de configuracin
app/config/parameters.ini
app/config/parameters.yml
#Carpeta de configuracin del proyecto de NetBeans
nbproject/

Crear el archivo README para explicar que fue lo que se ignor y algunas recomendaciones de ciertos archivos que han sido ignorados. Adems, este
archivo debe tener toda la informacin del proyecto y pasos necesarios para ejecutar el proyecto correctamente; por tanto, debe comenzar con una
descripcin sustancial del sistema/proyecto, los paquetes que se deben instalar para su correcto funcionamiento, las conguraciones que se deben
realizar, etc.
Ejecutar el siguiente comando:
git status

Debe mostrar un texto como se muestra a continuacin, donde especica que esta en la rama master y que es la conrmacin inicial.

Copiar todos los archivos relacionados al proyecto que se pretende subir al servidor git.
Dar seguimiento a todos los archivos copiados dentro de la carpeta; para ello ejecutar
git add --all

Para la conrmacin inicial ejecutar lo siguiente:

git commit -a

Lo cual abrir el editor congurado, para este caso, vi/vim. Si no se ha congurado un editor para Git, se utilizar el editor predeterminado del sistema. En
algunos casos ser nano.
En el mensaje de conrmacin colocar una breve descripcin del sistema, las caractersticas que tiene y cualquier otra informacin adicional que pueda ser
til.
Para subir los cambios al servidor se necesita saber el remoto autorizado para realizar esta accin; para saber eso, ejecutar:
git remote -v

2 of 8

09/10/14 10:33

Congurar un proyecto con Git - WikiSalud

http://wiki.salud.gob.sv/mediawiki/index.php?titl...

Al observar las lneas que se encuentran entre el recuadro rojo, se puede observar que el nombre del remoto es origin y nos indica que para modicar el
servidor se puede hacer mediante el fetch o el push.
Para subir los cambios al servidor se har en la rama master, ejecutando la siguiente sentencia:
git push origin master

Al revisar el servidor git deber aparecer el proyecto git con su primera conrmacin en la rama master.

Clonar proyecto Symfony congurado previamente

Para clonar el proyecto capacitacion/symfony.git utilizado en las capacitaciones, colocarse en el directorio en donde se quiere clonar el proyecto.
Nota: Para seguir con el ejemplo de la capacitacin colocarse en NetBeansProjects/

Ejecutar la siguiente sentencia:

git clone git@git.salud.gob.sv:capacitaciones/symfony.git

Si es la primera vez que se clona un proyecto desde el servidor Git, aparecer los siguiente:

En donde pregunta que si se esta seguro de realizar esa conexin via ssh. Responder escribiendo yes, luego de esto descargar el servidor tal y como se
encuentra en el momento de la clonacin.

Modicaciones para hacer funcionar un proyecto Symfony

Vericar si se tiene el archivo composer.phar; si no se tiene, se deben realizar los siguientes pasos:

Como usuario root instalar el paquete curl.

aptitude install curl

Si se tiene Debian Squeeze, es necesario realizar la siguiente conguracin de suhosin. Como usuario root editar el archivo /etc/php5/cli/conf.d
/suhosin.ini, cambiando:
;suhosin.executor.include.whitelist =

Por:
suhosin.executor.include.whitelist = phar

Como usuario normal, se crear una nueva rama y se activar para trabajar en ella. Ejecutar:
git checkout -b nombreRama

Para asegurarse que se esta en la rama correcta ejecutar:

git branch

Lo que se encuentra en color verde con un * es la rama en la que se est trabajando

Como usuario normal ejecutar lo siguiente:

curl -s https://getcomposer.org/installer | php

La sentencia anterior lo que hace es descargar el composer.phar, luego de ejecutar la sentencia deber generar el archivo:

3 of 8

09/10/14 10:33

Congurar un proyecto con Git - WikiSalud

http://wiki.salud.gob.sv/mediawiki/index.php?titl...

Ahora se procede a crear el parameters.yml en el directorio app/cong; ya que este archivo al haber sido ignorado no es copiado con el clonar el
proyecto. La estructura del archivo parameters.yml es la siguiente:
parameters:
database_driver: pdo_pgsql
database_host: nombreHost
database_port: ''
database_name: nombreBase
database_user: usuarioBase
database_password: contraseaBase
mailer_transport: smtp
mailer_host: localhost
mailer_user: null
mailer_password: null
locale: en
secret: Esta-clave-debe-generarse-como-se-describe-a-continuacin
database_path: null

Para generar una cadena de caracteres para usar como secret ejecutar lo siguiente como usuario normal:
mktemp |sha1sum

Aparecer una cadena como la que se muestra a continuacin:

21d0fdeb3ba911c8af21ebef790241c5664347c1

Ntese que al nal hay un espacio y un guin, esto no se usar como parte del secret. Por tanto, el secret sera
21d0fdeb3ba911c8af21ebef790241c5664347c1
Actualizar el kernel de Symfony para que nalmente se pueda acceder al sitio. Ejecutar:
php composer.phar install

Al terminar de descargar todos los archivos necesarios, deber aparecer en la consola algo similar a la imagen que se muestra a continuacin:

.
Aplicar las acl al directorio cache y logs:
setfacl -R -m u:www-data:rwx -m u:`whoami`:rwx app/cache/ app/logs/
setfacl -dR -m u:www-data:rwx -m u:`whoami`:rwx app/cache/ app/logs/
(Vase: Configuracin de ACL)

Probar symfony.localhost/app_dev.php
Nota: para realizar la prueba con la URL, tener en cuenta que el virtual host este en la IP 127.0.0.4 sino se

4 of 8

debe cambiar dicha direccin en el archivo app_dev.php

09/10/14 10:33

Congurar un proyecto con Git - WikiSalud

http://wiki.salud.gob.sv/mediawiki/index.php?titl...

.
En caso que se tenga el archivo composer.phar no se debe ejecutar la sentencia:
curl -s https://getcomposer.org/installer | php

Conrmacin inicial en la nueva rama

Luego de hacer todos los pasos del tem anterior, se procede a subir los cambios de la nueva rama creada. Para ello se debe estar seguro que se
encuentra en la nueva rama as que ejecutar:
git branch

Dar seguimiento a todos los archivos que se han creado y realizar la conrmacin inicial en la rama. Se debe agregar un mensaje descriptivo de la
utilidad que tendr la rama, por ejemplo, si es una rama de desarrollo, la rama de trabajo de un desarrollador, etc. Esto se hace con las sentencias:
git add --all
git commit -a

Asegurarse que el nombre del remoto que se tiene congurado para el proyecto, con la sentencia:
git remote -v

Subir los archivos al servidor con la siguiente sentencia:

git push origin prueba

Creando proyecto NetBeans

Al crear el archivo .gitignore de un proyecto Symfony con el IDE de desarrollo NetBeans se deben ignorar los siguientes archivos:
# Archivos de respaldo
*~
.*.kate-swp #kate
.*.swp #VIM
# Archivo de configuracin de la personalizacin del comportamiento del directorio para KDE
.directory
# Bootstrap
app/bootstrap*
# Directorios de Symfony
vendor/*

5 of 8

09/10/14 10:33

Congurar un proyecto con Git - WikiSalud

http://wiki.salud.gob.sv/mediawiki/index.php?titl...

*/logs/*
*/cache/*
web/uploads/*
web/bundles/*
# Archivos de configuracin
app/config/parameters.ini
app/config/parameters.yml
# Carpeta nbproject de NetBeans
nbproject/

Como se observa en las lneas anterior se ignora el directorio nbproject/, entonces para que NetBeans reconozca este proyecto como un proyecto NetBeans
se procede a crear un nuevo proyecto pero con la opcin PHP Aplication with Existing Source .

Luego seleccionar el origen del proyecto presionando el botn Browse..

Al seleccionar el proyecto aparecer la ruta en la siguiente ventana:

6 of 8

09/10/14 10:33

Congurar un proyecto con Git - WikiSalud

http://wiki.salud.gob.sv/mediawiki/index.php?titl...

En la siguiente ventana congurar la URL de prueba, en este caso es http://symfony.localhost/app_dev.php

Al presionar Finish, se crear el proyecto.

7 of 8

09/10/14 10:33

Congurar un proyecto con Git - WikiSalud

http://wiki.salud.gob.sv/mediawiki/index.php?titl...

Como se puede observar, justo abajo del nombre del proyecto aparece un cilindro azul; este cilindro indica que se han hecho modicaciones al proyecto git.
Se deben tomar las siguientes consideraciones a la hora de realizar cambios al proyecto:
Todos los archivos que aparezcan en color VERDE son archivos que han sigo agregados sin haberlos conrmado.
Todos los archivos que aparezcan en color AZUL son archivos que fueron creados desde el proyecto pero su estructura ha cambiado.
Obtenido de "http://wiki.salud.gob.sv/wiki/Congurar_un_proyecto_con_Git"
Categoras: DTIC | DTIC Desarrollo
Esta pgina fue modicada por ltima vez el 23 sep 2014, a las 21:23.
El contenido est disponible bajo los trminos de la Attribution-ShareAlike 3.0 Unported.

8 of 8

09/10/14 10:33