Instala la extensión de Cloud Code para VS Code

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

Antes de comenzar

Antes de instalar Cloud Code, confirma que las siguientes herramientas estén instalados y configurados 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 lo siguiente idiomas:

    • 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 Luego, agrégala a la variable de entorno PATH:

    • Si compilas solo con Cloud Build o Jib, puedes no instalar Docker.
    • Si usas Windows Home para configurar tu cliente Docker, consulta Guía de Docker Desktop para Windows Home.
    • Si usas WSL, pero no puedes instalar Docker para computadoras, usa en su lugar para el desarrollo local con Cloud Code.

  5. Si usas Google Cloud, crear un proyecto de Google Cloud y luego habilitar la facturación.

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

Instala Cloud Code

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 Ícono de extensión. Extensiones o presiona Ctrl/Cmd+Shift+X.

  2. Busca Google Cloud Code.

    Extensión de Cloud Code en VSC Marketplace

  3. Haz clic en Install.

  4. Si se te solicita, reinicia VS Code.

    Después de que la extensión se haya instalado correctamente, el Cloud Code se agregará a la barra de actividades y estará listo para que lo uses. Además, puedes configurar la instalación de Cloud Code especificando tu con la barra de tareas de la aplicación de nivel superior: navega a Code > Configuración > Configuración > Extensiones y buscar Gemini Code Assist + Google Cloud Code.

Versiones personalizadas de dependencias

De forma predeterminada, Cloud Code tiene activadas las dependencias automáticas. instala automáticamente algunas dependencias de línea de comandos. Si la desactivas de las dependencias automáticas, puede usar versiones personalizadas de las dependencias, debes instalar las dependencias por tu cuenta para que Cloud Code funcione.

Sigue estos pasos para usar versiones personalizadas de las dependencias de Cloud Code:

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

  2. Instala las siguientes dependencias en tu PATH:

Instala Google Cloud CLI

La primera vez que usas una función que requiere gcloud CLI, estás tienes la opción de aprender a instalar la CLI desde tu IDE, usa un archivo para la instalación o continuar con las dependencias administradas. Si prefieres instalar manualmente con gcloud CLI, consulta Instala gcloud CLI.

Opcional: Verifica Cloud Code vsix con VsixSignTool

Para verificar Cloud Code vsix con VsixSignTool, realiza la los siguientes pasos:

  1. Asegúrate de usar lo siguiente:

    • Administrador de paquetes de Nuget
    • SO Windows
    • Una versión de producción de Cloud Code

  2. Instala Microsoft VsixSignTool. y toma nota de la ruta de instalación.

  3. Abre VS Code y navega a Ícono de extensiones en VSC 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 de tu navegador, en Recursos, haz clic en Descarga la extensión para descargar la versión empaquetada de Cloud Code. Esto descarga la versión empaquetada de Cloud Code, que tiene una extensión de archivo .vsix, según tu configuración predeterminada directorio de descargas.

  6. Si prefieres verificar una versión diferente a la más reciente, haz clic en el Historial de versiones (Version History) y selecciona una versión diferente para descargar.

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

    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 credenciales para Google Cloud

Para ayudar en el desarrollo de aplicaciones con las APIs de Google Cloud, cuando accede a gcloud CLI, tu Credenciales predeterminadas de la aplicación las actualizaciones de software.

Accede a Google Cloud

Si no accediste a Google Cloud, sigue estos pasos para acceder:

  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 solicitará que agregues https://accounts.google.com a Dominio de confianza. Haz clic en Configurar dominios de confianza en el cuadro de diálogo que aparece:

    Diálogo Configurar dominio de confianza

  3. Sigue las indicaciones para acceder con el navegador web.

  4. Cuando se te solicite que permitas que Cloud Code acceda a tu cuenta de Google Cuenta, haz clic en Permitir.

Problema conocido: El navegador perimetral redirecciona a HTTPS en la devolución de llamada de autenticación

Cuando uses el navegador Microsoft Edge para autenticar tus credenciales, puedes Observa 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 del navegador Edge, ingresa edge://net-internals/#hsts.

  2. Vaya a la sección Borrar las 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. De forma alternativa, puedes salir 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.

Cambiar el proyecto activo de Google Cloud

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

    Nombre del proyecto activo en la barra de estado

  2. En el menú de Selección rápida que aparece, selecciona sync_alt Cambiar 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 en la Accede a Google Cloud, deberás hacer lo siguiente: autenticar tus credenciales para depurar localmente una aplicación en tu IDE que realiza llamadas a la API de Google.

Si no autenticas tus credenciales para depurar aplicaciones, se generará un error en tu IDE cuando intentas ejecutar o depurar una aplicación local que intenta realizar una llamada a una API de Google.

A fin de autenticar tus credenciales para depurar aplicaciones de forma local, realiza la los siguientes pasos:

  1. Instala gcloud en tu máquina si aún no lo has hecho. lo has hecho.

  2. Ejecuta el siguiente comando:

    gcloud auth application-default login

  3. Cuando hayas terminado la depuración local, puedes salir ejecutando el comando siguiente comando:

    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 Autentícate en los servicios de Cloud mediante bibliotecas cliente.

¿Qué sigue?

Obtener asistencia

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