<?xml version="1.0" encoding="UTF-8"?>
<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom" xmlns:content="http://purl.org/rss/1.0/modules/content/" xmlns:dc="http://purl.org/dc/elements/1.1/">
<channel>
<title>adem.build — le blog d&#39;Adem Usta</title>
<link>https://adem.build/fr/posts</link>
<description>Des articles concrets d&#39;Adem Usta sur le logiciel, l&#39;IA locale et agentique, le homelab, Kubernetes et le hardware : ce qui a marché, ce qui a cassé.</description>
<language>fr</language>
<atom:link href="https://adem.build/fr/rss.xml" rel="self" type="application/rss+xml"/>
<lastBuildDate>Tue, 07 Jul 2026 00:00:00 GMT</lastBuildDate>
<item><title>Monter une IA locale complète</title><link>https://adem.build/fr/posts/monter-une-ia-locale-complete</link><guid isPermaLink="true">https://adem.build/fr/posts/monter-une-ia-locale-complete</guid><pubDate>Tue, 07 Jul 2026 00:00:00 GMT</pubDate><dc:creator>Adem Usta</dc:creator><description>Comment ma workstation gaming est devenue une IA locale complète, privée et vocale.</description><category>ia</category><category>llm</category><category>homelab</category><category>vllm</category><category>qwen</category><category>open-webui</category><category>gpu</category><category>self-hosted</category><category>local-ai</category><category>opencode</category><category>agentic-coding</category><content:encoded><![CDATA[<h2 id="des-méandres-du-gaming-">Des méandres du gaming …</h2>
<p>J’suis un nerd, je joue (jouais…) à mes heures perdues. J’ai donc un PC de type “gamer”, avec une bonne carte graphique, un CPU puissant et beaucoup de RAM. C’est un build que j’ai commencé à faire pendant le covid, avant que les prix (déjà à l’époque c’était parti en vrille) ne s’envolent.</p>
<p>Une rtx 3080, et j’étais pas mal pour jouer (Watch Dogs, Satisfactory, et autres merveilles).</p>
<p>Puis j’ai changé de CG, pour faire un peu de ML dessus. Ajouter de la RAM aussi. Et voilà que mon PC Gamer se transforme petit à petit en workstation ML. Cool.</p>
<p>Puis on est entré dans l’ère des agents IA, des LLMs locaux (merci la Chine), des projets OSS pour gérer des agents IA etc (hello OpenClaw, Hermes, etc), et j’ai voulu jouer à tout cela chez moi. La workstation n’attendait que ça. Timing parfait.</p>
<p>Premiers essais avec des IAs locales et on voit déjà les limites de la rtx 3090, malgré ses 24 GB de VRAM.</p>
<p>En bon “tryharder”, je décide de trouver une seconde CG, exactement la même, pour une bouchée de pain (ouais bon, 650 euros quand même). Et puis je dois changer la CM pour pouvoir tirer parti de la puissance des deux CG (nombre de PCI LANE, etc, bref des trucs de bon gros nerds). On trouve une CM sur leboncoin, la CG aussi. On monte tout. La seconde CG surchauffe (seule ou à deux, tests croisés, double check). Je me suis fait berner par un daron de 60 piges qui, je cite, ne jouait qu’à Flight Simulator avec (et avait laissé le plastique sur la plaque de cooling !). J’aurais dû faire attention.</p>
<p>Tryhard toujours, je décide d’ouvrir la carte : pâte thermique SÈCHE.</p>
<p><img src="https://adem.build/articles/7/thermal-paste.webp" alt="Pâte thermique sèche" loading="lazy" decoding="async"></p>
<p>Je change tout ça (je n’ai qu’une photo malheureusement). On remonte le tout.. ça bombarde et c’est stable en température.</p>
<p>Le build complet:</p>
<p><img src="https://adem.build/articles/7/build.webp" alt="Le build complet" loading="lazy" decoding="async"></p>
<ul>
<li>Amd Ryzen 3900x</li>
<li>64 GB DDR4 RAM</li>
<li>Asus ROG X570</li>
<li>2x Asus TUF RTX 3090</li>
</ul>
<h2 id="-à-son-ia-locale">… à son IA locale</h2>
<p>Let’s go. Step by step.</p>
<h2 id="tests-préliminaires">Tests préliminaires</h2>
<p>La machine est prête, j’installe une distribution linux dessus et je fais mes premiers tests concluants, notamment avec gemma 4.</p>
<p>C’est bien cool tout ça, mais je veux pas gérer ma workstation en standalone, avec tout ce que ça peut impliquer.</p>
<p>Solution simple, c’était devant moi tout ce temps ! Intégrer à mon homelab la workstation. Comme avec les rpis, ma workstation se retrouve dans mon cluster en une commande.</p>
<p>Maintenant, que faire ?</p>
<p>Première étape: avoir son propre LLM servi proprement sur ce node.</p>
<p>À ce moment-là, gemma-4 est dans tous les threads llm OW, donc je teste de le servir dessus.</p>
<p>Pour cela, on va utiliser <code>vllm</code>, le configurer pour qu’il charge le bon gemma-4 qui fit dans les 2 CG (au total 48GB). De mémoire, on utilise un modèle quantifié + pré-allocation de 200k de context pour que ça devienne intéressant.</p>
<p>Bluffé des résultats. Ça commence à être sérieux niveau LLM local.</p>
<p>Je laisse ça tourner en local, sans trop l’utiliser.. un peu de opencode sur un “faux” projet pour voir comment il se débrouille. Sans plus.</p>
<p>Puis… arrive le dernier modèle de Qwen: qwen3.6. Les benchmarks annoncent des dingueries, surtout en agentic Coding.</p>
<h2 id="qwen36-juste-merci">Qwen3.6: juste merci.</h2>
<p>Vous connaissez le mec maintenant : la FOMO me fait passer de Gemma à QWEN. Mais cette fois on va plus loin: je veux en faire un agent perso, dispo sur mon tel partout, tout le temps. Avec de la voix. Le tout privé, en local, aucune donnée ne sort.</p>
<p>Pour réaliser cela, on va partir sur une stack complète qui fit dans la workstation:</p>
<ul>
<li>vllm servant qwen3.6 27B, la version exacte étant <code>cyankiwi/Qwen3.6-27B-AWQ-BF16-INT4</code></li>
<li>open-webui pour une interface de chat propre et configurable</li>
<li>Du STT et TTS pour pouvoir discuter avec Qwen de manière fluide.
<ul>
<li>STT: Speaches (faster whisper) lock en FR</li>
<li>TTS: Kokoro</li>
</ul>
</li>
<li>WebSearch SearXNG pour les recherches web sans APIs externes.</li>
</ul>
<p>Le tout accessible uniquement via mon network privé tailscale.</p>
<p>Chaque brique AI est servie via une API openai compliant, pour une interconnectivité accrue.</p>
<p>Un petit aperçu de open-webui:</p>
<p><img src="https://adem.build/articles/7/open-webui.webp" alt="Aperçu de open-webui" loading="lazy" decoding="async"></p>
<h2 id="performances">Performances</h2>
<h3 id="premier-cas-simple-recherche-web-et-analyse">Premier cas simple: recherche web et analyse.</h3>
<video controls preload="metadata" style="width: 100%; border-radius: 0.5rem;">
  <source src="https://adem.build/articles/7/websearch.webm" type="video/webm" />
</video>
<p>Performance:</p>
<pre class="astro-code astro-code-themes github-light github-dark" style="--shiki-light:#24292e;--shiki-dark:#e1e4e8;--shiki-light-bg:#fff;--shiki-dark-bg:#24292e; overflow-x: auto;" tabindex="0" data-language="plaintext"><code><span class="line"><span>Engine 000: Avg prompt throughput: 531.9 tokens/s, Avg generation throughput: 120.5 tokens/s, Running: 1 reqs, Waiting: 0 reqs,</span></span></code></pre>
<h3 id="démo-dune-conversation-audio">Démo d’une conversation audio:</h3>
<video controls preload="metadata" style="width: 100%; border-radius: 0.5rem;">
  <source src="https://adem.build/articles/7/audio.webm" type="video/webm" />
</video>
<p>Ça fonctionne, l’UI répond bien et c’est assez fluide. Bon c’est lent, mais il doit y avoir un moyen d’optimiser ça. Une bonne v1.</p>
<h2 id="agentic-coding">Agentic coding</h2>
<p>Pour ce test, on va utiliser un projet opensource: opencode.</p>
<p><a href="https://opencode.ai/">https://opencode.ai/</a></p>
<p>Pour ceux qui ne savent pas ce que c’est: c’est un peu l’équivalent de claude code pour anthropic, et codex pour openai. Un logiciel permettant de vous assister complètement sur la compréhension, la gestion, et l’évolution d’une codebase.</p>
<p>On le plug à notre llm local via une configuration simple:</p>
<pre class="astro-code astro-code-themes github-light github-dark" style="--shiki-light:#24292e;--shiki-dark:#e1e4e8;--shiki-light-bg:#fff;--shiki-dark-bg:#24292e; overflow-x: auto;" tabindex="0" data-language="json"><code><span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">{</span></span>
<span class="line"><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF">  "$schema"</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF">"https://opencode.ai/config.json"</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">,</span></span>
<span class="line"><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF">  "model"</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF">"vllm/qwen3.6-27b"</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">,</span></span>
<span class="line"><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF">  "small_model"</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF">"vllm/qwen3.6-27b"</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">,</span></span>
<span class="line"><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF">  "provider"</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">: {</span></span>
<span class="line"><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF">    "vllm"</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">: {</span></span>
<span class="line"><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF">      "npm"</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF">"@ai-sdk/openai-compatible"</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">,</span></span>
<span class="line"><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF">      "name"</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF">"vLLM (local)"</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">,</span></span>
<span class="line"><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF">      "options"</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">: {</span></span>
<span class="line"><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF">        "baseURL"</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF">"https://my.endpoint.com"</span></span>
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">      },</span></span>
<span class="line"><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF">      "models"</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">: {</span></span>
<span class="line"><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF">        "qwen3.6-27b"</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">: {</span></span>
<span class="line"><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF">          "name"</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF">"Qwen 3.6 27B"</span></span>
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">        }</span></span>
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">      }</span></span>
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">    }</span></span>
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">  }</span></span>
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">}</span></span></code></pre>
<p>L’interface ressemble à ça:</p>
<p><img src="https://adem.build/articles/7/opencode.webp" alt="Interface de opencode" loading="lazy" decoding="async"></p>
<p>Tout est setup, c’est good. Maintenant, que va-t-on lui faire coder pour tester ses performances ?</p>
<h3 id="premier-test-le-tic-tac-toe">Premier test: le tic-tac-toe.</h3>
<p>Prompt:</p>
<pre class="astro-code astro-code-themes github-light github-dark" style="--shiki-light:#24292e;--shiki-dark:#e1e4e8;--shiki-light-bg:#fff;--shiki-dark-bg:#24292e; overflow-x: auto;" tabindex="0" data-language="plaintext"><code><span class="line"><span>Let's build a well known game: tictactoe.</span></span>
<span class="line"><span>The goal is quite simple: a small React App, Typescript, Tailwind, served with a local dev server. 2 players can play the game locally on the same computer. Rules are the game rules, you know them.</span></span>
<span class="line"><span>Simple yet beautiful design, keep it simple and UX friendly.</span></span>
<span class="line"><span>Plan and go !</span></span></code></pre>
<p>En one-shot:</p>
<video controls preload="metadata" style="width: 100%; border-radius: 0.5rem;">
  <source src="https://adem.build/articles/7/tictactoe.webm" type="video/webm" />
</video>
<p>Code disponible ici:</p>
<p><a href="https://github.com/ademoverflow/tictactoe-qwen/">https://github.com/ademoverflow/tictactoe-qwen/</a></p>
<p>Ce que opencode a fait:</p>
<pre class="astro-code astro-code-themes github-light github-dark" style="--shiki-light:#24292e;--shiki-dark:#e1e4e8;--shiki-light-bg:#fff;--shiki-dark-bg:#24292e; overflow-x: auto;" tabindex="0" data-language="plaintext"><code><span class="line"><span>Summary: Tic-Tac-Toe Build</span></span>
<span class="line"><span></span></span>
<span class="line"><span>1. Project Scaffolding</span></span>
<span class="line"><span>- Ran npm create vite@latest . -- --template react-ts to scaffold a Vite + React + TypeScript project in the existing empty git repo</span></span>
<span class="line"><span>- Installed all dependencies with npm install</span></span>
<span class="line"><span>- Added Tailwind CSS 4 via npm install -D tailwindcss @tailwindcss/vite</span></span>
<span class="line"><span>2. Configuration</span></span>
<span class="line"><span>- vite.config.ts — Added @tailwindcss/vite plugin alongside the React plugin</span></span>
<span class="line"><span>- index.html — Updated &lt;title&gt; from "tictactoe" to "Tic-Tac-Toe"</span></span>
<span class="line"><span>- Cleaned up default template assets (App.css, hero.png, react.svg, vite.svg, favicon.svg)</span></span>
<span class="line"><span>3. Styles — src/index.css</span></span>
<span class="line"><span>- Replaced the Vite template CSS entirely</span></span>
<span class="line"><span>- Imported Tailwind via @import "tailwindcss"</span></span>
<span class="line"><span>- Defined 4 custom @keyframes:</span></span>
<span class="line"><span>- cell-pop — scale + fade animation for marks appearing</span></span>
<span class="line"><span>- glow — pulsing box-shadow for winning cells</span></span>
<span class="line"><span>- fade-in — slide-up + fade for result banners</span></span>
<span class="line"><span>- shimmer — (available for future use)</span></span>
<span class="line"><span>- Mapped keyframes to utility classes (.cell-pop, .cell-glow, .fade-in)</span></span>
<span class="line"><span>4. Game Logic — src/App.tsx</span></span>
<span class="line"><span>- Win detection — checkWinner() iterates 8 possible lines (3 rows, 3 cols, 2 diagonals)</span></span>
<span class="line"><span>- Draw detection — isDraw() checks if all 9 cells are filled</span></span>
<span class="line"><span>- AI (minimax with alpha-beta pruning) — getBestMove() evaluates all possible moves recursively, making the computer unbeatable</span></span>
<span class="line"><span>- Game state — board (9 cells), xIsNext, mode (2p / ai), status (playing / won / draw), winningLine, thinking flag</span></span>
<span class="line"><span>- AI move trigger — useEffect fires on AI's turn with a 400ms delay for natural feel</span></span>
<span class="line"><span>- Components — CellComponent renders each cell with SVG X/O, hover states, and winning glow</span></span>
<span class="line"><span>5. UI Design</span></span>
<span class="line"><span>- Gradient background (slate-100 → slate-200), centered layout</span></span>
<span class="line"><span>- Mode toggle buttons (pill-shaped, indigo active state)</span></span>
<span class="line"><span>- Turn indicator with animated dots during AI thinking</span></span>
<span class="line"><span>- 3×3 grid with rounded cells, shadow, hover scale effect</span></span>
<span class="line"><span>- X in indigo, O in rose/red</span></span>
<span class="line"><span>- Winning cells get a pulsing glow animation</span></span>
<span class="line"><span>- Result banner with fade-in animation</span></span>
<span class="line"><span>- "New Game" button after game ends, "Reset" button during play</span></span>
<span class="line"><span>6. Verification</span></span>
<span class="line"><span>- npx tsc --noEmit — zero TypeScript errors</span></span>
<span class="line"><span>- npm run dev — Vite dev server started successfully on http://localhost:5173/</span></span></code></pre>
<p>Fonctionnel, aucun souci, pas de bug.</p>
<h2 id="second-test-une-app-réelle">Second test: une app réelle</h2>
<p>Ce sera l’objet du prochain article.</p>
<p>D’ici là, patience.</p>
<p>À la prochaine,</p>
<p>Adem.</p>
]]></content:encoded></item>
<item><title>Monitorer son homelab k3s</title><link>https://adem.build/fr/posts/monitorer-son-homelab-k3s</link><guid isPermaLink="true">https://adem.build/fr/posts/monitorer-son-homelab-k3s</guid><pubDate>Thu, 09 Apr 2026 00:00:00 GMT</pubDate><dc:creator>Adem Usta</dc:creator><description>Monitorer un homelab k3s en Raspberry Pi avec Prometheus et Grafana (kube-prometheus via Helm), puis y accéder de partout avec Tailscale et Cloudflare Tunnel.</description><category>kubernetes</category><category>homelab</category><category>k3s</category><category>hardware</category><category>software</category><category>raspberry-pi</category><category>grafana</category><category>monitoring</category><category>tailscale</category><content:encoded><![CDATA[<h2 id="flashback">Flashback</h2>
<p>Le homelab k3s est prêt, propre et fonctionnel.</p>
<p>Si t’es arrivé sur cet article sans en comprendre le contexte, je t’invite à aller sur l’article précédent <a href="https://adem.build/fr/posts/construire-son-homelab-rpis-k3s">Construire son homelab avec des Rpis</a></p>
<p><img src="https://adem.build/articles/6/wait.gif" alt="En attente" loading="lazy" decoding="async"></p>
<p>Si tu lis cette phrase, j’pense que t’es OP pour lire la suite ! Let’s go.</p>
<h2 id="pourquoi-comment-où-">Pourquoi, comment, où ?</h2>
<p>Pour le moment, on n’a aucune visibilité sur le homelab, sauf si on s’y branche via k9s, ou pire, qu’on se ssh sur chaque node à la main pour voir si tout va bien niveau santé hardware.</p>
<p>Evidemment, on ne peut pas faire ça. Va falloir mettre en place deux trois trucs sympas pour nous rendre la vie plus simple.</p>
<p>Établissons déjà ce que l’on veut:</p>
<ul>
<li>Avoir de la visibilité sur la partie hardware (usage CPU, mémoire, disque, et réseau) -&gt; observabilité hardware.</li>
<li>Pouvoir y accéder en dehors de son réseau local, tout en gardant un certain niveau de sécurité.</li>
</ul>
<p>Détaillons tout cela.</p>
<h2 id="lobservabilité">L’observabilité</h2>
<p>On ne réinvente pas la roue ici. On sait déjà ce qu’on veut, vu le nombre de fois où j’ai du mettre en place cela en mission chez des clients. La stack prometheus - grafana. Grand classique, ça bouge pas.</p>
<p><img src="https://adem.build/articles/6/prometheus-grafana.webp" alt="Prometheus Grafana" loading="lazy" decoding="async"></p>
<p>Pour faire simple: c’est une stack classique qui permet:</p>
<ul>
<li>de collecter des métriques (peu importe lesquelles) -&gt; Prometheus</li>
<li>d’avoir une UI simple et efficace pour en faire ce que l’on veut (dashboards, aggrégations, etc) -&gt; Grafana.</li>
</ul>
<p>Encore une fois, on ne réinvente pas la roue, on va utiliser <code>kube-prometheus-stack</code> pour déployer tout ce beau monde.</p>
<p>Assez simple, on va utiliser le package manager Helm, qui permet d’installer plusieurs services simplement.</p>
<p>Un petit screenshot de l’interface, avec un dashboard préfait pour les métriques hardware:</p>
<p><img src="https://adem.build/articles/6/grafana-dashboard.png" alt="Grafana dashboard" loading="lazy" decoding="async"></p>
<p>Ici on peut voir une overview de ce qui se passe sur le cluster, en particulier sur un rpi (ici le control plane).</p>
<p>Il ne se passe pas grand chose.. pour le moment (c’est normal, calme toi).</p>
<p>Rien de bien compliqué, et ici on a accès aux données hardware directement.</p>
<p><strong>Note</strong>: cette stack ne sert pas juste à faire remonter des métriques hardware. On peut y brancher d’autres sources de données:</p>
<ul>
<li>Loki -&gt; pour faire remonter les logs de nos conteneurs sur Grafana</li>
<li>Custom metrics -&gt; on peut tout simplement définir des métriques dans du code (donc dans nos apps) et les voir sur Grafana.</li>
</ul>
<p>On peut aussi aller plus loin avec Grafana: si on veut être alerté d’une anomalie, on peut le connecter à différents services externes (Slack, Discord, et j’en passe) afin d’être alerté.</p>
<p>Cela donne beaucoup de perspectives d’amélioration et de facilité de maintenance.</p>
<p>Je vous l’ai dit dans l’article précédent: on ne fait pas les choses à moitié.</p>
<h2 id="laccessibilité">L’accessibilité</h2>
<p>Bon, c’est bien cool tout ca, mais si je ne suis pas chez moi, j’ai aucune visibilité et je ne peux accéder à rien.</p>
<p>Pas ouf le projet confiné.</p>
<p><img src="https://adem.build/articles/6/confine-fr.webp" alt="Confiné" loading="lazy" decoding="async"></p>
<p>Pour résoudre ce souci, on doit poser le problème proprement afin d’éviter de faire des conneries (dsl Maman).</p>
<p>On veut deux choses bien distinctes:</p>
<ul>
<li>accéder depuis l’extérieur à des outils / apps, mais nous seuls y avons accès (private network en gros)</li>
<li>accéder à des apps depuis internet, totalement publique (pas de restriction spécifique au niveau réseau)</li>
</ul>
<p>Pour la première solution, on va utiliser un outil que j’ai découvert chez Boxy (RIP…) -&gt; Tailscale.</p>
<h3 id="tailscale-cest-quoi-ca-encore-">Tailscale, c’est quoi ca encore ?</h3>
<p><img src="https://adem.build/articles/6/tailscale.webp" alt="Tailscale" loading="lazy" decoding="async"></p>
<p>Pour faire simple, c’est un SaaS qui permet de créer un réseau virtual privée, entre des machines qui ne sont pas physiquement au même endroit, sur le même réseau. C’est basé sur Wireguard, entre autres (tu sais, ce que tu utilises quand tu achètes ton VPN bleu pour …. regarder des animés sur Netflix Japan).</p>
<p>En gros, Tailscale te permet de connecter tes machines entre elles, et définir à l’intérieur de ton réseau privé qui a acces à quoi. C’est exactement ce que l’on veut !</p>
<p>Tu crées ton compte Tailscale (gratuit), tu register tes différentes machines (iPhone, NAS, Mac personnel, etc) et on peut accéder aux services ouverts entre chaque machine. Cool.</p>
<h4 id="et-comment-ca-se-passe-dans-ton-homelab-">Et comment ca se passe dans ton homelab ?</h4>
<p>Très simple. On va setup le homelab à plusieurs niveaux.</p>
<p>Dans un premier temps, on veut pouvoir accéder à notre cluster, via kubectl (k9s TUI pour nous).</p>
<p>Solution simple -&gt; on installe tailscale sur notre control plane, celui-ci est présent dans notre VPN et donc accessible depuis mon Mac, par exemple. Side note: il faut juste changer l’IP dans notre kubeconfig et le faire pointer vers l’adresse IP du control plane dans le VPN pour que cela puisse fonctionner.</p>
<p>Pour k9s, c’est fait.</p>
<p>Pour nos services, on va procéder autrement.</p>
<p>Prenons l’exemple de Grafana dashboard. Il est accessible via un cluster IP donc suffit d’être sur le réseau local pour y accéder.</p>
<p>Pour y accéder depuis le VPN tailscale, on doit:</p>
<ul>
<li>créer un Oauth tailscale</li>
<li>installer le tailscale-operator avec les bons credentials de l’oauth</li>
<li>définir un ingress tailscale pour servir notre app dans le VPN tailscale</li>
</ul>
<p>Petit exemple indicatif:</p>
<p>Notre application exapmle:</p>
<pre class="astro-code astro-code-themes github-light github-dark" style="--shiki-light:#24292e;--shiki-dark:#e1e4e8;--shiki-light-bg:#fff;--shiki-dark-bg:#24292e; overflow-x: auto;" tabindex="0" data-language="yaml"><code><span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D">apiVersion</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF">v1</span></span>
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D">kind</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF">Namespace</span></span>
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D">metadata</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">:</span></span>
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D">  name</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF">my-app</span></span>
<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0">---</span></span>
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D">apiVersion</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF">apps/v1</span></span>
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D">kind</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF">Deployment</span></span>
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D">metadata</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">:</span></span>
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D">  name</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF">my-app</span></span>
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D">  namespace</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF">my-app</span></span>
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D">spec</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">:</span></span>
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D">  replicas</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">: </span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF">1</span></span>
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D">  selector</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">:</span></span>
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D">    matchLabels</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">:</span></span>
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D">      app</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF">my-app</span></span>
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D">  template</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">:</span></span>
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D">    metadata</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">:</span></span>
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D">      labels</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">:</span></span>
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D">        app</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF">my-app</span></span>
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D">    spec</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">:</span></span>
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D">      containers</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">:</span></span>
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">        - </span><span style="--shiki-light:#22863A;--shiki-dark:#85E89D">name</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF">my-app</span></span>
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D">          image</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF">tiangolo/uvicorn-gunicorn-fastapi:python3.11-slim</span></span>
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D">          ports</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">:</span></span>
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">            - </span><span style="--shiki-light:#22863A;--shiki-dark:#85E89D">containerPort</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">: </span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF">80</span></span>
<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0">---</span></span>
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D">apiVersion</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF">v1</span></span>
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D">kind</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF">Service</span></span>
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D">metadata</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">:</span></span>
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D">  name</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF">my-app</span></span>
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D">  namespace</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF">my-app</span></span>
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D">spec</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">:</span></span>
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D">  selector</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">:</span></span>
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D">    app</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF">my-app</span></span>
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D">  ports</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">:</span></span>
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">    - </span><span style="--shiki-light:#22863A;--shiki-dark:#85E89D">port</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">: </span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF">80</span></span>
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D">      targetPort</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">: </span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF">80</span></span></code></pre>
<p>Et le fameux ingress tailscale:</p>
<pre class="astro-code astro-code-themes github-light github-dark" style="--shiki-light:#24292e;--shiki-dark:#e1e4e8;--shiki-light-bg:#fff;--shiki-dark-bg:#24292e; overflow-x: auto;" tabindex="0" data-language="yaml"><code><span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D">apiVersion</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF">networking.k8s.io/v1</span></span>
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D">kind</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF">Ingress</span></span>
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D">metadata</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">:</span></span>
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D">  name</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF">my-app</span></span>
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D">  namespace</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF">my-app</span></span>
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D">spec</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">:</span></span>
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D">  ingressClassName</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF">tailscale</span></span>
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D">  rules</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">:</span></span>
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">    - </span><span style="--shiki-light:#22863A;--shiki-dark:#85E89D">http</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">:</span></span>
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D">        paths</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">:</span></span>
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">          - </span><span style="--shiki-light:#22863A;--shiki-dark:#85E89D">path</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF">/</span></span>
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D">            pathType</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF">Prefix</span></span>
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D">            backend</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">:</span></span>
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D">              service</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">:</span></span>
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D">                name</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF">my-app</span></span>
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D">                port</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">:</span></span>
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D">                  number</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">: </span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF">80</span></span>
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D">  tls</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">:</span></span>
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">    - </span><span style="--shiki-light:#22863A;--shiki-dark:#85E89D">hosts</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">:</span></span>
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">        - </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF">my-app</span></span></code></pre>
<p>Et là, notre app est accessible via <a href="https://my-app.ton-tailscale.ts.net">https://my-app.ton-tailscale.ts.net</a></p>
<p>Magnifique, fonctionnel, et secured.</p>
<p><strong>Note 1</strong>: Tailscale reste un SaaS, donc un tiers de confiance par définition pour le service rendu.</p>
<p>Tailscale se sert de technologies assez smart, comme le traversal NAT pour établir des connexions directes. Dans ce cas, rien ne transite sur leurs serveurs.</p>
<p>Mais, si l’envie vous prenait, d’avoir votre propre tailscale self host, vous pouvez héberger votre <a href="https://github.com/juanfont/headscale">Headscale</a> et vous êtes sereins. C’est une version open source et self-hostable en gros.</p>
<p><strong>Note 2</strong>: Avec Tailscale, on peut désormais créer des Funnel, permettant d’exposer des apps a tout Internet. Mais c’est en version beta, la bande passante est limitées et n’est pas connue (en tout cas je ne l’ai pas trouvé). C’est donc possible de répondre au second besoin, mais pas fiable pour le moment.</p>
<p>C’est pourquoi nous avons donc choisi une solution plus robuste pour l’accès a Internet: Cloudfare Tunnel.</p>
<h3 id="cloudflare-encore-un-truc-dans-le-cloud-">Cloudflare, encore un truc dans le cloud ?</h3>
<p><img src="https://adem.build/articles/6/cloudflare.webp" alt="Cloudflare" loading="lazy" decoding="async"></p>
<p>Alors oui, encore un truc dans le cloud… mais pour la bonne cause !</p>
<p>Supposons que j’ai besoin d’une app qui doit etre accessible via les Internets (a tout hasard, le tracking de ce blog :)) .</p>
<p>Avec Tailscale on est limité, il nous faut une solution stable. Soit on ouvre des ports sur notre box, et on laisse du traffic entrant de l’exterieur vers chez nous. Ca se fait, mais on ne va pas le faire ici.</p>
<p>Soit on choisit de faire un tunnel entre notre homelab et le monde exterieur. C’est ce que l’on va faire ici, avec Cloudflare Edge.</p>
<h4 id="le-setup">Le setup</h4>
<p>Le plus simple est d’avoir un nom de domaine sur cloudfare. Sinon c’est relou. On reste dans ce cas de figure.</p>
<p>Le chemin du traffic ressemble a ca:</p>
<p>Internet → Cloudflare Edge → [tunnel chiffré] → pod cloudflared → ton service</p>
<p>Je vais pas détailler la configuration pour le faire, Claude est ton ami :)</p>
<p>C’est gratuit, robuste, et reste sécurisé.</p>
<h2 id="conclusion">Conclusion</h2>
<p>Article un peu plus technique (mais pas trop, ca va), permettant d’enclencher sur la suite: mettre des apps réelles dessus et accessibles en interne, et au public.</p>
<p>Mais ca, j’en parlerai dans les prochains articles.</p>
<p>Petit spoiler: de l’IA, des GPUs, des agents. Mais pas que.</p>
<p>D’ici là, porte toi bien.</p>
<p>Adem.</p>
]]></content:encoded></item>
<item><title>Construire son homelab avec des Raspberry Pis</title><link>https://adem.build/fr/posts/construire-son-homelab-rpis-k3s</link><guid isPermaLink="true">https://adem.build/fr/posts/construire-son-homelab-rpis-k3s</guid><pubDate>Sun, 05 Apr 2026 00:00:00 GMT</pubDate><dc:creator>Adem Usta</dc:creator><description>Comment j&#39;ai transformé des Raspberry Pi de récup en homelab Kubernetes k3s : boot NVMe, OS, cluster k3s et accès réseau local, des cartes nues au rack terminé.</description><category>kubernetes</category><category>homelab</category><category>k3s</category><category>hardware</category><category>software</category><category>raspberry-pi</category><content:encoded><![CDATA[<h2 id="construire-son-homelab-avec-des-rpis-de-récup">Construire son homelab avec des Rpis de récup.</h2>
<h2 id="comment-ça-des-rpis-de-récup-">Comment ça, des Rpis de récup ?</h2>
<p>On est en juin 2024. Avec mon acolyte / frère / cofondateur de <a href="https://antipodestudios.io/">@antipodestudios</a>, on décroche une prestation assez stylée : le développement d’une app complète de gestion d’un événement Nike Football en plein centre de Paris.</p>
<p>L’événement consistait en la disposition de plusieurs ateliers de Football, selon plusieurs thèmes, et d’un tournoi en 1v1. Pour rendre la gestion des ateliers et des joueurs, il fallait développer une application web permettant aux intervenants Nike de gérer les ateliers via plusieurs iPads, et développer en parallèle des interfaces sur écran géant pour y afficher scores / leaderboard, etc.</p>
<p>On rentre pas dans le détail de ce challenge technique, c’est pas le sujet de l’article. Mais en gros on était parti sur des raspberry pi 5 pour gérer chaque écran et afficher via une webapp les données de l’événement.</p>
<p>Si vous voulez en savoir plus, rendez vous sur <a href="https://antipodestudios.io/projects/nike-bureau-pleiades/">@Nike Football x Bureau Pleiades x Antipodestudios</a>. Ou sur notre instagram <a href="https://www.instagram.com/antipode.studios/">@antipodestudios</a>.</p>
<p>Passé cet événement (qui fut un succès technique pour nous), il me restait entre les mains plusieurs rpis 5.
Posés à côté d’anciens rpis 4 et 3, ils ne servaient plus à rien.</p>
<p>Fallait trouver un moyen de les faire bosser.</p>
<h2 id="que-faire-de-ces-jouets-pour-nerd-">Que faire de ces jouets pour Nerd ?</h2>
<p>5 Raspberry pi 5 (8GB), 1 Raspberry 4 (2 GB), et 1 Raspberry pi 3 (pas assez de GB).  Un switch.  Des cartes microSD.
C’est ce que j’avais en stock.</p>
<p>Qu’en faire ?</p>
<p>Et là, la lumière fut.</p>
<p><img src="https://adem.build/articles/5/homer.gif" alt="Homer Super Intelligence" loading="lazy" decoding="async"></p>
<p>Fous-moi ça sur le réseau local (chez moi quoi), ssh-toi dessus et host tes petits projets. C’est cool, mais chiant. Faut un setup un peu plus poussé.</p>
<p>Sur des projets pour des clients, j’installe souvent Coolify sur des VPS pour hoster leurs apps. C’est rapide, efficace, connecté à GitHub. Mais je voulais pouvoir hoster plusieurs projets sans me prendre la tête à me demander quel projet ira sur quelle machine. Il me fallait un niveau d’abstraction plus haut.</p>
<p>T’as compris, on est là pour se faire ch*er à setup une mini infra complète. On partira donc sur une solution kubernetes.</p>
<p>Mais il y a un hic : les rpis ne sont pas faits pour ça. k8s est gourmand, rien que pour le faire tourner seul. Ce serait du gâchis.</p>
<p>Et là, je tombe sur un projet initié par les gens de chez Rancher, j’ai nommé <a href="https://k3s.io/">k3s</a>.</p>
<p>k3s est une version légère de kubernetes, permettant de tourner sur des machines peu puissantes, i.e des rpis. Parfait candidat pour nous !</p>
<p>On s’y met.</p>
<p><img src="https://adem.build/articles/5/7nains-cartoon.gif" alt="Mission accomplie" loading="lazy" decoding="async"></p>
<h2 id="le-hardware">Le hardware</h2>
<p>Avant de me lancer, j’ai quand même demandé à mon ami <a href="https://claude.ai">Claude</a> ce qu’il pensait du projet. Complètement validé ! À une condition près : ne pas se fier aux cartes microSD. En effet sur le long-terme ça risque de cramer. On veut du cluster stable ici.</p>
<p>Voici donc le setup hardware qu’on gardera pour le projet :</p>
<ul>
<li>4x raspberry pi v5 (8GB) -&gt; workers</li>
<li>1x raspberry pi v4 (2GB) -&gt; control plane</li>
<li>1x SSD 2.5” pour le control plane</li>
<li>4x nvme SSD pour les workers (128 GB chacun)</li>
<li>Switch 2.5G 8 ports</li>
<li>Grosse alimentation 200W pour carry tout ce beau bordel (et éviter 5 alimentations distinctes pour chaque rpi.)</li>
</ul>
<p>Les raspberry pi v5 peuvent accueillir un ssd nvme via une carte d’extension connectée au port PCI, image d’illustration :</p>
<p><img src="https://adem.build/articles/5/rpi-nvme.webp" alt="Raspberry Pi avec un SSD NVMe" loading="lazy" decoding="async"></p>
<p>Ouais, bon… à la base c’était un projet à base de récup… personne ne me jugera ici. On fait les choses bien.</p>
<p>On a tout le hardware qu’il nous faut pour commencer à setup la partie logicielle. Let’s go.</p>
<h2 id="le-software">Le software</h2>
<p>La partie software se divise en deux :</p>
<ul>
<li>choisir le bon OS, l’installer sur NVME et boot dessus automatiquement</li>
<li>setup k3s sur chaque rpi.</li>
</ul>
<h3 id="los">L’OS</h3>
<p>Pas trop de choix ici. On choisit parmi les OS officiels de <a href="https://www.raspberrypi.com/software/">Raspberry PI Imager</a>. Le seul candidat pour nous sera Raspberry Pi lite OS (64bits), sans environnement de bureau.</p>
<p>Le setup est assez limpide : flash microSD, création d’un user, ajout de clef ssh (pour accéder au pi en direct, servira au setup et pour debug), etc.</p>
<p>On flash, on alimente le rpi, on le connecte au réseau via le switch, et on lui configure un bail DHCP statique <em>(important !)</em>, pour pouvoir garder la même adresse IP locale (prérequis pour assurer une bonne communication sous k3s).</p>
<p>Pour booter sur le nvme, il faut copier tout (<code>dd</code> est ton pote pour ça) sur le nvme, puis choisir le boot NVME avec <code>raspi-config</code>.</p>
<p>On fait cette manipulation pour tous les raspberry pis. C’est chronophage mais simple. D’ailleurs on pourrait scripter ça via Ansible ou Terraform, mais pas besoin de se prendre la tête ici. Ça serait néanmoins intéressant si le homelab doit subir des changements de rpis dans le temps, afin d’éviter d’avoir tout à refaire à la main.</p>
<h3 id="k3s">K3S</h3>
<p>La partie intéressante, et néanmoins la plus simple. On procède comme indiqué sur la doc officielle. En commençant bien entendu par le control plane.</p>
<p>On se ssh dessus.</p>
<p>Je passe les détails (si vous avez besoin d’aide sur cette partie, envoyez-moi un mail <a href="mailto:hello@ademoverflow.com">hello@ademoverflow.com</a>), mais en gros on installe avec cette belle commande :</p>
<pre class="astro-code astro-code-themes github-light github-dark" style="--shiki-light:#24292e;--shiki-dark:#e1e4e8;--shiki-light-bg:#fff;--shiki-dark-bg:#24292e; overflow-x: auto;" tabindex="0" data-language="bash"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0">curl</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF"> -sfL</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF"> https://get.k3s.io</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583"> |</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0"> sh</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF"> -</span></span></code></pre>
<p>Tu check que tout se passe bien, et tu lances <code>sudo kubectl get nodes</code> pour voir si ton control plane est visible.</p>
<p>On récupère le token d’authentication k3s, et on fait pareil avec les autres rpis :</p>
<pre class="astro-code astro-code-themes github-light github-dark" style="--shiki-light:#24292e;--shiki-dark:#e1e4e8;--shiki-light-bg:#fff;--shiki-dark-bg:#24292e; overflow-x: auto;" tabindex="0" data-language="bash"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0">curl</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF"> -sfL</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF"> https://get.k3s.io</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583"> |</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8"> </span></span>
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">K3S_URL</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583">=</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF">https://</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583">&lt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF">control-plane-ip</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583">&gt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF">:6443</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8"> </span></span>
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">K3S_TOKEN</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583">=&lt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF">node-token</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583">&gt;</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0"> sh</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF"> -</span></span></code></pre>
<p>Normalement tout est ok ! On a notre k3s up et prêt. Enfin presque.</p>
<h3 id="accès-depuis-le-réseau-local">Accès depuis le réseau local</h3>
<p>On pourrait accéder au cluster depuis le control plane via ssh dessus. Mais c’est chiant et pas propre.</p>
<p>On va donc récupérer la kube config avec les bons certificats, pour l’avoir sur notre machine locale (ton ordi quoi).</p>
<p>De mémoire, c’est dans <code>/etc/rancher/k3s/k3s.yaml</code>. Faut possiblement changer l’adresse ip boucle locale par celle du rpi, pour que ça puisse fonctionner.</p>
<p>À ce stade, on a notre cluster k3s up, prêt à recevoir du workload.</p>
<p><img src="https://adem.build/articles/5/hellfire.gif" alt="Ça chauffe" loading="lazy" decoding="async"></p>
<p>Un petit screenshot k9s, quand même !</p>
<p><img src="https://adem.build/articles/5/k9s.png" alt="Ça chauffe" loading="lazy" decoding="async"></p>
<h2 id="software-ok-hardware-ok-et-maintenant-">Software OK, Hardware OK, et maintenant ?</h2>
<p>Bon, c’est bien beau tout ça, mais ce beau monde ne va pas rester sur mon bureau. Regarde la gueule du bordel :</p>
<p><img src="https://adem.build/articles/5/mess.webp" alt="Installation en vrac" loading="lazy" decoding="async"></p>
<p>On va se lancer dans le design d’un mini server vertical style homelab (mais nan !?), le tout en impression 3D.</p>
<p>Je scroll sur makerworld, à la recherche d’un projet similaire, mais rien de bien appétissant. Je trouve quand même une base de type “tour” et je lance l’impression.</p>
<p>Ça donne ça :</p>
<p><img src="https://adem.build/articles/5/tour.webp" alt="La tour vide" loading="lazy" decoding="async"></p>
<p>Go design les étages maintenant. On a de la place, mais on va quand même optimiser un peu un étage, en y mettant 2 rpis.</p>
<p>Ça donne ça :</p>
<p><img src="https://adem.build/articles/5/workers.webp" alt="Les workers" loading="lazy" decoding="async"></p>
<p>Au final, on a 3 étages :</p>
<p><img src="https://adem.build/articles/5/all.webp" alt="Tous les racks" loading="lazy" decoding="async"></p>
<p>On passe au montage, câblage, blablabla…</p>
<p>On obtient ce magnifique homelab server :</p>
<p><img src="https://adem.build/articles/5/finished.webp" alt="Le homelab terminé" loading="lazy" decoding="async"></p>
<p>Bon c’est cool, on a tout de prêt ! Maintenant, passons à sa gestion.</p>
<p>Mais… j’en ferai un article dédié.</p>
<p>D’ici là, porte toi bien.</p>
<p>Adem.</p>
]]></content:encoded></item>
<item><title>Hey, j&#39;suis de retour.</title><link>https://adem.build/fr/posts/hey-jsuis-de-retour</link><guid isPermaLink="true">https://adem.build/fr/posts/hey-jsuis-de-retour</guid><pubDate>Mon, 30 Mar 2026 00:00:00 GMT</pubDate><dc:creator>Adem Usta</dc:creator><description>10 ans de dev, l&#39;arrivée de l&#39;IA, et un come-back. Je vous raconte mon parcours et ce qui a changé dans ce métier.</description><category>de-retour</category><category>2026</category><category>update</category><content:encoded><![CDATA[<p>2026, peut-être ma dernière année de dev telle que je l’ai connu il y a maintenant 10 ans.</p>
<h2 id="2016--mes-débuts-dans-le-dev">2016 — Mes débuts dans le dev</h2>
<p>2016, je débarque dans ce monde par la porte du dev web, dans une startup parisienne qui était le “shazam des célébrités” (Reminiz, devenu Context).</p>
<p>En gros, je devais bosser sur une app interne pour annoter des photos de célébrités, les stocker dans une base de données, qui était ensuite utilisée pour reconnaître des célébrités sur les flux de la TNT.</p>
<p>C’était cool, j’ai appris les bases du dev web sur le tas, direct en mode full stack. Pas le temps de niaiser.</p>
<p>À la base, j’ai une formation en robotique et machine learning (bref c’est pas le sujet).</p>
<p>Dédicace au CTO de Reminiz de cette époque révolue @Antoine Biard, qui m’a formé à ce métier de la plus belle des manières:</p>
<ul>
<li>1h de vim par jour (ouais je sais, hardcore le mec)</li>
<li>des sessions de touch typing dans la journée, afin d’atteindre 120 wpm et d’envoyer du code le plus vite possible.</li>
</ul>
<p>J’vous ai dit, c’était une époque dingue. J’en apprenais tous les jours. Je kiffais ça.</p>
<h2 id="tout-faire-tout-apprendre">Tout faire, tout apprendre</h2>
<p>Et puis les années sont passées, j’ai fait 4 ans dans cette boite, où il fallait tout gérer tout seul, entre newbies et passionnés.</p>
<p>Toute la stack, du design au code, à l’infra, le monitoring, bref tout cela sur le dos d’une équipe de 4 personnes. Fallait tout apprendre.</p>
<p>Quand je dis tout, c’est vraiment tout:</p>
<ul>
<li>créer / gérer un cluster k8s (pas avec les outils de maintenant, on parle de <code>kops</code>, pas de EKS managed, pas de GKE, rien de tout cela).</li>
<li>développer les applis (internes et clients), les architecturer correctement</li>
<li>déployer des outils de monitoring et gérer les erreurs, les alertes, etc</li>
<li>respecter les SLA clients (bon on en avait pas beaucoup des clients, mais assez pour que ce soit un challenge).</li>
</ul>
<p>Et on a réussi. On en a sué, mais on y est arrivé. Et purée que c’était bon d’apprendre, de se sentir vivre à travers son taff.</p>
<p>Bon… j’abuse un peu mais c’était enrichissant.</p>
<h2 id="et-après-">Et après ?</h2>
<p>Et après cette époque glorieuse, j’ai changé de taff, cherchant d’autres marchés, voulant voir de nouvelles choses.</p>
<p>Faire du freelancing, faire son métier pour un client direct -&gt; complètement différent. Moins de dopamine, mais plus d’oseille.</p>
<p>Cette carrière a suivi son cours, et elle continue encore aujourd’hui (grâce à Dieu). Mais depuis plus d’un an maintenant, une chose a changé.</p>
<h2 id="léléphant-dans-la-pièce">L’éléphant dans la pièce</h2>
<p><img src="https://adem.build/articles/4/elephant-room.jpg" alt="L’éléphant dans la pièce" loading="lazy" decoding="async"></p>
<p>On va parler, de l’éléphant dans la pièce: la genAI. Pas Kling ou Nanobanana (ça on s’en fout ici), mais les agents codeurs. BOUM.</p>
<p>On ne va pas refaire toute l’histoire, mais en gros on est passé par plusieurs étapes:</p>
<ul>
<li>Github Copilot -&gt; à chier, autocomplete foireux, parfois drole (allez essayer sur copilot d’écrire “Coucou, tu veux voir ma “ et attendez l’autocomplete. (Ça a dû être fixé, n’essayez pas)).</li>
<li>Cursor et autres premiers IDE AI assisted -&gt; premiers bons résultats, les features arrivaient semaine par semaine, mais bon c’était pas magique non plus.</li>
</ul>
<p>Et puis…</p>
<p><img src="https://adem.build/articles/4/claude-code.jpg" alt="Claude Code" loading="lazy" decoding="async"></p>
<p>Doux Jesus (calme-toi j’suis français, ça fait partie de la culture), quelle magie ! Cet outil a fait l’unanimité chez mes collègues et potes après un weekend de test.</p>
<p>Le truc t’envoie du code (ah il en génère, les 120 wpm me servent plus à rien).</p>
<p>Si tu lui donnes une base solide, plus besoin (ou presque, calme-toi), de taper du code. On exprime une demande, et les agents s’executent. Fascinant. Terrifiant.</p>
<h2 id="et-nous-dans-tout-ça-">Et nous dans tout ça ?</h2>
<p>Et là, en tant qu’ingénieur logiciel, on se pose quand même pas mal de questions sur notre rôle, notre carrière, et le futur de notre métier.</p>
<p>Alors oui, on a un semblant de productivité accrue, car certes il est physiquement impossible de taper du code aussi vite que ces agents ne génèrent de tokens.</p>
<p>Mais, si on fait son métier sérieusement, on relit, tout. Absolument tout. Même si on a des tests.</p>
<p>Alors, je ne dis pas que je le fais tout le temps (saturation cognitive) mais il faut le faire, afin d’éviter des surprises et surtout pouvoir comprendre et expliquer ce qui a été implémenté et comment.</p>
<p>Alors ce n’est pas un article sur “pour ou contre les agents codeurs”, on est pas en 2025. La réponse à cette question est limpide -&gt; on ne peut être contre. L’industrie ne te le permettra pas.</p>
<p>Et donc … le contre coup, et c’est le point important de ce come-back: l’envie, la passion.</p>
<p>Nombre de développeurs que je connais sont dans ce cas: celui de ne plus savoir s’ils aiment ce métier, en tout cas s’ils l’aiment encore, sous sa forme actuelle.</p>
<p>Si on revient à mon expérience de 2016, les heures de tryhard, apprendre, se documenter, s’envoyer des heures de tuto sur YouTube (merci les indiens pour les travaux) pour acquérir des compétences et pouvoir les utiliser le lendemain au travail…</p>
<p>C’est malheureusement une époque révolue, je le pense.</p>
<p>Toi qui lit cet article, si tu débutes dans ce domaine, n’hésite pas à t’aider de l’IA pour apprendre plus vite, mais ne tombe pas dans le piège du Plan -&gt; Approve sans au moins essayer de comprendre ce qui se passe.</p>
<h2 id="le-come-back">Le come-back</h2>
<p>Après cette terrible phrase de daron, venons en au titre de ce post: mon come-back.</p>
<p>Bon.. mon blog n’avait que 3 posts avant que je ne fasse celui-ci, mais ils datent de 2021… fallait que je revienne.</p>
<p>Pourquoi maintenant ?</p>
<p>Car j’estime avoir le temps de pouvoir transférer mon savoir, mes projets et mes expériences. 2026, claude code et je raconterai ce que je lui ai dit de créer.</p>
<p>Prochain article: un projet déjà fini et fonctionnel, qui nous servira de base pour les prochains: un petit cluster kubernetes avec des raspberry pis.</p>
<hr>
<p>See you soon,</p>
<p>Adem.</p>
]]></content:encoded></item>
<item><title>Explications du workflow Git flow</title><link>https://adem.build/fr/posts/git-flow-tutoriel</link><guid isPermaLink="true">https://adem.build/fr/posts/git-flow-tutoriel</guid><pubDate>Sun, 13 Jun 2021 00:00:00 GMT</pubDate><dc:creator>Adem Usta</dc:creator><description>Git flow expliqué simplement : branches feature, release et hotfix pas à pas, la CLI git-flow pour les automatiser et des changelogs cohérents entre deux tags.</description><category>git</category><category>software-development</category><category>workflow</category><content:encoded><![CDATA[<h2 id="quest-ce-que-git-flow-et-comment-limplémenter-">Qu’est ce que Git Flow et comment l’implémenter ?</h2>
<p>Travailler sur un projet git avec plusieurs contributeurs peut être compliqué et confus.</p>
<p>Ou du moins, si aucun workflow n’est utilisé pour l’utilisation de git.</p>
<p>C’est pourquoi un workflow a été conçu par certaines personnes (je ne sais qui) dans le but d’optimiser l’utilisation de git.</p>
<p>Ce workflow s’appelle <em>git flow</em>. Rentrons dans le vif du sujet !</p>
<h2 id="avertissement">Avertissement</h2>
<p>Dans ce tutoriel, il se peut qu’il y ait des changements avec le git flow traditionnel.</p>
<p>Les idées de base sont présentes, n’hésitez pas à comparer cet article avec d’autres sur le web.</p>
<p>Nous avons essayé d’ajouter quelques améliorations, notamment sur le format des messages dans nos commits, en vue de pouvoir simplifier la création de changelog.</p>
<h2 id="le-workflow-git-flow">Le workflow <code>git flow</code></h2>
<h3 id="idées-générales">Idées générales</h3>
<p>Un des concepts les plus impportants est de garder une seule branche pour le déploiement de nouvelles versions en production, et une autre pour accumuler plusieurs nouvelles fonctionnalités avant la création d’une nouvelle version:</p>
<ul>
<li><code>master</code> : branche gardant l’historique de chaque tag de votre code (aussi appelée <code>main</code>)</li>
<li><code>develop</code> : branche sur laquelle on va pousser de nouvelles fonctionnalités en vue d’une nouvelle version</li>
</ul>
<h3 id="développement-dune-nouvelle-fonctionnalité">Développement d’une nouvelle fonctionnalité</h3>
<p>Prenons un exemple simple: vous développez une nouvelle fonctionnalité. Vous allez donc suivre ces étapes:</p>
<ul>
<li>
<p>Vous partez de la branche <code>develop</code>, vous créez une nouvelle branche:</p>
<p><code>git checkout -b feature/my-awesome-feature</code></p>
</li>
<li>
<p>Faites votre magie avec le code. Faites autant de commits que vous voulez.</p>
</li>
<li>
<p>Une fois que votre code est prêt à être testé et relu par vos collègues, ouvrez une Merge / Pull request.</p>
</li>
<li>
<p>N’hésitez pas à rebase votre branche sur <code>origin/develop</code> afin d’être sûr d’avoir les derniers changements.</p>
<p>Pour une opération de rebase local:</p>
<p><code>git fetch -ap &amp;&amp; git rebase origin/develop</code></p>
<p>Après cela, vous avez besoin de push force sur votre repertoire distant (à cause du rebase):</p>
<p><code>git push -f</code></p>
</li>
<li>
<p>Une fois que votre code est testé, a passé votre pipeline d’intégration continu, et est accepté par vos collègues, vous pouvez merge <code>feature/my-awesome-feature</code> dans <code>develop</code>.</p>
<p>Faites cela via l’UI de votre service Git (GitHub / Gitlab / etc.)</p>
<p><strong>Note</strong>: Pour garder un historique propre sur <code>develop</code>, choisissez l’option <code>squash and merge</code> lors du merge: il n’y aura qu’un commit sur <code>develop</code>.</p>
<p>On va vous demander un message pour cet unique commit:</p>
<p>Dans l’idéal, vous pouvez utiliser ce format: <code>type(scope): my commit message</code>.</p>
<p>Avec:</p>
<ul>
<li><code>type</code> une des valeurs suivantes: <code>feat,fix,docs,breaking,build,ci,misc,refactor,style,test</code></li>
<li><code>scope</code> peut être n’importe quel mot.</li>
</ul>
<p>D’autres formats existent et peuvent être utilisés.</p>
<p>L’idée derrière ce format, vous allez le voir plus tard, est de pouvoir les parser et créer des changelogs automatiquement.</p>
<p>Mais cela ne fait pas partie du workflow traditionnel. Vous pouvez donc faire ce que vous voulez.</p>
</li>
</ul>
<h3 id="préparation-dune-nouvelle-version">Préparation d’une nouvelle version</h3>
<p>Vous avez développé plusieurs fonctionnalités que vous estimez être prêts pour une mise en production, l’idée est de suivre ces étapes:</p>
<ul>
<li>
<p>Créer une banche <code>release/vx.x.x</code> partant de <code>develop</code></p>
</li>
<li>
<p>Si vous avez des tests d’intégration, appliquez les sur cette branche</p>
</li>
<li>
<p>S’il y a des bugs sur cette branche, vous pouvez les fix sur celle-ci</p>
</li>
<li>
<p>Une fois que c’est prêt, vous pouvez merge sur <code>master</code>.</p>
<p><strong>Note</strong>: dans le workflow traditionnel, le merge sur <code>master</code> se fait en faisant un squash.
Mais, comme dit plus haut, nous avons décidé de modifier un peu ce workflow.
L’idée est de garder les commits venant de <code>develop</code> sur <code>master</code>. Un merge commit peut être présent et aussi simple que <code>vX.X.X</code>.
Garder les commits formattés sur <code>master</code> va nous aider plus tard pour créer les changelogs d’une release à l’autre.
On le verra plus tard dans l’article.</p>
</li>
<li>
<p>Créez une nouvelle version (avec un nouveau tag).</p>
</li>
<li>
<p>N’oubliez pas de rebase <code>develop</code> sur <code>master</code> afin de garder le même historique. <code>develop</code> doit être au courant de ce qu’il y a sur <code>master</code>. Toujours en avance.</p>
</li>
</ul>
<h3 id="développement-de-hotfix">Développement de hotfix</h3>
<p>Parfois (pour ne pas dire tout le temps …), il y a des bugs sur la nouvelle version de votre code.</p>
<p>Certains bugs peuvent attendre la prochaine version pour être corrigés, mais d’autres non.</p>
<p>Ces bugs doivent être corrigés au plus vite. Git flow a un plan de bataille pour ce cas de figure:</p>
<ul>
<li>
<p>Créez une branche partant de <code>master</code>: <code>hotfix/my-hotfix</code> par exemple</p>
</li>
<li>
<p>Corrigez le bug</p>
</li>
<li>
<p>Testez le hotfix:</p>
<ul>
<li>La correction est effective</li>
<li>Pas de regression dans le code</li>
</ul>
</li>
<li>
<p>Une fois que le fix est testé et approuvé, mergez sur <code>master</code> avec un squash.</p>
<p>Le message de commit doit être explicite, il peut ressembler à cela:</p>
<p><code>hotfix(scope): fix critical vx.x.x</code></p>
</li>
<li>
<p>Créez votre nouveau tag.</p>
</li>
<li>
<p>Rebase <code>develop</code> sur <code>master</code> pour garder un historique complet sur <code>develop</code>.</p>
</li>
</ul>
<h3 id="notes-importantes">Notes importantes</h3>
<ul>
<li>
<p>A chaque changement sur <code>master</code>, ne pas oublier de rebase <code>develop</code> sur <code>master</code>:</p>
<p><code>git fetch -ap &amp;&amp; git rebase origin/master</code> et <code>git push -f origin/develop</code></p>
</li>
<li>
<p>De même pour les branches qui partent de <code>develop</code>, quand celle-ci a changé:</p>
<p><code>git fetch -ap &amp;&amp; git rebase origin/develop</code> et <code>git push -f origin/feature/my-awesome-feature</code></p>
</li>
</ul>
<h2 id="appendix-1-git-flow--un-package-permettant-dimplémenter-ce-workflow-facilement">Appendix 1: <code>git flow</code> , un package permettant d’implémenter ce workflow facilement</h2>
<p>En lisant de la documentation sur git flow, je peux comprendre que cela puisse paraître fastidieux et difficile à maintenir sur le long terme.</p>
<p>C’est pourquoi il existe un plugin à git qui permet de simplifier l’utilisation de ce workflow: <code>git flow</code>.</p>
<p>Personnellement je ne l’utilise pas car je suis habitué à ce workflow depuis quelques années maintenant.</p>
<p>Mais si vous le souhaitez, allez regardez la documentation de cet outil <a href="https://github.com/nvie/gitflow">https://github.com/nvie/gitflow</a> et commencez à l’utiliser !</p>
<h2 id="appendix-2-créez-des-changelogs-automatiquement-entre-chaque-nouvelle-version-de-votre-code">Appendix 2: Créez des changelogs automatiquement entre chaque nouvelle version de votre code</h2>
<p>Dans cet article, j’ai inclus quelques améliorations par dessus le git flow traditionnel.</p>
<p>Le principal étant d’avoir un format commun de message pour les commits.</p>
<p>Si vous choisissez de suivre ces indications, vous pourrez créer vos changelogs facilement.</p>
<p>Pour cela, vous devez installer un petit binaire appelé <code>git-chlog</code>.</p>
<p>Vous pouvez le trouver ici <a href="https://github.com/git-chglog/git-chglog">https://github.com/git-chglog/git-chglog</a></p>
<p>Je ne vais pas faire un tutoriel complet sur son utilisation, mais vous pouvez aller lire la documentation pour en comprendre l’utililité.</p>
<p>Je vais juste vous partager un exemple d’utilisation pour conclure sur cet article:</p>
<p>Vous avez une nouvelle version de votre code: <code>v1.1.0</code>.</p>
<p>Le tag précédent était <code>v1.0.7</code>. Vous voulez créer un changelog entre ces deux tags.</p>
<p>Vous pouvez simplement executer: <code>git-chlog v1.1.0..</code> pour avoir la liste des commits parsés dans cette dernière version.</p>
<p>Si vous voulez un changelog complet: <code>git-chlog</code> simplement.</p>
<p><strong>Aussi simple que cela !</strong></p>
<h2 id="conclusions">Conclusions</h2>
<p>Dans cet article j’ai voulu vous expliquer comment avoir un workflow git propre, permettant à vous et votre équipe d’optimiser votre temps et de se concentrer sur le plus important: le code.</p>
<p>J’espère que ce tutoriel vous aidera à comprendre ce qu’est git flow !</p>
<p>Je vous partage deux liens qui m’ont aidé à écrire cet article:</p>
<ul>
<li><a href="https://www.toptal.com/gitflow/enhanced-git-flow-explained">Toptal: enhanced git flow explained</a></li>
<li><a href="https://www.youtube.com/watch?v=1SXpE08hvGs">The gitflow workflow - in less than 5 mins (du youtuber <code>DevChild</code>)</a></li>
</ul>
<p>A plus tard,</p>
<p>Adem.</p>
]]></content:encoded></item>
<item><title>Déployer votre application FastAPI sur AWS Lambda via Serverless</title><link>https://adem.build/fr/posts/tutoriel-fastapi-aws-lambda-serverless</link><guid isPermaLink="true">https://adem.build/fr/posts/tutoriel-fastapi-aws-lambda-serverless</guid><pubDate>Sat, 10 Apr 2021 00:00:00 GMT</pubDate><dc:creator>Adem Usta</dc:creator><description>Tutoriel pas à pas : déployer une application FastAPI sur AWS Lambda avec le framework Serverless et Mangum, la tester en local, puis la servir sur votre domaine.</description><category>fastapi</category><category>tutorial</category><category>lambda</category><category>serverless</category><content:encoded><![CDATA[<h2 id="introduction">Introduction</h2>
<p>FastAPI, le framework python créé par <a href="https://github.com/tiangolo">Sebastián Ramírez</a>, est un super framework permettant de créer des API REST.</p>
<p>Son utilisation est simple et facile d’accès.</p>
<p>Si vous ne connaissez pas ce framework, je vous invite à aller faire un tour sur la <a href="https://fastapi.tiangolo.com/">documentation officielle</a>, et de vous y mettre au plus vite !</p>
<p>Si vous êtes tombés sur cet article, c’est que vous cherchez un moyen simple de déployer votre app FastAPI sur une lambda, l’environnement serverless de AWS.</p>
<p>Bonne pioche ! On va vous expliquer comment procéder.</p>
<h2 id="tutoriel">Tutoriel</h2>
<h3 id="étape-1---créer-son-application-fastapi">Étape 1 - Créer son application FastAPI</h3>
<p>En suivant le guide dans la documentation officielle, on crée une app en quelques lignes de code.</p>
<p>Créer un fichier <code>main.py</code> contenant la déclaration de l’app et une route <code>hello</code>:</p>
<pre class="astro-code astro-code-themes github-light github-dark" style="--shiki-light:#24292e;--shiki-dark:#e1e4e8;--shiki-light-bg:#fff;--shiki-dark-bg:#24292e; overflow-x: auto;" tabindex="0" data-language="python"><code><span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583">from</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8"> fastapi </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583">import</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8"> FastAPI</span></span>
<span class="line"></span>
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">app </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583">=</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8"> FastAPI(</span><span style="--shiki-light:#E36209;--shiki-dark:#FFAB70">title</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583">=</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF">"MyAwesomeApp"</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">)</span></span>
<span class="line"></span>
<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0">@app.get</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">(</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF">"/hello"</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">)</span></span>
<span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583">def</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0"> hello_world</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">():</span></span>
<span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583">    return</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8"> {</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF">"message"</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF">"Hello World"</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">}</span></span></code></pre>
<h3 id="étape-2---tester-le-fonctionnement-de-lapp-localement">Étape 2 - Tester le fonctionnement de l’app localement</h3>
<p>Pour tester l’application localement, vous pouvez créer un environnement virtuel et installer le contenu du fichier <code>requirements.txt</code> suivant:</p>
<pre class="astro-code astro-code-themes github-light github-dark" style="--shiki-light:#24292e;--shiki-dark:#e1e4e8;--shiki-light-bg:#fff;--shiki-dark-bg:#24292e; overflow-x: auto;" tabindex="0" data-language="bash"><code><span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">fastapi</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583">=</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF">=0.63.0</span></span>
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">uvicorn</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583">=</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF">=0.13.4</span></span></code></pre>
<p>Quelques commandes pour créer tout cela …</p>
<pre class="astro-code astro-code-themes github-light github-dark" style="--shiki-light:#24292e;--shiki-dark:#e1e4e8;--shiki-light-bg:#fff;--shiki-dark-bg:#24292e; overflow-x: auto;" tabindex="0" data-language="bash"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0">python3.8</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF"> -m</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF"> venv</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF"> .virtualenv</span><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D">   # Création d'un environnement virtuel</span></span>
<span class="line"><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF">source</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF"> .virtualenv/bin/activate</span><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D"> # Activation de celui-ci</span></span>
<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0">pip</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF"> install</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF"> -r</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF"> requirements.txt</span><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D"> # Installation des packages python</span></span></code></pre>
<p>Lancez l’application localement:</p>
<pre class="astro-code astro-code-themes github-light github-dark" style="--shiki-light:#24292e;--shiki-dark:#e1e4e8;--shiki-light-bg:#fff;--shiki-dark-bg:#24292e; overflow-x: auto;" tabindex="0" data-language="bash"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0">uvicorn</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF"> main:app</span></span></code></pre>
<p>Vous devriez voir des logs comme ceux ci-dessous:</p>
<pre class="astro-code astro-code-themes github-light github-dark" style="--shiki-light:#24292e;--shiki-dark:#e1e4e8;--shiki-light-bg:#fff;--shiki-dark-bg:#24292e; overflow-x: auto;" tabindex="0" data-language="plaintext"><code><span class="line"><span>INFO:     Started server process [87999]</span></span>
<span class="line"><span>INFO:     Waiting for application startup.</span></span>
<span class="line"><span>INFO:     Application startup complete.</span></span>
<span class="line"><span>INFO:     Uvicorn running on http://127.0.0.1:8000 (Press CTRL+C to quit)</span></span></code></pre>
<p>Votre application est disponible sur <a href="http://127.0.0.1:8000">http://127.0.0.1:8000</a>.</p>
<p>Vous pouvez voir la documentation autogénérée via <a href="http://127.0.0.1:8000/docs">http://127.0.0.1:8000/docs</a></p>
<p>Un petit aperçu:</p>
<p><img src="https://adem.build/articles/2/1.webp" alt="FastAPI documentation autogénérée" loading="lazy" decoding="async"></p>
<p>Votre application fonctionne localement ? Parfait, on est prêts pour la suite.</p>
<h3 id="étape-3---rendre-compatible-votre-application-avec-lécosystème-daws-lambda">Étape 3 - Rendre compatible votre application avec l’écosystème d’AWS Lambda</h3>
<p>Pour rendre votre application compatible avec AWS Lambda, nous allons utiliser un outil: <a href="https://github.com/jordaneremieff/mangum">Mangum</a>.</p>
<p>Ajoutez le dans le fichier <code>requirements.txt</code>, il sera utile pour la suite:</p>
<pre class="astro-code astro-code-themes github-light github-dark" style="--shiki-light:#24292e;--shiki-dark:#e1e4e8;--shiki-light-bg:#fff;--shiki-dark-bg:#24292e; overflow-x: auto;" tabindex="0" data-language="bash"><code><span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">fastapi</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583">=</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF">=0.63.0</span></span>
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">uvicorn</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583">=</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF">=0.13.4</span></span>
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">mangum</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583">=</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF">=0.11.0</span></span></code></pre>
<p>Nous allons modifier <code>main.py</code> pour “envelopper” notre objet <code>app</code>.</p>
<p>Votre fichier <code>main.py</code> devient alors:</p>
<pre class="astro-code astro-code-themes github-light github-dark" style="--shiki-light:#24292e;--shiki-dark:#e1e4e8;--shiki-light-bg:#fff;--shiki-dark-bg:#24292e; overflow-x: auto;" tabindex="0" data-language="python"><code><span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583">from</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8"> fastapi </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583">import</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8"> FastAPI</span></span>
<span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583">from</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8"> mangum </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583">import</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8"> Mangum</span></span>
<span class="line"></span>
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">app </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583">=</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8"> FastAPI(</span><span style="--shiki-light:#E36209;--shiki-dark:#FFAB70">title</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583">=</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF">"MyAwesomeApp"</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">)</span></span>
<span class="line"></span>
<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0">@app.get</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">(</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF">"/hello"</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">)</span></span>
<span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583">def</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0"> hello_world</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">():</span></span>
<span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583">    return</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8"> {</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF">"message"</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF">"Hello World"</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">}</span></span>
<span class="line"></span>
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">handler </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583">=</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8"> Mangum(app)</span></span></code></pre>
<p><strong>Remarque</strong>:</p>
<p>A ce stade, l’application est prête et sera fonctionnelle avec l’environnement Lambda, mais une des fonctionnalités de FastAPI ne fonctionnera pas: la page de documentation.</p>
<p>En effet: lorsque la lambda sera créée, le point de terminaison de celle-ci aura la forme <code>https://XXXXXXX.execute-api.eu-west-1.amazonaws.com/stage</code>, avec <code>stage</code> qui peut valoir la valeur que vous voulez (on le verra dans la suite).</p>
<p>Hors, pour générer la page de documentation, FastAPI a besoin, par défaut, d’être servi sur un nom de domaine, et non sur un sous-domaine.</p>
<p>Pour régler cela, on va modifier un minimum le code de l’application, avec ceci:</p>
<pre class="astro-code astro-code-themes github-light github-dark" style="--shiki-light:#24292e;--shiki-dark:#e1e4e8;--shiki-light-bg:#fff;--shiki-dark-bg:#24292e; overflow-x: auto;" tabindex="0" data-language="python"><code><span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583">import</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8"> os</span></span>
<span class="line"></span>
<span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583">from</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8"> fastapi </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583">import</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8"> FastAPI</span></span>
<span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583">from</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8"> mangum </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583">import</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8"> Mangum</span></span>
<span class="line"></span>
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">stage </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583">=</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8"> os.environ.get(</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF">'STAGE'</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">, </span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF">None</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">)</span></span>
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">openapi_prefix </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583">=</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583"> f</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF">"/</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF">{</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">stage</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF">}</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF">"</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583"> if</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8"> stage </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583">else</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF"> "/"</span></span>
<span class="line"></span>
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">app </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583">=</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8"> FastAPI(</span><span style="--shiki-light:#E36209;--shiki-dark:#FFAB70">title</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583">=</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF">"MyAwesomeApp"</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">, </span><span style="--shiki-light:#E36209;--shiki-dark:#FFAB70">openapi_prefix</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583">=</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">openapi_prefix) </span><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D"># la magie se trouve ici.</span></span>
<span class="line"></span>
<span class="line"></span>
<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0">@app.get</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">(</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF">"/hello"</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">)</span></span>
<span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583">def</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0"> hello_world</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">():</span></span>
<span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583">    return</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8"> {</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF">"message"</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF">"Hello World"</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">}</span></span>
<span class="line"></span>
<span class="line"></span>
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">handler </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583">=</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8"> Mangum(app)</span></span></code></pre>
<p><strong>En résumé</strong>:</p>
<p>On change le chemin sur lequel le fichier <code>openapi.json</code> est servi, ce qui servira à la page de documentation de fonctionner correctement.</p>
<p>Dans l’état, votre code python est prêt ! Il nous reste plus qu’à déployer cela, avec le framework <code>serverless</code>.</p>
<h3 id="étape-4---utiliser-serverless-pour-le-déploiement-dans-le-cloud">Étape 4 - Utiliser <code>serverless</code> pour le déploiement dans le cloud</h3>
<p>A partir de cette étape, vous allez avoir besoin de la CLI <code>serverless</code> et de le configurer avec vos identifiants AWS.</p>
<p>La CLI s’installe avec <code>npm</code>:</p>
<pre class="astro-code astro-code-themes github-light github-dark" style="--shiki-light:#24292e;--shiki-dark:#e1e4e8;--shiki-light-bg:#fff;--shiki-dark-bg:#24292e; overflow-x: auto;" tabindex="0" data-language="bash"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0">npm</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF"> install</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF"> -g</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF"> serverless</span></span></code></pre>
<p>C’est un outil qui facilite le déploiement d’applications et services dans le cloud, en décrivant via un fichier YAML les services que l’on veut déployer.</p>
<p>Il est compatible avec AWS Lambda, et plus généralement avec l’outil Cloudformation d’AWS.</p>
<p>Pour plus d’informations, allez sur <a href="serverless.com">serverless.com</a></p>
<p>Après avoir installé <code>serverless</code>, il faut le configurer avec vos identifiants AWS, que vous trouverez dans votre console AWS.</p>
<p>La configuration se fait via cette commande:</p>
<pre class="astro-code astro-code-themes github-light github-dark" style="--shiki-light:#24292e;--shiki-dark:#e1e4e8;--shiki-light-bg:#fff;--shiki-dark-bg:#24292e; overflow-x: auto;" tabindex="0" data-language="bash"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0">serverless</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF"> config</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF"> credentials</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF"> --provider</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF"> aws</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF"> --key</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583"> &lt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF">YOUR_KE</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">Y</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583">&gt;</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF"> --secret</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583"> &lt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF">YOUR_SECRET_KE</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">Y</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583">&gt;</span></span></code></pre>
<p>Vous allez donc créer un fichier serverless.yaml qui va contenir les informations des services à déployer:</p>
<pre class="astro-code astro-code-themes github-light github-dark" style="--shiki-light:#24292e;--shiki-dark:#e1e4e8;--shiki-light-bg:#fff;--shiki-dark-bg:#24292e; overflow-x: auto;" tabindex="0" data-language="yaml"><code><span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D">service</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF">my-awesome-app</span></span>
<span class="line"></span>
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D">package</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">:</span></span>
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D">  individually</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">: </span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF">true</span></span>
<span class="line"></span>
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D">provider</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">:</span></span>
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D">  name</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF">aws</span></span>
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D">  runtime</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF">python3.8</span></span>
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D">  region</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF">eu-west-1</span></span>
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D">  stage</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF">${opt:stage, "dev"}</span></span>
<span class="line"></span>
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D">plugins</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">:</span></span>
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">  - </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF">serverless-python-requirements</span></span>
<span class="line"></span>
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D">custom</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">:</span></span>
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D">  pythonRequirements</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">:</span></span>
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D">    dockerizePip</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">: </span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF">true</span></span>
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D">    layer</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">:</span></span>
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D">      name</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF">my-awesome-app-layer</span></span>
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D">      description</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF">My awesome app layer</span></span>
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D">      compatibleRuntimes</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">:</span></span>
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">        - </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF">python3.8</span></span>
<span class="line"></span>
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D">functions</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">:</span></span>
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D">  app</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">:</span></span>
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D">    package</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">:</span></span>
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D">      include</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">:</span></span>
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">        - </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF">"main.py"</span></span>
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D">      exclude</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">:</span></span>
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">        - </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF">"requirements.txt"</span></span>
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">        - </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF">"package.json"</span></span>
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">        - </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF">"package-lock.json"</span></span>
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">        - </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF">".serverless/**"</span></span>
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">        - </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF">".virtualenv/**"</span></span>
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">        - </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF">"node_modules/**"</span></span>
<span class="line"></span>
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D">    handler</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF">main.handler</span></span>
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D">    environment</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">:</span></span>
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D">      STAGE</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF">${self:provider.stage}</span></span>
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D">    layers</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">:</span></span>
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">      - { </span><span style="--shiki-light:#22863A;--shiki-dark:#85E89D">Ref</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF">PythonRequirementsLambdaLayer</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8"> }</span></span>
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D">    events</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">:</span></span>
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">      - </span><span style="--shiki-light:#22863A;--shiki-dark:#85E89D">http</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">:</span></span>
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D">          method</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF">any</span></span>
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D">          path</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF">/{proxy+}</span></span></code></pre>
<p>Et, au même niveau, vous allez créer un fichier <code>package.json</code> contenant:</p>
<pre class="astro-code astro-code-themes github-light github-dark" style="--shiki-light:#24292e;--shiki-dark:#e1e4e8;--shiki-light-bg:#fff;--shiki-dark-bg:#24292e; overflow-x: auto;" tabindex="0" data-language="json"><code><span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">{</span></span>
<span class="line"><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF">  "name"</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF">"my-awesome-app"</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">,</span></span>
<span class="line"><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF">  "version"</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF">"1.0.0"</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">,</span></span>
<span class="line"><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF">  "author"</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF">"&lt;YOUR_NAME&gt;"</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">,</span></span>
<span class="line"><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF">  "dependencies"</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">: {</span></span>
<span class="line"><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF">    "serverless-python-requirements"</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF">"^5.0.1"</span></span>
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">  }</span></span>
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">}</span></span></code></pre>
<p>Ce fichier va servir à installer les différents plugins Javascript, qui sont utilisés et nommés dans le fichier YAML plus-haut.</p>
<p>Installons les plugins:</p>
<pre class="astro-code astro-code-themes github-light github-dark" style="--shiki-light:#24292e;--shiki-dark:#e1e4e8;--shiki-light-bg:#fff;--shiki-dark-bg:#24292e; overflow-x: auto;" tabindex="0" data-language="bash"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0">npm</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF"> install</span></span></code></pre>
<p>Et, déployons notre application dans le cloud !</p>
<pre class="astro-code astro-code-themes github-light github-dark" style="--shiki-light:#24292e;--shiki-dark:#e1e4e8;--shiki-light-bg:#fff;--shiki-dark-bg:#24292e; overflow-x: auto;" tabindex="0" data-language="bash"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0">sls</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF"> deploy</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF"> --stage</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF"> staging</span><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D"> # "stage" désignera le stage de votre application dans le cloud.</span></span></code></pre>
<p><code>serverless</code> fait sa magie, et au bout de quelques minutes (moins de 5 en général), vous aurez des logs ressemblant à ceux-ci:</p>
<pre class="astro-code astro-code-themes github-light github-dark" style="--shiki-light:#24292e;--shiki-dark:#e1e4e8;--shiki-light-bg:#fff;--shiki-dark-bg:#24292e; overflow-x: auto;" tabindex="0" data-language="plaintext"><code><span class="line"><span>Service Information</span></span>
<span class="line"><span>service: my-awesome-app</span></span>
<span class="line"><span>stage: staging</span></span>
<span class="line"><span>region: eu-west-1</span></span>
<span class="line"><span>stack: my-awesome-app-staging</span></span>
<span class="line"><span>resources: 12</span></span>
<span class="line"><span>api keys:</span></span>
<span class="line"><span>  None</span></span>
<span class="line"><span>endpoints:</span></span>
<span class="line"><span>  ANY - &lt;LE POINT DE TERMINAISON EST ICI&gt;</span></span>
<span class="line"><span>functions:</span></span>
<span class="line"><span>  app: my-awesome-app-staging-app</span></span>
<span class="line"><span>...</span></span></code></pre>
<p>En regardant ces logs, vous trouverez le point de terminaison de votre application !</p>
<p>Ici c’est <code>https://XXXXXXXXX.execute-api.eu-west-1.amazonaws.com/staging/</code> (XXXXXX est en général une suite de chiffres et de lettres).</p>
<p>Si vous allez sur <code>https://XXXXXXXXX.execute-api.eu-west-1.amazonaws.com/staging/docs</code>, vous allez vous retrouver face à la documentation de votre app FastAPI !</p>
<p>Pour mettre à jour votre application, vous avez juste à effectuer vos modifications dans le code python, et ensuite le déploiement se fait en executant:</p>
<pre class="astro-code astro-code-themes github-light github-dark" style="--shiki-light:#24292e;--shiki-dark:#e1e4e8;--shiki-light-bg:#fff;--shiki-dark-bg:#24292e; overflow-x: auto;" tabindex="0" data-language="bash"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0">sls</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF"> deploy</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF"> --stage</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF"> staging</span></span></code></pre>
<p>Pour supprimer l’application et ses dépendences du cloud:</p>
<pre class="astro-code astro-code-themes github-light github-dark" style="--shiki-light:#24292e;--shiki-dark:#e1e4e8;--shiki-light-bg:#fff;--shiki-dark-bg:#24292e; overflow-x: auto;" tabindex="0" data-language="bash"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0">sls</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF"> remove</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF"> --stage</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF"> staging</span></span></code></pre>
<p>Vous avez maintenant tout de votre côté pour créer des applications FastAPI et les héberger via l’ecosystème AWS Lambda !</p>
<p>Faites en bon usage !</p>
<h3 id="bonus-étape-5---utiliser-son-nom-de-domaine-personnalisé">[Bonus] Étape 5 - Utiliser son nom de domaine personnalisé</h3>
<p>Si vous voulez que votre app soit disponible sur votre domaine, il ne vous reste pas grand chose à faire.</p>
<p>Cette étape vous expliquera pas à pas ce qu’il manque.</p>
<p>Quelques pré-requis sont nécessaires:</p>
<ul>
<li>un nom de domaine enregistré sur AWS Route53</li>
<li>un certificat lié au nom de domaine pour avoir le HTTPS, généré sur AWS Certificate Manager (si vous n’en avez pas, faites en sorte de le créer dans la région par défaut d’AWS <code>us-east-1</code> qui est considéré comme global pour les certificats).</li>
</ul>
<p>On va utiliser un plugin qui va nous faciliter la vie: <code>serverless-domain-manager</code>.</p>
<p>Installons le:</p>
<pre class="astro-code astro-code-themes github-light github-dark" style="--shiki-light:#24292e;--shiki-dark:#e1e4e8;--shiki-light-bg:#fff;--shiki-dark-bg:#24292e; overflow-x: auto;" tabindex="0" data-language="bash"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0">npm</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF"> install</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF"> serverless-domain-manager</span></span></code></pre>
<p>Et ajoutons le dans la liste des plugins dans notre fichier serverless.yaml:</p>
<pre class="astro-code astro-code-themes github-light github-dark" style="--shiki-light:#24292e;--shiki-dark:#e1e4e8;--shiki-light-bg:#fff;--shiki-dark-bg:#24292e; overflow-x: auto;" tabindex="0" data-language="yaml"><code><span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D">plugins</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">:</span></span>
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">  - </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF">serverless-python-requirements</span></span>
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">  - </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF">serverless-domain-manager</span></span></code></pre>
<p>On doit configurer le plugin, vous allez donc ajouter dans la partie <strong>custom</strong> de serverless.yaml:</p>
<pre class="astro-code astro-code-themes github-light github-dark" style="--shiki-light:#24292e;--shiki-dark:#e1e4e8;--shiki-light-bg:#fff;--shiki-dark-bg:#24292e; overflow-x: auto;" tabindex="0" data-language="yaml"><code><span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D">custom</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">:</span></span>
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D">  customDomain</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">:</span></span>
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D">    domainName</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF">VOTRE_DOMAINE_ICI</span></span>
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D">    stage</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF">${self:provider.stage}</span></span>
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D">    certificateArn</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF">VOTRE_CERTIFICAT_ARN_ICI</span></span>
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D">    endpointType</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF">"edge"</span></span>
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D">    securityPolicy</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF">tls_1_2</span></span>
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D">    apiType</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF">rest</span></span>
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D">    autoDomain</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">: </span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF">true</span></span>
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D">    autoDomainWaitFor</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">: </span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF">120</span></span></code></pre>
<p>(N’oubliez pas de renseigner les champs comme indiqué).</p>
<p>Une fois cela fait, on déploie:</p>
<pre class="astro-code astro-code-themes github-light github-dark" style="--shiki-light:#24292e;--shiki-dark:#e1e4e8;--shiki-light-bg:#fff;--shiki-dark-bg:#24292e; overflow-x: auto;" tabindex="0" data-language="bash"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0">sls</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF"> deploy</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF"> --stage</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF"> staging</span></span></code></pre>
<p>Après quelques minutes on peut accéder à notre API via votre nom de domaine !</p>
<p>… Vraiment ?</p>
<p>Tentez d’accéder à la documentation générée sur /docs … vous voyez le piège ?</p>
<p><img src="https://adem.build/articles/2/2.webp" alt="FastAPI Erreur documentation" loading="lazy" decoding="async"></p>
<p>Cela vient de ce que l’on a ajouté dans le code python pour pouvoir accéder à la documentation depuis le point de terminaison de notre lambda !</p>
<p>Il ne nous reste plus qu’à l’enlever:</p>
<pre class="astro-code astro-code-themes github-light github-dark" style="--shiki-light:#24292e;--shiki-dark:#e1e4e8;--shiki-light-bg:#fff;--shiki-dark-bg:#24292e; overflow-x: auto;" tabindex="0" data-language="python"><code><span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">app </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583">=</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8"> FastAPI(</span><span style="--shiki-light:#E36209;--shiki-dark:#FFAB70">title</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583">=</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF">"MyAwesomeApp"</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">, </span><span style="--shiki-light:#E36209;--shiki-dark:#FFAB70">openapi_prefix</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583">=</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">openapi_prefix) </span><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D"># Changez cela</span></span>
<span class="line"></span>
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">app </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583">=</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8"> FastAPI(</span><span style="--shiki-light:#E36209;--shiki-dark:#FFAB70">title</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583">=</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF">"MyAwesomeApp"</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">) </span><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D"># Avec cela</span></span></code></pre>
<p>Redéployez.</p>
<p><img src="https://adem.build/articles/2/tada.webp" alt="Tada GIF" loading="lazy" decoding="async"></p>
<p>Vous avez maintenant votre application FastAPI, hébergé sur AWS Lambda, accessible depuis votre nom de domaine personnel.</p>
<p>Libre à vous maintenant de créer des applications cools !</p>
<h2 id="conclusion">Conclusion</h2>
<p>A travers cet article écrit sous la forme d’un petit tutoriel, vous êtes maintenant capable de créer une application FastAPI, de la tester localement et de la déployer sur AWS via serverless !</p>
<p>Si vous avez des questions ou des remarques, n’hésitez pas à me contacter.</p>
<p>A la prochaine,</p>
<p>Adem.</p>
]]></content:encoded></item>
<item><title>Stratégies merge vs rebase avec git</title><link>https://adem.build/fr/posts/git-merge-vs-rebase</link><guid isPermaLink="true">https://adem.build/fr/posts/git-merge-vs-rebase</guid><pubDate>Sat, 01 Aug 2020 00:00:00 GMT</pubDate><dc:creator>Adem Usta</dc:creator><description>Merge, ou rebase avant de merger ? Les deux stratégies git comparées sur un cas réel à plusieurs développeurs : graphes de commits, push force et rebase depuis GitHub.</description><category>git</category><category>software-development</category><category>workflow</category><content:encoded><![CDATA[<h2 id="introduction">Introduction</h2>
<p>Lorsqu’on développe un logiciel (application web, logiciel desktop, site internet, etc.),
une des bonnes pratiques à ne surtout pas négliger est la gestion des versions du code source.</p>
<p>C’est en réponse à ce besoin que le logiciel libre <a href="https://git-scm.com">git</a> est né.</p>
<p>Il permet de versionner son logiciel et de garder un historique précis de ces versions.</p>
<p>Il permet aussi à plusieurs personnes de travailler sur le même projet, sans qu’ils (les développeurs) ne se marchent dessus, du moins en théorie.</p>
<p>Nous allons exposer dans cet article une situation classique de développement d’un logiciel par plusieurs personnes.</p>
<p>Voici le contexte:</p>
<ul>
<li>un projet dont le code source est hebergé sur <a href="https://github.com">GitHub</a>.</li>
<li>plusieurs développeurs travaillent sur le même fichier, et potentiellement modifient la même partie de celui-ci.</li>
</ul>
<h2 id="contexte">Contexte</h2>
<p>La branche principale du projet est nommée <strong>master</strong>, comme dans la plupart des projets.</p>
<p>La branche <strong>master</strong> contient déjà quelques commits:</p>
<p><img src="https://adem.build/articles/1/1.webp" alt="Graphe réseau GitHub : la branche master et ses premiers commits" loading="lazy" decoding="async"></p>
<h2 id="modification-du-code-source-par-plusieurs-développeurs">Modification du code source par plusieurs développeurs</h2>
<p>Supposons deux développeurs A et B, voulant modifier des fichiers sources du projet.</p>
<p>La bonne pratique est pour chacun de créer une branche et d’effectuer leurs modifications dessus.</p>
<p>On les nommera <em>branch-A</em> et <em>branch-B</em>.</p>
<p>À un moment donné, les deux développeurs seront satisfaits de leur boulot et voudront pousser leurs changements sur la branche <strong>master</strong>.</p>
<p>C’est à ce moment là où il existe deux façons de faire: via un <code>merge</code> ou un <code>rebase</code>.</p>
<p>Voici la situation des branches:</p>
<p><img src="https://adem.build/articles/1/2.webp" alt="Graphe réseau GitHub : branch-A et branch-B créées depuis master" loading="lazy" decoding="async"></p>
<p>Dans la suite, on suppose que A va pousser ses changements sur <strong>master</strong> en premier.</p>
<p>Il crée donc une pull-request, et après validation, il la merge sur <strong>master</strong>.</p>
<p>Le schéma devient donc le suivant:</p>
<p><img src="https://adem.build/articles/1/3.webp" alt="Graphe réseau GitHub : branch-A mergée dans master" loading="lazy" decoding="async"></p>
<p>Jusque là, tout va bien, rien de bien méchant.</p>
<p>Là où les choses deviennent intéressantes, c’est pour B, lorsqu’il va vouloir pousser ses modifications sur <strong>master</strong>.</p>
<p>Comme on le voit dans le réseau des branches, <strong>master</strong> a bougé (grâce aux modifications de A) et donc la branche de B n’a pas les dernières modifications apportées sur <strong>master</strong>.</p>
<p>C’est à ce moment précis que le choix entre un <code>merge</code> et un <code>rebase</code> doit se faire.</p>
<p>Nous allons donc voir les deux cas, et voir ce que cela implique sur l’arborescence, la gestion des éventuels conflits, etc.</p>
<h3 id="stratégie-de-merge">Stratégie de merge</h3>
<p>En choisissant la stratégie de merge, git va tout simplement prendre les commits de <em>branch-B</em> et les ajouter sur <strong>master</strong>, on a alors ce graphique:</p>
<p><img src="https://adem.build/articles/1/4.webp" alt="Graphe réseau GitHub : branch-B mergée dans master avec un commit de merge" loading="lazy" decoding="async"></p>
<p><strong>Note</strong>: les couleurs ne représentent pas les mêmes branches à chaque fois … merci GitHub !</p>
<p><strong>Note 2</strong>: un développeur C s’est incrusté en cours de route, il servira d’exemple pour le rebase !</p>
<p>On voit ici que l’historique des commits n’est pas lisible, et là nous n’avons que deux développeurs !</p>
<p>C’est dans ce contexte que nous allons voir en quoi la strategie de rebase peut rendre l’historique plus lisible.</p>
<h3 id="stratégie-de-rebase">Stratégie de rebase</h3>
<p>Un nouveau développeur s’est incrusté au projet, avec toute sa bonne volonté.</p>
<p>Il a donc sa branche <em>branch-C</em>, sur laquelle il effectue ses modifications.</p>
<p>Vient le moment où il veut pousser ses changements sur <strong>master</strong>.</p>
<p>Sa pull-request étant validée, il décide de merge mais en effecutant un rebase dans un premier temps.</p>
<p><strong>Note</strong>: pour effectuer un rebase, vous pouvez le faire via la CLI de git sur votre environnement de travail local, en effectuant:</p>
<pre class="astro-code astro-code-themes github-light github-dark" style="--shiki-light:#24292e;--shiki-dark:#e1e4e8;--shiki-light-bg:#fff;--shiki-dark-bg:#24292e; overflow-x: auto;" tabindex="0" data-language="bash"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0">git</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF"> fetch</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8"> &amp;&amp; </span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0">git</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF"> rebase</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF"> origin/master</span></span></code></pre>
<p>Il se peut que vous aillez des conflits, vous pourrez les régler localement avant de pousser votre code.</p>
<p>Il faudra <code>push force</code>, cela peut être problématique dans des cas précis, notamment quand vous bossez à plusieurs sur la même branche.</p>
<p>Sinon, vous pouvez effectuer le rebase via <a href="https://github.com">GitHub</a> directement.</p>
<p>En effectuant un “rebase and merge” sur l’interface de github, nous obtenons ceci:</p>
<p><img src="https://adem.build/articles/1/5.webp" alt="Graphe réseau GitHub : branch-C rebasée et mergée depuis GitHub" loading="lazy" decoding="async"></p>
<p>Dans ce cas, github ne montre plus la <em>branch-C</em>, mais les commits de celle-ci se retrouve sur <strong>master</strong>, plus précisemment en dernier.</p>
<p>Pour montrer ce que fait un rebase en CLI, nous incluons une nouvelle branche <em>branch-D</em>, l’arbre des branches est alors:</p>
<p><img src="https://adem.build/articles/1/6.webp" alt="Graphe réseau GitHub : branch-D avant le rebase" loading="lazy" decoding="async"></p>
<p>Le rebase depuis la CLI + push force nous donne:</p>
<p><img src="https://adem.build/articles/1/7.webp" alt="Graphe réseau GitHub : branch-D rebasée sur master après un push force" loading="lazy" decoding="async"></p>
<p>Nous voyons ce que fait le rebase ici: git remonte notre branche <em>branch-D</em> au dessus de <strong>master</strong>, puis rejoue nos commits un à un.</p>
<p>S’il y a des conflits, c’est à ce moment là qu’ils doivent être réglés.</p>
<p>Il nous reste plus qu’à merge depuis l’interface.</p>
<p>On a alors:</p>
<p><img src="https://adem.build/articles/1/8.webp" alt="Graphe réseau GitHub : branch-D mergée dans master" loading="lazy" decoding="async"></p>
<p>Ici, on voit bien notre <em>branch-D</em> (en bleu en haut) qui est “remonté”.</p>
<p>L’intérêt de cette dernière stratégie est d’avoir un historique des branches qui suit une forme de simples boucles.</p>
<p>L’historique est alors plus lisible.</p>
<p>Un seul bémol: le push force à effectuer après un rebase (il est nécessaire car on ré-écrit les commits de notre branche, il y a donc mismatch avec la branche sur le serveur).</p>
<p>Cela peut être problématique si vous êtes plusieurs à développer sur la même branche (il faudra faire attention et <code>pull</code> les changements de vos collègues avant d’effectuer le rebase).</p>
<h2 id="conclusions">Conclusions</h2>
<p>Comme on l’a vu dans cet article, la stratégie de <code>merge</code> est la plus simple: elle ne nécessite pas de workflow particulier:</p>
<ol>
<li>on développe sur une branche séparée notre nouvelle fonctionnalité</li>
<li>une fois prête, on ouvre une pull-request sur GitHub</li>
<li>une fois validée, on merge le tout.</li>
</ol>
<p>Mais cela implique un historique des branches qui n’est pas assez lisible (à mon sens).</p>
<p>A l’inverse, effectuer un <code>rebase</code> implique un peu plus de discipline:</p>
<ol>
<li>on développe sur une branche séparée notre nouvelle fonctionnalité</li>
<li>une fois prête, on ouvre une pull-request sur GitHub</li>
<li>une fois les modifications validées, on effectue un rebase</li>
<li>On merge la pull-request.</li>
</ol>
<p>Le workflow est plus compliqué, et nécessite un peu plus de discipline de la part des développeurs.</p>
<p>Mais le résultat est un historique beaucoup plus lisible.</p>
<p>Voilà pour ce premier billet de blog, si vous avez des questions, n’hésitez pas à m’envoyer un email !</p>
<p>A tres vite,</p>
<p>Adem Usta.</p>
]]></content:encoded></item>
</channel>
</rss>