# Google Cloud CLI

Un conjunto de herramientas de línea de comandos para gestionar proyectos de Google Cloud, recursos en la nube y aplicaciones, adecuado para operaciones en terminal y despliegues automatizados.

> Esta es la versión en Markdown de la página de Google Cloud CLI en OpenNavo, con el mismo contenido que la página web: <https://opennavo.com/es/apps/gcloud-cli>

- **Última versión**: `594.0.0`
- **Desarrollador**: Google
- **Inicio**: <https://cloud.google.com/cli/>
- **Categorías**: [Herramientas de desarrollo](https://opennavo.com/es/categories/developer-tools)
- **Instalación**: `brew install --cask gcloud-cli`
- **Instalaciones en los últimos 30 días**: 50.571
- **Homebrew**: Se puede instalar; la app se actualiza sola
- **Tokens anteriores**: google-cloud-sdk
- **URL de descarga**: <https://dl.google.com/dl/cloudsdk/channels/rapid/downloads/google-cloud-cli-594.0.0-darwin-arm.tar.gz>
- **SHA-256**: `45fbcc5a2caf9ec43847383d2f9fe4720eb8a650349be8d9bd271bdfb6912b55`
- **Comandos incluidos**: git-credential-gcloud, gsutil, bq, docker-credential-gcloud, gcloud

SHA-256 solo comprueba que la descarga esté completa; no es una certificación de seguridad.

## Avisos

To use additional binary components installed via gcloud, add the "$HOMEBREW_PREFIX/share/google-cloud-sdk/bin" directory to your PATH environment variable, e.g., (for Bash shell): export PATH=$HOMEBREW_PREFIX/share/google-cloud-sdk/bin:"$PATH"

## Contenido de instalación y desinstalación

```json
[
  {
    "declaration": {
      "preflight_steps": [
        {
          "steps": [
            {
              "recursive": true,
              "source": {
                "base": "staged_path",
                "path": "google-cloud-sdk/."
              },
              "target": {
                "base": "homebrew_prefix",
                "path": "share/google-cloud-sdk"
              },
              "type": "copy"
            },
            {
              "paths": [
                {
                  "base": "staged_path",
                  "path": "google-cloud-sdk"
                }
              ],
              "recursive": true,
              "type": "remove"
            },
            {
              "source": {
                "path": "{{HOMEBREW_PREFIX}}/share/google-cloud-sdk"
              },
              "target": {
                "base": "staged_path",
                "path": "google-cloud-sdk"
              },
              "type": "symlink"
            }
          ]
        }
      ]
    },
    "phase": "install",
    "sources": [],
    "type": "preflight_steps"
  },
  {
    "declaration": {
      "uninstall": [
        {
          "trash": "$HOMEBREW_PREFIX/Caskroom/gcloud-cli/latest"
        }
      ]
    },
    "phase": "uninstall",
    "sources": [],
    "type": "uninstall"
  },
  {
    "declaration": {
      "installer": [
        {
          "script": {
            "args": [
              "--quiet",
              "--usage-reporting",
              "false",
              "--bash-completion",
              "false",
              "--path-update",
              "false",
              "--rc-path",
              "false",
              "--update-installed-components",
              "--install-python",
              "false"
            ],
            "executable": "google-cloud-sdk/install.sh"
          }
        }
      ]
    },
    "phase": "install",
    "sources": [],
    "type": "installer"
  },
  {
    "declaration": {
      "binary": [
        "google-cloud-sdk/bin/git-credential-gcloud.sh",
        {
          "target": "git-credential-gcloud"
        }
      ],
      "target": "$HOMEBREW_PREFIX/bin/git-credential-gcloud"
    },
    "phase": "install",
    "sources": [
      "google-cloud-sdk/bin/git-credential-gcloud.sh"
    ],
    "target": "$HOMEBREW_PREFIX/bin/git-credential-gcloud",
    "type": "binary"
  },
  {
    "declaration": {
      "binary": [
        "google-cloud-sdk/bin/gsutil"
      ],
      "target": "$HOMEBREW_PREFIX/bin/gsutil"
    },
    "phase": "install",
    "sources": [
      "google-cloud-sdk/bin/gsutil"
    ],
    "target": "$HOMEBREW_PREFIX/bin/gsutil",
    "type": "binary"
  },
  {
    "declaration": {
      "binary": [
        "google-cloud-sdk/bin/bq"
      ],
      "target": "$HOMEBREW_PREFIX/bin/bq"
    },
    "phase": "install",
    "sources": [
      "google-cloud-sdk/bin/bq"
    ],
    "target": "$HOMEBREW_PREFIX/bin/bq",
    "type": "binary"
  },
  {
    "declaration": {
      "binary": [
        "google-cloud-sdk/bin/docker-credential-gcloud"
      ],
      "target": "$HOMEBREW_PREFIX/bin/docker-credential-gcloud"
    },
    "phase": "install",
    "sources": [
      "google-cloud-sdk/bin/docker-credential-gcloud"
    ],
    "target": "$HOMEBREW_PREFIX/bin/docker-credential-gcloud",
    "type": "binary"
  },
  {
    "declaration": {
      "binary": [
        "google-cloud-sdk/bin/gcloud"
      ],
      "target": "$HOMEBREW_PREFIX/bin/gcloud"
    },
    "phase": "install",
    "sources": [
      "google-cloud-sdk/bin/gcloud"
    ],
    "target": "$HOMEBREW_PREFIX/bin/gcloud",
    "type": "binary"
  },
  {
    "declaration": {
      "bash_completion": [
        "google-cloud-sdk/completion.bash.inc",
        {
          "target": "google-cloud-sdk"
        }
      ],
      "target": "$HOMEBREW_PREFIX/etc/bash_completion.d/google-cloud-sdk"
    },
    "phase": "install",
    "sources": [
      "google-cloud-sdk/completion.bash.inc"
    ],
    "target": "$HOMEBREW_PREFIX/etc/bash_completion.d/google-cloud-sdk",
    "type": "bash_completion"
  },
  {
    "declaration": {
      "target": "$HOMEBREW_PREFIX/share/zsh/site-functions/_google_cloud_sdk",
      "zsh_completion": [
        "google-cloud-sdk/completion.zsh.inc",
        {
          "target": "_google_cloud_sdk"
        }
      ]
    },
    "phase": "install",
    "sources": [
      "google-cloud-sdk/completion.zsh.inc"
    ],
    "target": "$HOMEBREW_PREFIX/share/zsh/site-functions/_google_cloud_sdk",
    "type": "zsh_completion"
  },
  {
    "declaration": {
      "postflight_steps": [
        {
          "steps": [
            {
              "force": true,
              "guards": [
                {
                  "condition": "unless_exists",
                  "id": "1",
                  "path": "{{caskroom_path}}/latest"
                }
              ],
              "source": {
                "path": "{{staged_path}}"
              },
              "target": {
                "path": "{{caskroom_path}}/latest"
              },
              "type": "symlink"
            },
            {
              "args": [
                "config",
                "virtualenv",
                "delete",
                "-q"
              ],
              "command": {
                "base": "homebrew_prefix",
                "path": "share/google-cloud-sdk/bin/gcloud"
              },
              "env": {
                "CLOUDSDK_PYTHON": "{{HOMEBREW_PREFIX}}/opt/python@3.14/libexec/bin/python"
              },
              "guards": [
                {
                  "condition": "on",
                  "id": "2",
                  "value": "macos"
                },
                {
                  "condition": "if_exists",
                  "id": "3",
                  "path": "~/.config/gcloud/virtenv"
                }
              ],
              "type": "run"
            },
            {
              "args": [
                "config",
                "virtualenv",
                "create",
                "--python-to-use",
                "{{HOMEBREW_PREFIX}}/opt/python@3.14/libexec/bin/python"
              ],
              "command": {
                "base": "homebrew_prefix",
                "path": "share/google-cloud-sdk/bin/gcloud"
              },
              "env": {
                "CLOUDSDK_PYTHON": "{{HOMEBREW_PREFIX}}/opt/python@3.14/libexec/bin/python"
              },
              "guards": [
                {
                  "condition": "on",
                  "id": "2",
                  "value": "macos"
                }
              ],
              "network_access": true,
              "type": "run"
            },
            {
              "args": [
                "config",
                "virtualenv",
                "enable"
              ],
              "command": {
                "base": "homebrew_prefix",
                "path": "share/google-cloud-sdk/bin/gcloud"
              },
              "env": {
                "CLOUDSDK_PYTHON": "{{HOMEBREW_PREFIX}}/opt/python@3.14/libexec/bin/python"
              },
              "guards": [
                {
                  "condition": "on",
                  "id": "2",
                  "value": "macos"
                }
              ],
              "type": "run"
            },
            {
              "args": [
                "version"
              ],
              "command": {
                "base": "homebrew_prefix",
                "path": "share/google-cloud-sdk/bin/gcloud"
              },
              "env": {
                "CLOUDSDK_PYTHON": "{{HOMEBREW_PREFIX}}/opt/python@3.14/libexec/bin/python"
              },
              "guards": [
                {
                  "condition": "on",
                  "id": "2",
                  "value": "macos"
                }
              ],
              "type": "run"
            }
          ]
        }
      ]
    },
    "phase": "install",
    "sources": [],
    "type": "postflight_steps"
  },
  {
    "declaration": {
      "zap": [
        {
          "trash": [
            "$HOMEBREW_PREFIX/share/google-cloud-sdk.staging",
            "$HOMEBREW_PREFIX/share/google-cloud-sdk"
          ]
        }
      ]
    },
    "phase": "cleanup",
    "sources": [],
    "type": "zap"
  }
]
```

## Descripción

Google Cloud CLI es el cliente de línea de comandos de Google para crear y gestionar proyectos, recursos y despliegues de aplicaciones de Google Cloud desde una terminal. La versión registrada actual es 592.0.0. En un Mac se instala desde los archivos de Google o con Homebrew; después se ejecuta `gcloud init` para elegir una cuenta y un proyecto.

### Para qué sirve

`gcloud` cubre la configuración de proyectos, la autenticación y los comandos de recursos. Los paquetes de componentes añaden grupos de comandos adicionales y se pueden instalar o eliminar con `gcloud components`. La CLI es la contraparte en terminal de Cloud Console: ambas usan la misma cuenta de Google Cloud. Los scripts pueden llamar a los mismos comandos sin el navegador. Los clientes relacionados se listan en la [categoría Developer Tools](/categories/developer-tools).

### Instalación en Mac

Google publica archivos macOS separados para Intel de 64 bits (x86_64) y ARM64 de 64 bits (Apple silicon). La guía de instalación de Google también documenta Homebrew. Tras la instalación, ejecute `gcloud init` para iniciar sesión y definir un proyecto y una región predeterminada, o `gcloud auth login` cuando solo necesite actualizar las credenciales. Compruebe la compilación con `gcloud version`.

Actualice una instalación desde archivo con `gcloud components update`. Una instalación con Homebrew sigue el comando de actualización de esa formula para no mezclar dos copias en PATH.

### Requisitos del sistema

La guía de instalación de Google indica que la CLI requiere Python 3.10 a 3.15. Confirme la arquitectura del Mac con `uname -m` antes de elegir el archivo x86_64 o ARM64. La cask de Homebrew registra tanto Apple Silicon como Intel. La tabla de paquetes de la guía de instalación no indica una versión mínima de macOS, una RAM mínima ni una cifra única de disco más allá de los tamaños de archivo indicados (unos 54,8 MB para x86_64 y 54,7 MB para ARM64).

### Precio y licencia

Google documenta la CLI como el cliente para una cuenta de Google Cloud. La descarga del cliente está disponible sin un precio de software aparte en la página del producto. Los recursos que cree se facturan por esos servicios de Google Cloud. La autenticación usa una cuenta de Google con acceso al proyecto.

### Versiones

La versión registrada es 592.0.0. Google publica notas de la versión de la CLI para los cambios de componentes y comandos. Compare el cliente de Microsoft en la página de [Azure CLI](/apps/azure-cli) y el acceso a sesiones de AWS en [Session Manager Plugin](/apps/session-manager-plugin).

### Herramientas relacionadas

Azure CLI administra suscripciones de Azure. Session Manager Plugin abre sesiones de AWS Systems Manager. Use el cliente que corresponda a la cuenta de nube que ya tiene. Hay más herramientas de terminal para Mac en la [colección Developer Workbench](/collections/developer-workbench).

### Preguntas frecuentes

#### ¿Qué versiones de Python necesita la CLI?

La guía de instalación de Google requiere Python 3.10 a 3.15.

#### ¿Cómo elijo un proyecto?

Ejecute `gcloud init` y seleccione la cuenta y el proyecto, o defínalos más tarde con `gcloud config set project`.

#### ¿Instalar la CLI genera cargos en la nube?

Instalar el cliente no crea por sí mismo recursos facturables. Los cargos empiezan cuando aprovisiona servicios de Google Cloud en la cuenta.

#### ¿Cómo distingo los paquetes de Intel y de Apple silicon?

Ejecute `uname -m`. Google incluye un archivo darwin-x86_64 y un archivo darwin-arm.

Última actualización: 2026-11-05. Fuentes: guía de instalación de Google Cloud CLI (https://docs.cloud.google.com/sdk/docs/install-sdk) para Python 3.10–3.15 y la tabla de archivos macOS, y el registro de la cask de Homebrew para la versión 592.0.0.

## Requisitos del sistema

- Versión para macOS 27, 26, 15, 14, 13, 12, 11 · Versión de la app: 594.0.0 · Intel · <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/g/gcloud-cli.rb> · Comprobado el 2026-11-21
  - <https://dl.google.com/dl/cloudsdk/channels/rapid/downloads/google-cloud-cli-594.0.0-darwin-x86_64.tar.gz>
  - SHA-256: `f8c788cb2ce0af3bd03f236d67c825afe810908f4cd1ade435eb7b5bfb4173c7`
- Versión para macOS 27, 26, 15, 14, 13, 12, 11 · Versión de la app: 594.0.0 · Chip Apple · <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/g/gcloud-cli.rb> · Comprobado el 2026-11-21
  - <https://dl.google.com/dl/cloudsdk/channels/rapid/downloads/google-cloud-cli-594.0.0-darwin-arm.tar.gz>
  - SHA-256: `45fbcc5a2caf9ec43847383d2f9fe4720eb8a650349be8d9bd271bdfb6912b55`

## Desinstalación

- `brew uninstall --cask gcloud-cli`

Una desinstalación normal elimina la App y conserva sus ajustes y cachés.

### Qué más gestiona la desinstalación

- Archivos y carpetas: `$HOMEBREW_PREFIX/Caskroom/gcloud-cli/latest` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/g/gcloud-cli.rb> · Estas entradas proceden de la definición de Homebrew, comprobada el 2026-11-21. Solo indican lo que la definición declara que se eliminará, no que todo esté en tu Mac.

### Limpieza a fondo (opcional)

- `brew uninstall --zap --cask gcloud-cli`

`--zap` también borra los ajustes, cachés y otros archivos que indica la definición de Homebrew. Pueden incluir datos compartidos con otras apps y no se pueden recuperar tras borrarlos; tampoco garantiza que no quede ningún resto. Haz primero una copia de seguridad de los datos que necesites conservar. Para conservar los ajustes y cachés, no añadas `--zap`.

Una desinstalación normal elimina la App y conserva sus ajustes y cachés.

- Archivos y carpetas: `$HOMEBREW_PREFIX/share/google-cloud-sdk.staging` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/g/gcloud-cli.rb> · Estas entradas proceden de la definición de Homebrew, comprobada el 2026-11-21. Solo indican lo que la definición declara que se eliminará, no que todo esté en tu Mac.
- Archivos y carpetas: `$HOMEBREW_PREFIX/share/google-cloud-sdk` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/g/gcloud-cli.rb> · Estas entradas proceden de la definición de Homebrew, comprobada el 2026-11-21. Solo indican lo que la definición declara que se eliminará, no que todo esté en tu Mac.

## Notas de la última versión

### 594.0.0 (2026-11-17)

Google Cloud CLI 594.0.0, publicado el 2026-11-17, evita que --account y --project sustituyan argumentos posicionales y pasa varios grupos de comandos a disponibilidad general.

**Rupturas**

- \`--account\` ya no sustituye el argumento de cuenta.
- Facturación exige ACCOUNT_ID ante un \`--account\` posterior.
- shared-vpc exige PROJECT_ID ante un \`--project\` posterior.

**CLI**

- config-helper ya no se bloquea al sustituir credenciales.
- Las operaciones fallidas incluyen el motivo y enlaces de ayuda.

**GA**

- Cifrado de skills y descarga de revisiones de Agent Registry son GA.
- Anulación de BigLake e implementaciones blue-green de Cloud SQL son GA.
- Creación y eliminación por lotes de Cloud Tasks ya son GA.
- Los extremos regionales de deploy y servicios de Cloud Run ya son GA.

**Nuevo**

- AlloyDB añade la máquina z4d-highmem-16-standardlssd.
- Composer puede revertir Composer 3 a la imagen anterior.
- Crear y actualizar GKE puede activar escala a cero y un retraso.

**Arreglos**

- El deploy de model-garden ya no ignora \`--system-labels\`.
- La actualización de buckets fusiona las etiquetas repetidas.

## Datos y fuentes

- <https://opennavo.com/es/apps/gcloud-cli>
- <https://opennavo.com/es/apps/gcloud-cli/versions>
- <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/g/gcloud-cli.rb> · Comprobado el 2026-11-21
- <https://formulae.brew.sh/cask/gcloud-cli>
