3 h 15 (S2.1 : 45 min · S2.2 : 35 min · S2.3 : 35 min · S2.4 : 45 min · S2.5 : 30 min · S2.6 : 5 min)
module 1 (cluster exploré, oc connecté)
code source dans Gitea → devis-api et PostgreSQL déployés, exposés, équipe Devis habilitée
oc describe45 min
Projet = Namespace + Métadonnées (nom affiché, description) + Droits initiauxadmin sur le projet (RoleBinding automatique)oc new-project devis-dev --display-name="Devis Auto - développement"Sortie attendue :
Now using project "devis-dev" on server "https://api.<CLUSTER>.<DOMAINE>:6443".| Registre | Contenu | Authentification |
|---|---|---|
registry.redhat.io |
Images Red Hat supportées | Pull secret du cluster |
registry.access.redhat.com |
Images UBI (redistribuables) | Aucune |
quay.io / docker.io |
Images publiques ou privées | Selon le dépôt (quotas Docker Hub) |
| Registre interne | Images construites dans le cluster | Jeton OpenShift |
registre miroir interne (Quay, Artifactory) + liste blanche de registres autorisés
image-registry.openshift-image-registry.svc:5000/<PROJET>/<IMAGE>:<TAG>system:image-puller / system:image-builderdefault-route, désactivée par défaut)images de production construites ou promues par la CI, jamais poussées depuis un poste
ImageStream = Nom stable + Tags → Digests (sha256)devis-api:latest → sha256:4f2a… (image exacte)Avant : image: devis-api:latest → version réelle inconnue, pas de redéploiement
Après : ImageStreamTag → digest tracé, Deployment mis à jour à chaque build
S2I = Code source (Git) + Image builder (Python, Java, Node.js) → Image applicative
flowchart LR
G[Gitea] --> B[Build S2I]
I[Image builder python-312] --> B
B --> R[Registre interne]
R --> IS[ImageStream devis-api]
IS --> D[Deployment]
BUILDER=registry.access.redhat.com/ubi9/python-312
DEPOT=http://gitea.gitea.svc:3000/mutuelle-horizon/devis-auto.git
oc new-app ${BUILDER}~${DEPOT} --context-dir=devis-api --name=devis-apiSortie attendue (extrait) :
buildconfig.build.openshift.io "devis-api" created
deployment.apps "devis-api" created
service "devis-api" created
--> Successimage~source : image builder ~ dépôt Git ; --context-dir : sous-dossier du dépôtoc logs -f buildconfig/devis-api
oc get builds
oc get imagestreamtag devis-api:latestSortie attendue (extrait) :
Successfully pushed image-registry.openshift-image-registry.svc:5000/devis-dev/devis-api@…
Push successful
NAME TYPE FROM STATUS STARTED DURATION
devis-api-1 Source Git@3f2c1a7 Complete 2 minutes ago 1m40sBuilds for Red Hat OpenShift (Shipwright), BuildConfig toujours supporté en 4.22 (capacité Build)
35 min
Deployment (versions) → ReplicaSet (nombre) → Pods (exécution)
flowchart LR
D[Deployment devis-api] --> RS1[ReplicaSet v1]
D --> RS2[ReplicaSet v2]
RS2 --> P1[Pod]
RS2 --> P2[Pod]
apiVersion: apps/v1
kind: Deployment
metadata: {name: devis-api}
spec:
replicas: 1
selector: {matchLabels: {deployment: devis-api}}
template:
metadata: {labels: {deployment: devis-api}}
spec:
containers:
- name: devis-api
image: image-registry.openshift-image-registry.svc:5000/devis-dev/devis-api:latestselector présents dans template.metadata.labels (sinon refus de l'API)template → nouveau ReplicaSet → nouveaux podsoc create deployment postgresql --image=registry.redhat.io/rhel9/postgresql-16 --port=5432
oc set env deployment/postgresql POSTGRESQL_USER=devis \
POSTGRESQL_PASSWORD=devis-mdp-v1 POSTGRESQL_DATABASE=devis
oc expose deployment/postgresqlSortie attendue :
deployment.apps/postgresql created
deployment.apps/postgresql updated
service/postgresql exposedmot de passe en clair dans le Deployment → Secret au module 3
oc set env deployment/devis-api DB_HOST=postgresql DB_NAME=devis \
DB_USER=devis DB_PASSWORD=devis-mdp-v1
oc rollout status deployment/devis-api
oc get replicasets -l deployment=devis-apiSortie attendue :
deployment "devis-api" successfully rolled out
NAME DESIRED CURRENT READY AGE
devis-api-5d8f7c9b4d 0 0 0 12m
devis-api-6c4b8f7d9a 0 0 0 10m
devis-api-7b9c6d5f8e 1 1 1 40s3 ReplicaSets : modèle sans image (oc new-app), image du build, variables DB_*
DB_HOST=postgresql : nom du Service, résolu par le DNS du cluster
oc scale deployment/devis-api --replicas=3
oc delete pod -l deployment=devis-api --wait=false
oc get pods -l deployment=devis-apiSortie attendue :
NAME READY STATUS RESTARTS AGE
devis-api-7b9c6d5f8e-4xk2p 1/1 Terminating 0 3m
devis-api-7b9c6d5f8e-9qwm7 0/1 ContainerCreating 0 1s--replicas=1) : économie de ressources sur le SNO| DeploymentConfig | Deployment | |
|---|---|---|
| Origine | OpenShift (historique) | Kubernetes (standard) |
| Statut | Déprécié depuis OpenShift 4.14 | Recommandé |
| Déclencheur d'image | Natif (triggers) |
Annotation image.openshift.io/triggers |
| Hooks de cycle de vie | Oui | Non (sondes, init containers) |
DeploymentConfig hérités → migration vers Deployment à planifier
35 min
Service = IP virtuelle stable + Nom DNS + Sélecteur de labels → Pods prêts<SERVICE>.<PROJET>.svc.cluster.local (ou <SERVICE> dans le projet)deployment=devis-api)oc get service devis-api
oc get endpointslices -l kubernetes.io/service-name=devis-api| Type | Accessible depuis | Usage |
|---|---|---|
| ClusterIP (défaut) | Le cluster uniquement | Communication entre applications |
Headless (clusterIP: None) |
DNS → IP des pods | Bases de données en StatefulSet |
| NodePort | Port fixe sur chaque nœud (30000-32767) | Cas particuliers, labs |
| LoadBalancer | Équilibreur du cloud (ELB sur AWS) | Protocoles non HTTP (TCP) |
Route = Nom d'hôte → Routeur (HAProxy) → Service → Pods
flowchart LR
C[Navigateur] --> LB[ELB AWS]
LB --> R[Routeur HAProxy]
R --> S[Service devis-api]
S --> P[Pods]
<ROUTE>-<PROJET>.apps.<CLUSTER>.<DOMAINE> (DNS joker *.apps)| Type | Déchiffrement | Usage |
|---|---|---|
| edge | Routeur (HTTP vers le pod) | Cas le plus courant |
| passthrough | Pod (le routeur ne lit rien) | TLS de bout en bout, certificat géré par l'application |
| reencrypt | Routeur puis rechiffrement vers le pod | Chiffrement interne exigé |
insecureEdgeTerminationPolicy: Redirect : HTTP → HTTPS automatique*.apps)oc create route edge devis-api --service=devis-api --insecure-policy=Redirect
HOTE=$(oc get route devis-api -o jsonpath='{.spec.host}')
curl -sk "https://$HOTE/devis?puissance=7&age=30"Sortie attendue :
route.route.openshift.io/devis-api created
{"age":30,"devise":"EUR","enregistre":true,"id":1,"prime_annuelle":460.0,"puissance":7}"enregistre":true : devis-api joint PostgreSQL via le Serviceoc label deployment/devis-api deployment/postgresql app.kubernetes.io/part-of=devis-auto
oc label deployment/devis-api app.openshift.io/runtime=python
oc label deployment/postgresql app.openshift.io/runtime=postgresql
LIEN='[{"apiVersion":"apps/v1","kind":"Deployment","name":"postgresql"}]'
oc annotate deployment/devis-api app.openshift.io/connects-to="$LIEN"part-of : regroupe les composants dans une même applicationruntime : icône du composant ; connects-to : flèche de dépendance45 min
RBAC = Sujet (qui) + Rôle (quoi) + Liaison (où)get, create, delete) sur des ressourcesdroits accordés à des groupes, jamais à des personnes
| Rôle | Droits | Profil type |
|---|---|---|
view |
Lecture (hors Secrets) | Exploitation, audit |
edit |
Lecture + écriture des objets applicatifs | Développeurs |
admin |
edit + gestion des droits du projet |
Responsable d'application |
cluster-admin |
Tout, sur tout le cluster | Équipe plateforme |
self-provisioner : création de projets (accordé à tous par défaut)oc adm groups new equipe-devis dev1 dev2
oc adm policy add-role-to-group edit equipe-devis -n devis-dev
oc adm policy add-role-to-user view ops1 -n devis-dev
oc auth can-i delete pods -n devis-dev --as=dev1 --as-group=equipe-devis
oc auth can-i delete pods -n devis-dev --as=ops1Sortie attendue (deux dernières lignes) :
yes
nooc get rolebindings -n devis-dev : liaisons crééesSCC = UID autorisés + Capacités Linux + Volumes + Accès à l'hôterestricted-v2 → UID imposé (plage du projet), aucune capacité, pas d'accès hôteoc get pod -l deployment=devis-api \
-o jsonpath='{.items[0].metadata.annotations.openshift\.io/scc}'| SCC | UID | Usage |
|---|---|---|
restricted-v2 |
Plage du projet | Défaut, toutes les applications |
nonroot-v2 |
Tout UID ≠ 0 | Image à UID fixe non root |
anyuid |
Tout UID, root inclus | Image héritée, exception justifiée |
privileged |
Tout + accès hôte | Composants système uniquement |
anyuid ou privileged accordés « pour que ça marche » → risque d'évasion de conteneur
nginx officielle (Docker Hub)oc create deployment aide --image=docker.io/library/nginx:1.27
oc logs deployment/aideSortie attendue :
nginx: [emerg] mkdir() "/var/cache/nginx/client_temp" failed (13: Permission denied)CrashLoopBackOffAvant : poste du développeur, root → fonctionne
Après : OpenShift, UID 1000xxxxxx → échec au démarrage
oc set image deployment/aide nginx=docker.io/nginxinc/nginx-unprivileged:1.27anyuidoc create serviceaccount aide-sa
oc adm policy add-scc-to-user anyuid -z aide-sa
oc set serviceaccount deployment/aide aide-sa30 min
Diagnostic = Statut → Événements → Journaux → Inspectionoc get pods : statut, redémarrages, READYoc describe pod <POD> : événements (planification, image, sondes)oc logs <POD> (--previous si redémarré) : erreur de l'applicationoc debug deployment/<DEPLOIEMENT> : copie du pod avec un shelloc get events --sort-by=.lastTimestamp : chronologie du projetlire les événements AVANT de modifier quoi que ce soit
| Statut | Signification | Où regarder |
|---|---|---|
| Aucun pod, Deployment non à jour | Refus d'admission (SCC, quota) | get events : FailedCreate |
Pending |
Aucun nœud ne convient | describe : Insufficient cpu / memory |
ImagePullBackOff |
Image introuvable ou accès refusé | describe : nom, tag, pull secret |
CrashLoopBackOff |
Le conteneur démarre puis s'arrête | logs --previous ; Last State OOMKilled |
CreateContainerConfigError |
ConfigMap ou Secret manquant | describe : référence absente |
Running, READY 0/1 |
Sonde readiness en échec | describe : Readiness probe failed |
lab02-pannesoc get pods -n lab02-pannes
oc describe pod <POD> -n lab02-pannes | sed -n '/Events:/,$p'
oc logs <POD> -n lab02-pannes --previous
oc debug deployment/<DEPLOIEMENT> -n lab02-pannesSortie attendue (extrait de describe) :
Warning Failed 12s kubelet Failed to pull image "...:9.99": manifest unknown
Warning FailedScheduling 5s default-scheduler 0/1 nodes are available: …5 min
Projet = Namespace + Droits initiaux ; une équipe ou une application par projetDeployment → ReplicaSet → Pods : toute modification du modèle = nouveau ReplicaSetview / edit / admin par projetrestricted-v2 : jamais root ; corriger l'image avant d'accorder anyuidoc new-app image~https://depot.git ?image~source déclenche un build S2I : BuildConfig, ImageStreams, Deployment et Service.vieweditadmincluster-adminedit permet de modifier les objets applicatifs sans gérer les droits du projet.privileged au projetrestricted-v2cluster-adminPending. Où trouver la cause ?oc logs <POD>oc get routeoc describe pod <POD>oc get buildsPending n'a pas démarré : la cause figure dans les événements (FailedScheduling).