Inicio rápido: implementación de una aplicación web y almacenamiento de datos

Cree un archivo denominado cluster-config.yaml y pegue en él el siguiente contenido. Sustituya region-code por una región válida, como us-east-1

A continuación, se muestra un ejemplo de resultado:

apiVersion: eksctl.io/v1alpha5
kind: ClusterConfig

metadata:
  name: web-quickstart
  region: region-code

managedNodeGroups:
  - name: eks-mng
    instanceType: t3.medium
    desiredCapacity: 2

iam:
  withOIDC: true
  serviceAccounts:
  - metadata:
      name: aws-load-balancer-controller
      namespace: kube-system
    wellKnownPolicies:
      awsLoadBalancerController: true

addons:
  - name: aws-ebs-csi-driver
    wellKnownPolicies: # Adds an IAM service account
      ebsCSIController: true

cloudWatch:
 clusterLogging:
   enableTypes: ["*"]
   logRetentionInDays: 30

Cree el clúster de Amazon EKS y especifique el cluster-config.yaml.

eksctl create cluster -f cluster-config.yaml

Cuando se haya completado, debería ver la siguiente respuesta de salida:

2024-07-04 21:47:53 [✔]  EKS cluster "web-quickstart" in "region-code" region is ready

Establezca la variable de entorno CLUSTER_REGION para el clúster de Amazon EKS. Sustituya el valor de muestra por region-code.

export CLUSTER_REGION=region-code
            

Establezca la variable de entorno CLUSTER_VPC para el clúster de Amazon EKS.

export CLUSTER_VPC=$(aws eks describe-cluster --name web-quickstart --region $CLUSTER_REGION --query "cluster.resourcesVpcConfig.vpcId" --output text)

Utilice Helm para agregar el repositorio de gráficos de Amazon EKS a Helm.

helm repo add eks https://aws.github.io/eks-charts

Actualice los repositorios para asegurarse de que Helm esté al tanto de las últimas versiones de los gráficos:

helm repo update eks

Ejecute el siguiente comando de Helm para instalar simultáneamente las definiciones de recursos personalizadas (CRD) y el controlador principal del controlador del equilibrador de carga deAWS (LBC de AWS). Para omitir la instalación de los CRD, pase la marca --skip-crds, lo que puede resultar útil si los CRD ya están instalados, si se requiere una compatibilidad de versiones específica o en entornos con requisitos estrictos de control de acceso y personalización.

helm install aws-load-balancer-controller eks/aws-load-balancer-controller \
    --namespace kube-system \
    --set clusterName=web-quickstart \
    --set serviceAccount.create=false \
    --set region=${CLUSTER_REGION} \
    --set vpcId=${CLUSTER_VPC} \
    --set serviceAccount.name=aws-load-balancer-controller

Debería ver la siguiente respuesta de salida:

NAME: aws-load-balancer-controller
LAST DEPLOYED: Wed July 3 19:43:12 2024
NAMESPACE: kube-system
STATUS: deployed
REVISION: 1
TEST SUITE: None
NOTES:
AWS Load Balancer controller installed!

Cree un espacio de nombres de Kubernetes llamado game-2048 con la marca --save-config.

kubectl create namespace game-2048 --save-config

Debería ver la siguiente respuesta de salida:

namespace/game-2048 created

Implemente la aplicación de ejemplo del juego 2048.

kubectl apply -n game-2048 -f https://raw.githubusercontent.com/kubernetes-sigs/aws-load-balancer-controller/v2.8.0/docs/examples/2048/2048_full.yaml

Este manifiesto configura una implementación, un servicio y una entrada de Kubernetes para el espacio de nombres game-2048, lo que crea los recursos necesarios para implementar y exponer la aplicación de game-2048 dentro del clúster. Incluye la creación de un servicio denominado service-2048 que expone la implementación en el puerto 80 y un recurso Ingress denominado ingress-2048 que define las reglas de enrutamiento para el tráfico HTTP entrante y las anotaciones para un equilibrador de carga de aplicaciones (ALB) con acceso a Internet. Debería ver la siguiente respuesta de salida:

namespace/game-2048 configured
deployment.apps/deployment-2048 created
service/service-2048 created
ingress.networking.k8s.io/ingress-2048 created

Ejecute el siguiente comando para obtener el recurso Ingress para el espacio de nombres game-2048.

kubectl get ingress -n game-2048

Debería ver la siguiente respuesta de salida:

NAME           CLASS   HOSTS   ADDRESS                                                                    PORTS   AGE
ingress-2048   alb     *       k8s-game2048-ingress2-eb379a0f83-378466616.region-code.elb.amazonaws.com   80      31s

Deberá esperar varios minutos para que el equilibrador de carga de aplicación (ALB) se aprovisione antes de comenzar con los siguientes pasos.

Abra un navegador web y escriba la ADDRESS del paso anterior para acceder a la aplicación web. Por ejemplo:

k8s-game2048-ingress2-eb379a0f83-378466616.region-code.elb.amazonaws.com

Debería ver el juego 2048 en el navegador. Juegue.

Cree una clase de almacenamiento para el controlador CSI de EBS:

kubectl apply -n game-2048 -f https://raw.githubusercontent.com/kubernetes-sigs/aws-ebs-csi-driver/master/examples/kubernetes/dynamic-provisioning/manifests/storageclass.yaml

Cree una reclamación de volumen persistente (PVC) para solicitar el almacenamiento de los datos de su juego. Cree un archivo llamado ebs-pvc.yaml y agregue el siguiente contenido:

apiVersion: v1
kind: PersistentVolumeClaim
metadata:
  name: game-data-pvc
spec:
  accessModes:
    - ReadWriteOnce
  resources:
    requests:
      storage: 10Gi
  storageClassName: ebs-sc

Aplique el PVC en su clúster:

kubectl apply -f ebs-pvc.yaml

Debería ver la siguiente respuesta de salida:

persistentvolumeclaim/game-data-pvc created

Ahora, tiene que actualizar la implementación del juego 2048 para usar este PVC para almacenar datos. La siguiente implementación está configurada para usar el PVC para almacenar los datos del juego. Cree un archivo llamado ebs-deployment.yaml que contenga lo siguiente:

apiVersion: apps/v1
kind: Deployment
metadata:
  namespace: game-2048
  name: deployment-2048
spec:
  replicas: 3  # Adjust the number of replicas as needed
  selector:
    matchLabels:
      app.kubernetes.io/name: app-2048
  template:
    metadata:
      labels:
        app.kubernetes.io/name: app-2048
    spec:
      containers:
        - name: app-2048
          image: public.ecr.aws/l6m2t8p7/docker-2048:latest
          imagePullPolicy: Always
          ports:
            - containerPort: 80
          volumeMounts:
            - name: game-data
              mountPath: /var/lib/2048
      volumes:
        - name: game-data
          persistentVolumeClaim:
            claimName: game-data-pvc

Aplique la implementación actualizada:

kubectl apply -f ebs-deployment.yaml

Debería ver la siguiente respuesta de salida:

deployment.apps/deployment-2048 configured