Ir al contenido principal

Procedimiento para realizar un despliegue de instancia nuby en GCP

Macroproceso de desarrollar e implementar productos y servicios

Fecha de elaboración: 2025/05/29


Procedimiento para realizar un despliegue de instancia nuby en GCP

Código:

Versión: 1

Esta guía te ayudará a realizar el despliegue de una nueva versión de Arrendasoft (nuby) en Google Cloud Run. Dependiendo de si hay cambios en el código fuente, puedes seguir dos procedimientos diferentes.


Caso 1: No hay cambios en el código fuente

Si no has realizado cambios en el código fuente, puedes seguir los siguientes pasos para desplegar una nueva versión sin necesidad de reconstruir el contenedor:

  1. Navegar a Google Cloud Run
    Abra su navegador web y acceda a la consola de Google Cloud. Desde el menú principal, seleccione 'Cloud Run' para dirigirse a la página de servicios de Cloud Run.




  2. Navega al servicio correspondiente

    En la página de Cloud Run, busque y seleccione el servicio específico para el cual desea desplegar una nueva revisión. Haga clic en el nombre del servicio para abrir sus detalles.

     

  3. Crear un nuevo despliegue

    Dentro de la página de detalles del servicio, localice y haga clic en el botón 'Editar y desplegar nueva revisión'. Esto le permitirá comenzar el proceso de despliegue de una nueva revisión.

     


     

  4. Seleccionar la imagen del contenedor

    En la sección de configuración de la nueva revisión, busque la opción para seleccionar la imagen del contenedor. Aquí puede especificar una nueva imagen de contenedor o seleccionar una que ya haya sido utilizada anteriormente.

     

     

  5. Selecciona el contenedor correspondiente

    Seleccione la imagen de contenedor adecuada de la lista. Asegúrese de que esta corresponde a la versión del contenedor que desea desplegar como una nueva revisión para el servicio.

     

     

     

  6. Configurar ajustes y variables de entorno (opcional)

    Si es necesario, configure las opciones adicionales como ajustes de recursos y variables de entorno. Este paso es opcional y depende de cualquier ajuste específico que necesite realizar para esta nueva revisión.


     

  7. Desplegar la nueva revisión

    Revise todos los cambios configurados y, cuando esté listo, haga clic en 'Desplegar' para iniciar el despliegue de la nueva revisión del servicio en Google Cloud Run.




Caso 2: Hay cambios en el código fuente (Reconstrucción del contenedor)

Si has realizado cambios en el código fuente, deberás reconstruir el contenedor antes de desplegar la nueva versión. Sigue estos pasos:

  1. Activar Cloud Shell

    Haz clic en el ícono de Cloud Shell en Google Cloud Console para activar el entorno de Cloud Shell.

     



  2. Abrir Cloud Shell en una nueva pestaña

    Para una interfaz más cómoda, abre Cloud Shell en una nueva pestaña seleccionando la opción correspondiente.



  3. Configurar el proyecto en Cloud Shell
    En la consola, ejecuta el siguiente comando para configurar el proyecto:

     

    gcloud config set project [ID_DEL_PROYECTO]


  4. Configurar la región de ejecución en Cloud Shell

    Configura la región donde se ejecutará el servicio de Google Cloud Run:

    gcloud config set run/region [REGIÓN]



  5. Posicionarse en la carpeta que contiene el código a desplegar
    Si ya tienes la carpeta con el código, navega a ella usando:

    cd [RUTA_DE_LA_CARPETA]

    Si no, crea la carpeta necesaria y posiciona el terminal en dicha ruta.

     

  6. Configurar el usuario de GitHub
    Configura tu usuario de GitHub en Cloud Shell con:

    git config --global user.name [TU_USUARIO]



  7. Configurar el correo electrónico de GitHub
    Configura tu correo electrónico de GitHub en Cloud Shell con el comando:

    git config --global user.email [TU_EMAIL]


  8. Abrir Editor de Cloud Shell
    Abre el editor de Cloud Shell haciendo clic en el ícono correspondiente en la esquina superior derecha



  9. Seleccionar la opción para abrir una carpeta
    En el menú lateral izquierdo, selecciona la opción de "Abrir Carpeta"



  10. Seleccionar la respectiva carpeta
    Navega y selecciona la carpeta que contiene tu código fuente para cargarla en el editor



  11. Sincronizar el repositorio de GitHub
    Accede a la extensión de GitHub dentro del editor y realiza un fetch para sincronizar los cambios de la rama de origen con la local.



  12. Autorizar la extensión de GitHub

    Sigue las instrucciones para autorizar la extensión de GitHub con tus credenciales.



  13. Seleccionar la rama a desplegar
    Asegúrate de haber cargado la rama con la versión del código fuente que requieres desplegar



  14. Desplegar la nueva versión
    Vuelve a la consola de Cloud Shell y ejecuta el siguiente comando para desplegar la nueva versión:


    gcloud run deploy [NOMBRE_SERVICIO] --source .

     

  15. Esperar a que el despliegue finalice su ejecución
    Espera pacientemente a que el proceso de despliegue complete antes de proceder.



  16. Al finalizar, haga clic en el link para visualizar los logs
    Una vez finalizado el despliegue, haz clic en el enlace proporcionado para ver los registros de logs del proceso. Revisa los logs detalladamente para identificar y solucionar cualquier error o inconsistencia.



Consejos Adicionales:

  • Asegúrate de verificar que los dominios de los clientes estén correctamente configurados para que el contenedor se conecte a la base de datos adecuada según el dominio.
  • Monitorea el servicio después del despliegue para asegurarte de que no haya problemas de escalabilidad o rendimiento.

Elaborado por: Isabel Higuita Giraldo

Revisado por: Isabel Higuita Giraldo

Aprobado por: Isabel Higuita Giraldo

Fecha de elaboración: 2025-05-29

Fecha Revisión: 2025-05-29

Fecha Aprobación: 2025-05-29