Déployer un conteneur

Le manifest complet, prêt à copier :

apiVersion: apps/v1
kind: Deployment
metadata:
  name: nginx-demo
spec:
  selector:
    matchLabels:
      app: nginx-demo
  template:
    metadata:
      labels:
        app: nginx-demo
    spec:
      containers:
        - name: web
          image: nginx:alpine
          resources:
            requests:
              cpu: 100m
              memory: 200Mi

💡 Débutant Kubernetes ?

Un Pod est l’unité d’exécution minimale sur Kubernetes ; il regroupe un ou plusieurs conteneurs. Dans la pratique, on crée rarement un Pod « nu » : on préfère un Deployment, qui crée les Pods, maintient le nombre désiré de répliques et gère les mises à jour progressives (roll-outs) et retours arrière (roll-backs). Pour approfondir : Pods et Deployments.

Déployer nginx:alpine

Via l'interface graphique de Rancher

1. Ouvrez le menu Workloads › Deployments dans votre namespace.

   

2. Cliquez sur Create puis remplissez :

   • Name : nginx-demo
   • Container name : web
   • Container Image : nginx:alpine

   

3. Validez avec Create. Votre workload apparaît en vert quand le Pod est prêt.

   

Via un manifest YAML

1. Créez un fichier nginx-deployment.yaml avec le manifest en tête de page.

2. Appliquez-le dans votre namespace :

   kubectl apply -f nginx-deployment.yaml -n <votre-namespace>

3. Vérifiez :

   kubectl get pods -n <votre-namespace>

Les spécificités Kontainers à connaître

• imagePullPolicy est forcé à Always : l’image est re-vérifiée auprès du registre à chaque démarrage de pod. Conséquence importante : si votre registre est indisponible (ou un token expiré), vos pods ne peuvent plus redémarrer.
• Des requests par défaut sont injectées si vous n’en déclarez pas (0,1 vCPU / 200 Mi) — et elles sont facturées. Déclarez toujours vos resources, comme dans l’exemple en tête de page.
• La limite mémoire est toujours égale à la request : au-delà, le conteneur est OOMKilled. Dimensionnez la request sur votre pic réel.
• Quota : 20 pods par namespace (augmentable via ticket).

Le détail de ces comportements : Mutations automatiques et politiques.

Applications avec état : StatefulSets

Pour les applications qui exigent une identité stable par réplique (bases de données, files de messages…), Kubernetes propose les StatefulSets — disponibles sur Kontainers (quota : 20 par namespace). Chaque réplique y reçoit un nom stable (db-0, db-1…) et son propre volume persistant.

Pour PostgreSQL, préférez l’opérateur managé — voir Permissions et RBAC (guide dédié à venir).

Étapes suivantes

• Configurer votre application — variables d’environnement et secrets ;
• Exposer votre application ;
• Mon pod est en erreur — si le déploiement se passe mal.