Cloud Code instala y administra minikube automáticamente. Si inhabilitaste la administración de dependencias, agrega el archivo 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 hiciste.
Crea una aplicación a partir de una plantilla
Cloud Code incluye una colección de plantillas de muestras de código para que puedas comenzar 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 Ver > Paleta de comandos) 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. Las opciones disponibles son NodeJS, Go, Python y Java.
Elige la ubicación que desees para tu aplicación en tu máquina local y, luego, haz clic en Create new application para guardar.
Cloud Code clona la muestra que elegiste y abre tu proyecto nuevo para usarlo.
Estructura de la aplicación de ejemplo
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: Es el mensaje que solicita la descarga de extensiones relacionadas cuando se abre este proyecto.launch.json: Configuración de lanzamiento (del tipocloudcode.kubernetes) para ejecutar o depurar la aplicación de Kubernetestasks.json: La 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 del Pod para los nodos de frontendmongo.deployment.yaml: Especificación del Pod para la base de datos
- src
(backend|frontend)/app.js: 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: Un archivo de configuración que Cloud Code usa para compilar, implementar y depurar aplicaciones de Kubernetes
Usa tu propia aplicación
Para conocer los pasos para usar un proyecto existente, consulta Cómo usar Cloud Code con una aplicación de Kubernetes existente.
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 configurando los parámetros disponibles.
Para agregar o editar configuraciones, ve a Run > Open Configurations y, luego, edita o agrega configuraciones.Crea e implementa una aplicación 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 archivo binario de minikube a tu PATH.
- Inicia la paleta de comandos (presiona
Ctrl/Cmd+Shift+Po haz clic en Ver > Paleta de comandos) y, luego, ejecuta el comando Cloud Code: Control minikube. - Haz clic en minikube en Elige un clúster (perfil) de Minikube para controlar y, luego, en Iniciar.
Ejecuta en minikube
- Abre la paleta de comandos y ejecuta Cloud Code: Run on Kubernetes.
- Haz clic en Sí para ¿Usar el contexto actual (minikube) para ejecutar la app?
Cloud Code ejecuta tu app en tu clúster de minikube. Si se te solicita, autoriza a Cloud Shell para que use tus credenciales para realizar una llamada a la API deGoogle 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 tu navegador con la aplicación en ejecución.
Abre una terminal interactiva en un contenedor
- Haz clic en
Cloud Code y, luego, expande el explorador de Development Sessions. - Expande Recursos implementados y, luego, Pods.
- Haz clic con el botón derecho en un contenedor y, luego, en Get Terminal.
Cómo pausar o detener un clúster de Minikube
- Inicia la paleta de comandos (presiona
Ctrl/Cmd+Shift+Po haz clic en Ver > Paleta de comandos) y, luego, ejecuta el comando Cloud Code: Control minikube. - Después de que se propague la opción Elige un clúster (perfil) de Minikube para controlar, haz clic en minikube y, luego, en Detener o Pausar.
Crea y agrega un clúster de 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 que Cloud Code funcione con un clúster local, asegúrate de que tu configuración predeterminada (por ejemplo, ~/.kube/config) contenga el clúster local. Este clúster debe configurarse 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