Esta guía esta diseñada para instalar Goolge Cloud CLI en Kubuntu/Ubuntu modernos (20.04, 22.04, 24.04). Vamos a realizar la explicación paso a paso en donde descargaremos el repositorio oficial y realizaremos la instalación.
Adicionalmente instalaremos la herramienta de kubectl para integrarla con la CLI.
Precondiciones
Debe Crear cuenta facturación google cloud para poder acceder a al Cloud de GCP
Parte 1: Instalar Google Cloud CLI
Eliminar claves (opcional)
Si tenemos claves ya registradas, las borramos para que no genere error, con esto podemos descargar las ultimas claves y que no se presenten errores al momento de instalar. usamos el comando rm de linux.
sudo rm -f /etc/apt/sources.list.d/google-cloud-sdk.list
sudo rm -f /usr/share/keyrings/cloud.google.gpg
Instalar dependencias necesarias
Procedes a actualizar los indices de paquetes y a actualizar los paquetes que lo requieran.
sudo apt update && sudo apt upgrade -y
Luego procedemos a instalar los siguientes paquetes:
sudo apt install -y apt-transport-https ca-certificates gnupg curl
Instala herramientas esenciales para:
apt-transport-https:Permite que APT use repositorios HTTPS.ca-certificates:Instala certificados raíz de confianza.gnupg:Instala herramientas GPG/GnuPG.curl:Herramienta para descargar contenido desde URLs.
Descargar la clave GPG oficial
El siguiente comando descarga la clave pública GPG oficial de Google y la convierte al formato que APT utiliza para verificar repositorios seguros.
Permitir que tu sistema confíe en el repositorio oficial de: Google
Para instalar software como:
- Google Cloud CLI
- kubectl
- componentes GKE
curl -fsSL https://packages.cloud.google.com/apt/doc/apt-key.gpg | \
sudo gpg --dearmor -o /usr/share/keyrings/cloud.google.gpg
Desglose completo
curl -fsSLhttps://packages.cloud.google.com/apt/doc/apt-key.gpg: Descarga el archivo de clave pública desde Internet. Contiene la clave GPG oficial de Google.-f:Fail silently on server errors. Si el servidor devuelve error (404, 500, etc.),curlfalla.-s:Silent mode. Oculta barra de progreso y mensajes innecesarios.-S:Muestra errores aunque esté en modo silencioso.-L:Follow redirects. Sigue redirecciones HTTP automáticamente.
- El pipe (
|): La salida del primer comando será la entrada del segundo.- Entonces: curl descarga la clave -> gpg la procesa
gpg --dearmor:Convierte la clave GPG desde formato ASCII/texto a formato binario compatible con APT.-o:Guarda el resultado convertido en: /usr/share/keyrings/cloud.google.gpg
¿Por qué esto es importante?: Cuando haces: apt update, APT verifica que los paquetes realmente vienen de Google, fueron modificados, la firma coincide
Dar permisos correctos
Procedemos a verificar si el archivo se creo correctamente y damos los permisos necesarios para su uso por APT:
Verificamos si ya se descargo el archivo:
ls -l /usr/share/keyrings/cloud.google.gpg
sudo chmod go+r /usr/share/keyrings/cloud.google.gpg
Respuesta: -rw-r--r-- 1 root root 695 May 21 10:52 /usr/share/keyrings/cloud.google.gpg
Crear el repositorio
Crea un archivo de configuración APT que registra el repositorio oficial de Google Cloud y le indica a Linux qué clave GPG usar para verificarlo de forma segura.
En otras palabras: Le dice a Kubuntu/Ubuntu dónde buscar paquetes oficiales de Google Cloud. Ejecutamos el siguiente comando:
echo "deb [signed-by=/usr/share/keyrings/cloud.google.gpg] https://packages.cloud.google.com/apt cloud-sdk main" | sudo tee /etc/apt/sources.list.d/google-cloud-sdk.list
Desglose completo
echo: simplemente imprime texto en pantalla.deb:Indica que el repositorio contiene paquetes binarios Debian/Ubuntu.[signed-by=...]:le dice a APT que usa esta clave GPG para verificar este repositorio.cloud-sdk:Es la distribución/repositorio específico. Contiene paquetes relacionados con: Google Cloud CLImain:Es la sección principal del repositorio.
- El pipe (|) conecta comandos
sudo tee:escribe texto en un archivo.- Archivo que crea
/etc/apt/sources.list.d/google-cloud-sdk.listAPT lee automáticamente todos los archivos .list de esa carpeta.
- Archivo que crea
Resultado final: Tu sistema queda configurado para usar el repositorio Google Cloud.
Después de ejecutarlo, APT podrá instalar software como:
- Google Cloud CLI
- componentes de GKE
- plugins de autenticación
- herramientas relacionadas con Google Cloud
Actualizar repositorios
Volvemos a actualizar el repositorio para que tome los cambios credos con la descarga del repositorio de Google Cloud
sudo apt update
Respuesta:
...
Des:12 https://packages.cloud.google.com/apt cloud-sdk/main amd64 Packages [4.735 kB]
Des:13 https://packages.cloud.google.com/apt cloud-sdk/main all Packages [2.012 kB]
Des:14 https://packages.cloud.google.com/apt cloud-sdk/main i386 Packages [1.124 kB]
Instalar Google Cloud CLI
Procedemos a instalar google cloud de la siguiente forma:
sudo apt install -y google-cloud-cli
Respuesta:
Instalando:
google-cloud-cli
Paquetes sugeridos:
google-cloud-cli-app-engine-java google-cloud-cli-bigtable-emulator
google-cloud-cli-app-engine-python google-cloud-cli-datastore-emulator
google-cloud-cli-pubsub-emulator kubectl
Resumen:
Actualizando: 0, Instalando 1, Eliminando: 0, no actualizando: 5
Tamaño de la descarga: 87,2 MB
Espacio necesario: 476 MB / 184 GB disponible
Des:1 https://packages.cloud.google.com/apt cloud-sdk/main amd64 google-cloud-cli amd64 569.0.0-0 [87,2 MB]
Descargados 87,2 MB en 4s (19,7 MB/s)
Seleccionando el paquete google-cloud-cli previamente no seleccionado.
(Leyendo la base de datos ... 280957 ficheros o directorios instalados actualmente.)
Preparando para desempaquetar .../google-cloud-cli_569.0.0-0_amd64.deb ...
Desempaquetando google-cloud-cli (569.0.0-0) ...
Configurando google-cloud-cli (569.0.0-0) ...
Procesando disparadores para libc-bin (2.43-2ubuntu2) ...
Verificar instalación
Procedemos a verificar si ha quedado todo correctamente instalado, ejecutamos:
gcloud version
Deberías ver algo similar a:
Google Cloud SDK 530.x.x
bq 2.x.x
core 2026.x.x
gcloud-crc32c 1.x.x
gsutil 5.x
Parte 2: Configurar Google Cloud CLI
Procedemos a iniciar sesión y a realizar la primera configuración, para poder ver los recursos que estamos usando en la consola web de Google.
Iniciar sesión
Ejecuta:
gcloud auth login
Esto hará lo siguiente:
- Abrirá el navegador
- Te pedirá iniciar sesión con tu cuenta Google
- Autorizará la CLI
Inicializar configuración
gcloud init
Te permitirá:
- Seleccionar cuenta
- Elegir proyecto
- Configurar región/zona
Ejemplo:
Please choose account:
[1] cuenta@gmail.com
Pick cloud project:
[1] mi-proyecto-dev
Ver proyecto activo
A continuación, tenemos varios comandos en donde verificamos y configuramos los proyectos de GCP.
Listamos proyectos activos.
gcloud config list
gcloud config get-value project
Configurar proyecto manualmente
gcloud config set project ID_DEL_PROYECTO
Plugins adicionales
Instalamos el siguiente plugin para que kubectl pueda autenticarse con el clustes gke de google.
sudo apt install google-cloud-cli-gke-gcloud-auth-plugin
Parte 3: Instalar kubectl
Procedemos a realizar la instalación y configuración del comando kubectl, para ello vamos a Instalar kubectl desde el repositorio oficial de Kubernetes, esta suele ser la más estable y universal.
Documentación oficial: https://kubernetes.io/docs/tasks/tools/install-kubectl-linux/?utm_source=chatgpt.com
Instalar dependencias
Procedemos a instalar las dependencias como ya lo realizamos en la nacionalista de google cloud
sudo apt update
sudo apt install -y apt-transport-https ca-certificates curl gnupg
Crear carpeta de llaves
Preparar la carpeta: /etc/apt/keyrings que Ubuntu/Kubuntu usa modernamente para guardar claves criptográficas de repositorios externos.
sudo mkdir -p -m 755 /etc/apt/keyrings
Desglose completo.
mkdir:crea la carpeta- -p: Crea también directorios padres si no existen.
- -m 755: Define permisos del directorio. rwxr-xr-x
- /etc/apt/keyrings: Es la ruta del directorio.
Descargar la clave oficial
Procedemos a descargar la clave GPG oficial de Kubernetes y la convierte al formato que APT utiliza para validar repositorios seguros.
curl -fsSL https://pkgs.k8s.io/core:/stable:/v1.30/deb/Release.key | sudo gpg --dearmor -o /etc/apt/keyrings/kubernetes-apt-keyring.gpg
Desglose completo
curl:Descarga desde Internet la clave pública oficial de Kubernetes.-f:Fail silently on server errors. Si el servidor devuelve error (404, 500, etc.),curlfalla.-s:Silent mode. Oculta barra de progreso y mensajes innecesarios.-S:Muestra errores aunque esté en modo silencioso.-L:Follow redirects. Sigue redirecciones HTTP automáticamente.
- El pipe (
|): La salida del primer comando será la entrada del segundo.- Entonces: curl descarga la clave -> gpg la procesa
gpg --dearmor:Convierte la clave GPG desde formato ASCII/texto a formato binario compatible con APT.-o:Guarda el resultado convertido en: /etc/apt/keyrings/kubernetes-apt-keyring.gpg
Qué logra este comando después de ejecutarlo:
- APT podrá verificar firmas del repositorio Kubernetes
- podrás instalar kubectl de forma segura
- Linux confiará criptográficamente en los paquetes Kubernetes
Agregar repositorio Kubernetes
Ahora, agregamos el repositorio oficial de Kubernetes al sistema APT de Ubuntu/Kubuntu.
En otras palabras: Le dice a Linux dónde descargar paquetes oficiales de Kubernetes, como kubectl.
echo 'deb [signed-by=/etc/apt/keyrings/kubernetes-apt-keyring.gpg] https://pkgs.k8s.io/core:/stable:/v1.30/deb/ /' | sudo tee /etc/apt/sources.list.d/kubernetes.list
echo: simplemente imprime texto en pantalla.deb:Indica que el repositorio contiene paquetes binarios Debian/Ubuntu.[signed-by=...]:le dice a APT que usa esta clave GPG para verificar este repositorio.cloud-sdk:Es la distribución/repositorio específico. Contiene paquetes relacionados con: Google Cloud CLImain:Es la sección principal del repositorio.
- El pipe (|) conecta comandos
sudo tee:escribe texto en un archivo.- Archivo que crea
/etc/apt/sources.list.d/kubernetes.listAPT lee automáticamente todos los archivos .list de esa carpeta.
- Archivo que crea
Actualizar repositorios
Volvemos a actualizar el repositorio para que tome los cambios credos con la descarga del repositorio de kubernetes.
sudo apt update
Instalar kubectl
Procedemos a instalar kubectl de la siguiente forma:
sudo apt install -y kubectl
Verificar instalación
Ejecutamos el siguiente comando para verificar que se ha instalado correctamente y muestre la version instalada.
kubectl version --client
Retorna:
Client Version: v1.33.12
Kustomize Version: v5.6.0
Verificar dónde quedó instalado
which kubectl
Responde: /usr/bin/kubectl
Preguntas frecuentas
¿Qué es Google Cloud CLI?
Google Cloud CLI es una herramienta oficial de línea de comandos para administrar recursos y servicios de Google Cloud Platform.
¿Qué es kubectl?
kubectl es la herramienta oficial de Kubernetes para administrar clusters, pods, deployments y servicios desde terminal.
¿Cómo instalar kubectl en Ubuntu?
kubectl se instala agregando el repositorio oficial de Kubernetes y usando apt install kubectl.
¿Qué es gke-gcloud-auth-plugin?
Es el plugin oficial requerido para autenticar kubectl contra clusters GKE usando Google Cloud CLI.