CGI: Planificación Institucional (PPI)

Jira

https://universidadnacional.atlassian.net/jira/your-work

Dentro de Planificación institucional existe uan kanban para la gestión de los proyectos
Dirección específica: https://universidadnacional.atlassian.net/jira/software/c/projects/PPI/boards/144
Se compone 6 columnas:
- Por hacer:
  - Lista de las tareas a desarrollar ordenas por:
    - Spring
    - Prioridad
- En Progreso:
  - Lista de las tareas que actualemente los desarrolladores están trabajando
- Pend Rev Código (Pendiente de Revisión de Código):
  - Una vez que un desarrollador probo localmente su tarea, esta debe ser revisada por otro compañero
- Su. Desarrollo (Subir a Desarrollo)
  - Si la revisión del código por parte del compañero es existosa, se debe para la tarea a esta etapa para que el cordinardor del proyecto la suba a desarrollo
- Pr. Desarrollo (Pruebas Desarrollo):
  - Cuando el código se encuentra en el servidor de desarrollo, el coordinador pasa la tarea a una etapa de pruebas en desarrollo parra comprobar su funcionamiento, es responsabilidad del desarrollador realizar las pruebas respectivas en el ambiente de desarrollo
- hecho:
  - Si las pruebas en desarrollo son existosas, se puede dar por finalizada la tarea uicandola en la columna de hecho

Notas: Jira

Si se encuentra un error pequeño al códificar se puede corregir de una vez, pero debe agregar una nota en la tarea
Si existre una atraso de la tarea se debe poner en los comentarios la razón
Hay que registrar el tiempo de forma diario Seguimiento de tiempo NO SE PUEDE REVERSAR

Creación de rama a partir de Tarea-Jira

Para crear una nueva rama para atender una tarea de jira
Primero debemos ingresar al Jira: https://universidadnacional.atlassian.net/jira/software/c/projects/PPI/boards/144
Luego debemos seleccionar la trea que deseamos trabajar

Luego debemos asiganarnos la tarea para esto:

Luego desde aquí podemos modificar su estado, asignandola a «EN PROGRESO»

Y finalmente creamos la rama, seleccionando la opción de «crear rama»

Seleccionamos la opción «Crear rama en Bitbucket»

esto nos va a llevar bitbucket: https://bitbucket.una.ac.cr/ ugmaros/pt22.
Donde debemos completar la siguiente información:
- Repository: SIGESA/SIGESA
- Branch type:
  - Feature: para PPI este es el type principal cualquier tarea de jira debe ser esta
  - BugFix: para PPI este solo cuando es una reparación de un error
  - Si desea consultar los tipos puede hacer aquí
- Branch from: develop
  - Todas la nuevas ramas se deben obtener de «develop» que es la última versión de SIGESA
  - Sin embargo hay otra rama «develop-ppi» que es el servidor de desarrollo, donode se deben realizar las pruebas por esta razón es necesario que cuando se suba una tarea se suba en ambos servidores
- Branch name: por defecto jira le colo el nombre de la tarea a la nueva rama sin embargo debemos eliminar la descripción y solo dejar su número de tarea. Ej: PPI-251

Y con esto abremos terminado la creación de una rama desde una tarea de jira

Conexión. desa07

Ahora para PPI, el servidor de desarrollo es el DESA07
Por tanto debemos agregar o modiificar la conexión de BD dentro de nuestro SQLDeveloper
Lo abrimos y le damos «Nueva Conexión»

Y agregamos la siguiente conexión

nombre: desa07
usuario: adm
p: sigesa2015
Nombre de host: sigesa-desa.una.ac.cr
puerto: 1521
SID: DESA07

Con esto tendremos una conexión a la BD para poder trabajar a nivel SQL
Sin embargo, para que nuestra aplicación LOCALHOST vea al servidor de BD DESA07
Debemos abrir por SSH nuestra Máquina Virtual

ssh cgi@10.0.100.30

Y nos debemos ubicar en la carpeta que contiene el tomcat del CGI (El que contiene la configuración de BD)
Específicamente en la carpeta de conf

cd /home/cgi/apache-tomcat-8.5.78/conf

Luego de esto abrimos el archivo

nano context.xml

Buscamos la línea que tiene la URL por ejemplo a DESA01 y la modificamos por DESA07

url="jdbc:oracle:thin:@sigesa-desa.una.ac.cr:1521:DESA01"
X
url="jdbc:oracle:thin:@sigesa-desa.una.ac.cr:1521:DESA07"

Y con esto ya nuestra aplicación se encuentra viendo a DESA07

Configuración de VS Code

Si desea ver la configuración de VS Code puede visitar: aquí

Conectar y Clonar con Bitbucket

Si es la primera vez que va a clonar desde VS Code debe serguir estos pasos:
Vamos a la sección de git -> Clone Repository

Vamos a bitbucket , específicamente al proyecto de SIGESA
https://bitbucket.una.ac.cr/projects/ERP/repos/sigesa/browse
Y le damos la opción de clone

O puede utilizar la siguiente dirección

https://bitbucket.una.ac.cr/scm/erp/sigesa.git

Regresamos a VS Code y la pegamos

Seleccionamos donde lo deseamos clonar para nuestro caso utilizaremos el “Escritorio”

Nos pregunta los datos del usuario.

gmatamoros
t22.

Si todo el proceso es correcto:
- Debemos tebner conexión al servidor remoto
- Y el código de SIGESA en VS Code
- Y la rama creada en los pasos anteriores

ahora podemos ir a FILE->SAVE WORKSPACE AS
Y guardar el workspace con toda la configuración para que cuando abramos VS Code nos haga todo solo

Modificación de la rama

Para este ejemplo se crear una tarea-jira de crear una bitacora, aqupi no se va a mostrar los cambios pero si desea ver como crear una bitacora puede ver el articulo: CGI: Creación de bitacora

Publicación de modificaciones

Una vez que se terminar de programar y probar la tarea-Jira
Debemos hacer commit a todos los cambios
para esto primero debemos decirle a git cual es nuestro usuario e información

git config --global user.name "Gustavo Matamoros González"
git config --global user.email "gustavo.matamoros.gonzalez@una.cr"
git config --global color.ui true
git config --global credential.helper store

git config --global alias.superlog "log --graph --abbrev-commit --decorate --date=relative --format=format:'%C(bold blue)%h%C(reset) - %C(bold green)(%ar)%C(reset) %C(white)%s%C(reset) %C(dim white)- %an%C(reset)%C(bold yellow)%d%C(reset)' --all"

VS Code trae una herramienta para git, por tanto podemos guardar el commit desde la herramienta
Tambien desde la herramienta en la flecha de abajo podemos hacer de una vez «Commit and Push»

O podemos ejecutar desde la terminal

git commit -m "Mensaje"

NOTA IMPORTANTE: para PPI se recomienda que solo se haga un commit para la tarea-jira y debe tener como comentario el título de la tarea

Y publicamos los cambios

git push

Con esto ya tenemos nuestros cambios en la bitbucket
Ahora debemos solicitar una «pull resquet» o unificación al código
Pero debemos recordar que tenemos dos ramas
- develop
- develop-ppi
Por tanto debemos solicitar un pull request para cada uno
Y tambien se debe solicitar a un compañero la revisión del código
Para esto debemos ingresar a https://bitbucket.una.ac.cr/projects/ERP/repos/sigesa/pull-requests?create
Seleccionamos la rama que deseamos solicitar el pull request
Y en destino la rama develop