Guide de Déploiement PostgreSQL Operator sur OpenShift

# Vérifier la connexion au cluster
oc cluster-info

# Vérifier vos permissions
oc auth can-i create customresourcedefinitions
oc auth can-i create clusterroles

# Créer un nouveau projet pour l'opérateur
oc new-project postgres-operator

# Ou utiliser un projet existant
oc project postgres-operator

git clone https://github.com/zalando/postgres-operator.git
cd postgres-operator

apiVersion: v1
kind: ConfigMap
metadata:
  name: postgres-operator
data:
  # Configuration spécifique OpenShift
  kubernetes_use_configmaps: "true"

  # Configuration générale
  docker_image: registry.opensource.zalan.do/acid/spilo-16:3.2-p3
  sidecar_docker_image: registry.opensource.zalan.do/acid/pgbouncer:master-32

  # Ressources par défaut
  min_cpu_limit: "250m"
  max_cpu_request: "1"
  min_memory_limit: "250Mi"
  max_memory_request: "1Gi"

  # Configuration des pods
  pod_management_policy: "ordered_ready"
  pod_terminate_grace_period: 

  
   
   

  
   

  
   

oc create -f openshift-configmap.yaml

# Utiliser le manifest RBAC spécifique pour OpenShift
oc create -f manifests/operator-service-account-rbac-openshift.yaml

# Déployer l'opérateur
oc create -f manifests/postgres-operator.yaml

# (Optionnel) Déployer l'API UI
oc create -f manifests/api-service.yaml

# Vérifier que le pod de l'opérateur est en cours d'exécution
oc get pods -l name=postgres-operator

# Vérifier les logs
oc logs -l name=postgres-operator -f

# Vérifier la CRD
oc get crd postgresqls.acid.zalan.do

NAME                                READY   STATUS    RESTARTS   AGE
postgres-operator-xxxxxxxxxx-xxxxx  1/1     Running   0          30s

# Créer un projet dédié pour vos bases PostgreSQL
oc new-project postgres-databases

# Ou utiliser un projet existant
oc project postgres-databases

apiVersion: "acid.zalan.do/v1"
kind: postgresql
metadata:
  name: production-cluster
  namespace: postgres-databases
spec:
  # Identifiant de l'équipe
  teamId: "myteam"

  # Configuration HA : 3 instances pour production
  numberOfInstances: 3

  # Version PostgreSQL
  postgresql:
    version: "16"
    parameters:
      
       
       
       
      
       
       

  
  
     
       

  
  
    
    
       
       

    
    
       

  
  
     

  
  
    
       
       
    
       
       

  
   

  
  
     
     

  
  
  
  
  
  

# Appliquer le manifest
oc apply -f postgres-cluster-ha.yaml

# Vérifier la création du cluster
oc get postgresql

# Observer la création des pods
oc get pods -l cluster-name=production-cluster -w

# Vérifier l'état du cluster
oc get postgresql production-cluster

# Tous les pods doivent être en Running
oc get pods -l cluster-name=production-cluster

NAME                    READY   STATUS    RESTARTS   AGE
production-cluster-0    1/1     Running   0          3m
production-cluster-1    1/1     Running   0          2m30s
production-cluster-2    1/1     Running   0          2m

# Lister les services
oc get svc -l cluster-name=production-cluster

# Lister les secrets des utilisateurs
oc get secrets -l cluster-name=production-cluster

# Vérifier les volumes persistants
oc get pvc -l cluster-name=production-cluster

# Vérifier quel pod est le master
oc get pods -l cluster-name=production-cluster -L spilo-role

# Se connecter au master et vérifier la réplication
oc exec production-cluster-0 -- psql -U postgres -c "SELECT * FROM pg_stat_replication;"

# Récupérer le mot de passe de l'utilisateur admin
export PGPASSWORD=$(oc get secret admin.production-cluster.credentials.postgresql.acid.zalan.do \
  -o jsonpath='{.data.password}' | base64 -d)

echo "Password: $PGPASSWORD"

# Récupérer le username
export PGUSER=$(oc get secret admin.production-cluster.credentials.postgresql.acid.zalan.do \
  -o jsonpath='{.data.username}' | base64 -d)

echo "Username: $PGUSER"

# Lancer un pod PostgreSQL client
oc run psql-client --rm -it --restart=Never --image=postgres:16 -- bash

# Dans le pod, se connecter au master
psql -h production-cluster.postgres-databases.svc.cluster.local -U admin -d app_db

# Ou se connecter aux replicas (lecture seule)
psql -h production-cluster-repl.postgres-databases.svc.cluster.local -U admin -d app_db

# Créer une route (pour dev/test uniquement)
oc create route passthrough production-cluster-route \
  --service=production-cluster \
  --port=5432

# Récupérer l'URL
oc get route production-cluster-route

# Pour le master (lecture/écriture)
postgresql://admin:PASSWORD@production-cluster.postgres-databases.svc.cluster.local:5432/app_db

# Pour les replicas (lecture seule)
postgresql://admin:PASSWORD@production-cluster-repl.postgres-databases.svc.cluster.local:5432/app_db

spec:
  # ... autres configurations ...

  # Configuration des backups
  enableLogicalBackup: true
  logicalBackupSchedule: "30 2 * * *"  # Tous les jours à 2h30

  # Configuration de WAL-E pour AWS S3
  env:
    - name: WAL_S3_BUCKET
      value: "my-postgres-backups"
    - name: AWS_REGION
      value: "eu-west-1"
    - name: AWS_ACCESS_KEY_ID
      valueFrom:
        secretKeyRef:
          name: postgres-backup-credentials
          key: access-key
    - name: AWS_SECRET_ACCESS_KEY
      valueFrom:
        
           
           

spec:
  # ... autres configurations ...

  # Activer PgBouncer en sidecar
  enableConnectionPooler: true
  connectionPooler:
    numberOfInstances: 2
    mode: "transaction"
    schema: "pooler"
    user: "pooler"
    dockerImage: "registry.opensource.zalan.do/acid/pgbouncer:master-32"
    maxClientConnections: 1000
    defaultPoolSize: 25
    resources:
      requests:
        cpu: "100m"
        memory: "128Mi"
      limits:
        cpu: "500m"
        memory: "256Mi"

spec:
  # ... autres configurations ...

  # Ajouter le sidecar d'export pour Prometheus
  sidecars:
    - name: postgres-exporter
      image: "quay.io/prometheuscommunity/postgres-exporter:latest"
      ports:
        - containerPort: 9187
          name: metrics
      env:
        - name: DATA_SOURCE_NAME
          value: "postgresql://postgres@localhost:5432/postgres?sslmode=disable"

# Éditer le cluster
oc edit postgresql production-cluster

# Modifier numberOfInstances
spec:
  numberOfInstances: 5  # Augmenter le nombre

# Ou via patch
oc patch postgresql production-cluster --type='merge' -p '{"spec":{"numberOfInstances":5}}'

# L'opérateur gère automatiquement la rotation
# Forcer une rotation manuelle en ajoutant une annotation
oc annotate postgresql production-cluster \
  "acid.zalan.do/password-rotation"="$(date +%s)"

# Éditer le cluster
oc edit postgresql production-cluster

# Modifier la version
spec:
  postgresql:
    version: "17"  # Nouvelle version

# L'opérateur effectuera un rolling upgrade
oc get pods -l cluster-name=production-cluster -w

# Patch le cluster avec une nouvelle taille
oc patch postgresql production-cluster --type='merge' \
  -p '{"spec":{"volume":{"size":"50Gi"}}}'

# Vérifier les PVCs
oc get pvc -l cluster-name=production-cluster

# Se connecter au master
oc exec production-cluster-0 -- su postgres -c \
  "pg_dump -Fc app_db > /home/postgres/backup_$(date +%Y%m%d).dump"

# Copier le backup localement
oc cp production-cluster-0:/home/postgres/backup_*.dump ./backup.dump

# Copier le backup dans le pod
oc cp ./backup.dump production-cluster-0:/tmp/backup.dump

# Restaurer
oc exec production-cluster-0 -- su postgres -c \
  "pg_restore -d app_db /tmp/backup.dump"

# Vérifier les logs
oc logs -l name=postgres-operator --tail=100

# Vérifier les events
oc get events --sort-by='.lastTimestamp'

# Vérifier les SecurityContextConstraints
oc get scc

# Vérifier les PVCs
oc get pvc -l cluster-name=production-cluster

# Vérifier les ressources disponibles
oc describe nodes | grep -A 5 "Allocated resources"

# Vérifier les events du pod
oc describe pod production-cluster-0

# Se connecter au master
oc exec production-cluster-0 -- psql -U postgres -c \
  "SELECT * FROM pg_stat_replication;"

# Vérifier les logs du pod replica
oc logs production-cluster-1 --tail=50

# Vérifier la configuration
oc exec production-cluster-1 -- cat /home/postgres/pgdata/pgroot/data/postgresql.conf | grep -i replication

# Vérifier l'état du custom resource
oc describe postgresql production-cluster

# Vérifier les logs de l'opérateur
oc logs -l name=postgres-operator -f

# Vérifier que l'opérateur surveille le bon namespace
oc get configmap postgres-operator -o yaml | grep watched_namespace

# Vérifier l'utilisation du disque
oc exec production-cluster-0 -- df -h

# Augmenter la taille du volume (voir section Maintenance)
# Nettoyer les WAL anciens
oc exec production-cluster-0 -- su postgres -c \
  "psql -c \"SELECT pg_switch_wal(); SELECT pg_switch_wal();\""

# Vérifier les connexions actives
oc exec production-cluster-0 -- psql -U postgres -c \
  "SELECT count(*) FROM pg_stat_activity;"

# Vérifier les requêtes lentes
oc exec production-cluster-0 -- psql -U postgres -c \
  "SELECT pid, now() - query_start as duration, query FROM pg_stat_activity WHERE state = 'active' AND now() - query_start > interval '1 minute';"

# Analyser les locks
oc exec production-cluster-0 -- psql -U postgres -c \
  "SELECT * FROM pg_locks WHERE NOT granted;"

# Lister tous les clusters PostgreSQL
oc get postgresql --all-namespaces

# Voir les détails d'un cluster
oc describe postgresql production-cluster

# Voir les logs d'un pod PostgreSQL
oc logs production-cluster-0 -c postgres

# Se connecter en bash à un pod
oc exec -it production-cluster-0 -- bash

# Lister les bases de données
oc exec production-cluster-0 -- psql -U postgres -c "\l"

# Lister les utilisateurs
oc exec production-cluster-0 -- psql -U postgres -c "\du"

# Voir la taille des bases
oc exec production-cluster-0 -- psql -U postgres -c \
  "SELECT pg_database.datname, pg_size_pretty(pg_database_size(pg_database.datname)) AS size FROM pg_database;"

# Redémarrer un pod (rolling restart)
oc delete pod production-cluster-0
# L'opérateur le recréera automatiquement

# Supprimer un cluster (ATTENTION : destructif)
oc delete postgresql production-cluster