Ver el código fuente de «Configurar un proyecto con Git»

==Generar clave id_rsa.pub==
Para conectarse al servidor Git del MINSAL se realizará por conexión ssh. Lo primero que debe realizarse es la comprobación de la llave id_rsa.pub, como usuario normal ejecutar la siguiente sentencia. 
<source lang=bash>
ls ./ssh
</source>
Pueden resultar dos opciones:
* Que no encuentre la carpeta y genere el siguiente mensaje:
[[Archivo:PluginSymfony88.png|centro|ls ./ssh]] 

*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 identificador de la clave RSA pública que permite conectarse vía shh sin escribir contraseña mientras el equipo que permita la conexión se le halla establecido esta clave pública.

Para poder generar tanto la clave pública y privada se debe de ejecutar en consola como ''usuario normal''
<source lang=bash>
ssh-keygen -t rsa
</source>

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 figura:
[[Archivo:PluginSymfony91.png|centro|ruta del archivo]] 

Luego pedirá que se ingrese una contraseña para la conexión; en este caso no le daremos contraseña así que presionamos enter tanto para la petición como para la confirmación.
[[Archivo:PluginSymfony92.png|centro|Contraseña ssh]] 

A continuación se realizará la revisión del archivo id_rsa.pub, para ello ejecutar la siguiente sentencia en la consola:
<source lang=bash>
cat .ssh/id_rsa.pub
</source>
Deberá aparecer algo similiar a la imagen que se presenta a continuación:
[[Archivo:PluginSymfony93.png|centro|id_rsa.pub]] 

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.

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.

==Instalación de Git==

Verificar que se tienen los [[Actualizaciones y sources.list|repositorios]] y el sistema actualizado. Luego, como usuario root ejecutar la siguiente instrucción.

<source lang=bash>aptitude install git kdiff3 qgit</source>

==Configuración de Git==
Para configurar el usuario git, como usuario normal escribir en consola:
<source lang=bash>
git config --global user.name “Nombre de la persona”
git config --global user.email correoElectronico
git config --global color.ui true
git config --global merge.tool kdiff3
</source>

Para estar seguro de lo que se agrego ejecutar:
<source lang=bash>
git config --list
</source>

==Clonar proyecto vacío para dar confirmación inicial==
* El administrador del proyecto debe de haber creado previamente un proyecto git vacio sin ningín archivo; ahora se debe clonar dicho proyecto en el directorio en el que se quiere guardar este proyecto. Ejecutar desde consola:
<source lang=bash>
git clone git@git.salud.gob.sv:nombreProyecto.git
</source>

* Crear el ''.gitignore'' para excluir archivos como la conexión a la base de datos, cache, logs, por mencionar algunos. Si es un proyecto Symfony se puede utilizar el siguiente gitignore:
<source lang=bash>
# Archivos de respaldo
*~
 
# Bootstrap
app/bootstrap*
 
# Symfony directories
vendor/*
*/logs/*
*/cache/*
web/uploads/*
web/bundles/*
 
# Configuration files
app/config/parameters.ini
app/config/parameters.yml
 
#Carpeta nbproject de netbeans
nbproject/
</source>
* Crear README para explicar que fue lo que se ignoro y algunas recomendaciones de ciertos archivos que han sigo ignorados. 
* Ejecutar el siguiente comando:
<source lang=bash>
git status 
</source>
Debe mostrar un texto como se muestra a continuación, donde especifica que esta en la rama master y que es la confirmación inicial.
[[Archivo:Git_status.png‎|centro|git branch]] 
* 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
<source lang=bash>
git add --all
</source>
* Para la confirmación inicial ejecutar lo siguiente:
<source lang=bash>
git commit -a -m "Confirmación inicial del proyecto"
</source>
* Para poder subir los cambios al servidor se necesita saber el remoto autorizado para realizar esta acción; para saber eso, ejecutar:
<source lang=bash>
git remote -v 
</source>
[[Archivo:PluginSymfony104.png|centro|gir remote -v]] 
Al observar las lineas que se encuentran entre el recuadro rojo, se puede observar que el nombre del remote es ''' ''origin'' ''' y nos indica que para modificar 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:
<source lang=bash>
git push origin master
</source>
* Al revisar el servidor git deberá aparecer el proyecto git con su primera confirmación en la rama master.

==Clonar proyecto Symfony configurado 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 capacitación colocarse en NetBeansProjects/

Ejecutar la siguiente sentencia:
<source lang=bash>
git clone git@git.salud.gob.sv:capacitaciones/symfony.git
</source>

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

[[Archivo:PluginSymfony105.png|centro|Clonar proyecto]] 

En donde pregunta que si se esta seguro de realizar esa conexión via ssh. Responder escribiendo '''yes''', luego de esto descargará el servidor tal y como se encuentra en el momento de la clonación. 

[[Archivo:PluginSymfony106.png|centro|Clonar proyecto]] 
===Modificaciones para hacer funcionar un proyecto symfony ===
Verificar si se tiene el archivo ''composer.phar''; si no se tiene debe de realizar los siguientes pasos:
[[Archivo:PluginSymfony108.png|centro|ls symfony/]] 
* Como '''usuario root''' instalar el paquete '''curl'''.
<source lang=bash>
aptitude install curl
</source>
* Si se tiene Debian Squeeze, es necesario realizar la siguiente configuración de suhosin. Como '''usuario root''' editar el archivo /etc/php5/cli/conf.d/suhosin.ini, cambiando:
<source lang=bash>
;suhosin.executor.include.whitelist =
</source>
Por: 
<source lang=bash>
suhosin.executor.include.whitelist = phar
</source>
* Como '''usuario normal''', se creará una nueva rama y se activará para trabajar en ello. Ejecutar:
<source lang=bash>
git checkout -b nombreRama
</source>
[[Archivo:PluginSymfony110.png|centro|git checkout]] 
* Para asegurarse que se esta en la rama correcta ejecutar:
<source lang=bash>
git branch
</source>
[[Archivo:PluginSymfony112.png|centro|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:
<source lang=bash>
curl -s https://getcomposer.org/installer | php
</source>
La sentencia anterior lo que hace es descargar el composer.phar, luego de ejecutar la sentencia deberá generar el archivo:
[[Archivo:PluginSymfony109.png|centro|composer.phar]] 

* Ahora se procede a crear el ''parameters.yml'' en el directorio app/config; ya que este archivo al haber sido ignorado no es copiado con el clonado del proyecto. La estructura del parameters.yml es la siguiente:
<source lang=php>
parameters:
    database_driver: pdo_pgsql
    database_host: nombreHost
    database_port: ''
    database_name: nombreBase
    database_user: usuarioBase
    database_password: contraseñaBase
    mailer_transport: smtp
    mailer_host: localhost
    mailer_user: null
    mailer_password: null
    locale: en
    secret: df1ca40cfc425c4f34e654696720435a044b9ca9
    database_path: null
</source>
* Actualizar el kernel de symfony para que finalmente se pueda acceder al sitio. Ejecutar:
<source lang=bash>
php composer.phar install
</source>
[[Archivo:PluginSymfony113.png|centro|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 continuación:
[[Archivo:PluginSymfony114.png|centro|php composer.phar install]].

* Aplicar las acl al directorio cache y logs:
<source lang=bash>
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/
</source>

 (Véase: [[Desarrollo_web_Symfony2#Permisos_a_las_carpetas_cache_y_logs|Configuración 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 cambiar se
 debe cambiar dicha dirección en el archivo app_dev.php
[[Archivo:PluginSymfony115.png|centro|symfony.localhost app/dev.php]].

* En caso que se tenga el archivo ''' ''composer.phar'' ''' no se debe realizar la sentencia: 
<source lang=bash>
curl -s https://getcomposer.org/installer | php
</source>

=== Confirmación 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:
<source lang=bash>
git branch
</source>
[[Archivo:PluginSymfony123.png|centro|git branch]] 

* Poner en seguimiento todos los archivos que se han creado y realizar la confirmación inicial , esto se hace con las sentencias:
<source lang=bash>
git add --all
git commit -a -m "Confirmación Inicial de la rama prueba"
</source>

[[Archivo:PluginSymfony124.png|centro|Seguimiento y confirmación de archivos]] 

*Asegurarse del nombre del remoto que se tiene configurado para el proyecto, con la sentencia:
<source lang=bash>
git remote -v
</source>

* Subir los archivos al servidor con la siguiente sentencia:
<source lang=bash>
git push origin prueba
</source>

[[Archivo:PluginSymfony125.png|centro|Verificar remoto y subir archivos]]

== Creando proyecto Netbeans ==
Al crear el .gitignore de un proyecto Symfony con el IDE de desarrollo NetBeans se deben ignorar los siguientes archivos:
<source lang=bash>
# Archivos de respaldo
*~

# Bootstrap
app/bootstrap*

# Symfony directories
vendor/*
*/logs/*
*/cache/*
web/uploads/*
web/bundles/*

# Configuration files
app/config/parameters.ini
app/config/parameters.yml

#Carpeta nbproject de netbeans
nbproject/
</source>
Como se observa en las lineas anterior se ignora el ''nbproject/'', entonces para que NetBeans reconozca este proyecto como un proyecto netbeans se procede a crear un nuevo proyecto pero con la opción ''' ''PHP Aplication with Existing Source '' '''.

[[Archivo:PluginSymfony116.png|centro|Crear proyecto con una fuente existente]] 

Luego seleccionar el origen del proyecto presionando el botón ''Browse..''

[[Archivo:PluginSymfony118.png|centro|Buscar el proyecto clonado]] 

Al seleccionar el proyecto aparecerá la ruta en la siguiente ventana:
[[Archivo:PluginSymfony119.png|centro|Proyecto seleccionado]] 

En la siguiente ventana configurar la URl de prueba, en este caso es ''http://symfony.localhost/app_dev.php''
[[Archivo:PluginSymfony120.png|centro|Proyecto seleccionado]] 

Al presionar finalizar, se creará el proyecto.

[[Archivo:PluginSymfony121.png|centro|Proyecto creado]] 

Si se observa que justo abajo del nombre del proyecto aparece un cilindro azul; este cilindro indica que se han hecho modificaciones 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 haberles dado un commit.
* Todos los archivos que aparezcan en color AZUL son archivos que fueron creados desde el proyecto pero su estructrura ha cambiado.


[[Category:DTIC]] [[Category:DTIC_Desarrollo]]