Установка Google Cloud SDK

Ветка	Пайплайн
master

Эта роль Ansible предназначена для установки Google Cloud SDK на машины разработки под Ubuntu и macOS.

Не используйте это на продуктивных серверах.

Место установки

Роль по умолчанию устанавливает Cloud SDK в ~/google-cloud-sdk.

Чтобы установить его в другое место, измените переменную gcloud_install_dir. Она будет использоваться как директория установки относительно домашней директории пользователя.

Например, чтобы установить в ~/opt/google-cloud-sdk, вы можете установить:

# Установить в ~/opt/google-cloud-sdk
gcloud_install_dir: "/opt"

Для обратной совместимости роль автоматически обнаружит существующую установку в ~/opt/google-cloud-sdk и установится по этому пути, если она найдена.

Предпочитать Python 3

Текущий установщик Google Cloud SDK будет искать доступные версии Python и отдавать предпочтение python2 над python3.

Вы можете включить предпочтение python3 над python2 во время установки.

gcloud_prefer_python3: true

Установка с помощью менеджера пакетов

Чтобы установить Cloud SDK из менеджера пакетов, если он доступен, включите это в конфигурации Ansible:

# Установить Cloud SDK из APT
gcloud_install_from_package_manager: true

Это поддерживается только на системах на основе Debian с репозиториями APT.

Изменения в конфигурационных файлах оболочки

Эта роль вносит изменения в файлы .bashrc и .zshrc, если они есть в вашей домашней директории. Она разрешит любые символические ссылки на ваши dotfiles при внесении изменений.

Автодополнение для команды gcloud будет загружено со всеми опциями установки.

Если вы управляете своими скриптами оболочки .dotfiles или используете фреймворк, вам следует установить gcloud_setup_shell в false и самостоятельно обновить эти файлы, чтобы сохранить их чистыми.

# Не трогайте мои dotfiles!
gcloud_setup_shell: false

Ручная настройка bash

Ссылки на конфигурацию .bashrc при установке в ~/google-cloud-sdk с использованием архива:

if [ -d "$HOME/google-cloud-sdk" ]; then
  export CLOUDSDK_ROOT_DIR="$HOME/google-cloud-sdk"
  # Обновить PATH для Google Cloud SDK.
  source $CLOUDSDK_ROOT_DIR/path.bash.inc
  # Включить автодополнение bash для gcloud.
  source $CLOUDSDK_ROOT_DIR/completion.bash.inc
fi

Если в вашем .bashrc уже есть строка export CLOUDSDK_ROOT_DIR=, файл не будет изменён.

Ссылки на конфигурацию .bashrc при установке из APT:

if [ -d "/usr/share/google-cloud-sdk" ]; then
  # Включить автодополнение zsh для gcloud.
  source /usr/share/google-cloud-sdk/completion.bash.inc
fi

Ручная настройка zsh

Ссылки на конфигурацию .zshrc при установке в ~/google-cloud-sdk с использованием архива:

if [ -d "$HOME/google-cloud-sdk" ]; then
  export CLOUDSDK_ROOT_DIR="$HOME/google-cloud-sdk"
  # Обновить PATH для Google Cloud SDK.
  source $CLOUDSDK_ROOT_DIR/path.zsh.inc
  # Включить автодополнение zsh для gcloud.
  source $CLOUDSDK_ROOT_DIR/completion.zsh.inc
fi

Если в вашем .zshrc уже есть строка export CLOUDSDK_ROOT_DIR=, файл не будет изменён.

Ссылки на конфигурацию .zshrc при установке из APT:

if [ -d "/usr/share/google-cloud-sdk" ]; then
  # Включить автодополнение zsh для gcloud.
  source /usr/share/google-cloud-sdk/completion.zsh.inc
fi

Обновление релиза

Обновите версию Cloud SDK в переменных Ansible:

make update

Стиль кодирования

Установите хуки pre-commit и проверьте стиль кодирования:

make lint

Запуск тестов

Запустите тесты в Ubuntu и Debian с помощью Docker:

make test

Лицензия

• MIT

Вклад

Скрипт установки основан на ansible/role-install-gcloud роли Ansible от @chouseknecht.

Авторы

• @markosamuli