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.

Antes de comenzar

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

Nota: Para aprovechar al máximo esta guía de inicio rápido, se recomienda crear un proyecto de Google Cloud. Esto te permitirá crear y trabajar con facilidad con un clúster de GKE activo, aprovechar la oferta de entrega continua de Cloud Code y usar sus capacidades de depuración en vivo.

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”  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.

   

   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.

   

Crea una aplicación

1. En la barra de estado de Cloud Code, selecciona Nueva aplicación.

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 . 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 “+” () (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 .

   

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.

   

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 ). 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.

   

   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.

   

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 ).

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.

   

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.

   

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 , 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

• Considera importar una aplicación existente a VS Code y configurar Cloud Code.
• Aborda la configuración más avanzada de Google Cloud y Kubernetes con la asistencia de edición de YAML de Cloud Code.
• Descubre la asistencia para la depuración específica del lenguaje que proporciona Cloud Code.
• Explora los diversos tipos de clústeres de Kubernetes con los que puedes trabajar mientras desarrollas con Cloud Code.
• Para obtener información más precisa sobre la administración de los recursos de Kubernetes, usa Kubernetes Explorer.
• Para personalizar tu experiencia en Cloud Code, establece los parámetros de la configuración relevante.