Tutorial desarrollo del núcleo de API CNIG (Servidor) - IGN-CNIG/API-CNIG GitHub Wiki

** ! Página en desarrollo**

En esta página vamos a guiar paso por paso cómo comenzar con el desarrollo de la parte servidor de API-CNIG

1./ Creamos un "fork" o bifurcación del repositorio de API-CNIG a nuestro GitHub personal desde: https://github.com/IGN-CNIG/API-CNIG/fork . Si se van a hacer desarrollos de forma activa, es recomendable no marcar la opción de copiar sólo la rama máster. Con este paso, tendremos una copia del repositorio de API-CNIG donde podremos desarrollar.

2./ Realizamos un "clone" del repositorio en la máquina donde se vaya a desarrollar:

    cd {ruta de la carpeta donde se quiera hacer el clone}
    git clone https://github.com/{nuestro_repositorio}/API-CNIG.git

3./ Vamos a la carpeta del proyecto y nos cambiamos a la rama "develop":

    cd API-CNIG
    git checkout develop
    git pull

4./ Una vez descargado el repo y estando posicionados en "develop", creamos una rama de trabajo y nos posicionamos en ella, en este caso la vamos a llamar "prueba":

    git checkout -b prueba

5./ Abrimos eclipse en un nuevo proyecto. Desde file -> Import -> Maven -> Existing Maven Projects -> Next -> y seleccionamos la carpeta api-ign-parent -> seleccionamos todas las carpetas del proyecto -> finish. Esperamos a que se carguen todas las dependencias.

6./ Una vez importadas todas las dependencias: en la pestaña de servers -> create new server -> Apache -> tomcat -> next -> añadimos api-ign-rest -> finish. Al desplegar el servidor, debe aparecer api-ign-rest, y al desplegarlo, api-ign-proxy y api-ign-database

7./ Botón derecho sobre el servidor tomcat -> start

8./ Al abrir un navegador en la dirección : http://localhost:8080/api-core/api/actions/version , por ejemplo, debemos ver la versión en la que estamos desarrollando

9./ Una vez realizado el desarrollo, subimos el código a nuestro repositorio. Desde este enlace: https://git-scm.com/docs se puede obtener documentación sobre Git y sus comandos.

    cd ../ # volvemos a la carpeta API-CNIG
    git add ./{ruta del archivo que se ha modificado}
    git commit -m "{comentario descriptivo del desarrollo realizado}"
    git push

10./ Ya subido el código a nuestro repositorio, realizamos un Pull Request para integrar estos desarrollos al repositorio de API-CNIG. Para ello, en la parte de la izquierda seleccionaremos nuestro repositorio y la rama "prueba" y a la izquierda el repositorio de API-CNIG y la rama "develop"

11./ En este punto, el equipo de desarrollo de API-CNIG hará el control de calidad y las pruebas necesarias para validar la incorporación del nuevo código al repositorio y poder ser utilizado por al comunidad en próximas versiones de API-CNIG