Este laboratorio muestra como crear un cluster de Kubernetes con AKS (Azure Kubernetes Service) y correr una aplicación basada en Docker en dicho cluster.
Este ejemplo muestra como:
- Crear una aplicación ASP.NET Core
- Crear una imagen de Docker que incluya la aplicación
- Publicación de la imagen a un Docker Registry privado (Azure Container Registry)
- Crear un cluster de Kubernetes (K8S) administrador por Azure (Azure Kubernetes Services)
- Distribuir de la imagen en el cluster de Kubernetes
- Instalar .NET Core
- Instalar Docker
- (Opcional) Instalar Azure Command Line Interface (CLI):
- (Opcional) Instalar GIT
- (Opcional) Instalar Visual Studio Code
Para verificar que ya se instalaron los componentes anteriores, abrir una ventana de Powershell y usar los siguientes comandos:
.NET Core:
dotnet --version
Docker Community Edition
docker version
Azure Command Line Interface
az
GIT
git version
Visual Studio Code
code .
Para crear una aplicación ASP.NET Model-View-Controller, primero se crea un directorio. El nombre de dicho directorio determina el nombre del proyecto y por lo tanto el nombre del archivo binario que se debe ejecutar en el contenedor.
mkdir HolaMundo
cd HolaMundo
dotnet new mvc --no-https
Ejercutar localmente la aplicación
dotnet run
Para verificar que la aplicación esta corriendo localmente es necesario abrir el navegador e ir a la dirección: http://localhost:5000
Para empaquetar la aplicacion en una imagen de Docker es necesario crear el archivo Dockerfile en el directorio de la aplicación con las siguientes instrucciones de Docker:
# Obtiene la imagen base para crear la nueva imagen
FROM microsoft/dotnet:2.1-sdk AS build-env
# Crea un directorio para la aplicación
WORKDIR /app
# Copia el archivo de proyecto (*.csproj) al contenedor
COPY *.csproj ./
# Restaura las librerías (Nugets) requeridas por el proyecto
RUN dotnet restore
# Copia todos los archivos del proyecto al contenedor
COPY . ./
# Compila la aplicación
RUN dotnet publish -c Release -o out
# Obtiene una segunda imagen con el runtime de aspnetcore
FROM microsoft/dotnet:2.1-aspnetcore-runtime
# Crea un directorio para la aplicación
WORKDIR /app
# Copy de la primera imagen (build-env) los archivos binarios
COPY --from=build-env /app/out .
# Establece el commando a ejecutar cuando el contenedor se cargue
ENTRYPOINT ["dotnet", "HolaMundo.dll"]El archivo Dockerfile le indica a Docker como debe construir la imagen, para construir la imagen es necesario el siguiente comando:
docker build -t holamundo:1.0
Para verificar que la imagen se generó adecuadamente
docker images
Debe aparecer una imagen con el nombre holamundo.
Se puede ejecutar un contenedor con la aplicación usando:
docker run -p 4000:80 holamundo:1.0
Para verificar que la aplicación esta corriendo localmente es necesario abrir el navegador e ir a la dirección: http://localhost:4000
Para crear un repositorio de imágenes Docker se utilizarán comandos de la interface de línea de comandos (CLI) de Azure.
Primero es necesario tener acceso a la suscripción de Azure
az login
Los recursos que se utilizarán durante este ejercicio se generarán dentro de un grupo de recursos de Azure para facilitar su eliminación al final del taller.
az group create -n Ejemplo-Contenedores -l eastus
El servicio Azure Container Registry es un repositorio privado de imágenes Docker, para crearlo se puede usar el siguiente comando:
ACR_NAME=<nombre del repositorio, sin comillas ni llaves>
az acr create -n $ACR_NAME -g Ejemplo-Contenedores --sku Basic --admin-enabled true
Una vez que el registry se ha creado Docker puede usarlo para almacenar imágenes, para ello es necesario etiquetar la imagen con el nombre del servidor del registry:
ACR_NAME=<nombre del repositorio, sin comillas ni llaves>
docker tag $ACR.azurecr.io/holamundo:1.0 holamundo:1.0
Dado que el repositorio creado (ACR) es privado, antes de poder publicar una imagen es necesario que Docker se autentique con el ACR
ACR_NAME=<nombre del repositorio, sin comillas ni llaves>
az acr login -n $ACR_NAME -g Ejemplo-Contenedores
La publicación de la imagen se hace con el siguiente comando de Docker:
ACR_NAME=<nombre del repositorio, sin comillas ni llaves>
docker push $ACR_NAME.azurecr.io/holamundo:1.0
Para crear un cluster de Kubernetes usando el servicio Azure AKS se utiliza el siguiente comando de Azure CLI:
az aks create -n ClusterK8s -g Sample-AKS --generate-ssh-keys
Una vez creado el cluster, es necesario obtener las credenciales de acceso al mismo antes de poder administrarlo
az aks get-credentials -n ClusterK8s -g Sample-AKS
El comando anterior obtiene las credenciales del cluster y las almacena en archivos de configuración que estan en el directorio ~/.kube con lo que ahora se puede administrar el cluster con el cliente de administración de kubernetes
El cliente de Kubernetes (kubectrl) puede instalarse localmente con el siguiente comando:
az aks install-cli
A continuación algunos de los comandos más comunes para administrar el cluster de Kubernetes
kubectl get nodes
kubectl get pods
kubectl get services
ACR_SERVER=<nombre del ACR>.azurecr.io
ACR_USER=<nombre del ACR>
ACR_PWD=<clave del ACR>
kubectl create secret docker-registry acr-secret --docker-server=$ACR_SERVER --docker-username=$ACR_USER --docker-password=$ACR_PWD [email protected]
kubectl apply -f hello.yml
Para verificar que la aplicación ha sido distribuida y está lista
kubectl get services
Frente al servicio holamundo, aparecerá la dirección IP pública del servicio. Para verificar que la aplicación esta corriendo abrir el navegador e ir a la dirección pública.
Cloud Design Patterns: https://docs.microsoft.com/en-us/azure/architecture/patterns/