OpenShift Container Platform 4.22 · oc aligné sur le cluster · fil rouge Devis Auto
oc = kubectl + projets, builds, Routes, comptes, administration du cluster
| Besoin | Commande |
|---|---|
| Se connecter | oc login https://api.<CLUSTER>.<DOMAINE>:6443 -u admin |
| Identité, serveur, jeton | oc whoami · oc whoami --show-server · oc whoami -t |
| Changer de projet | oc project devis-dev · oc projects |
| Besoin | Commande |
|---|---|
| Contextes (plusieurs clusters) | oc config get-contexts · oc config use-context <CONTEXTE> |
| Vérifier un droit | oc auth can-i create deployments -n devis-dev --as=dev1 --as-group=equipe-devis |
| Documentation d'un champ | oc explain deployment.spec.strategy |
| Besoin | Commande |
|---|---|
| Version et mises à jour | oc get clusterversion |
| Santé de la plateforme | oc get clusteroperators (AVAILABLE=True, DEGRADED=False) |
| Nœuds, configuration machine | oc get nodes -o wide · oc get machineconfigpool |
| Shell sur un nœud | oc debug node/<NOEUD> puis chroot /host |
| Operators | oc get subscriptions.operators.coreos.com,installplan,csv -n <NAMESPACE> |
| Approuver un InstallPlan | oc patch installplan <IP> -n <NS> --type merge -p '{"spec":{"approved":true}}' |
oc new-project devis-dev
GIT=http://gitea.gitea.svc:3000/mutuelle-horizon/devis-auto.git
oc new-app registry.access.redhat.com/ubi9/python-312~$GIT \
--context-dir=devis-api --name=devis-api
oc logs -f buildconfig/devis-api # suivi du build S2I
oc start-build devis-api --follow # nouveau build
oc create route edge devis-api --service=devis-api --insecure-policy=Redirect| Besoin | Commande |
|---|---|
| Déployer une image | oc create deployment postgresql --image=registry.redhat.io/rhel9/postgresql-16 --port=5432 |
| Exposer en interne | oc expose deployment/postgresql (Service) |
| Images et versions | oc get imagestreamtags · oc tag devis-api:latest devis-api:1.0.0 |
| Mettre à l'échelle | oc scale deployment/devis-api --replicas=2 |
| Besoin | Commande |
|---|---|
| ConfigMap | oc create configmap devis-config --from-literal=TARIF_BASE=450 |
| Secret | oc create secret generic devis-db --from-literal=PASSWORD=<MOT_DE_PASSE> |
| Variables depuis une ressource | oc set env deployment/devis-api --from=configmap/devis-config |
| Monter en fichiers | oc set volume deployment/devis-api --add --type=secret --secret-name=devis-db --mount-path=/var/run/secrets/devis-db |
| Retirer une variable | oc set env deployment/devis-api DEBUG- |
| Besoin | Commande |
|---|---|
| Classes et volumes | oc get storageclass · oc get pvc,pv |
| Volume persistant | oc set volume deployment/postgresql --add --name=donnees --type=pvc --claim-name=postgresql-data --claim-size=1Gi --mount-path=/var/lib/pgsql/data |
| Besoin | Commande |
|---|---|
| Sondes | oc set probe deployment/devis-api --readiness --get-url=http://:8080/ready (--liveness, --startup) |
| Ressources | oc set resources deployment/devis-api --requests=cpu=100m,memory=128Mi --limits=cpu=500m,memory=256Mi |
| Autoscaling | oc autoscale deployment/devis-api --min=2 --max=4 --cpu=50% · oc get hpa |
| Besoin | Commande |
|---|---|
| Nouvelle version | oc set image deployment/devis-api devis-api=<IMAGE>:3.0.0 |
| Suivre / historique | oc rollout status deployment/devis-api · oc rollout history deployment/devis-api |
| Retour arrière | oc rollout undo deployment/devis-api (--to-revision=<N>) |
| Redémarrer les pods | oc rollout restart deployment/devis-api |
| Besoin | Commande |
|---|---|
| Groupe d'équipe | oc adm groups new equipe-devis dev1 dev2 |
| Rôle sur un projet | oc adm policy add-role-to-group edit equipe-devis -n devis-dev · add-role-to-user view ops1 |
| SCC appliquée à un pod | oc get pod <POD> -o jsonpath='{.metadata.annotations.openshift\.io/scc}' |
| SCC nécessaire à un compte | oc adm policy scc-subject-review -f <FICHIER>.yaml |
Pod en erreur → oc get pods → oc describe pod (Events) → oc logs (--previous) → correction| Symptôme | Piste | Commande |
|---|---|---|
ImagePullBackOff |
Nom ou tag d'image, droits du registre | oc describe pod <POD> |
CrashLoopBackOff |
Erreur de l'application au démarrage | oc logs <POD> --previous |
CreateContainerConfigError |
ConfigMap ou Secret absent | oc describe pod <POD> |
CrashLoopBackOff + Permission denied |
Image conçue pour root, UID imposé par la SCC | oc logs <POD> · annotation openshift.io/scc |
| Symptôme | Piste | Commande |
|---|---|---|
Aucun pod, FailedCreate … unable to validate against any security context constraint |
Pod demandant runAsUser: 0 ou privileged |
oc get events · oc describe replicaset |
Pending |
Ressources insuffisantes, quota, PVC non lié | oc describe pod <POD> · oc describe quota |
OOMKilled |
Limite mémoire trop basse | oc get pod <POD> -o jsonpath='{.status.containerStatuses[0].lastState}' |
| Route en 503 | Aucun pod prêt derrière le Service | oc describe endpointslices -l kubernetes.io/service-name=devis-api (Ready: false) |
Raccourcis : oc rsh <POD> · oc exec deployment/devis-api -- env · oc port-forward svc/devis-api 8080
| Besoin | Commande |
|---|---|
| Autoriser Argo CD sur un namespace | oc label namespace devis-prod argocd.argoproj.io/managed-by=openshift-gitops |
| État des Applications | oc get applications.argoproj.io -n openshift-gitops (SYNC STATUS, HEALTH STATUS) |
| Forcer une relecture de Git | oc annotate applications.argoproj.io devis-auto-dev -n openshift-gitops argocd.argoproj.io/refresh=normal --overwrite |
| Rendu local Kustomize | oc kustomize overlays/prod |
| Interface | oc get route openshift-gitops-server -n openshift-gitops |
Promotion = commit dans overlays/prod → synchronisation → déploiement · Retour arrière = git revert
| Besoin | Commande / requête |
|---|---|
| Activer le monitoring des projets | ConfigMap cluster-monitoring-config (openshift-monitoring) : enableUserWorkload: true |
| Cibles collectées | Console → Observe → Targets · oc get servicemonitor -n devis-prod |
| Débit | sum(rate(devis_requetes_total{namespace="devis-prod"}[2m])) |
| Taux d'erreurs | sum(rate(devis_requetes_total{code=~"5.."}[2m])) / sum(rate(devis_requetes_total[2m])) |
| Latence p95 | histogram_quantile(0.95, sum by (le) (rate(devis_duree_secondes_bucket[5m]))) |
Méthode RED = Rate (débit) + Errors (erreurs) + Duration (latence)
| Besoin | Commande / requête |
|---|---|
| Par pod | sum by (pod) (...) |
| Alertes | Console → Observe → Alerting · oc get prometheusrule -n devis-prod |
| Journaux | oc logs -l deployment=devis-api --prefix --tail=20 · Observe → Logs (LogQL) |
| LogQL | {kubernetes_namespace_name="devis-prod"} \|= "erreur" · \| json \| level="error" |
| Option | Usage |
|---|---|
-o wide · -o yaml |
Détail · ressource complète |
-o jsonpath='{.spec.host}' |
Extraire un champ |
-w |
Suivre les changements |
-l app=devis-api |
Filtrer par label |
--sort-by=.lastTimestamp |
Trier les événements |