Instala la extensión de Cloud Code para VS Code

La extensión de Cloud Code para VS Code agrega compatibilidad con el Google Cloud desarrollo en VS Code.

Antes de comenzar

Antes de instalar Cloud Code, confirma que las siguientes herramientas estén instaladas y configuradas en tu sistema:

1. Instala y configura Visual Studio Code en tu máquina.

2. Instala y configura los archivos de compatibilidad del lenguaje pertinente.

   La extensión de Cloud Code funciona mejor con los siguientes lenguajes:

   • NodeJS (la compatibilidad está integrada; no se requiere acción)
   • Go
   • Python
   • Java
   • .NET

3. Instala Git. Se requiere Git para copiar muestras en tu máquina.

4. Instala el cliente de 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 WSL, pero no puedes instalar Docker para computadoras de escritorio, usa minikube en su lugar a fin de realizar desarrollos locales con Cloud Code.

5. Si usas Google Cloud, crea un proyecto Google Cloud y, luego, habilita la facturación.

   Los proyectos te permiten recopilar los recursos relacionados de una sola aplicación en un solo lugar, administrar APIs, habilitar Google Cloud servicios, agregar y quitar colaboradores, y administrar permisos para los recursos de Google Cloud .

Instala Cloud Code

Nota: Cuando instalas Cloud Code, también se instala de forma predeterminada la extensión Gemini Code Assist.

Instala la extensión de Google Cloud Code desde Visual Studio Code Marketplace.

Como alternativa, abre la vista Extensiones en VS Code:

1. Haz clic en Extensiones o presiona Ctrl/Cmd+Shift+X.

2. Busca Google Cloud Code.

   

3. Haz clic en Install.

4. Si se te solicita, reinicia VS Code.

   Una vez que hayas instalado la extensión de forma correcta, se agregará el ícono de Cloud Code a la barra de actividades y estará listo para usar. Puedes configurar con más detalle la instalación de Cloud Code especificando tus preferencias a través de la barra de tareas del nivel superior de la aplicación: navega a Code > Settings > Settings > Extensions y busca Gemini Code Assist + Google Cloud Code.

Versiones personalizadas de dependencias

De forma predeterminada, Cloud Code tiene activada la opción Dependencias automáticas y, además, instala automáticamente algunas dependencias de línea de comandos. 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, haz lo siguiente:

1. Haz clic en Configuración Administrar > Configuración y, luego, establece Dependencias automáticas (cloudcode.autoDependencies) en off.

2. Instala las siguientes dependencias en tu PATH:

   • kubectl
   • Skaffold
   • minikube para el desarrollo local

Instala Google Cloud CLI

La primera vez que uses una función que requiera gcloud CLI, tendrás la opción de aprender a instalar la CLI desde tu IDE, usar una instalación existente o continuar con las dependencias administradas. Si prefieres instalar gcloud CLI de forma manual, consulta Instala la CLI de gcloud.

Opcional: Verifica el archivo .vsix de Cloud Code con VsixSignTool

Para verificar el archivo .vsix de Cloud Code con VsixSignTool, sigue estos pasos:

1. Asegúrate de usar lo siguiente:

   • Administrador de paquetes NuGet
   • SO Windows
   • Es una versión de producción de Cloud Code.

2. Instala Microsoft VsixSignTool y anota la ruta de acceso de instalación.

3. Abre VS Code y navega a Extensiones > Cloud Code.

4. En la pestaña Detalles, en Recursos de la extensión, haz clic en Marketplace.

5. En la página de Marketplace del navegador, en Recursos, haz clic en Descargar extensión para descargar la versión empaquetada de Cloud Code. Esto descargará la versión empaquetada de Cloud Code, que tiene una extensión de archivo .vsix, en tu directorio de descargas predeterminado.

6. Si prefieres verificar una versión diferente de la más reciente, haz clic en la pestaña Historial de versiones y selecciona otra versión para descargar.

   Nota: La versión más antigua de Cloud Code que puedes verificar con VsixSignTool es 1.20.2.

7. Cuando se complete la descarga, abre una ventana de terminal y ejecuta el siguiente comando:

   PATH_TO_VSIXSIGNTOOL verify PATH_TO_DOWNLOADED_VSIX
   

8. Confirma que el resultado coincida con lo siguiente:

   VsixSignTool Success: Package PATH_TO_DOWNLOADED_VSIX is valid.

Autentica las credenciales para Google Cloud

Para ayudarte 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 hacerlo:

1. En la barra de estado de Cloud Code, haz clic en Cloud Code - Acceder.

2. Si es la primera vez que te conectas a Google Cloud en tu IDE, se te pedirá que agregues https://accounts.google.com al dominio de confianza. Haz clic en Configurar dominios de confianza en el diálogo que aparece:

   

3. Sigue las instrucciones para acceder con tu navegador web.

4. Cuando se te solicite permitir 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 observes que el navegador Edge 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:

1. En la barra de direcciones de tu navegador Edge, ingresa edge://net-internals/#hsts.

2. Ve a la sección Borrar políticas de seguridad del dominio.

3. Ingresa localhost y, luego, haz clic en Borrar.

Salir de Google Cloud

1. Haz clic en Cloud Code y, luego, expande Ayuda y comentarios.
2. Haz clic en Salir de Google Cloud y, cuando se te solicite, selecciona Salir.
3. Como alternativa, puedes salir de tu cuenta con 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.

Cambia el proyecto Google Cloud activo

1. En la barra de estado de Cloud Code, haz clic en el nombre del proyecto activo.

   

2. En el menú Selección rápida que aparece, selecciona sync_alt Cambiar de proyecto.

3. 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 que se indican en la sección Accede a Google Cloud, deberás autenticar tus credenciales para depurar una aplicación de forma local en tu IDE que realice llamadas a las APIs 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.

Para autenticar tus credenciales y depurar aplicaciones de forma local, sigue estos pasos:

1. Si aún no lo hiciste, instala gcloud en tu máquina.

2. Ejecuta el siguiente comando:

   gcloud auth application-default login
   

3. Cuando termines de depurar de forma local, puedes salir de la cuenta con el siguiente comando:

   gcloud auth application-default revoke
   

Si deseas obtener más información sobre las credenciales predeterminadas de la aplicación y las APIs de Google, consulta Autentica los servicios de Cloud con bibliotecas cliente.

¿Qué sigue?

• Crear una aplicación
• Crea y configura un clúster de GKE
• Developing APIs using Apigee (Desarrollo de APIs con Apigee)

Obtener asistencia

Para enviar comentarios, informa problemas en GitHub o haz preguntas en Stack Overflow.