Déployer un exemple d'application

Dans cette rubrique, vous déployez un exemple d'application sur votre cluster.

Prérequis

Un existant Kubernetes cluster avec au moins un nœud. Si vous ne possédez pas de EKS cluster Amazon existant, vous pouvez en déployer un à l'aide de l'un des Commencez avec Amazon EKS guides. Si vous déployez un Windows application, alors vous devez avoir Windows support activé pour votre cluster et au moins un Amazon EC2 Windows nœud.
Kubectl installé sur votre ordinateur. Pour de plus amples informations, veuillez consulter Configuration kubectl et eksctl.
Kubectl configuré pour communiquer avec votre cluster. Pour de plus amples informations, veuillez consulter Connexion kubectl à un EKS cluster en créant un kubeconfig dans le fichier.
Si vous prévoyez de déployer votre charge de travail d'exemple sur Fargate, vous devez disposer d'un profil Fargate existant qui inclut le même espace de noms créé dans ce didacticiel, à savoir eks-sample-app, à moins que vous ne changiez le nom. Si vous avez utilisé l'un des guides de démarrage pour créer votre cluster, vous devrez créer un nouveau profil ou ajouter l'espace de noms à votre profil existant, car le profil créé dans les guides de démarrage ne spécifie pas l'espace de noms utilisé dans ce didacticiel. Vous VPC devez également disposer d'au moins un sous-réseau privé.

Pour déployer un exemple d'application

Bien que de nombreuses variables soient modifiables dans les étapes suivantes, nous vous recommandons de ne modifier les valeurs des variables qu'aux endroits spécifiés. Une fois que vous aurez une meilleure compréhension de Kubernetes Pods, déploiements et services, vous pouvez essayer de modifier d'autres valeurs.

Créez un espace de noms . Un espace de noms vous permet de regrouper des ressources dans Kubernetes. Pour plus d'informations, consultez la section Espaces de noms dans le Kubernetes . Si vous prévoyez de déployer votre application d'exemple vers Simplifiez la gestion informatique avec AWS Fargate, assurez-vous que la valeur de namespace dans votre Définissez quelle Pods utilisation AWS Fargate lors du lancement est eks-sample-app.
```
kubectl create namespace eks-sample-app
```

Créez un Kubernetes déploiement. Cet exemple de déploiement extrait une image de conteneur d'un référentiel public et déploie trois répliques (individuelles) Pods) de celui-ci à votre cluster. Pour en savoir plus, consultez la section Déploiements dans le Kubernetes . Vous pouvez déployer l'application sur Linux or Windows nœuds. Si vous effectuez un déploiement sur Fargate, vous ne pouvez déployer qu'un Linux application.

Enregistrez le contenu suivant dans un fichier nommé eks-sample-deployment.yaml. Les conteneurs de l'application d'exemple n'utilisent pas de stockage réseau, mais vous pouvez avoir des applications qui en ont besoin. Pour de plus amples informations, veuillez consulter Stockez les données d'application pour votre cluster.

Linux

Le amd64 ou arm64 values sous la clé kubernetes.io/arch signifient que l'application peut être déployée sur l'une ou l'autre architecture matérielle (si vous avez les deux dans votre cluster). Cela est possible car cette image est une image multi-architecture, mais toutes ne le sont pas. Vous pouvez déterminer l'architecture matérielle prise en charge par l'image en consultant les détails de l'image dans le référentiel d'où vous la retirez. Lorsque vous déployez des images qui ne prennent pas en charge un type d'architecture matérielle, ou pour lesquelles vous ne souhaitez pas que l'image soit déployée, supprimez ce type du manifeste. Pour plus d'informations, consultez la section Étiquettes, annotations et marques connues dans le Kubernetes .

kubernetes.io/os: linuxnodeSelectorCela signifie que si vous aviez Linux and Windows nœuds (par exemple) de votre cluster, l'image ne serait déployée que sur Linux nœuds. Pour plus d'informations, consultez la section Étiquettes, annotations et marques connues dans le Kubernetes .


apiVersion: apps/v1
kind: Deployment
metadata:
  name: eks-sample-linux-deployment
  namespace: eks-sample-app
  labels:
    app: eks-sample-linux-app
spec:
  replicas: 3
  selector:
    matchLabels:
      app: eks-sample-linux-app
  template:
    metadata:
      labels:
        app: eks-sample-linux-app
    spec:
      affinity:
        nodeAffinity:
          requiredDuringSchedulingIgnoredDuringExecution:
            nodeSelectorTerms:
            - matchExpressions:
              - key: kubernetes.io/arch
                operator: In
                values:
                - amd64
                - arm64
      containers:
      - name: nginx
        image: public.ecr.aws/nginx/nginx:1.23
        ports:
        - name: http
          containerPort: 80
        imagePullPolicy: IfNotPresent
      nodeSelector:
        kubernetes.io/os: linux

Windows

kubernetes.io/os: windowsnodeSelectorCela signifie que si vous aviez Windows and Linux nœuds (par exemple) de votre cluster, l'image ne serait déployée que sur Windows nœuds. Pour plus d'informations, consultez la section Étiquettes, annotations et marques connues dans le Kubernetes .


apiVersion: apps/v1
kind: Deployment
metadata:
  name: eks-sample-windows-deployment
  namespace: eks-sample-app
  labels:
    app: eks-sample-windows-app
spec:
  replicas: 3
  selector:
    matchLabels:
      app: eks-sample-windows-app
  template:
    metadata:
      labels:
        app: eks-sample-windows-app
    spec:
      affinity:
        nodeAffinity:
          requiredDuringSchedulingIgnoredDuringExecution:
            nodeSelectorTerms:
            - matchExpressions:
              - key: beta.kubernetes.io/arch
                operator: In
                values:
                - amd64
      containers:
      - name: windows-server-iis
        image: mcr.microsoft.com/windows/servercore:ltsc2019
        ports:
        - name: http
          containerPort: 80
        imagePullPolicy: IfNotPresent
        command:
        - powershell.exe
        - -command
        - "Add-WindowsFeature Web-Server; Invoke-WebRequest -UseBasicParsing -Uri 'https://dotnetbinaries.blob.core.windows.net/servicemonitor/2.0.1.6/ServiceMonitor.exe' -OutFile 'C:\\ServiceMonitor.exe'; echo '<html><body><br/><br/><marquee><H1>Hello EKS!!!<H1><marquee></body><html>' > C:\\inetpub\\wwwroot\\default.html; C:\\ServiceMonitor.exe 'w3svc'; "
      nodeSelector:
        kubernetes.io/os: windows

Appliquer le manifeste de déploiement à votre cluster.
```
kubectl apply -f eks-sample-deployment.yaml
```

Créer un service. Un service vous permet d'accéder à toutes les réplicas via une seule adresse IP ou un seul nom. Pour plus d'informations, consultez la section Service dans le Kubernetes . Bien que cela ne soit pas implémenté dans l'exemple d'application, si certaines applications doivent interagir avec d'autres AWS services, nous vous recommandons de créer Kubernetes comptes de service pour votre Pods, et associez-les à AWS IAM des comptes. En spécifiant les comptes de service, votre Pods disposent uniquement des autorisations minimales que vous leur avez spécifiées pour interagir avec d'autres services. Pour de plus amples informations, veuillez consulter Rôles IAM pour les comptes de service.
1. Enregistrez le contenu suivant dans un fichier nommé eks-sample-service.yaml. Kubernetes attribue au service sa propre adresse IP accessible uniquement depuis le cluster. Pour accéder au service depuis l'extérieur de votre cluster, déployez AWS Load Balancer Controllerpour équilibrer la charge du trafic applicatif ou réseau vers le service.
  Linux
  apiVersion: v1 kind: Service metadata: name: eks-sample-linux-service namespace: eks-sample-app labels: app: eks-sample-linux-app spec: selector: app: eks-sample-linux-app ports: - protocol: TCP port: 80 targetPort: 80
  Windows
  apiVersion: v1 kind: Service metadata: name: eks-sample-windows-service namespace: eks-sample-app labels: app: eks-sample-windows-app spec: selector: app: eks-sample-windows-app ports: - protocol: TCP port: 80 targetPort: 80
2. Appliquer le manifeste du service à votre cluster.
```
kubectl apply -f eks-sample-service.yaml
```
Affichez toutes les ressources présentes dans l'espace de noms eks-sample-app.
```
kubectl get all -n eks-sample-app
```
L'exemple qui suit illustre un résultat.

Si vous avez déployé Windows ressources, alors toutes les instances linux de la sortie suivante sontwindows. L'autre example values peut être différent de votre sortie.
```
NAME                                               READY   STATUS    RESTARTS   AGE
pod/eks-sample-linux-deployment-65b7669776-m6qxz   1/1     Running   0          27m
pod/eks-sample-linux-deployment-65b7669776-mmxvd   1/1     Running   0          27m
pod/eks-sample-linux-deployment-65b7669776-qzn22   1/1     Running   0          27m

NAME                               TYPE         CLUSTER-IP      EXTERNAL-IP   PORT(S)   AGE
service/eks-sample-linux-service   ClusterIP    10.100.74.8     <none>        80/TCP    32m

NAME                                        READY   UP-TO-DATE   AVAILABLE   AGE
deployment.apps/eks-sample-linux-deployment 3/3     3            3           27m

NAME                                                      DESIRED   CURRENT   READY   AGE
replicaset.apps/eks-sample-linux-deployment-776d8f8fd8    3         3         3       27m
```
Dans la sortie, vous voyez le service et le déploiement spécifiés dans l'exemple de manifestes déployés dans les étapes précédentes. Vous en voyez également trois Pods. Cela est dû au fait que 3 replicas nous avons été spécifiés dans l'exemple de manifeste. Pour plus d'informations sur Pods, voir Pods dans le Kubernetes . Kubernetes crée automatiquement la replicaset ressource, même si elle n'est pas spécifiée dans les exemples de manifestes. Pour plus d'informations surReplicaSets, consultez ReplicaSetle Kubernetes .

Note
Kubernetes conserve le nombre de répliques spécifiées dans le manifeste. S'il s'agissait d'un déploiement de production et que vous vouliez Kubernetes pour redimensionner horizontalement le nombre de répliques ou dimensionner verticalement les ressources de calcul pour Pods, utilisez les Faites évoluer les déploiements de pods avec Horizontal Pod Autoscaler et Ajustez les ressources du pod avec Vertical Pod Autoscaler pour ce faire.
Affichez les détails du service déployé. Si vous avez déployé un Windows service, remplacer linux parwindows.
```
kubectl -n eks-sample-app describe service eks-sample-linux-service
```
L'exemple qui suit illustre un résultat.

Si vous avez déployé Windows ressources, alors toutes les instances linux de la sortie suivante sontwindows. L'autre example values peut être différent de votre sortie.
```
Name:              eks-sample-linux-service
Namespace:         eks-sample-app
Labels:            app=eks-sample-linux-app
Annotations:       <none>
Selector:          app=eks-sample-linux-app
Type:              ClusterIP
IP Families:       <none>
IP:                10.100.74.8
IPs:               10.100.74.8
Port:              <unset>  80/TCP
TargetPort:        80/TCP
Endpoints:         192.168.24.212:80,192.168.50.185:80,192.168.63.93:80
Session Affinity:  None
Events:            <none>
```
Dans la sortie précédente, la valeur pour IP: est une adresse IP unique accessible depuis n'importe quel nœud ou Pod au sein du cluster, mais il n'est pas accessible depuis l'extérieur du cluster. Les valeurs pour Endpoints sont les adresses IP attribuées depuis votre adresse VPC à Pods qui font partie du service.
Consultez les détails de l'un des Pods répertorié dans la sortie lorsque vous avez consulté l'espace de noms lors d'une étape précédente. Si vous avez déployé un Windows app, remplacez linux par windows et remplacez 776d8f8fd8-78w66 par la valeur renvoyée pour l'un de vos Pods.
```
kubectl -n eks-sample-app describe pod eks-sample-linux-deployment-65b7669776-m6qxz
```
Sortie abrégée

Si vous avez déployé Windows ressources, alors toutes les instances linux de la sortie suivante sontwindows. Les autres example values peuvent être différents de votre sortie.
```
Name:         eks-sample-linux-deployment-65b7669776-m6qxz
Namespace:    eks-sample-app
Priority:     0
Node:         ip-192-168-45-132.us-west-2.compute.internal/192.168.45.132
[...]
IP:           192.168.63.93
IPs:
  IP:           192.168.63.93
Controlled By:  ReplicaSet/eks-sample-linux-deployment-65b7669776
[...]
Conditions:
  Type              Status
  Initialized       True
  Ready             True
  ContainersReady   True
  PodScheduled      True
[...]
Events:
  Type    Reason     Age    From                                                 Message
  ----    ------     ----   ----                                                 -------
  Normal  Scheduled  3m20s  default-scheduler                                    Successfully assigned eks-sample-app/eks-sample-linux-deployment-65b7669776-m6qxz to ip-192-168-45-132.us-west-2.compute.internal
[...]
```
Dans la sortie précédente, la valeur pour IP: est une adresse IP unique attribuée à Pod à partir du CIDR bloc attribué au sous-réseau dans lequel se trouve le nœud. Si vous préférez attribuer Pods Adresses IP provenant de différents CIDR blocs, vous pouvez modifier le comportement par défaut. Pour de plus amples informations, veuillez consulter Déploiement pods dans des sous-réseaux alternatifs avec mise en réseau personnalisée. Vous pouvez également constater que le Kubernetes le planificateur a programmé le Pod sur le Node avec l'adresse IP 192,168.45,132.

Astuce
Plutôt que d'utiliser la ligne de commande, vous pouvez consulter de nombreux détails sur Pods, services, déploiements et autres Kubernetes ressources dans le AWS Management Console. Pour de plus amples informations, veuillez consulter Vue Kubernetes ressources dans le AWS Management Console.

Exécutez un shell sur le Pod que vous avez décrit à l'étape précédente, en le 65b7669776-m6qxz remplaçant par l'identifiant de l'un de vos Pods.

À partir du Pod shell, affichez la sortie du serveur Web qui a été installé avec votre déploiement lors d'une étape précédente. Vous devez uniquement spécifier le nom du service. Il est résolu à l'adresse IP du service par CoreDNS, qui est déployé avec un EKS cluster Amazon, par défaut.

À partir du Pod shell, affichez le DNS serveur pour le Pod.
Linux
```
cat /etc/resolv.conf
```
L'exemple qui suit illustre un résultat.
```
nameserver 10.100.0.10
search eks-sample-app.svc.cluster.local svc.cluster.local cluster.local us-west-2.compute.internal
options ndots:5
```
Dans la sortie précédente, 10.100.0.10 est automatiquement attribué comme étant nameserver pour tous Pods déployé sur le cluster.
Windows
```
Get-NetIPConfiguration
```
Sortie abrégée
```
InterfaceAlias       : vEthernet
[...]
IPv4Address          : 192.168.63.14
[...]
DNSServer            : 10.100.0.10
```
Dans la sortie précédente, 10.100.0.10 est automatiquement assigné comme DNS serveur pour tous Pods déployé sur le cluster.
Déconnectez-vous du Pod en tapantexit.
Une fois que vous avez terminé avec l'application d'exemple, vous pouvez supprimer l'espace de noms, le service et le déploiement d'exemple avec la commande suivante.
```
kubectl delete namespace eks-sample-app
```

Étapes suivantes

Après avoir déployé l'exemple d'application, vous pouvez essayer certains des exercices suivants :

Avertissement JavaScript est désactivé ou n'est pas disponible dans votre navigateur.

Pour que vous puissiez utiliser la documentation AWS, Javascript doit être activé. Vous trouverez des instructions sur les pages d'aide de votre navigateur.

Conventions de rédaction

Charges de travail

Vertical Pod Autoscaler (VPA)

Déployer un exemple d'application

Prérequis

Pour déployer un exemple d'application

Note

Astuce

Étapes suivantes