Guía de inicio rápido para el desarrollo remoto

En esta página, se muestra cómo comenzar a usar Cloud Code con rapidez mediante un entorno de desarrollo remoto en Cloud Shell.

En esta guía de inicio rápido, omitirás la configuración y clonarás un proyecto en tu lugar de trabajo de desarrollo remoto con un clic, crearás un clúster, ejecutarás una app de Kubernetes en él, depurarás el código en ejecución, verás los registros de tu aplicación activa y, además, conectarás una terminal a tu contenedor en ejecución.

Antes de comenzar

Para acceder a Cloud Shell y al entorno de desarrollo remoto en Google Cloud que usarás en esta guía de inicio rápido, deberás crear un proyecto de GCP y habilitar la facturación.

También deberás tener las siguientes herramientas instaladas en tu máquina:

Inicia Cloud Code

Una vez que hayas instalado Visual Studio Code y la extensión Remote-SSH, haz clic en el botón “Open with Cloud Code” (Abrir con Cloud Code) a continuación para abrir Visual Studio Code que se conectó a un entorno de desarrollo remoto en Cloud Shell. Este entorno tiene todas las herramientas que necesitas para desarrollar aplicaciones de Kubernetes.

Cuando hagas clic en el botón “Abrir con Cloud Code”, VS Code iniciará y clonará de forma automática un proyecto en tu lugar de trabajo de desarrollo remoto. Si aún no estableciste los requisitos previos, se te solicitará que los instales.

Elige el lenguaje que prefieras para el proyecto clonado y haz clic en el botón Abrir con Cloud Code si deseas comenzar a trabajar en tu lugar de trabajo de desarrollo remoto:

Crea un clúster de Google Kubernetes Engine

Para crear un clúster de GKE, sigue estos pasos:

  1. Para navegar hacia el explorador de Google Kubernetes Engine mediante la vista de Cloud Code Ícono de Kubernetes Explorer, haz clic en su ícono en la barra de actividad de VS Code a la izquierda.
  2. Para autenticarte con el SDK de Cloud, haz clic en “'Click here to log in to Google Cloud SDK” (Hacer clic aquí para acceder al SDK de Google Cloud).
  3. En el encabezado del panel del Explorador de Google Kubernetes Engine, haz clic en el botón "+" (signo más) (disponible cuando desplazas el mouse) para crear un clúster de GKE nuevo.
  4. Asegúrate de crear el clúster en tu proyecto predeterminado.
  5. Completa los campos en el asistente de creación de clústeres y haz clic en “Create Cluster” (Crear clúster).

    En este ejemplo, el ID del proyecto se configura con el botón del ID del proyecto predeterminado, la zona se establece como “us-central1-a” y el nombre del clúster se define como “test” (prueba).

    La creación del clúster tarda unos minutos. Cuando se haya creado, tu clúster aparecerá en la vista de GKE Explorer Ícono de Kubernetes Explorer.

    Crea un clúster nuevo con GKE Explorer

Ejecuta la app

Ahora puedes ejecutar tu aplicación y verla en vivo. Además, Cloud Code inspecciona los cambios en tu sistema de archivos para que puedas editar y volver a ejecutar tu app casi en tiempo real.

Para ejecutar tu aplicación, sigue estos pasos:

  1. Usa la barra de estado de Cloud Code y selecciona Run on Kubernetes (Ejecutar en Kubernetes).
  2. Confirma si deseas usar el contexto del clúster actual (o cambia a uno que prefieras).
  3. Según el contexto que elijas, es posible que se te solicite seleccionar un registro de imágenes para enviarlas.
  4. Aparecerá una ventana de salida en la que podrás realizar un seguimiento del progreso de tu aplicación en ejecución. También verás una transmisión en vivo de los registros de los pods en ejecución dentro de la salida de la terminal.
  5. Una vez que se complete de forma correcta, en la ventana de salida se mostrará una dirección IP. Presiona Ctrl/Cmd + clic para usar esta dirección vinculada a fin de acceder a tu aplicación.

    Ejecuta la app de Hello World

Sugerencias para solucionar problemas

  1. Si usas un clúster preexistente, ejecuta gcloud container clusters get-credentials ${CLUSTER} --zone=${ZONE} para obtener las credenciales del clúster. Esto también agregará tu clúster a kubectl.

    Como alternativa, puedes navegar hacia GKE Explorer (como un panel accesible a través del explorador de Kubernetes en la vista de Cloud Code Ícono de Kubernetes Explorer). Haz clic con el botón derecho en el clúster que prefieras y selecciona “Establecer como clúster activo”.

Depura tu app

Para depurar la aplicación, sigue estos pasos:

  1. Usa la barra de estado de Cloud Code y selecciona Debug on Kubernetes (Depurar en Kubernetes).
  2. Si se te solicita, confirma si deseas usar el contexto del clúster actual (o cambia a uno que prefieras).

    En Cloud Code, se usa la configuración “cloudcode.kubernetes” en tu archivo .vscode/lanzamiento.json para ejecutar la aplicación y adjuntarle una sesión de depurador.

  3. Luego, Cloud Code compila tus contenedores, los envía al registro, aplica configuraciones de Kubernetes al clúster y muestra la dirección IP que puedes usar para explorar tu aplicación activa.

  4. Antes de adjuntar la sesión del depurador, se te pedirá que confirmes o ingreses el directorio en el contenedor remoto en el que se encuentra el programa que deseas depurar (o presiona Esc para omitir la depuración del contenedor).

  5. Haz clic en el margen del editor de app.js para agregar una interrupción.

    Los círculos rellenos de color rojo indican las interrupciones activas, mientras que los círculos vacíos de color gris indican las interrupciones inhabilitadas. Para un control de interrupciones más preciso, puedes usar la sección de interrupciones en la vista de depuración de VS Code.

    Sección de interrupciones en el panel izquierdo de la vista de depuración que permite agregar, quitar y, también, inhabilitar interrupciones

    Cada vez que envíes una solicitud nueva a tu aplicación, se detendrá en la línea deseada.

  6. Usa la Barra lateral de depuración para inspeccionar las variables y la información de pila (Opcional).

    Usa la consola de depuración ubicada en el depurador del panel inferior si deseas interactuar con la sesión de depuración.

    App detenida en la interrupción, variables y secciones de pila de llamadas propagadas con valores dentro del permiso

Visualiza registros

Si bien puedes ver una transmisión en vivo de los registros de los pods en ejecución dentro del resultado de la terminal de tu aplicación en ejecución, también puedes ver los registros con el visor de registros que viene con Cloud Code.

Para ver los registros, sigue estos pasos:

  1. Para iniciar el visor de registros, escribe Cloud Code: Ver registros mediante la paleta de comandos (accesible con Ctrl/Cmd + Mayúsculas + P o a través del menú “Administrar” marcado con un ícono de ajustes Ícono “Administrar”).
  2. Busca la app en ejecución, en este caso “nodejs-hello-world”, para ver los registros desde el campo de implementación en el cuadro de búsqueda del visor de registros.

    Ver registros mediante la configuración del campo de implementación dentro del cuadro de búsqueda del visor de registros en “nodejs-hello-world”.

Bonificación: Abre una terminal en tu contenedor

Además, si deseas abrir una terminal en tu contenedor, sigue estas instrucciones:

  1. Navega a Kubernetes Explorer.
  2. Selecciona el clúster y, desde la sección Pods subyacente, el pod al que deseas conectarte.
  3. En el pod especificado, expande la sección Containers (Contenedores) y haz clic con el botón derecho en el contenedor en el que deseas abrir una terminal.
  4. Selecciona Get Terminal (Obtener terminal).

    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

Realiza una limpieza

Una vez que finalices tu aplicación, todos los recursos de Kubernetes que implementaste durante la ejecución se borrarán de forma automática.

Sin embargo, para evitar que se apliquen cargos en tu cuenta por otros recursos que usaste en esta guía de inicio rápido, asegúrate de borrar el clúster y el proyecto que creaste.

Si usas Google Cloud y deseas borrar solo tu clúster, puedes hacerlo de la siguiente manera:

  • Con el explorador de Kubernetes en la vista de Cloud Code Ícono de Kubernetes Explorer, haz clic derecho en el clúster que deseas borrar del panel de Google Kubernetes Engine Explorer y selecciona “Delete cluster” (Borrar clúster).

Para borrar tu proyecto (y los recursos asociados, incluidos los clústeres), sigue estos pasos:

  • Ve a la página Proyectos en Cloud 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.

    Con esta acción, se cierra el proyecto y se programa su eliminación.

Próximos pasos