Guía de inicio rápido

En esta página, se muestra cómo comenzar a usar Cloud Code mediante la aplicación de muestra Hello World para Node.js. Puedes elegir cualquiera de las otras muestras de hello-world de Cloud Code (para Python, Java y Go) y seguir los pasos que se indican en este documento, siempre y cuando tu sistema y Visual Studio Code estén configurados para admitir el lenguaje que elijas.

Antes de comenzar

¿Qué se incluye?

La muestra de “hello-world” incluye los siguientes archivos:

  • .vscode
    • extensions.json: Solicita la descarga de las extensiones relacionadas cuando abres este proyecto
    • launch.json: La información necesaria para que el depurador se adjunte a nuestro servicio
    • tasks.json: La información de configuración para las tareas de Visual Studio Code
  • kubernetes-manifests
    • hello.deployment.yaml: El manifiesto de Kubernetes para la implementación de Hello World
    • hello.service.yaml: El manifiesto de Kubernetes para el servicio LoadBalancer de Hello World
  • src
    • app.js: El código de Node.js con la lógica del servidor web
    • Dockerfile: Se usa a fin de compilar la imagen del contenedor para nuestro programa
  • skaffold.yaml: Es el archivo de configuración de Skaffold, que se usa por Cloud Code para la compilación y también la implementación de imágenes

Crea un clúster de Google Kubernetes Engine

En la paleta de comandos Ícono “Administrar”, escribe o selecciona Cloud Code: Crear clúster de GKE (Cloud Code: Create GKE cluster).

Llena los campos del asistente de creación de clústeres y haz clic en “Crear clúster” (Create Cluster). Se creará un clúster y aparecerá en la vista GKE Explorer.

Crear un clúster de GKE con el asistente de creación de clústeres

Implementa tu app

Usa la paleta de comandos nuevamente y esta vez escribe Cloud Code: Implementar. Selecciona “hello-world” como la aplicación que deseas implementar.

Tienes las siguientes opciones de configuración:

  • Selecciona “default” para compilar contenedores mediante tu instancia local de Docker.
  • Selecciona “cloudbuild” para compilar con Google Cloud Build.

Aparecerá una ventana de resultados en la que puedes seguir el progreso de tu implementación. Una vez que la implementación sea exitosa, la ventana de resultados mostrará una dirección IP que puedes usar para acceder a tu aplicación.

Inicia la implementación continua

Cloud Code incluye la opción de implementación continua, es decir, cualquier cambio en tu código se compilará, enviará y también implementará automáticamente en una versión nueva de tu aplicación.

La implementación continua funciona de la misma forma que la normal, pero debes elegir Cloud Code: Implementación continua (Cloud Code: Continuous Deploy) cuando implementes tu aplicación. Después de seguir estos pasos y cuando se haya completado la implementación inicial, puedes probar la implementación continua si actualizas el mensaje que muestra el servidor en app.js y guardas el archivo. Cloud Code notará el cambio, enviará y, luego, implementará una versión nueva de tu aplicación automáticamente.

Visualiza registros de contenedores

Escribe Cloud Code: Ver registros desde la paleta de comandos.

Selecciona el pod que contiene los archivos que deseas ver. Se abrirá un archivo nuevo, propagado con los resultados estándar del contenedor de hello-world.

Visualizar registros del pod especificado

Depura tu aplicación

Abre la vista de depuración de VS Code desde la barra de tareas izquierda Ícono de depuración.

Selecciona “hello-world” como configuración de depuración en el menú desplegable y presiona el botón para iniciar el proceso a fin de adjuntar la sesión del depurador a la aplicación de hello-world. Cloud Code usa el archivo .vscode/launch.json para ubicar los pods a los que se debe adjuntar la sesión de depuración.

Ahora se abrirá la barra de herramientas de depuración (con todos los controles de depuración que conoces). Haz clic en el margen de app.js para agregar una interrupción. Cada vez que envíes una solicitud nueva a tu aplicación, se detendrá en la línea deseada. Usa la barra lateral de depuración para inspeccionar información sobre las variables y la pila. Usa la consola de depuración ubicada en el depurador del panel inferior a si deseas interactuar con la sesión de depuración.

Abre una terminal en tu contenedor

Escribe Cloud Code: Obtener terminal en la paleta de comandos.

Selecciona el pod al que deseas conectarte. Esta acción iniciará una terminal. Ahora tendrás acceso a una shell dentro del contenedor en ejecución.

Abrir una terminal para el pod especificado

Limpieza

Para evitar que se generen cargos en tu cuenta de GCP por los recursos que se usan en esta guía de inicio rápido, haz lo siguiente:

  • Ve a la página de Proyectos en Console:

    Ir a la página Proyectos

  • Selecciona el proyecto que creaste para este inicio rápido y bórralo. Para ello, debes hacer clic en el ícono de la papelera que se encuentra al lado.

Esta acción cierra el proyecto y programa su eliminación.

En Azure, haz clic en el logotipo de Azure DevOps para abrir los proyectos y, luego, elige “Organization Settings”. Selecciona “Projects” desde la barra lateral y selecciona “Delete” desde el ícono de acción de tres puntos correspondiente, que se encuentra junto al nombre de tu proyecto.

En AWS, accede a la consola de AWS CodeBuild, elige “Build Projects”, elige el botón de selección que se encuentra junto al proyecto de compilación que deseas borrar y haz clic en “Delete”.

Pasos siguientes