Installer Google Cloud SDK

Branche	Pipeline
master

Ce rôle Ansible permet d'installer Google Cloud SDK sur des machines de développement sous Ubuntu et macOS.

Ne pas utiliser ceci sur des serveurs de production.

Emplacement d'installation

Le rôle installe le Cloud SDK par défaut dans ~/google-cloud-sdk.

Pour l'installer à un autre emplacement, changez la variable gcloud_install_dir. Elle sera utilisée comme répertoire d'installation relatif au répertoire principal de l'utilisateur.

Par exemple, pour installer dans ~/opt/google-cloud-sdk, vous pouvez définir :

# Installer dans ~/opt/google-cloud-sdk
gcloud_install_dir: "/opt"

Pour des raisons de compatibilité, le rôle détectera automatiquement une installation existante dans ~/opt/google-cloud-sdk et y reviendra par défaut si elle est trouvée.

Préférer Python 3

L'installateur actuel de Google Cloud SDK cherchera les versions de Python disponibles et préférera python2 à python3.

Vous pouvez activer python3 pour qu'il soit préféré à python2 lors de l'installation.

gcloud_prefer_python3: true

Installer en utilisant le gestionnaire de paquets

Pour installer le Cloud SDK depuis le gestionnaire de paquets lorsqu'il est disponible, activez-le dans la configuration Ansible :

# Installer le Cloud SDK depuis APT
gcloud_install_from_package_manager: true

Cela n'est pris en charge que sur les systèmes basés sur Debian avec des dépôts APT.

Modifications des fichiers de configuration du shell

Ce rôle modifie les fichiers .bashrc et .zshrc s'ils existent dans votre répertoire principal. Il résoudra tous les liens symboliques vers vos fichiers de configuration lors des modifications.

La complétion du code pour la commande gcloud est chargée avec toutes les options d'installation.

Si vous gérez vos scripts shell .dotfiles ou utilisez un framework, vous devez définir gcloud_setup_shell sur false et mettre à jour ces fichiers vous-même pour les garder propres.

# Ne pas toucher à mes fichiers de configuration !
gcloud_setup_shell: false

Configuration manuelle de bash

Référencez la configuration de .bashrc lorsque installé dans ~/google-cloud-sdk à l'aide de l'archive :

if [ -d "$HOME/google-cloud-sdk" ]; then
  export CLOUDSDK_ROOT_DIR="$HOME/google-cloud-sdk"
  # Mettre à jour le PATH pour Google Cloud SDK.
  source $CLOUDSDK_ROOT_DIR/path.bash.inc
  # Activer la complétion bash pour gcloud.
  source $CLOUDSDK_ROOT_DIR/completion.bash.inc
fi

Si votre .bashrc contient déjà une ligne export CLOUDSDK_ROOT_DIR=, le fichier ne sera pas modifié.

Référencez la configuration de .bashrc lorsqu'installé depuis APT :

if [ -d "/usr/share/google-cloud-sdk" ]; then
  # Activer la complétion zsh pour gcloud.
  source /usr/share/google-cloud-sdk/completion.bash.inc
fi

Configuration manuelle de zsh

Référencez la configuration de .zshrc lorsque installé dans ~/google-cloud-sdk à l'aide de l'archive :

if [ -d "$HOME/google-cloud-sdk" ]; then
  export CLOUDSDK_ROOT_DIR="$HOME/google-cloud-sdk"
  # Mettre à jour le PATH pour Google Cloud SDK.
  source $CLOUDSDK_ROOT_DIR/path.zsh.inc
  # Activer la complétion zsh pour gcloud.
  source $CLOUDSDK_ROOT_DIR/completion.zsh.inc
fi

Si votre .zshrc contient déjà une ligne export CLOUDSDK_ROOT_DIR=, le fichier ne sera pas modifié.

Référencez la configuration de .zshrc lorsqu'installé depuis APT :

if [ -d "/usr/share/google-cloud-sdk" ]; then
  # Activer la complétion zsh pour gcloud.
  source /usr/share/google-cloud-sdk/completion.zsh.inc
fi

Mettre à jour la version

Mettez à jour la version de Cloud SDK dans les variables Ansible :

make update

Style de codage

Installez des hooks de pré-commit et validez le style de codage :

make lint

Exécuter des tests

Exécutez des tests sous Ubuntu et Debian en utilisant Docker :

make test

Licence

• MIT

Contributions

Le script d'installation est basé sur le rôle Ansible ansible/role-install-gcloud par @chouseknecht.

Auteurs

• @markosamuli