# Exécuter une application stateless avec un Déploiement LLMS index: [llms.txt](/llms.txt) --- Cette page montre comment exécuter une application en utilisant une resource Deployment (déploiement) dans Kubernetes. ## Objectifs - Créer un déploiement nginx. - Utiliser kubectl pour afficher des informations sur le déploiement. - Mettre à jour le déploiement. ## Pré-requis

Vous devez disposer d'un cluster Kubernetes et l'outil de ligne de commande kubectl doit être configuré pour communiquer avec votre cluster. Si vous ne possédez pas déjà de cluster, vous pouvez en créer un en utilisant Minikube, ou vous pouvez utiliser l'un de ces environnements Kubernetes:

Votre serveur Kubernetes doit être au moins à la version v1.9.

Pour consulter la version, entrez kubectl version.

## Création et exploration d'un déploiement nginx Vous pouvez exécuter une application en créant un objet déploiement Kubernetes, et vous pouvez décrire un déploiement dans un fichier YAML. Par exemple, ce fichier YAML décrit un déploiement qui exécute l'image Docker nginx:1.14.2 :

    application/deployment.yaml
    
apiVersion: apps/v1
kind: Deployment
metadata:
  name: nginx-deployment
spec:
  selector:
    matchLabels:
      app: nginx
  replicas: 2 # tells deployment to run 2 pods matching the template
  template:
    metadata:
      labels:
        app: nginx
    spec:
      containers:
      - name: nginx
        image: nginx:1.14.2
        ports:
        - containerPort: 80

1. Créez un déploiement basé sur ce fichier YAML: ```shell kubectl apply -f https://k8s.io/examples/application/deployment.yaml ``` 1. Affichez les informations du déploiement: ```shell kubectl describe deployment nginx-deployment ``` Le résultat sera similaire à ceci : ``` Name: nginx-deployment Namespace: default CreationTimestamp: Tue, 30 Aug 2016 18:11:37 -0700 Labels: app=nginx Annotations: deployment.kubernetes.io/revision=1 Selector: app=nginx Replicas: 2 desired | 2 updated | 2 total | 2 available | 0 unavailable StrategyType: RollingUpdate MinReadySeconds: 0 RollingUpdateStrategy: 1 max unavailable, 1 max surge Pod Template: Labels: app=nginx Containers: nginx: Image: nginx:1.14.2 Port: 80/TCP Environment: Mounts: Volumes: Conditions: Type Status Reason ---- ------ ------ Available True MinimumReplicasAvailable Progressing True NewReplicaSetAvailable OldReplicaSets: NewReplicaSet: nginx-deployment-1771418926 (2/2 replicas created) No events. ``` 1. Affichez les Pods créés par le déploiement : ```shell kubectl get pods -l app=nginx ``` Le résultat sera similaire à ceci : ``` NAME READY STATUS RESTARTS AGE nginx-deployment-1771418926-7o5ns 1/1 Running 0 16h nginx-deployment-1771418926-r18az 1/1 Running 0 16h ``` 1. Affichez les informations d'un Pod : ```shell kubectl describe pod ``` où est le nom d'un de vos Pods. ## Mise à jour du déploiement Vous pouvez mettre à jour le déploiement en appliquant un nouveau fichier YAML. Ce fichier YAML indique que le déploiement doit être mis à jour pour utiliser nginx 1.16.1.

    application/deployment-update.yaml
    
apiVersion: apps/v1
kind: Deployment
metadata:
  name: nginx-deployment
spec:
  selector:
    matchLabels:
      app: nginx
  replicas: 2
  template:
    metadata:
      labels:
        app: nginx
    spec:
      containers:
      - name: nginx
        image: nginx:1.16.1 # Update the version of nginx from 1.14.2 to 1.16.1
        ports:
        - containerPort: 80

1. Appliquez le nouveau fichier YAML : ```shell kubectl apply -f https://k8s.io/examples/application/deployment-update.yaml ``` 1. Regardez le déploiement créer de nouveaux pods et supprimer les anciens : ```shell kubectl get pods -l app=nginx ``` ## Mise à l'échelle de l'application en augmentant le nombre de réplicas Vous pouvez augmenter le nombre de pods dans votre déploiement en appliquant un nouveau fichier YAML. Ce fichier YAML définit `replicas` à 4, ce qui spécifie que le déploiement devrait avoir quatre pods :

    application/deployment-scale.yaml
    
apiVersion: apps/v1
kind: Deployment
metadata:
  name: nginx-deployment
spec:
  selector:
    matchLabels:
      app: nginx
  replicas: 4 # Update the replicas from 2 to 4
  template:
    metadata:
      labels:
        app: nginx
    spec:
      containers:
      - name: nginx
        image: nginx:1.16.1
        ports:
        - containerPort: 80

1. Appliquez le nouveau fichier YAML : ```shell kubectl apply -f https://k8s.io/examples/application/deployment-scale.yaml ``` 1. Vérifiez que le déploiement a quatre pods: ```shell kubectl get pods -l app=nginx ``` Le résultat sera similaire à ceci : ``` NAME READY STATUS RESTARTS AGE nginx-deployment-148880595-4zdqq 1/1 Running 0 25s nginx-deployment-148880595-6zgi1 1/1 Running 0 25s nginx-deployment-148880595-fxcez 1/1 Running 0 2m nginx-deployment-148880595-rwovn 1/1 Running 0 2m ``` ## Suppression d'un déploiement Supprimez le déploiement avec son nom : ```shell kubectl delete deployment nginx-deployment ``` ## ReplicationControllers -- méthode obsolète La méthode préférée pour créer une application répliquée consiste à utiliser un déploiement, qui utilise à son tour un ReplicaSet. Avant que le déploiement et le ReplicaSet ne soient ajoutés à Kubernetes, les applications répliquées étaient configurées à l'aide d'un [ReplicationController](/docs/concepts/workloads/controllers/replicationcontroller/). ## A suivre - En savoir plus sur les [Deployments](/docs/concepts/workloads/controllers/deployment/).