# TOP Dev — Stateless Coffee Break menu fixture on VKS

This disposable Kubernetes exercise accompanies the VKS series. It exposes one fixed `GET /menu` response:

```json
{"release":"v1","items":[{"sku":"coffee-beans","stock":0},{"sku":"filters","stock":24}]}
```

The fixture has no database and never creates an order. It teaches Kubernetes Deployment, Service selection, readiness and configuration rollout. A successful menu request proves neither persistence nor an application order workflow. These instructions do not claim a real VKS deployment.

Prerequisites: a platform-provisioned workload cluster, trusted kubeconfig, compatible `kubectl`, and an allocated namespace `coffee-demo`. Examples use the local context name `coffee-workload`; adapt it. Do not apply the file to the Supervisor context. The platform team owns namespace creation, quota, admission and network policy. A registry mirror may be required.

Inspect [`workload.yaml`](./workload.yaml). It creates only a `coffee-config` ConfigMap, a two-replica `coffee` Deployment and a ClusterIP Service, all in `coffee-demo`.

```sh
kubectl --context coffee-workload -n coffee-demo apply --dry-run=server -f workload.yaml
kubectl --context coffee-workload -n coffee-demo apply -f workload.yaml
kubectl --context coffee-workload -n coffee-demo rollout status deployment/coffee --timeout=120s
kubectl --context coffee-workload -n coffee-demo port-forward service/coffee 18080:80
```

In another terminal, `curl --fail http://127.0.0.1:18080/menu` returns the fixture above. Port-forward binds localhost by default; it does not validate Service VIP forwarding, ingress, DNS, TLS or an external load balancer. If exec is permitted, try `kubectl --context coffee-workload -n coffee-demo exec deployment/coffee -- wget -qO- http://coffee/menu`; this request originates from an existing demo Pod and is subject to its network policy.

The selector exercise intentionally changes only the demo Service selector, then restores it. Stop port-forward with Ctrl-C. Cleanup removes exactly the three objects in the manifest; the namespace remains allocated:

```sh
kubectl --context coffee-workload -n coffee-demo delete -f workload.yaml
```

For a configuration rollout, change only `release` from `v1` to `v2` in the ConfigMap and set `spec.template.metadata.annotations.demo-release: v2` in the Deployment. The Pod-template change triggers replacement Pods. Because the ConfigMap is mounted with `subPath` and NGINX does not reload it automatically, changing the ConfigMap alone is not enough. Verify the new release in `GET /menu`; the SKU and stock values remain unchanged. The image digest also remains unchanged.

For the separate local app and its PostgreSQL-backed order flow, see the [Coffee Break local lab](../coffee-break/README.md). That lab is not deployed by these Kubernetes instructions.

## TOP Dev — Fixture de menu stateless sur VKS

Cet exercice Kubernetes jetable accompagne la série VKS. Il expose une seule réponse fixe à `GET /menu` :

```json
{"release":"v1","items":[{"sku":"coffee-beans","stock":0},{"sku":"filters","stock":24}]}
```

Le fixture n’a pas de base de données et ne crée jamais de commande. Il sert à étudier Deployment, sélection par Service, readiness et rollout de configuration dans Kubernetes. Une réponse de menu réussie ne prouve ni persistance ni parcours de commande. Ces instructions ne revendiquent aucun déploiement réel sur VKS.

Prérequis : un cluster de workloads provisionné par la plateforme, un kubeconfig de confiance, une version compatible de `kubectl` et un namespace `coffee-demo` alloué. Les exemples utilisent le contexte local `coffee-workload` ; adapte-le. N’applique pas ce manifeste au contexte Supervisor. L’équipe plateforme gère la création du namespace, les quotas, l’admission et les politiques réseau. Un miroir de registre peut être nécessaire.

Examine [`workload.yaml`](./workload.yaml). Il crée uniquement une ConfigMap `coffee-config`, un Deployment `coffee` à deux réplicas et un Service ClusterIP, tous dans `coffee-demo`.

```sh
kubectl --context coffee-workload -n coffee-demo apply --dry-run=server -f workload.yaml
kubectl --context coffee-workload -n coffee-demo apply -f workload.yaml
kubectl --context coffee-workload -n coffee-demo rollout status deployment/coffee --timeout=120s
kubectl --context coffee-workload -n coffee-demo port-forward service/coffee 18080:80
```

Dans un autre terminal, `curl --fail http://127.0.0.1:18080/menu` renvoie le fixture ci-dessus. Par défaut, port-forward est lié à localhost ; cela ne valide ni le transfert VIP du Service, ni l’ingress, DNS, TLS ou un load balancer externe. Si le droit exec est accordé, essaie `kubectl --context coffee-workload -n coffee-demo exec deployment/coffee -- wget -qO- http://coffee/menu` ; l’appel vient d’un Pod de démonstration existant et reste soumis à sa politique réseau.

L’exercice de sélecteur ne modifie volontairement que le Service de démonstration, puis restaure son selector. Arrête port-forward avec Ctrl-C. Le nettoyage supprime exactement les trois objets du manifeste ; le namespace reste alloué :

```sh
kubectl --context coffee-workload -n coffee-demo delete -f workload.yaml
```

Pour un rollout de configuration, change uniquement `release` de `v1` à `v2` dans la ConfigMap et règle `spec.template.metadata.annotations.demo-release: v2` dans le Deployment. La modification du Pod template déclenche le remplacement des Pods. La ConfigMap est montée avec `subPath` et NGINX ne la recharge pas automatiquement : changer seulement la ConfigMap ne suffit pas. Vérifie la nouvelle version dans `GET /menu` ; les SKU et les quantités restent identiques. Le digest de l’image ne change pas.

Pour l’application locale distincte et ses commandes persistées dans PostgreSQL, consulte le [labo local Pause Café](../coffee-break/README.md). Ces instructions Kubernetes ne la déploient pas.
