Guía de inicio rápido

En esta guía de inicio rápido, se muestra cómo implementar una aplicación en contenedores con Google Kubernetes Engine.

Puedes seguir los pasos que se enumeran en esta página o probar esta guía de inicio rápido como un lab de capacitación de Google Cloud.

Prueba con un lab

Antes de comenzar

Sigue los pasos que se indican a continuación para habilitar la API de Kubernetes Engine:
  1. Consulta la página de Kubernetes Engine en Google Cloud Platform Console.
  2. Crea o selecciona un proyecto.
  3. Espera a que la API y los servicios relacionados se habiliten. Esto puede tardar varios minutos.
  4. Comprueba que la facturación esté habilitada en tu proyecto.

    Descubre cómo puedes habilitar la facturación

Elige un shell

Para completar esta guía de inicio rápido, puedes usar Cloud Shell o tu shell local.

Cloud Shell es un entorno de shell para administrar recursos alojados en Google Cloud Platform (GCP). Cloud Shell ya viene instalado en la herramienta de línea de comandos de gcloud y la herramienta de línea de comandos de kubectl. La herramienta gcloud proporciona la interfaz de línea de comandos principal para GCP y kubectl proporciona la interfaz de línea de comandos principal a fin de ejecutar comandos en clústeres de Kubernetes.

Si prefieres usar tu shell local, debes instalar las herramientas gcloud y kubectl en tu entorno.

Cloud Shell

Para iniciar Cloud Shell, sigue estos pasos:

  1. Ve a Google Cloud Platform Console.

    Google Cloud Platform Console

  2. Desde la esquina superior derecha de la consola, haz clic en el botón Activar Cloud Shell .

Se abrirá una sesión de Cloud Shell dentro de un marco en la parte inferior en la consola. Usa este shell para ejecutar los comandos gcloud y kubectl.

Shell local

Si deseas instalar gcloud y kubectl, sigue los pasos siguientes:

  1. Instala el SDK de Cloud, que incluye la herramienta de línea de comandos de gcloud.
  2. Luego de instalar el SDK de Cloud, instala la herramienta de línea de comandos kubectl mediante la ejecución del comando siguiente:

    gcloud components install kubectl

Establece la configuración predeterminada para la herramienta gcloud

Antes de comenzar, usa la herramienta gcloud para establecer dos opciones de configuración predeterminadas: tu proyecto y zona de procesamiento predeterminada.

Tu proyecto cuenta con un ID del proyecto, que es su identificador único. Cuando creas un proyecto por primera vez, puedes usar el ID del proyecto generado de forma automática o crear el tuyo propio.

La zona de procesamiento es una ubicación regional aproximada en la que residen tus clústeres y sus recursos. Por ejemplo, us-west1-a es una zona en la región us-west.

Establecer esta configuración predeterminada simplifica la ejecución de los comandos gcloud, ya que requiere que especifiques el proyecto y la zona de procesamiento en la que deseas trabajar. Para especificar esta configuración o anular la configuración predeterminada, también puedes usar marcadores de operación como --project, --zone y --cluster, en los comandos de gcloud.

Cuando creas tus recursos de GKE luego de configurar tu proyecto y zona de procesamiento predeterminados, estos se crean de forma automática en ese proyecto y esa zona.

Configura un proyecto predeterminado

Para configurar un proyecto predeterminado, ejecuta los comandos siguientes desde Cloud Shell:

gcloud config set project project-id

Reemplaza project-id por tu ID del proyecto.

Configura una zona de procesamiento predeterminada

Para configurar una zona de procesamiento predeterminada, ejecuta el comando siguiente:

gcloud config set compute/zone compute-zone

donde compute-zone es la zona de procesamiento geográfica deseada, por ejemplo: us-west1-a.

Crea un clúster de GKE

Un clúster consta de al menos una máquina de clúster principal y varias máquinas trabajadoras, llamadas nodos. Los nodos son instancias de máquinas virtuales (VM) de Compute Engine que ejecutan los procesos de Kubernetes necesarios para que sean parte del clúster. Las aplicaciones se implementan en los clústeres y, luego, se ejecutan en los nodos.

Para crear un clúster, debes ejecutar el comando siguiente:

gcloud container clusters create cluster-name

donde cluster-name es el nombre que eliges para el clúster.

Obtén las credenciales de autenticación para el clúster

Después de crear tu clúster, debes obtener las credenciales de autenticación para interactuar con él.

Para autenticarte y poder interactuar con el clúster, debes ejecutar el comando siguiente:

gcloud container clusters get-credentials cluster-name

Este comando configura kubectl para usar el clúster que creaste.

Implementa una aplicación en el clúster

Una vez creado el clúster, puedes implementar una aplicación en contenedores en él. Para esta guía de inicio rápido, puedes implementar nuestra aplicación web de ejemplo, hello-app.

GKE utiliza los objetos de Kubernetes para crear y administrar los recursos de tus clústeres. Kubernetes proporciona el objeto Implementación a fin de implementar aplicaciones sin estado como servidores web. Los objetos de Servicio definen las reglas y el balanceo de cargas para acceder a tu aplicación desde Internet.

Crea la Implementación

Si deseas ejecutar hello-app en tu clúster, debes ejecutar el comando siguiente:

kubectl create deployment hello-server --image=gcr.io/google-samples/hello-app:1.0

Con este comando de Kubernetes, kubectl create deployment, se crea una implementación llamada hello-server. El pod de la implementación ejecuta la imagen hello-app en su contenedor.

En este comando, se dan las situaciones siguientes:

  • --image especifica la imagen de contenedor para implementar. En este caso, el comando obtiene la imagen de ejemplo de un depósito de Container Registry, gcr.io/google-samples/hello-app. :1.0 indica la versión específica de la imagen que se desea obtener. Si no se especifica una versión, se usa la versión más reciente.

Cómo exponer la implementación

Luego de implementar la aplicación, debes exponerla en Internet para que los usuarios puedan acceder a ella. Para exponer tu aplicación, puedes crear un Servicio, un recurso de Kubernetes que expone tu aplicación al tráfico externo.

Para exponer tu aplicación, debes ejecutar el comando siguiente kubectl expose:

kubectl expose deployment hello-server --type LoadBalancer \
  --port 80 --target-port 8080

Cuando pasas la marca --type LoadBalancer, se crea un balanceador de cargas de Compute Engine para el contenedor. La marca --port inicializa el puerto público 80 a Internet y la marca --target-port direcciona el tráfico al puerto 8080 de la aplicación.

Los balanceadores de cargas se facturan según los precios de los balanceadores de cargas de Compute Engine.

Inspecciona y visualiza la aplicación

  1. Para inspeccionar los pods en ejecución, usa kubectl get pods:

    kubectl get pods

    Deberías ver un pod hello-server en ejecución en el clúster.

  2. Inspecciona el servicio hello-server mediante kubectl get service:

    kubectl get service hello-server

    Copia la dirección IP externa del Servicio de la columna EXTERNAL-IP que aparece en el resultado del comando.

  3. Para ver la aplicación desde tu navegador web, usa la dirección IP externa con el puerto expuesto:

    http://external-ip/

Acabas de implementar una aplicación web en contenedores en GKE.

Realiza una limpieza

Para evitar que se generen cargos en tu cuenta de GCP por los recursos que usaste en esta guía de inicio rápido, sigue estos pasos:

  1. Borra el Servicio de la aplicación mediante la ejecución de kubectl delete:

    kubectl delete service hello-server

    Este comando borra el balanceador de cargas de Compute Engine que creaste al momento de exponer la implementación.

  2. Si deseas borrar tu clúster, ejecuta gcloud container clusters delete:

    gcloud container clusters delete cluster-name

Opcional: revisión del código de hello-app

hello-app es una aplicación de servidor web simple que consta de dos archivos: main.go y un Dockerfile.

hello-app se empaqueta como imagen de contenedor de Docker. Las imágenes de contenedor se almacenan en cualquier registro de imágenes de Docker, como Container Registry. hello-app se aloja en un depósito de Container Registry llamado gcr.io/google-samples/hello-app.

main.go

main.go es una implementación de servidor web escrita en el lenguaje de programación Go. El servidor responde a cualquier solicitud HTTP con el mensaje “Hello, world!”.

package main

import (
	"fmt"
	"log"
	"net/http"
	"os"
)

func main() {
	// use PORT environment variable, or default to 8080
	port := "8080"
	if fromEnv := os.Getenv("PORT"); fromEnv != "" {
		port = fromEnv
	}

	// register hello function to handle all requests
	server := http.NewServeMux()
	server.HandleFunc("/", hello)

	// start the web server on port and accept requests
	log.Printf("Server listening on port %s", port)
	err := http.ListenAndServe(":"+port, server)
	log.Fatal(err)
}

// hello responds to the request with a plain-text "Hello, world" message.
func hello(w http.ResponseWriter, r *http.Request) {
	log.Printf("Serving request: %s", r.URL.Path)
	host, _ := os.Hostname()
	fmt.Fprintf(w, "Hello, world!\n")
	fmt.Fprintf(w, "Version: 1.0.0\n")
	fmt.Fprintf(w, "Hostname: %s\n", host)
}

Dockerfile

Dockerfile describe la imagen que quieres que Docker compile, incluidos todos sus recursos y dependencias, y especifica qué puerto de red debe exponer la app. Para obtener más información sobre cómo funciona este archivo, consulta la referencia de Dockerfile en la documentación de Docker.

FROM golang:1.8-alpine
ADD . /go/src/hello-app
RUN go install hello-app

FROM alpine:latest
COPY --from=0 /go/bin/hello-app .
ENV PORT 8080
CMD ["./hello-app"]

Pasos siguientes

¿Te ha resultado útil esta página? Enviar comentarios:

Enviar comentarios sobre...

Documentación de Kubernetes Engine