Guía de inicio rápido para Windows

En esta página, se muestra cómo instalar el SDK de Google Cloud, inicializarlo y ejecutar los comandos principales de gcloud desde la línea de comandos.

Antes de comenzar

  1. Crea un proyecto de Google Cloud Platform, si todavía no tienes uno.
  2. Descarga el instalador del SDK de Google Cloud.

  3. Inicia el instalador y sigue las instrucciones.

  4. Después de que se haya completado la instalación, el instalador presenta varias opciones:

    Mensajes del instalador de Windows

    Asegúrate de seleccionar lo siguiente:

    • Iniciar el SDK de Google Cloud Shell
    • Ejecutar 'gcloud init'

    El instalador inicia una ventana de la terminal y ejecuta el comando gcloud init.

Sugerencias para solucionar problemas:

  • Si el SDK de Cloud no se ejecuta después de instalar la versión 274.0.0, consulta este error de seguimiento para conocer las soluciones más recientes.
  • Si la instalación no se realiza correctamente debido a que el comando find no se reconoce, asegúrate de que la variable de entorno PATH esté configurada para incluir la carpeta que contiene find. Por lo general, esto es C:\WINDOWS\system32;.
  • Después de desinstalar el SDK de Cloud, deberás reiniciar el sistema antes de volver a instalar el SDK de Cloud.

Inicializa el SDK

Usa el comando gcloud init para realizar varias tareas comunes de configuración del SDK. Algunas de estas tareas son autorizar a las herramientas del SDK para acceder a Google Cloud Platform con las credenciales de tu cuenta de usuario y establecer la configuración predeterminada del SDK.

Cómo inicializar el SDK:

  1. Ejecuta el siguiente comando en un símbolo de sistema:

    gcloud init
        

    Nota: Si se produce un error relacionado con la ausencia del comando de gcloud, consulta el paso 5 de la sección anterior.

    Nota: Para evitar que el comando inicie un navegador web, usa gcloud init --console-only en su lugar. Para autorizar sin un navegador web y de forma no interactiva, crea una cuenta de servicio con los permisos adecuados mediante Google Cloud Platform Console y usa gcloud auth activate-service-account con el archivo de claves JSON correspondiente.

  2. Acepta la opción para acceder con tu cuenta de usuario de Google:

        To continue, you must log in. Would you like to log in (Y/n)? Y
        
  3. En tu navegador, accede a tu cuenta de usuario de Google cuando se te solicite y haz clic en Permitir para autorizar el acceso a los recursos de Google Cloud Platform.

  4. En el símbolo del sistema, selecciona un proyecto de Cloud Platform de la lista de aquellos en los que tienes permiso de Propietario, Editor o Lector:

        Pick cloud project to use:
         [1] [my-project-1]
         [2] [my-project-2]
         ...
         Please enter your numeric choice:
        

    Si solo tienes un proyecto, gcloud init lo selecciona automáticamente.

  5. Si tienes habilitada la API de Google Compute Engine, gcloud init te permite elegir una zona predeterminada de Compute Engine:

        Which compute zone would you like to use as project default?
         [1] [asia-east1-a]
         [2] [asia-east1-b]
         ...
         [14] Do not use default zone
         Please enter your numeric choice:
        

    gcloud init confirma que completaste los pasos de configuración correctamente:

        gcloud has now been configured!
        You can use [gcloud config] to change more gcloud settings.
    
        Your active configuration is: [default]
        
  6. (Opcional) Si deseas una experiencia de lector de pantalla más optimizada, la herramienta de línea de comandos de gcloud incluye una propiedad accessibility/screen_reader.

    Para habilitar esta propiedad, ejecuta lo siguiente:

    gcloud config set accessibility/screen_reader true
        

    Para obtener más detalles sobre las funciones de accesibilidad que vienen con la herramienta de línea de comandos de gcloud, consulta la guía de habilitación de funciones de accesibilidad.

Ejecuta los comandos principales de gcloud

Ejecuta estos comandos de gcloud para ver información sobre la instalación del SDK:

  1. Para enumerar las cuentas cuyas credenciales están guardadas en el sistema local:

    gcloud auth list
        

    gcloud muestra una lista de cuentas con credenciales:

               Credentialed Accounts
        ACTIVE             ACCOUNT
        *                  example-user-1@gmail.com
                           example-user-2@gmail.com
        
  2. Para enumerar las propiedades en tu configuración del SDK activa:

    gcloud config list
        

    gcloud muestra la lista de propiedades:

        [core]
        account = example-user-1@gmail.com
        disable_usage_reporting = False
        project = example-project
        
  3. Para ver información sobre la instalación de tu SDK de Cloud y la configuración del SDK activa, sigue estos pasos:

    gcloud info
        

    gcloud muestra un resumen de la información sobre la instalación de tu SDK de Cloud. Esto incluye información sobre tu sistema, los componentes del SDK instalados, la cuenta de usuario activa, el proyecto actual y las propiedades en la configuración del SDK activa.

  4. Para ver información sobre los comandos de gcloud y otros temas de la línea de comandos:

    gcloud help
        

    Por ejemplo, para ver la ayuda de gcloud compute instances create:

    gcloud help compute instances create
        

    gcloud muestra un tema de ayuda que contiene una descripción del comando, una lista de marcas y argumentos del comando, y ejemplos de cómo usarlo.

Qué sigue

  • Lee la guía de la herramienta gcloud para obtener una descripción general de la herramienta de línea de comandos de gcloud, que incluye una introducción rápida a conceptos clave, convenciones de comandos y sugerencias útiles.
  • Lee la guía de referencia de gcloud para obtener páginas detalladas sobre cada comando gcloud, incluidas descripciones, marcas y ejemplos, que puedes usar para realizar diversas tareas en Google Cloud Platform.
  • Instala componentes adicionales, como los emuladores de App Engine o kubectl con el administrador de componentes del SDK de Cloud.