# Google Cloud CLI

Набор инструментов командной строки для управления проектами Google Cloud, облачными ресурсами и приложениями, подходящий для работы в терминале и автоматического развёртывания.

> Это Markdown-версия страницы Google Cloud CLI на OpenNavo с теми же сведениями, что и на веб-странице: <https://opennavo.com/ru/apps/gcloud-cli>

- **Последняя версия**: `594.0.0`
- **Разработчик**: Google
- **Главная**: <https://cloud.google.com/cli/>
- **Категории**: [Инструменты разработки](https://opennavo.com/ru/categories/developer-tools)
- **Установка**: `brew install --cask gcloud-cli`
- **Установки за последние 30 дней**: 50 571
- **Homebrew**: Можно установить, приложение обновляется само
- **Прежние токены**: google-cloud-sdk
- **Ссылка для загрузки**: <https://dl.google.com/dl/cloudsdk/channels/rapid/downloads/google-cloud-cli-594.0.0-darwin-arm.tar.gz>
- **SHA-256**: `45fbcc5a2caf9ec43847383d2f9fe4720eb8a650349be8d9bd271bdfb6912b55`
- **Включает команды**: git-credential-gcloud, gsutil, bq, docker-credential-gcloud, gcloud

SHA-256 лишь проверяет, что файл скачан полностью; это не сертификат безопасности.

## Примечания

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"

## Состав установки и удаления

```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"
  }
]
```

## Описание

Google Cloud CLI — это клиент командной строки Google для создания проектов Google Cloud, управления ими, а также для работы с ресурсами и развёртыванием приложений из терминала. Текущая зафиксированная версия — 592.0.0. На Mac он устанавливается из архивов Google или через Homebrew, после чего запускается `gcloud init`, чтобы выбрать аккаунт и проект.

### Для чего он нужен

`gcloud` охватывает настройку проекта, аутентификацию и команды для работы с ресурсами. Компонентные пакеты добавляют дополнительные группы команд, их можно устанавливать и удалять с помощью `gcloud components`. CLI — терминальный аналог Cloud Console: оба используют один и тот же аккаунт Google Cloud. Скрипты могут вызывать те же команды без браузера. Связанные клиенты перечислены в [категории Developer Tools](/categories/developer-tools).

### Установка на Mac

Google публикует отдельные архивы macOS для 64-битных Intel (x86_64) и 64-битных ARM64 (Apple silicon). Руководство по установке Google также описывает Homebrew. После установки запустите `gcloud init`, чтобы войти и задать проект и регион по умолчанию, или `gcloud auth login`, если нужно только обновить учётные данные. Проверьте сборку с помощью `gcloud version`.

Установку из архива обновляйте командой `gcloud components update`. Установка через Homebrew использует команду обновления своей formula, чтобы не смешивать две копии в PATH.

### Системные требования

В руководстве по установке Google указано, что CLI требует Python 3.10–3.15. Перед выбором архива x86_64 или ARM64 проверьте архитектуру Mac с помощью `uname -m`. В cask Homebrew указаны и Apple Silicon, и Intel. В таблице пакетов руководства по установке не указаны минимальная версия macOS, минимальный объём RAM и единая цифра по диску, кроме размеров архивов (около 54,8 МБ для x86_64 и 54,7 МБ для ARM64).

### Цена и лицензия

Google описывает CLI как клиент для аккаунта Google Cloud. Загрузка клиента доступна без отдельной цены за программное обеспечение на странице продукта. За созданные вами ресурсы начисляет плату соответствующий сервис Google Cloud. Для аутентификации используется аккаунт Google с доступом к проекту.

### Версии

Зафиксированная версия — 592.0.0. Google публикует примечания к выпускам CLI об изменениях компонентов и команд. Сравните клиент Microsoft на странице [Azure CLI](/apps/azure-cli), а доступ к сессиям AWS — в [Session Manager Plugin](/apps/session-manager-plugin).

### Связанные инструменты

Azure CLI управляет подписками Azure. Session Manager Plugin открывает сессии AWS Systems Manager. Используйте клиент, соответствующий имеющемуся у вас облачному аккаунту. Больше терминальных инструментов для Mac — в [коллекции Developer Workbench](/collections/developer-workbench).

### Частые вопросы

#### Какие версии Python нужны CLI?

Руководство по установке Google требует Python 3.10–3.15.

#### Как выбрать проект?

Запустите `gcloud init` и выберите аккаунт и проект или задайте их позже командой `gcloud config set project`.

#### Создаёт ли установка CLI облачные расходы?

Установка клиента сама по себе не создаёт оплачиваемых ресурсов. Расходы начинаются, когда вы развёртываете сервисы Google Cloud в аккаунте.

#### Как различить пакеты для Intel и Apple silicon?

Запустите `uname -m`. Google предоставляет архив darwin-x86_64 и архив darwin-arm.

Последнее обновление: 2026-11-05. Источники: руководство по установке Google Cloud CLI (https://docs.cloud.google.com/sdk/docs/install-sdk) — для Python 3.10–3.15 и таблицы архивов macOS; запись cask Homebrew — для версии 592.0.0.

## Системные требования

- Сборка для macOS 27, 26, 15, 14, 13, 12, 11 · Версия приложения: 594.0.0 · Intel · <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/g/gcloud-cli.rb> · Проверено 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`
- Сборка для macOS 27, 26, 15, 14, 13, 12, 11 · Версия приложения: 594.0.0 · Чип Apple · <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/g/gcloud-cli.rb> · Проверено 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`

## Удаление

- `brew uninstall --cask gcloud-cli`

Обычное удаление стирает приложение, но оставляет настройки и кеш.

### При удалении также обрабатываются

- Файлы и папки: `$HOMEBREW_PREFIX/Caskroom/gcloud-cli/latest` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/g/gcloud-cli.rb> · Эти пункты взяты из определения Homebrew, проверенного 2026-11-21. Они показывают только то, что по определению должно удаляться, и не означают, что всё это есть на вашем Mac.

### Глубокая очистка (по желанию)

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

`--zap` также удаляет настройки, кеш и другие файлы, перечисленные в определении Homebrew. Среди них могут быть данные, общие с другими приложениями; после удаления их нельзя восстановить. Полное отсутствие остаточных файлов тоже не гарантируется. Сначала создайте резервную копию данных, которые нужно сохранить. Чтобы сохранить настройки и кеш, не добавляйте `--zap`.

Обычное удаление стирает приложение, но оставляет настройки и кеш.

- Файлы и папки: `$HOMEBREW_PREFIX/share/google-cloud-sdk.staging` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/g/gcloud-cli.rb> · Эти пункты взяты из определения Homebrew, проверенного 2026-11-21. Они показывают только то, что по определению должно удаляться, и не означают, что всё это есть на вашем Mac.
- Файлы и папки: `$HOMEBREW_PREFIX/share/google-cloud-sdk` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/g/gcloud-cli.rb> · Эти пункты взяты из определения Homebrew, проверенного 2026-11-21. Они показывают только то, что по определению должно удаляться, и не означают, что всё это есть на вашем Mac.

## Примечания к последнему выпуску

### 594.0.0 (2026-11-17)

Google Cloud CLI 594.0.0 от 2026-11-17 больше не даёт --account и --project заменять позиционные аргументы и переводит несколько групп команд в общую доступность.

**Ломающие**

- \`--account\` больше не заменяет аргумент аккаунта при входе.
- Биллинг требует ACCOUNT_ID вместо позднего \`--account\`.
- shared-vpc требует PROJECT_ID вместо позднего \`--project\`.

**CLI**

- config-helper не падает при замене файла учётных данных.
- Сбойные операции включают причину ошибки и ссылки на справку.

**GA**

- Шифрование skills и загрузка ревизий Agent Registry теперь GA.
- Отмена публикации BigLake и blue-green Cloud SQL теперь GA.
- Пакетное создание и удаление Cloud Tasks теперь GA.
- Региональные точки деплоя и сервисов Cloud Run теперь GA.

**Новое**

- В AlloyDB добавлен тип z4d-highmem-16-standardlssd.
- Обновление Composer откатывает Composer 3 к прежнему образу.
- Создание и обновление GKE включают масштаб до нуля и задержку.

**Исправления**

- Деплой model-garden больше не игнорирует \`--system-labels\`.
- Обновление бакета теперь объединяет повторные метки.

## Сведения и источники

- <https://opennavo.com/ru/apps/gcloud-cli>
- <https://opennavo.com/ru/apps/gcloud-cli/versions>
- <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/g/gcloud-cli.rb> · Проверено 2026-11-21
- <https://formulae.brew.sh/cask/gcloud-cli>
