Instalar la extensión Cloud Code para VS Code

La extensión Cloud Code para VS Code añade compatibilidad con el Google Cloud desarrollo en VS Code.

Antes de empezar

Antes de instalar Cloud Code, comprueba 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 la compatibilidad con idiomas.

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

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

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

  4. Instala el cliente de Docker y añádelo a la variable de entorno PATH:

    • Si solo vas a usar Cloud Build o Jib, puedes saltarte la instalación de Docker.
    • Si usas WSL, pero no puedes instalar Docker Desktop, usa minikube para el desarrollo local con Cloud Code.

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

    Los proyectos te permiten reunir los recursos relacionados de una sola aplicación en un mismo lugar, gestionar APIs, habilitar servicios, añadir y quitar colaboradores, y gestionar los permisos de los recursos. Google Cloud Google Cloud

Instalar Cloud Code

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

También puedes abrir la vista Extensiones en VS Code:

  1. Haz clic en Icono de la extensión Extensiones o pulsa Ctrl/Cmd+Shift+X.

  2. Buscar Google Cloud Code.

    Extensión de Cloud Code en el mercado de VSC

  3. Haz clic en Instalar.

  4. Si se te pide, reinicia VS Code.

    Una vez que la extensión se haya instalado correctamente, el icono de Cloud Code se añadirá a la barra de actividad y estará listo para usarse. Puedes configurar aún más tu instalación de Cloud Code especificando tus preferencias en la barra de tareas de la aplicación de nivel superior: ve a Code > Settings > Settings > Extensions y busca Gemini Code Assist + Google Cloud Code.

Versiones personalizadas de las dependencias

De forma predeterminada, Cloud Code tiene activada la opción Dependencias automáticas e 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, sigue estos pasos:

  1. Haz clic en Configuración Gestionar > Configuración y, a continuación, activa Dependencias automáticas (cloudcode.autoDependencies) off.

  2. Instala las siguientes dependencias en tu PATH:

Instalar Google Cloud CLI

La primera vez que uses una función que requiera la CLI de gcloud, se te dará la opción de aprender a instalar la CLI desde tu IDE, usar una instalación que ya tengas o continuar con las dependencias gestionadas. Si prefieres instalar gcloud CLI manualmente, consulta Instalar gcloud CLI.

Opcional: Verificar 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 que cumples los siguientes requisitos:

    • Gestor de paquetes NuGet
    • Sistema operativo Windows
    • Una versión de producción de Cloud Code

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

  3. Abre VS Code y ve a Icono de extensiones en VSC Extensiones > Cloud Code.

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

  5. En la página de Marketplace de tu navegador, en Recursos, haz clic en Descargar extensión para descargar la versión empaquetada de Cloud Code. De esta forma, se descarga la versión empaquetada de Cloud Code, que tiene la extensión de archivo .vsix, en el directorio de descargas predeterminado.

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

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

    PATH_TO_VSIXSIGNTOOL verify PATH_TO_DOWNLOADED_VSIX

  8. Confirma que el resultado coincide con lo siguiente:

    VsixSignTool Success: Package PATH_TO_DOWNLOADED_VSIX is valid.

Autenticar las credenciales de Google Cloud

Para facilitar el desarrollo de aplicaciones con las APIs de Google Cloud , cuando inicias sesión en la CLI de gcloud, se actualizan tus credenciales predeterminadas de aplicación.

Inicia sesión en Google Cloud

Si no has iniciado sesión en Google Cloud, sigue estos pasos para hacerlo:

  1. En la barra de estado de Cloud Code, haz clic en Cloud Code - Iniciar sesión.

  2. Si es la primera vez que te conectas a Google Cloud en tu IDE, se te pedirá que añadas https://accounts.google.com a Dominios de confianza. En el cuadro de diálogo que aparece, haz clic en Configurar dominios de confianza:

    Cuadro de diálogo Configurar dominio de confianza

  3. Sigue las instrucciones para iniciar sesión con tu navegador web.

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

Problema conocido: el navegador Edge redirige a HTTPS en la retrollamada de autenticación

Cuando uses el navegador Microsoft Edge para autenticar tus credenciales, puede que observes que el navegador Edge redirige la URL http://localhost:3000 a https://localhost:3000. Esto provoca que se muestre 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 solucionar este problema, puedes excluir localhost de la redirección:

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

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

  3. Escribe localhost y haz clic en Eliminar.

Cerrar sesión en Google Cloud

  1. Haz clic en Cloud Code y, a continuación, expande Ayuda y comentarios.
  2. Haz clic en Cerrar sesión en Google Cloud y, cuando se te pida, selecciona Cerrar sesión.
  3. También puedes cerrar sesión mediante la paleta de comandos. Pulsa Ctrl/Cmd+Shift+P o haz clic en Ver > Paleta de comandos y, a continuación, en Cerrar sesión en todas las cuentas del SDK de Google Cloud.

Cambiar el proyecto Google Cloud activo

  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 de proyecto.

  3. Selecciona un proyecto o introduce palabras clave en la barra de búsqueda para filtrar los proyectos.

Autenticar credenciales para depurar aplicaciones de forma local

Además de los pasos de autenticación de la sección Iniciar sesión en Google Cloud, tendrás que autenticar tus credenciales para depurar una aplicación localmente en tu IDE que haga 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 hacer una llamada a una API de Google.

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

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

  2. Ejecuta el siguiente comando:

    gcloud auth application-default login

  3. Cuando hayas terminado de depurar de forma local, puedes cerrar sesión ejecutando el 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 el artículo Autenticarse en servicios de Cloud mediante bibliotecas de cliente.

Siguientes pasos

Obtener asistencia

Para enviar comentarios o informar de problemas, visita GitHub o haz una pregunta en Stack Overflow.