Cloud Code instala y administra Minikube automáticamente. Si inhabilitaste la administración de dependencias, agrega el objeto binario de minikube a tu PATH.
Antes de comenzar
- Instala Git para que Cloud Code pueda realizar operaciones de Git, como clonar una muestra.
- Instala el complemento de Cloud Code si aún no lo has hecho.
Crea una aplicación a partir de una plantilla
Cloud Code incluye una colección de plantillas de muestras de código para que comiences con rapidez. Para crear una aplicación de Kubernetes con una muestra existente, sigue estos pasos:
- Inicia la paleta de comandos (presiona
Ctrl/Cmd+Shift+Po haz clic en View > Command Palette) y, luego, ejecuta Cloud Code: New Application. - Selecciona Kubernetes application como el tipo de muestra.
- Selecciona una muestra según el lenguaje que deseas usar entre las opciones disponibles: NodeJS, Go, Python y Java.
Elige una ubicación de aplicación preferida en tu máquina local y, luego, haz clic en Crear aplicación nueva para guardar los cambios.
Cloud Code clona la muestra que elegiste y abre tu proyecto nuevo para su uso.
Estructura de la aplicación de muestra
Los ejemplos de aplicación tienen la casi la misma estructura en todos los lenguajes. Esta no es la única estructura que se admite, pero es la que se recomienda para comenzar.
Por ejemplo, la estructura de la aplicación del libro de visitas de Node.js tiene el siguiente aspecto:
.
|---- .vscode
| └---- launch.json
|---- kubernetes-manifests
| |---- guestbook-backend.deployment.yaml
| |---- guestbook-backend.service.yaml
| |---- guestbook-frontend.deployment.yaml
| |---- guestbook-frontend.service.yaml
| |---- mongo.deployment.yaml
| └---- mongo.service.yaml
|---- src
| |---- backend
| | |---- Dockerfile
| | |---- index.js
| | |---- app.js
| | └---- package.json
| |---- frontend
| |---- Dockerfile
| |---- index.js
| | |---- app.js
| └---- package.json
└---- skaffold.yaml
Examina en mayor detalle esta app de muestra de Node.js del libro de visitas de Kubernetes; estos son algunos archivos de claves y sus usos:
- .vscode
extensions.json: Mensaje que solicita la descarga de extensiones relacionadas cuando se abre este proyectolaunch.json: Inicia la configuración (del tipocloudcode.kubernetes) para ejecutar o depurar la aplicación de Kubernetes.tasks.json: Información de configuración para las tareas de Visual Studio Code
- kubernetes-manifests
guestbook-backend.deployment.yaml: Especificación del Pod para los nodos de backendguestbook-frontend.deployment.yaml: Especificación de Pod para los nodos de frontendmongo.deployment.yaml: Especificación del Pod para la base de datos
- src
(backend|frontend)/app.js: El código de Node.js con la lógica del servidor web(backend|frontend)/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 Cloud Code usa para compilar, implementar y depurar aplicaciones de Kubernetes.
Usa tu propia aplicación
Si quieres conocer los pasos para usar un proyecto existente, consulta cómo usar Cloud Code con una aplicación de Kubernetes existente.
Establece el 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 especificarlo en tu configuración.
Configuración
Cuando usas la configuración de ejecución Cloud Code: Develop on Kubernetes, puedes personalizar la implementación mediante la configuración disponible.
Para agregar o editar configuraciones, ve a Ejecutar > Abrir configuraciones y, luego, edita o agrega configuraciones.Crea e implementa en un clúster de Minikube
Inicia un clúster de Minikube
Cloud Code instala y administra Minikube automáticamente. Si inhabilitaste la administración de dependencias, agrega el objeto binario de minikube a tu PATH.
- Inicia la paleta de comandos (presiona
Ctrl/Cmd+Shift+Po haz clic en View > Command Palette) y, luego, ejecuta el comando Cloud Code: Control minikube. - Haz clic en minikube en Elige un clúster de Minikube (perfil) para controlar y, luego, haz clic en Iniciar.
Ejecuta en Minikube
- Inicia la paleta de comandos y ejecuta Cloud Code: Run on Kubernetes.
- Haz clic en Sí en Use current context (minikube) para ejecutar la app?
Cloud Code ejecuta tu app en un clúster de Minikube. Si se te solicita, autoriza a Cloud Shell a usar tus credenciales para realizar una llamada a la API de Google Cloud.
Consulta los detalles de la implementación en la sección Sesiones de desarrollo de Cloud Code.
Para ver las URLs, haz clic en Portfoward URLs en la sección Development sessions y, luego, haz clic en el vínculo de la URL para abrir el navegador con la aplicación en ejecución.
Abre una terminal interactiva para un contenedor
- Haz clic en
Cloud Code y, luego, expande el explorador Development Sessions. - Expande Recursos implementados y, luego, Pods.
- Haz clic con el botón derecho en un contenedor y, luego, en Obtener terminal.
Pausar o detener un clúster de Minikube
- Inicia la paleta de comandos (presiona
Ctrl/Cmd+Shift+Po haz clic en View > Command Palette) y, luego, ejecuta el comando Cloud Code: Control minikube. - Después de que se propague la opción Elige un clúster de Minikube (perfil) para controlar, haz clic en minikube y, luego, en Detener o Pausar.
Crea y agrega un clúster desde otro proveedor de servicios en la nube
Si usas un clúster local o un clúster de otro proveedor, como Azure o AWS, usa las herramientas del proveedor para crear el clúster y agregarlo a tu KubeConfig.
Trabaja con otros clústeres locales
Además de minikube, puedes trabajar con Cloud Code si usas Docker Desktop (para Mac o Windows).
Para hacer que Cloud Code funcione con un clúster local, asegúrate de que la configuración predeterminada (por ejemplo, ~/.kube/config) contenga tu clúster local. Este clúster se debe configurar como el contexto actual.
Por ejemplo, si usabas un clúster local, docker-for-desktop, con Docker Desktop, configura tu clúster preferido con el siguiente comando:
kubectl config use-context docker-for-desktop
¿Qué sigue?
- Usa la sincronización de archivos y la recarga en caliente para acelerar el desarrollo.
- Depura tu aplicación en Cloud Code