Início rápido: implantar uma aplicação Web e armazenar dados

Crie um arquivo cluster-config.yaml e cole o conteúdo a seguir nele. Substitua region-code por uma região válida, como us-east-1

O exemplo de saída é o seguinte:

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

Crie o cluster do Amazon EKS e especifique o cluster-config.yaml.

eksctl create cluster -f cluster-config.yaml

Após a conclusão, você verá a seguinte saída de resposta:

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

Defina a variável de ambiente CLUSTER_REGION para o cluster do Amazon EKS. Substitua o valor de amostra para region-code.

export CLUSTER_REGION=region-code
            

Defina a variável de ambiente CLUSTER_VPC para o cluster do Amazon EKS.

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

Use o Helm para adicionar o repositório de gráficos do Amazon EKS ao Helm.

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

Atualize os repositórios para garantir que o Helm esteja ciente das versões mais recentes dos gráficos:

helm repo update eks

Execute o comando do Helm a seguir para instalar simultaneamente as definições de recursos personalizados (CRDs) e o controlador principal do AWS Load Balancer Controller (AWS LBC). Para pular a instalação das CRDs, passe o sinalizador --skip-crds, que poderá ser útil se as CRDs já estiverem instaladas, se for necessária uma compatibilidade de versão específica ou em ambientes com necessidades rigorosas de controle de acesso e personalização.

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

Você verá a seguinte saída de resposta:

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!

Crie um namespace do Kubernetes denominado game-2048 com o sinalizador --save-config.

kubectl create namespace game-2048 --save-config

Você verá a seguinte saída de resposta:

namespace/game-2048 created

Implante a aplicação de amostra do jogo 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

Esse manifesto configura uma implantação, um serviço e uma entrada do Kubernetes para o namespace game-2048, criando os recursos necessários para implantar e expor a aplicação game-2048 no cluster. Isso inclui a criação de um serviço denominado service-2048 que expõe a implantação na porta 80 e um recurso de entrada denominado ingress-2048 que define regras de roteamento para tráfego HTTP de entrada e anotações para um Application Load Balancer (ALB) voltado para a internet. Você verá a seguinte saída de resposta:

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

Execute o comando a seguir para obter o recurso de entrada para o namespace game-2048.

kubectl get ingress -n game-2048

Você verá a seguinte saída de resposta:

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

Você precisará esperar alguns minutos para que o Application Load Balancer (ALB) seja provisionado antes de começar as etapas a seguir.

Abra o navegador da Web e digite o ADDRESS da etapa anterior para acessar a aplicação Web. Por exemplo:

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

Você deve ver o jogo 2048 no seu navegador. Reproduza.

Crie uma classe de armazenamento para o driver CSI do 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

Crie uma solicitação de volume persistente (PVC) para solicitar armazenamento para os dados do seu jogo. Crie um arquivo denominado ebs-pvc.yaml e adicione o seguinte conteúdo a ele:

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

Aplique a PVC ao cluster:

kubectl apply -f ebs-pvc.yaml

Você verá a seguinte saída de resposta:

persistentvolumeclaim/game-data-pvc created

Você agora precisa atualizar a implantação do jogo 2048 para usar essa PVC para armazenar dados. A implantação a seguir está configurada para usar a PVC para armazenar dados do jogo. Crie um arquivo denominado ebs-deployment.yaml e adicione o seguinte conteúdo a ele:

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 a implantação atualizada:

kubectl apply -f ebs-deployment.yaml

Você verá a seguinte saída de resposta:

deployment.apps/deployment-2048 configured