Dev Ops

Manos a la obra
Contenido
Introducción................................................................................................................................... 3
Instalación de Software ................................................................................................................ 1
Java.............................................................................................................................................. 1
Maven ......................................................................................................................................... 7
Tomcat ........................................................................................................................................ 9
Eclipse ....................................................................................................................................... 13
Git .............................................................................................................................................. 15
Jenkins ...................................................................................................................................... 25
Docker ...................................................................................................................................... 30
Descargar el proyecto ................................................................................................................. 33
Configuración del proyecto en Eclipse ...................................................................................... 35
Configuración de Jenkins ............................................................................................................ 47
Configuración y Deploy en Docker ............................................................................................ 57
Introducción

El presente documento tiene como propósito mostrar el uso de algunas herramientas de

software para ejemplificar como a través de Dev Ops es posible automatizar los procesos de
Integración y Entrega continuas.

El software a instalar se encuentra disponible en el siguiente link de Google Drive:

Instaladores. Ahí se encuentran los archivos para ejecutar las siguientes herramientas:

• Java 1.8
• Maven
• Tomcat
• Eclipse
• Git
• Jenkins
• Docker

En los siguientes apartados se indicarán los pasos para instalar, configurar y ejecutar cada
una de las herramientas para descargar y desplegar el proyecto diseñado para el curso.
Instalación de Software

Java

1. Ejecutar el archivo jdk-8u31-windows-x64.exe

2. Seguir la instalación recomendada hasta que la instalación concluya.

a. Iniciar el proceso de instalación

b. Conservar los componentes propuestos por el instalador

1
c. Conservar la ruta de instalación de Java Runtime Environment

d. Al término de la instalación el sistema mostrará la siguiente pantalla la cual

podemos cerrar.

2
3. El proceso instalara el Kit de Desarrollo (JDK) y el ambiente de ejecución (JRE):

4. Haz clic en el botón de Windows y realiza la búsqueda “variables de sistema”

5. Selecciona la opción “variables de entorno”

3
6. En la sección de variables de usuario o de la cuenta, hacer clic en “Nuevo”

7. Crea la variable JAVA_HOME con la ruta de Java JDK

8. Editar la variable de entorno con nombre PATH para agregar la variable JAVA_HOME

4
5
9. Agregar el registro %JAVA_HOME%\bin de la siguiente manera:

10. Una vez guardada la variable de entorno, abre una ventana de comandos “CMD” y
ejecuta el comando “java -version”. Si la configuración se realizó de manera adecuada,
el sistema reconocerá la versión de java de la siguiente manera:

6
Maven

1. Crear el directorio C:\Apache Maven

2. Copiar el archivo apache-maven-3.8.2.zip
3. Descomprimir el archivo zip.
4. Crear la variable de entorno con nombre M2_HOME y con la ruta de maven.

5. Editar el PATH y agregar el registro %M2_HOME%\bin

6. Abre una ventana de comandos “CMD” y ejecuta el comando “mvn –v”. Si la

configuración se realizó de manera adecuada, el sistema reconocerá la versión de
java de la siguiente manera:

7
8
Tomcat

1. Ejecutar el archivo apache-tomcat-9.0.55.exe para instalar el servicio de Servidor de

aplicaciones.
2. Seguir la instalación recomendada.

a. Da inicio al proceso de instalación

b. Acepta los términos y condiciones

9
c. Selecciona todos los componentes a instalar

d. Asigna el puerto 8080 para el servicio e ingresa un usuario y contraseña

sencillos para el administrador de Tomcat, ejemplo, admin/admin.

10
e. Indicar la ruta de Java JRE 8, debido a que se instaló previamente, la instalación
de Tomcat la identificará en automático.

f. Conservar la ruta de instalación asignada por el wizard

11
 g. Al finalizar, indicar que el servicio inicie su ejecución.

3. Cuando la instalación concluya, ingresa en el navegador localhost:8080. Si la

instalación se realizó correctamente se mostrará la página de inicio de Apache:

12
Eclipse

1. Crear el directorio C:\Development\

2. Copiar el archivo eclipse-jee-oxygen-3a-win32-x86_64.zip en el directorio creado en
el punto anterior y descomprimirlo. Este eclipse es portable y no requiere instalación.
3. Una vez que el archivo termine de descomprimir. Abrir el directorio
C:\Development\eclipse y ejecutar el archivo eclipse.exe

4. Al iniciar la aplicación solicitara el directorio del workspace, indicar la ruta

C:\Development\eclipse-workspace:

5. Cuando eclipse muestre la página de inicio significara que el programa ejecuta

correctamente.

13
14
Git

1. Ejecutar el archivo Git-2.34.0-64-bit.exe.

2. Seguir la instalación recomendada por el wizard.

a. Acepta los términos y condiciones

b. Conservar la ruta de instalación asignada por el wizard.

15
16
c. Verifica que los siguientes componentes estén seleccionados.

d. Indicar el nombre del directorio del menú de inicio como “Git”.

17
e. La instalación preguntara por la configuración de diversas características
durante el proceso. Seleccionar dicha configuración de acuerdo a las
siguientes imágenes

18
19
20
21
22
f. Al concluir la instalación se mostrará la siguiente pantalla

23
3. Al concluir la instalación, abrir una ventana CMD y ejecutar el comando “git versión”.
Si la instalación se realizó correctamente el sistema mostrara la versión instalada.

24
Jenkins

1. Ejecutar el archivo jenkins.msi

2. Seguir la instalación con las siguientes indicaciones.

a. Iniciar el wizard de instalación.

b. Conservar el directorio de instalación recomendado por el wizard

25
c. Indicar el método de autenticación para LocalSystem.

d. Asignar el puerto 8081 para la ejecución del servicio de Jenkins y probar el

puerto

26
e. Conservar el Java identificado por el wizard.

f. Selecciona los componentes a instalar de la siguiente manera

27
g. Confirmar la instalación

h. Finalizar la instalación cuando el wizard confirme

28
i. Ingresa en tu navegador el link http://localhost:8081/

Jenkins te indicara la ruta de la contraseña inicial para poder configurar el

usuario administrador. Se recomiendo utilizar un usuario y contraseña fácil de
recordar, ejemplo: admin/ admin

29
Docker

1. Ejecutar el archivo Docker Desktop Installer.exe.

2. Seguir la instalación recomendada por el wizard.

a. Iniciar la instalación seleccionando lo siguientes componentes.

b. El wizard descomprimirá todos los componentes para poder realizar la

instalación.

30
c. Una vez finalizada la descompresión de archivos, se iniciará la instalación

d. Al concluir la instalación se solicitará reiniciar el equipo

31
e. Al abrir Docker se mostrará la siguiente página de inicio

32
Descargar el proyecto

1. Abrir una ventana de comandos “CMD” y ejecutar el comando “cd

C:\Development\eclipse-workspace”. Esto posicionara la ventana en dicha carpeta.

2. El proyecto se encuentra en el siguiente link

https://github.com/danielHuSo/certiprof.git el cual es un repositorio público de
GitHub. La descarga del proyecto se realizará a través del comando “git clone
https://github.com/danielHuSo/certiprof.git”

3. El proyecto se descargará en la carpeta que habíamos definido para el workspace de

eclipse

33
34
Configuración del proyecto en Eclipse

1. Una vez abierto Eclipse, ir a la opción File -> Import

2. El sistema abrirá un wizard para importar el proyecto y seleccionaremos la opción

“Existing Maven Projects”.

35
3. Se solicitará la ubicación del proyecto. Indicaremos la ubicación del proyecto
descargado con GIT

4. Una vez que el sistema concluya de cargar el archivo, debemos cerrar la ventana de
bienvenida de Eclipse.

36
5. El sistema mostrará el panel de desarrollador y del lado izquierdo se mostrará el
proyecto

6. Realizaremos algunas configuraciones al proyecto para poder ejecutarlo, haciendo

clic derecho y seleccionando la opción “Build Path -> Configure Build Path”

7. Se abrirá el wizard de configuración del proyecto y nos posicionaremos en la pestaña

de “Libraries”

37
38
8. Seleccionaremos la librería “JRE System Library [JavaSE-1.8]” y después haremos clic
en el botón de “Remove” para eliminar la librería y poder agregar la versión de Java
que instalamos al inicio.

9. Para agregar el nuevo Java haremos clic en el botón de “Add Library” y

seleccionaremos JRE System Library

39
10. Seleccionaremos la opción “Alternate JRE” y con el botón “Installed JREs” buscaremos
el JDK que instalamos.

En la ventana de “Installed JREs” aparecerá también el Java default de elipse el cual

podemos eliminar. Aplicamos los cambios para ser direccionados al wizard de
configuración inicial.

11. Hacemos de nuevo clic en el botón de “Add Library” y seleccionamos la opción JUnit

40
41
12. Seleccionamos la opción JUnit5 y aplicamos los cambios

13. Después de aplicar todos los cambios, las librerías del proyecto quedarán de la
siguiente manera

42
14. Ahora debemos descargar las dependencias de Maven, esto lo haremos haciendo clic
derecho al proyecto y seleccionando la opción Maven -> Update Project. Esto
descargara las dependencias indicadas en el archivo pom.xml

15. Confirmamos la acción y el sistema comenzara a descargar los componentes.

43
44
16. Con todo lo anterior ya estamos listos para ejecutar el proyecto ☺ ☺ ☺. Haremos clic
derecho al proyecto ye seleccionamos “Run As- > Run configurations”

17. El sistema mostrará un wizard en el que haremos clic en la opción de “Java

application” y seleccionaremos “New”. Y en los datos de configuración asignaremos
lo siguiente

45
18. Al hacer clic en “Run”, Eclipse ejecutara el proyecto. En la consola visualizaremos lo
siguiente

19. Si la consola no presenta ningún error, podemos abrir el navegador y pegar el link:
http://localhost:8082/certiprof/. El proyecto por ahora está ejecutándose en el
Tomcat interno de Eclipse

¡Felicidades!
Has configurado y ejecutado el
proyecto del curso correctamente

46
Configuración de Jenkins

1. Una vez que Jenkins nos presente su página de inicio, vamos al menú “Manage
Jenkins”.

2. Ingresamos a la opción de manage Plugins

3. Debemos verificar en la pestaña de “Installed” que los Plugins Deploy to container

Plugin y Maven Integration estén instalados, de lo contrario debemos buscarlos en la
pestaña de “Available” e instalarlos. Se recomiendo reiniciar Jenkins después de
instalar cada Plugin.

47
48
4. Una vez configurado los Plugins, debemos ir a “Global Configuration Tool” para
configurar Java y Maven.

5. Las secciones deberán configurarse de la siguiente manera

a. Maven Configuration

b. Para JDK hacer clic en “JDK Installations” y configurar la ruta del JDK de Java

49
c. En GIT configuraremos la ruta de instalación de git.exe de la siguiente manera

d. Los apartados de Gradle y Ant no los configuraremos. Por último, en el

apartado de Maven configuraremos la ruta donde descomprimimos las
librerías de Maven

e. No olvides guardar los cambios

50
6. Ahora configuraremos la integración de Jenkins con el proyecto que descargamos
de Git. En la página de inicio seleccionaremos el menú “New Item”

a. En el wizard de creación de ítems asigna un nombre y selecciona “Maven

Project” y haz clic en “ok”

b. En la siguiente pantalla en “General” ingresa una descripción. Selecciona “Git

Project” e ingresa el link de GitHub del proyecto:
https://github.com/danielHuSo/certiprof.git

51
52
c. En “Source Code Management” selecciona la opción “GIT” e indica de nuevo la
url del repositorio.

d. En “Build Triggers” seleccionar la opción “Build Periodically” e indicar el valor

de “H/10 * * * *”. Esto generará un despliegue automático cada 10 minutos.

53
e. “Build Environment” y “Pre Steps” se dejarán con la información default, es
decir, no realizaremos cambios. En “Build” asignaremos la siguiente
configuración.

f. “Post Steps” tampoco tendrá cambio de nuestra parte, en “Build Settings”

haremos clic en el botón “Add Post Build Action” y seleccionaremos “Deploy
war/ear to a container”, y lo configuraremos de la siguiente manera

g. Guardamos cambios y en la página principal del ítem hacemos clic en “Build

Now”

54
55
h. Si el despliegue se ejecuta correctamente, el job marcara lo siguiente

i. Al colocar el link http://localhost:8080/certiprof/ en el navegador nos

mostrara lo siguiente

¡Felicidades!
La integración de Jenkins con Git y
Tomcat se realizó correctamente

56
Configuración y Deploy en Docker

1. Abrir una ventana de comandos “CMD”

2. Copiar y ejecutar los siguientes comandos:

• docker run -it --rm -d -p 8888:8080 --name tomcat-container tomcat:9.0

Docker descargara el contenedor de tomcat y lo ejecutara en Segundo plano en
el Puerto 88888

• docker exec -it tomcat-container /bin/bash

Docker se desplazará a las carpetas de instalación de Tomcat

• cd webapps.dist
Docker cambiará de carpeta a /webapps.dist

• cp -r ./* /usr/local/tomcat/webapps
Docker copiara el contenido de /webapps.dist a /webapp

• cd ..
Docker se desplazará a una carpeta superior, en este caso a /tomcat

• cd webapps
Docker se desplazará a la carpeta /webapps

• ls –a
Docker enlistará el contenido de /webapps para validar que el copiado fue
correcto

• exit
Docker terminará la conexión a los directorios del contenedor de tomcat.

• cd C:\Program Files\Apache Software Foundation\Tomcat 9.0\webapps\

Desplazamos la ventana de comandos a la carpeta de webapps de tomcat
instalado por nosotros donde ya se encuentra el war del proyecto.

• docker cp certiprof.war tomcat-

container:/usr/local/tomcat/webapps/certiprof.war
Copiamos el war a los directorios del contenedor de tomcat instalado en Docker.

57
3. La consola mostrara un resultado similar al siguiente

4. Ejecutar el siguiente link en el navegador: http://localhost:8888/certiprof/

58