Guía de inicio rápido

En esta página, se muestra cómo comenzar a usar Cloud Code con rapidez.

Configurarás una aplicación nueva de Kubernetes mediante una plantilla de inicio de “Hello World”, crearás un clúster, ejecutarás tu aplicación en él, depurarás tu código en ejecución, verás los registros de la aplicación activa y, también, conectarás una terminal al contenedor en ejecución.

Crea una app nueva de Hello World con Cloud Code

Antes de comenzar

Si deseas usar Google Cloud, deberás crear un proyecto de Google Cloud y habilitar la facturación.

Instala Cloud Code

  1. Si aún no lo hiciste, instala Visual Studio Code en tu máquina.
  2. Para todas las plataformas de Cloud, asegúrate de que esté instalado el cliente de Docker (autenticado con tu registro de Docker) en la PATH de tu máquina (su carpeta respectiva debe estar visible en un directorio dentro de tu PATH). Cloud Code instalará de forma automática kubectl, Skaffold y el SDK de Google Cloud.
  3. Instala Cloud Code mediante una de estas opciones:
    • Usa este vínculo para abrir VS Code y, luego, instalar Cloud Code.
    • Abre Visual Studio Code en tu máquina. En la vista “Extensiones” Ícono de extensión de VS Code (el ícono cuadrado disponible en la barra de tareas del lado izquierdo), busca la extensión “Cloud Code” y haz clic en “Install” (Instalar).
  4. Cuando se complete la instalación, verás la página de bienvenida de Cloud Code y una colección de plantillas integradas en Aplicaciones de inicio que puedes usar para configurar una aplicación nueva con rapidez.

    Página de bienvenida de Cloud Code

    Además, la barra de estado de Cloud Code, que incluye acciones comunes, ahora está disponible dentro de la barra de estado de VS Code.

    Página de bienvenida de Cloud Code

Crea una aplicación

  1. En la barra de estado de Cloud Code, selecciona Nueva aplicación.Crea una app nueva con la barra de estado de Cloud Code
  2. De la lista de plantillas (Node.js, Python [frameworks de Flask y Django], Java, Go), elige una app de Hello World en el lenguaje que elijas.

    Por ejemplo, si eliges Node.js: Hello World, se creará una app de Hello World de Node.js de inicio.

  3. Confirma la ubicación de tu aplicación para continuar (o modifícala si es necesario).

    Se enviará una notificación para confirmar que se creó tu aplicación y se abrirá una ventana nueva con ella.

Crea un clúster de Google Kubernetes Engine

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

  1. Navega hacia Google Kubernetes Engine Explorer mediante la vista de Cloud Code Ícono de Kubernetes Explorer. Para ello, 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 de Google Kubernetes Engine Explorer, haz clic en el botón “+” (signo más) (disponible cuando desplazas el mouse sobre un anuncio) 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. Una vez 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, la ventana de salida mostrará una dirección IP. 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 tu clúster preferido y selecciona “Configurar como clúster activo”.

Depura tu app

Para depurar tu 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. Escribe Cloud Code: View Logs a fin de iniciar el visor de registros mediante la paleta de comandos (accesible con Ctrl/Cmd + Mayúsculas + P o a través del menú “Manage” (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 hacia 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:

  • Mediante el 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 deseas borrar del panel del Google Kubernetes Engine Explorer y selecciona “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