Comienza a usar Cloud Code para Cloud Shell en Kubernetes

Cloud Code te permite crear una aplicación de Kubernetes basada en una o a partir de un proyecto existente.

Crea una aplicación a partir de una plantilla

Cloud Code incluye una colección de plantillas de ejemplos de código para que puedas comenzar con rapidez. Para crear una aplicación de Kubernetes con una muestra existente, sigue estos pasos:

  1. Inicia la paleta de comandos (presiona Ctrl/Cmd+Shift+P o haz clic en Ver > Paleta de comandos) y, luego, ejecuta Cloud Code: Nueva aplicación.
  2. Selecciona Aplicación de Kubernetes para el tipo de muestra.
  3. Selecciona una muestra según el lenguaje que deseas usar. Las opciones disponibles son NodeJS, Go, Python y Java.

  4. Elige la ubicación que prefieras para la aplicación en tu máquina local y, luego, haz clic en Crea una aplicación nueva para guardar los cambios.

    Cloud Code clona la muestra que elegiste y abre la nueva el proyecto para usarlo.

Usa tu propia aplicación

Si quieres conocer los pasos para usar un proyecto existente, consulta Usar Cloud Code con una aplicación existente de Kubernetes

Configura tu contexto de Kubernetes

Antes de ejecutar la aplicación, asegúrate de realizar la configuración a fin de implementar tu app en el contexto de Kubernetes que prefieras. Puedes especificar esto en tu configuración.

Configuración

Cuando usas la configuración de ejecución Cloud Code: Develop on Kubernetes, puedes personalizar tu implementación mediante la configuración disponible.

Para agregar o editar parámetros de configuración, ve a Run > Open Configurations y, luego, edita o agrega parámetros de configuración.

Parámetros de configuración de compilación

Cloud Code es compatible con los tipos de artefactos Docker, Jib y Buildpacks. Consulta la guía de configuración de las preferencias de compilación de la imagen del contenedor para obtener información sobre cómo establecer tu compilador preferido y su configuración relevante.

Personaliza la configuración de inicio

Para configurar cómo se ejecuta tu aplicación, puedes personalizar Archivo skaffold.yaml.

Para obtener más información sobre cómo personalizar la configuración de lanzamiento, consulta Kubernetes en Cloud Code.

Ejecuta tu aplicación

Una vez que hayas configurado una aplicación, podrás ejecutarla en un clúster de Kubernetes y verla en vivo si aprovechas skaffold dev. Puedes ejecutar tu aplicación en un clúster local (como Minikube o Docker Desktop), Google Kubernetes Engine o cualquier otro proveedor de servicios en la nube.

  1. Abre la paleta de comandos (presiona Ctrl/Cmd+Shift+P) y, luego, ejecuta la Comando Cloud Code: Run on Kubernetes.
  2. Confirma si deseas usar el contexto de Kubernetes actual para ejecutar la app (o cambia a uno preferido). Para obtener más información sobre cómo configurar un contexto de Kubernetes, consulta Cómo configurar la configuración.

  3. Si elegiste un clúster remoto como contexto, cuando se te solicite, elige un registro de imágenes para enviar las imágenes. Si usas Container Registry, puedes busca un registro existente o especifica el nombre del registro que deseas crear. Si tu proyecto tiene La API de Artifact Registry está habilitada y al menos un repositorio de Artifact Registry puedes navegar hasta un repositorio existente de Artifact Registry y seleccionarlo.

    En los siguientes ejemplos, se muestra cómo especificar la ubicación de las imágenes de contenedor almacenados en algunos registros comunes:

    Artifact Registry {region}-docker.pkg.dev/{project_id}/{repo-name}
    Container Registry gcr.io/{project_id}
    Docker Hub docker.io/{account}
    Asegúrate de estar autenticado correctamente si usas un repositorio privado de Docker Hub.

    Cloud Code concatena este registro de imágenes con el nombre de imagen especificado en los manifiestos de Kubernetes para generar el nombre final del repositorio de imágenes.

    Para obtener más información, consulta la guía de manejo del registro de imágenes.

    Esta opción se almacena en tu configuración de inicio de cloudcode.kubernetes (que se encuentra en .vscode/lanzamiento.json).

    A continuación, Cloud Code compila los contenedores, los envía al registro, aplica las configuraciones de Kubernetes al clúster y espera el lanzamiento.

Visualiza registros

Además de ver los registros de los Pods en ejecución como una transmisión en vivo en el resultado de la terminal mientras desarrollas y ejecutas la aplicación, puedes ver los registros de un Pod específico si navegas hacia el explorador de Kubernetes.

Para ver los registros de un pod específico, sigue estos pasos:

  1. En Kubernetes Explorer, expande Implementaciones

  2. Haz clic con el botón derecho en el pod del que deseas ver los registros y, luego, en Ver registros.

    Se abrirá el Visor de registros.

Realiza cambios, vuelve a compilar y limpia

Si configuraste el modo de observación en false en la configuración de lanzamiento y deseas realizar cambios en la aplicación y volver a compilar y a implementar la aplicación, haz lo siguiente:

  1. Realiza y guarda los cambios.

  2. En la barra de herramientas de depuración, haz clic en Pause (F6) y, luego, en Reinicia (Ctrl/Cmd + Shift + F5) para volver a compilar y a implementar el y mantener la integridad de su aplicación.

  3. Para dejar de ejecutar la aplicación, haz clic en Detener en la barra de herramientas de depuración.

Después de detener la aplicación, todos los recursos de Kubernetes implementados del clúster. Puedes cambiar este comportamiento con el cleanUp. en tu configuración de inicio.

Almacena secretos

Si el código incluye datos potencialmente sensibles, como claves de API, contraseñas y certificados, se recomienda almacenarlos como secretos. Con Cloud Code, puedes almacenar estos secretos de forma segura en Secret Manager y recuperarlos de manera programática cuando los necesites.

Para obtener información detallada sobre cómo crear y administrar secretos con Cloud Code, consulta la guía de Secret Manager.

Ver detalles del recurso

Kubernetes Explorer muestra clústeres, espacios de nombres, nodos, cargas de trabajo (como implementaciones, conjuntos de réplicas, pods y contenedores), servicios y entradas, configuraciones (como secretos y mapas de configuración) y almacenamiento (como volúmenes). Con Kubernetes Explorer, puedes realizar acciones únicas en algunos de estos recursos.

Consulta la Descripción general de Kubernetes para obtener más información información sobre la visualización de los detalles de los recursos.

¿Qué sigue?