Table of Contents

Présentation

Projet de formation visant à maîtriser le déploiement cloud sur Azure. Cette pipeline automatise le build, le test et le déploiement d’une application FastAPI sur un cluster AKS, avec une infrastructure provisionnée en Terraform.

Architecture

flowchart LR
    subgraph Azure["Azure Cloud"]
        direction TB
        VNET["VNET (10.0.0.0/16)"]
        
        subgraph Subnets
            AKS[("AKS Cluster<br/>10.1.0.0/16")]
            POSTGRES[("PostgreSQL<br/>Flexible")]
            ACR[("ACR")]
        end
        
        VNET --- Subnets
    end
    
    GH["GitHub<br/>Repository"] -->|"GitHub Actions"| Azure
    
    style Azure fill:#0078D4,stroke:#fff,color:#fff
    style GH fill:#24292F,stroke:#fff,color:#fff
    style AKS fill:#326CE5,stroke:#fff,color:#fff
    style POSTGRES fill:#FF8C00,stroke:#fff,color:#fff
    style ACR fill:#0096FF,stroke:#fff,color:#fff

Composants

Ressource	Description
AKS Cluster	Azure Kubernetes Service (2 nodes B1s)
PostgreSQL Flexible	Base de données PostgreSQL v15 avec Private Endpoint
ACR	Azure Container Registry pour les images Docker
VNET	Virtual Network 10.0.0.0/16 avec sous-réseaux dédiés
GitHub Actions	Pipeline CI/CD automatisé

Structure

kubernetes-azure/
├── app/                 # Application FastAPI + Dockerfile
├── terraform/           # IaC (modules: network, aks, acr, postgres)
├── k8s/                 # Manifests Kubernetes
└── .github/workflows/   # CI/CD Pipeline

Stack Technique

• Application : FastAPI + SQLAlchemy + Pydantic
• Base de données : PostgreSQL Flexible Server
• Conteneurisation : Docker + ACR
• Orchestration : Kubernetes (AKS)
• IaC : Terraform
• CI/CD : GitHub Actions

Application FastAPI

L’application expose plusieurs endpoints :

# Endpoints disponibles
GET  /                   # Hello World
GET  /hello/{name}      # Message personnalisé
GET  /items             # Liste des items
POST /items             # Créer un item

Déploiement

1. Terraform (Infrastructure)

cd terraform
terraform init
terraform plan
terraform apply

2. Docker (Build & Push)

cd app
docker build -t acrjul24.azurecr.io/fastapi-app:latest .
az acr login -n acrjul24
docker push acrjul24.azurecr.io/fastapi-app:latest

3. Kubernetes (Application)

az aks get-credentials -g rg-aks-jul24 -n aks-jul24
kubectl apply -f k8s/

Commandes Utiles

# Vérifier les pods
kubectl get pods -n fastapi-ns

# Logs en temps réel
kubectl logs -n fastapi-ns -l app=fastapi -f

# Accéder au cluster
kubectl exec -it <pod-name> -n fastapi-ns -- /bin/bash

Compétences Acquises

• Azure Kubernetes Service (AKS)
• Terraform modules
• Docker & ACR
• GitHub Actions
• PostgreSQL Flexible Server
• Private Endpoints
• Infrastructure as Code
• CI/CD Pipeline