Para el desarrollo de este proyecto se tiene como base el desarrollo de una aplicación basada en la librería React de javascript y su posterior despliegue en un Cluster de OpenShift que se encuentra alojado en IBM Cloud.
- Despliegue en OpenShift desde IBM Cloud shell
- Despliegue Aplicación Demo en React
- Despliegue Aplicación Feedback App Desde la consola web de OpenShift
- Monitoreo de la aplicación
- Despliegue de una imagen Docker en un contenedor de Openshift
- Referencias
Inicialmente debe acceder al shell de IBM Cloud desde el siguiente link:
https://cloud.ibm.com/shell
-
Inicie sesión e ingrese desde la CLI de OpenShift al clúster en el que se va a trabajar. Para ingresar al clúster que tengamos aprovisionado en nuestra cuenta de IBM Cloud se deben realizar los siguientes pasos:
- Ingresar a la plataforma de IBM cloud con sus credenciales de inicio de sesión, lo puede hacer desde el siguiente link:
https://cloud.ibm.com/
-
Diríjase al resource list. Primero debe dar clic en el navigation menu y luego donde dice Resource list, como se puede ver en la siguiente imagen:
-
Diríjase a la sección de clústers y dé clic en el que se desea acceder.
-
Dé clic en el botón OpenShift web console.
Ahora en la parte superior derecha dé clic sobre el ID del correo con el que ingresamos y luego en la sección que dice Copy Login Command.
Y por último vuelva a la terminal que se estaba utilizando, pegue el comando y presione enter.
- Cree un nuevo proyecto en el clúster de la siguiente manera:
oc new-project <projectname>
Nota: Para el projectname coloque roks + las iniciales de su nombre y apellido.
- Acceda al proyecto que acabó de crear de la siguiente manera:
oc project <projectname>
- Desde el Shell de IBM cloud digite el siguiente comando para crear una aplicación de react:
npx create-react-app react-web-app
- Dirigirse a esta carpeta con el comando:
cd react-web-app
- Para desplegar la aplicación en OpenShift es necesario escribir el siguiente comando:
npx nodeshift --deploy.port 3000 --expose
El resultado de este comando va a ser una respuesta de este tipo, que nos indica que la aplicación se desplegó correctamente.
-
Para poder acceder al la URL de la aplicación y realizar la verificación de la misma ingrese a la consola web de OpenShift, en la vista topology
Y por último solo faltaría dar clic en el link que lo llevará a la aplicación desplegada.
De esta forma se daría por terminado el despliegue de la aplicación react en openshift.
Para realizar el despliegue desde la consola web de OpenShift de una manera más intuitiva se deben seguir los siguientes pasos:
- Cree un nuevo proyecto con la siguiente sintaxis handson-nombreapellido.
- Ingrese a la sección add y luego debe elegir From Catalog.
- Ingrese la URL del repositorio de GitHub que contiene la aplicación a desplegar, si lo desea puede ser la siguiente:
https://github.com/sofiaponteb/feedback-app-openshift
- Una vez seleccionada, presione
Show Advanced Optionsy baje hastaShow Advanced Routing Options. En el puerto ingrese el puerto donde se expone la aplicación creada. En el caso de react suele ser el puerto 3000, a menos que haya sido cambiado en el desarrollo de la aplicación.
- Al final de esta página encontrará una sección de opciones avanzadas en la cual encontrará un link de Scaling.
- La sección de Scaling, nos permitirá configurar el número de replicas si deseamos un auto escalamiento para nuestra aplicación.
- Al dar clic en crear se iniciará un proceso de build el cual nos entregará el link de despliegue de nuestra aplicación".
Nota: Espere unos cuantos segundos mientras el proceso de construcción y despliegue de la aplicación se termina.
- Una vez terminado el proceso de despliegue puede dirigirse a Routes, donde podrá ver la URL mediante la cual podrá acceder a la aplicación ya desplegada.
Para realizar un monitoreo de la aplicación desplegada debe seguir los pasos que se indican a continuación:
- Dé click en la pestaña del proyecto (parte superior) y allí busque y seleccione el proyecto
openshift-monitoring. Este namespace está creado por defecto y contiene herramientas como Prometheus y Grafana que permiten monitorear el clúster. Observe los componentes que aparecen y dé click en la opciónOpen URLque aparece para Grafana.
- Esta acción nos va a redirigir a una nueva ventana de nuestro navegador en la cual debemos seleccionar nuestro método de acceso al cual debemos dar clic en Log in with Openshift.
- En esta nueva ventana inicialmente nos aparecerá un mensaje de autorización en cual debemos dar clic en Allow Selected Permissions.
- Al completar el paso anterior nos aparecerá el Dashboard inicial de Grafana, la cual es la herramineta de monitoreo que viene integrada con openshift.
- Para poder monitorear nuestra aplicacion debemos dar clic en Home y acá se nos mostrará un menú desplegable en el cual debemos seleccionar lo siguienete:
- El paso final es en el apartado de namespace, buscar nuestro proyecto el cual tenía la syntaxis de handson-nombreapellido.
De esta manera podemos analizar el consumo que se ha tenido en nuestra aplicación tanto en CPU como en Memoria.
Para realizar el despliegue de una aplicación que se encuentra alojada en un una imagen de DockerHub se deben realizar los siguientes pasos:
- Dé clic en la sección Add y luego en la sección **Container Image.
- Al dar clic en Container Image se abre una ventana en la cual debemos seleccionar el campo Image Name y llenar el campo con la ruta fuente de la imagen docker.
- Si reconoce la imagen docker, automaticamente aparece la imagen docker y se llena la información necesaria para el despliegue y se habilita la opción para dar clic en CREAR, y al dar clic acá se inicia el despliegue de la aplicación por lo que se debe esperar un momento mientras se realiza el mismo.
- Una vez terminado el proceso de despliegue puede dirigirse a Overview dando clic sobre el circulo de despliegue, donde podra ver la URL mediante la cual podra acceder a la aplicacion ya desplegada.
- al dar clic en la URL podrá acceder a la aplicacion ya desplegada.
-
La documentación en linea de IBM Cloud Red Hat OpenShift Managed, se encuentra en el siguiente enlace: https://cloud.ibm.com/docs/openshift?topic=openshift-getting-started
-
En la siguiente página se encuentra la información de administración y configuración de Open Shift 4.11: https://access.redhat.com/documentation/en-us/openshift_container_platform/4.11
Equipo IBM Cloud Tech Sales Colombia.