La extensión de Cloud Code para VS Code agrega compatibilidad con el desarrollo de Google Cloud a VS Code.
Antes de comenzar
Antes de instalar Cloud Code, confirma que las siguientes herramientas estén instaladas y configuradas en tu sistema:
- Instala y configura Visual Studio Code en tu máquina.
Instala y configura los archivos de compatibilidad del lenguaje pertinente.
La extensión de Cloud Code funciona mejor con los siguientes lenguajes:
Instala Git. Se requiere Git para copiar muestras en tu máquina.
Instala el cliente Docker y agrégalo a la variable de entorno
PATH
:- Si compilas exclusivamente con Cloud Build o Jib, puedes omitir la instalación de Docker.
- Si usas Windows Home y quieres ver los pasos para configurar tu cliente Docker, consulta la guía de Docker Desktop para Windows Home.
- Si usas WSL, pero no puedes instalar Docker para computadoras, usa minikube para desarrollar de manera local con Cloud Code.
Si usas Google Cloud, crea un proyecto de Google Cloud y, luego, habilita la facturación.
Los proyectos te permiten recopilar los recursos relacionados de una aplicación individual en un solo lugar, administrar las APIs, habilitar los servicios de Google Cloud, agregar y quitar colaboradores, y administrar permisos para los recursos de Google Cloud.
Instala Cloud Code
Instala la extensión de Google Cloud Code desde Visual Studio Code Marketplace.
También puedes abrir la vista Extensiones en VS Code:
Haz clic en Extensiones o presiona
Ctrl
/Cmd
+Shift
+X
.Busca
Google Cloud Code
.Haz clic en Install.
Si se te solicita, reinicia VS Code.
Una vez que la extensión se haya instalado correctamente, el ícono de Cloud Code se agregará a la barra de actividades y estará listo para usarse. Puedes configurar aún más la instalación de Cloud Code si especificas tus preferencias en la barra de tareas de nivel superior de la aplicación: Code > Preferences > Settings > Extensions > Cloud Code.
Versiones personalizadas de dependencias
De forma predeterminada, Cloud Code tiene activadas las dependencias automáticas y, además, instala algunas dependencias de línea de comandos automáticamente. Si desactivas las dependencias automáticas, puedes usar versiones personalizadas de las dependencias, pero debes instalarlas tú mismo para que Cloud Code funcione.
Para usar versiones personalizadas de las dependencias de Cloud Code, sigue estos pasos:
- Haz clic en settings
Administrar > Configuración y, luego, configura Dependencias automáticas (
cloudcode.autoDependencies
) enoff
. Instala las siguientes dependencias en tu
PATH
:- kubectl
- Skaffold
- minikube para desarrollo local
- Google Cloud CLI, si desarrollas con Google Cloud
Opcional: Verifica Cloud Code vsix con VsixSignTool
Para verificar el uso de vsix de Cloud Code con VsixSignTool, sigue estos pasos:
Asegúrate de usar lo siguiente:
- Administrador de paquetes de Nuget
- SO Windows
- Una versión de producción de Cloud Code
Instala Microsoft VsixSignTool y toma nota de la ruta de instalación.
Abre VS Code y navega hasta Extensiones > Cloud Code.
En la pestaña Details, en Extension Resources, haz clic en Marketplace.
En la página de Marketplace en el navegador, en Recursos, haz clic en Descargar extensión para descargar la versión empaquetada de Cloud Code. Con esta acción, se descarga la versión empaquetada de Cloud Code, que tiene una extensión de archivo
.vsix
, en tu directorio de descargas predeterminado.Si prefieres verificar una versión diferente a la más reciente, haz clic en la pestaña Historial de versiones (Version History) y selecciona una versión diferente para descargar.
Cuando se complete la descarga, abre una ventana de terminal y ejecuta lo siguiente:
PATH_TO_VSIXSIGNTOOL verify PATH_TO_DOWNLOADED_VSIX
Confirma que el resultado coincida con lo siguiente:
VsixSignTool Success: Package PATH_TO_DOWNLOADED_VSIX is valid.
Autentica credenciales para Google Cloud
Para ayudar con el desarrollo de aplicaciones con las APIs de Google Cloud, cuando accedes a gcloud CLI, se actualizan tus credenciales predeterminadas de la aplicación.
Accede a Google Cloud
Si no accediste a Google Cloud, sigue estos pasos para ingresar:
- En la barra de estado de Cloud Code, haz clic en Cloud Code - Acceder.
Si es la primera vez que te conectas a Google Cloud en tu IDE, se te solicitará que agregues
https://accounts.google.com
a un dominio de confianza. Haz clic en Configurar dominios de confianza en el cuadro de diálogo que aparece:Sigue las indicaciones para acceder con tu navegador web.
Cuando se te solicite que permitas que Cloud Code acceda a tu Cuenta de Google, haz clic en Permitir.
Problema conocido: El navegador Edge redirecciona a HTTPS en la devolución de llamada de autenticación
Cuando uses el navegador Microsoft Edge para autenticar tus credenciales, es posible que notes que este navegador redirecciona la URL http://localhost:3000
a https://localhost:3000
. Esto genera el siguiente mensaje de error:
The connection for this site is not secure. localhost sent an invalid response.
Try running Windows Network Diagnostics. ERR_SSL_PROTOCOL_ERROR.
Para resolver este problema, puedes excluir localhost
del redireccionamiento:
En la barra de direcciones del navegador Edge, ingresa
edge://net-internals/#hsts
.Ve a la sección Borra las políticas de seguridad del dominio.
Ingresa
localhost
y, luego, haz clic en Borrar.
Salir de Google Cloud
- Haz clic en Cloud Code y, luego, expande Ayuda y comentarios.
- Haz clic en Salir de Google Cloud y, cuando se te solicite, selecciona Salir.
- Como alternativa, puedes salir de la cuenta usando la paleta de comandos. Presiona
Ctrl
/Cmd
+Shift
+P
o haz clic en Ver > Paleta de comandos y, luego, haz clic en Salir de todas las cuentas en el SDK de Google Cloud.
Cambiar el proyecto activo de Google Cloud
En la barra de estado de Cloud Code, haz clic en el nombre del proyecto activo.
En el menú de selección rápida que aparece, selecciona sync_alt Cambiar proyecto.
Selecciona un proyecto o ingresa palabras clave en la barra de búsqueda para filtrar proyectos.
Autentica credenciales para depurar aplicaciones de forma local
Además de los pasos de autenticación de la sección Accede a Google Cloud, deberás autenticar tus credenciales para depurar de forma local en tu IDE una aplicación que realiza llamadas a la API de Google.
Si no autenticas tus credenciales para depurar aplicaciones, aparecerá un mensaje de error en tu IDE cuando intentes ejecutar o depurar una aplicación local que intente realizar una llamada a una API de Google.
Si deseas autenticar tus credenciales para depurar aplicaciones de forma local, sigue estos pasos:
Instala gcloud en tu máquina si aún no lo has hecho.
Ejecuta el siguiente comando:
gcloud auth application-default login
Cuando termines de depurar de forma local, ejecuta el siguiente comando para salir:
gcloud auth application-default revoke
Para obtener más información sobre las credenciales predeterminadas de la aplicación y las APIs de Google, consulta Autenticación en los servicios de Cloud con bibliotecas cliente.