> ## Documentation Index
> Fetch the complete documentation index at: https://infra-docs.kaeyros.org/llms.txt
> Use this file to discover all available pages before exploring further.

# PostgreSQL géré par l'opérateur Zalando

> Comment nos ~95 bases PostgreSQL sont décrites, provisionnées et consommées via l'opérateur Zalando dans le cluster.

Nos bases sont gérées par l'opérateur PostgreSQL de Zalando. Vous ne créez pas une base à la main : vous décrivez un cluster PostgreSQL dans un manifeste, et l'opérateur s'occupe du reste, à savoir le StatefulSet, les volumes, les utilisateurs, les mots de passe et la sauvegarde.

## Manifeste type

Un manifeste comme on en trouve dans `databases/` :

```yaml databases/monappli-prod.yaml theme={null}
apiVersion: acid.zalan.do/v1
kind: postgresql
metadata:
  name: monappliprod
  namespace: mon-produit           # ← à ne pas oublier, voir /infrastructure/stockage-local-path
spec:
  teamId: acid
  numberOfInstances: 1
  postgresql: { version: '17' }
  volume:
    size: 8Gi
    storageClass: local-path
  enableLogicalBackup: true
  logicalBackupSchedule: "0 0 * * *"
```

## Convention de nommage

Le nom du cluster s'écrit **sans séparateur**, suffixé par l'environnement : `oimdashboardapiprod`, `precomputepointagestg`, `semaunivbulkbackprod`. Le pod correspondant s'appellera `<nom>-0`.

## Identifiants et Secret généré

Les identifiants sont générés par l'opérateur dans un Secret nommé :

```text theme={null}
<utilisateur>.<cluster>.credentials.postgresql.acid.zalan.do
```

Vos applications le consomment par `secretKeyRef` :

```yaml Consommation dans un fichier de valeurs theme={null}
env:
  - name: DATABASE_PASSWORD
    valueFrom:
      secretKeyRef:
        name: monappli.monappliprod.credentials.postgresql.acid.zalan.do
        key: password
```

> [!NOTE]
>
> Pour créer une nouvelle base dans le dépôt, voir [Créer une base](https://infra-docs.kaeyros.org/operations/creer-base.md). Pour comprendre les conséquences du stockage local-path, voir [Stockage local-path](https://infra-docs.kaeyros.org/infrastructure/stockage-local-path.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.