Software Engineer Encyclopedia
0%
Domain 08 · DevOps, Cloud & Production Engineering · Topic 8.7

Kubernetes وTerraform: Orchestration وInfrastructure as Code

Kubernetes & Terraform — Containers at Scale and Repeatable Infrastructure

Container orchestration، Pods/Deployments/Services/Ingress، ConfigMaps/Secrets، probes، HPA/PDB، volumes، namespaces/RBAC، Helm، Terraform providers/state/plan/apply/modules/remote state/import/drift/secrets.

  • Advanced
  • ~20 min read
  • 17 sections
  • 13 code examples
  • 1 diagrams
  • 6 questions
  • Priority L3 · Advanced
  • Kubernetes current stable concepts · Terraform 1.x · .NET 10

المتطلبات قبل ما تبدأ

تطبيق backend جاهز للنشر (المجالات 03–05).

مستوى التعمق المطلوب

LATERLearn these after you are comfortable with Docker and deploying applications.

01

ليه Kubernetes بعد Docker؟

Manage many containers across machines
Deep dive

Docker يشرح بناء image وتشغيل container على host. لما عندك عدة instances، nodes، rolling updates، service discovery، health probes، secrets، autoscaling و storage، تحتاج orchestration. Kubernetes يعلن desired state: «أريد 3 replicas من API image هذه»، وال controllers تحاول باستمرار تقرّب actual state من desired state.

Kubernetes ليس شرطًا لكل API. لو App Service أو Azure Container Apps أو Cloud Run تلبي احتياجك، قد تكون managed PaaS أبسط وأقل تكلفة تشغيلية. AKS/GKE/EKS مناسبة عندما تحتاج Kubernetes ecosystem أو control أو portability أو workload complexity تبرر cluster operations. تعلم Kubernetes بعد Docker و networking و Linux و CI/CD.

02

Kubernetes objects في رسمة

Core Kubernetes objects
Basics
IngressServicestable DNS + VIPDeployment → ReplicaSetPodprobes, limitsPodPodConfigMap · Secret · ServiceAccount · HPA · PDB
Ingress routes to a Service; the Service load-balances to Pods managed by a Deployment
03

Cluster و Node و Pod و Container

Understand the execution hierarchy
Deep dive

Cluster يتكون من control plane و worker nodes. Control plane يدير API server/scheduler/controllers/state store حسب distribution. Node تشغل kubelet/container runtime. Pod أصغر scheduling unit، وقد تحتوي container واحدة أو عدة containers تتشارك network namespace و volumes. لا تتعامل مع Pod كأنه VM أو مكان دائم للبيانات؛ Pods قابلة للاستبدال.

Sidecar container داخل نفس Pod قد يشارك localhost/volumes مع app، لكنه يزيد resource coupling. غالبًا container واحدة لكل app process تكفي. لا تشغل عدة مستقلات غير مترابطة داخل Pod لمجرد أنها في نفس project.

Kubernetes Core Objects: Pod و Deployment و Service و Ingress

Pod هو أصغر scheduling unit وغالبًا لا تديره يدويًا؛ Deployment يحدد desired replicas ويقوم controller بإنشاء ReplicaSets/Pods. Service يوفر stable virtual endpoint فوق Pods المتغيرة. Ingress/Gateway يعرّف HTTP routing من خارج cluster حسب controller المستخدم. ConfigMap للإعدادات غير السرية، Secret للبيانات الحساسة مع ملاحظة أن base64 ليست encryption بذاتها.

YAMLDeployment and ClusterIP Service
apiVersion: apps/v1
kind: Deployment
metadata:
  name: shop-api
spec:
  replicas: 3
  selector:
    matchLabels:
      app: shop-api
  template:
    metadata:
      labels:
        app: shop-api
    spec:
      containers:
        - name: api
          image: registry.example/shop-api:1.4.2
          ports:
            - name: http
              containerPort: 8080
          resources:
            requests: { cpu: "100m", memory: "128Mi" }
            limits: { cpu: "1", memory: "512Mi" }
---
apiVersion: v1
kind: Service
metadata:
  name: shop-api
spec:
  selector:
    app: shop-api
  ports:
    - name: http
      port: 80
      targetPort: http
  type: ClusterIP

لا تستخدم mutable tag مثل latest في deployment production. حدّد resource requests حتى scheduler يخطط، و limits بعد load testing. Container port لا يفتح host port تلقائيًا. Service يوجه إلى Pods التي تطابق labels؛ label mismatch سبب شائع لعدم وصول traffic.

04

Deployment و ReplicaSet و Rolling Updates

Declare replicas and rollout strategy
Deep dive

Deployment يدير ReplicaSet و Pods لتطبيق stateless. تحدد image، replicas، labels/selectors، resources، probes و update strategy. عند تحديث template ينشئ ReplicaSet جديدة ويغير replicas تدريجيًا حسب maxSurge/maxUnavailable. Rollout status/history/undo تساعد release management، لكن rollback image لا يعكس database migration تلقائيًا.

YAMLASP.NET Core Deployment sketch
apiVersion: apps/v1
kind: Deployment
metadata:
  name: myshop-api
spec:
  replicas: 3
  selector:
    matchLabels:
      app: myshop-api
  strategy:
    type: RollingUpdate
    rollingUpdate:
      maxSurge: 1
      maxUnavailable: 0
  template:
    metadata:
      labels:
        app: myshop-api
    spec:
      containers:
        - name: api
          image: registry.example.com/myshop-api:1.0.0
          ports:
            - containerPort: 8080
          resources:
            requests:
              cpu: 250m
              memory: 256Mi
            limits:
              cpu: "1"
              memory: 512Mi

الـ manifest يحتاج namespace/service account/probes/env/secrets/ingress configuration حسب environment. لا تضع latest tag في production؛ استخدم version/digest. resource requests تؤثر في scheduling، limits تقيّد الاستهلاك وقد تسبب CPU throttling أو OOMKilled. اختبر memory limit مع ‎.NET GC behavior.

Deployment و Service و Probes: Manifest مع تفسير الحقول

Deployment يدير ReplicaSets و Pods stateless عادةً؛ Service يعطي stable virtual endpoint داخل cluster. لا تستخدم Pod IP مباشرة لأنه يتغير. readiness probe تتحكم في دخول Pod إلى endpoints، و liveness probe قد تعيد تشغيل container، و startup probe تمنح التطبيق وقت إقلاع أطول قبل تقييم liveness/readiness.

YAMLIllustrative Kubernetes Deployment
apiVersion: apps/v1
kind: Deployment
metadata:
  name: myshop-api
spec:
  replicas: 3
  selector:
    matchLabels:
      app: myshop-api
  template:
    metadata:
      labels:
        app: myshop-api
    spec:
      containers:
        - name: api
          image: registry.example/myshop-api:1.4.2
          ports:
            - name: http
              containerPort: 8080
          resources:
            requests:
              cpu: 100m
              memory: 128Mi
            limits:
              cpu: "1"
              memory: 512Mi
          readinessProbe:
            httpGet: { path: /health/ready, port: http }
            periodSeconds: 10
          livenessProbe:
            httpGet: { path: /health/live, port: http }
            periodSeconds: 20

هذا manifest تعليمي وليس production-ready بالكامل: أضف securityContext non-root، readOnlyRootFilesystem حيث ممكن، dropped capabilities، image digest pinning، PodDisruptionBudget، topology spread، NetworkPolicy، ServiceAccount محدود، و startupProbe عند بطء startup. لا تجعل liveness تعتمد على SQL؛ انقطاع قاعدة البيانات لا يعني أن process نفسها ماتت، وقد يسبب restart storm.

اختبر rolling update مع readiness حقيقية، وحدد terminationGracePeriodSeconds و graceful shutdown. عند إنهاء Pod، يجب أن يتوقف عن استقبال traffic، ينهي requests الجارية ضمن مهلة، ويغلق consumers بطريقة لا تفقد الرسائل. راقب rollout status و events و previous container logs.

Rollouts و Probes و Pod Security

RollingUpdate يتحكم في maxSurge و maxUnavailable; readiness probe تمنع Pod غير جاهزة من استقبال traffic. Liveness تعيد تشغيل container، ويجب ألا تعتمد على database availability. استخدم PodDisruptionBudget لحماية الحد الأدنى أثناء voluntary disruptions، لكنه لا يمنع كل أشكال الفشل. افصل startup probe عند الإقلاع الطويل.

شغّل non-root، filesystem read-only قدر الإمكان، drop Linux capabilities، لا تستخدم privileged containers، وقيّد egress/ingress عبر NetworkPolicy عند دعم CNI. Secrets يجب تكون encrypted at rest في cluster configuration، مع RBAC محدود و rotation. لا تضع cloud credentials داخل image أو YAML committed.

YAMLSafer pod security context
spec:
  securityContext:
    runAsNonRoot: true
    seccompProfile:
      type: RuntimeDefault
  containers:
    - name: api
      securityContext:
        allowPrivilegeEscalation: false
        readOnlyRootFilesystem: true
        capabilities:
          drop: ["ALL"]

اختبر أن التطبيق لا يحتاج الكتابة إلى root filesystem؛ خصص emptyDir محدودًا فقط للمسارات التي تحتاجها. SecurityContext على Pod و container لهما نطاقات مختلفة. راجع compatibility مع base image والـ UID وملفات certificate/temp.

ASP.NET Core Deployment على Kubernetes

الـ Deployment يدير ReplicaSets و Pods ويضمن العدد المطلوب من النسخ. الـ Service يعطي عنوانًا ثابتًا داخل cluster ويوزع traffic على Pods المطابقة للـ selector. المثال يفترض image منشورة في registry وتطبيقًا يستمع على 8080 ويعرض health endpoints.

YAMLapi-deployment.yaml
apiVersion: apps/v1
kind: Deployment
metadata:
  name: myshop-api
  namespace: myshop
spec:
  replicas: 2
  selector:
    matchLabels:
      app: myshop-api
  template:
    metadata:
      labels:
        app: myshop-api
    spec:
      terminationGracePeriodSeconds: 30
      containers:
        - name: api
          image: ghcr.io/example/myshop-api:1.4.2
          ports:
            - name: http
              containerPort: 8080
          env:
            - name: ASPNETCORE_URLS
              value: http://+:8080
          readinessProbe:
            httpGet:
              path: /health/ready
              port: http
            periodSeconds: 5
            failureThreshold: 3
          livenessProbe:
            httpGet:
              path: /health/live
              port: http
            periodSeconds: 10
            failureThreshold: 3
          resources:
            requests:
              cpu: 100m
              memory: 128Mi
            limits:
              cpu: "1"
              memory: 512Mi
          securityContext:
            allowPrivilegeEscalation: false
            readOnlyRootFilesystem: true
            runAsNonRoot: true
---
apiVersion: v1
kind: Service
metadata:
  name: myshop-api
  namespace: myshop
spec:
  selector:
    app: myshop-api
  ports:
    - name: http
      port: 80
      targetPort: http
  type: ClusterIP

أنشئ namespace أولًا وتأكد أن health endpoints لا تكشف تفاصيل حساسة. readiness تعني أن Pod جاهز لاستقبال traffic؛ فشلها يخرجه من endpoints مؤقتًا. liveness تعني أن العملية عالقة ويجب إعادة تشغيلها؛ لا تربطها مباشرة بتوفر SQL Server، لأن انقطاع DB قد يجعل كل Pods تعيد التشغيل بلا فائدة.

تحقق بـ kubectl apply -f api-deployment.yaml ثم kubectl rollout status deployment/myshop-api -n myshop و kubectl get pods,svc -n myshop. عند الفشل استخدم kubectl describe pod و kubectl logs. kubectl rollout undo يرجع التطبيق إلى ReplicaSet سابق لكنه لا يعكس database migration.

في production أضف NetworkPolicy و PodDisruptionBudget و HPA بعد القياس و service account محدودًا و image pinning بال digest و secret integration من secret manager. لا تحفظ production secrets في YAML plain داخل Git.

05

Service و Ingress و DNS

Stable networking over ephemeral Pods
Deep dive

Pod IP قد يتغير عند recreate؛ Service توفر stable virtual endpoint وتختار Pods عبر labels/selectors. ClusterIP داخلي، NodePort يفتح port على nodes، LoadBalancer يطلب external load balancer حسب provider. Ingress controller/gateway يوجه HTTP(S) host/path إلى services. Service discovery عبر DNS names داخل cluster يقلل hard-coded IPs.

NetworkPolicy تحدد allowed pod ingress/egress إذا CNI يدعمها. لا تفترض أن كل cluster تفرض default deny؛ policies يجب تكتب وتختبر. TLS termination و WAF/rate limits/authentication يمكن تكون في ingress/gateway أو application حسب trust boundaries.

YAMLInternal ClusterIP service
apiVersion: v1
kind: Service
metadata:
  name: myshop-api
spec:
  type: ClusterIP
  selector:
    app: myshop-api
  ports:
    - name: http
      port: 80
      targetPort: 8080

Kubernetes Networking و DNS و NetworkPolicy

كل Pod يحصل على network identity وفق CNI، والـ Service يقدم stable virtual IP/DNS name مثل shop-api.namespace.svc.cluster.local. Ingress/Gateway controller يستقبل external traffic ويطبق routing/TLS. NetworkPolicy قد تقيد ingress/egress إذا كان CNI يدعمها. لا تفترض أن NetworkPolicy مفعلة لمجرد كتابة YAML؛ تحقق من implementation.

مشاكل الاتصال تُشخّص طبقة طبقة: DNS resolution، service selectors/endpoints، pod readiness، port/targetPort، ingress controller، TLS certificate، NetworkPolicy، ثم application logs. لا تستخدم NodePort أو LoadBalancer لكل internal service. استخدم least exposure و TLS بين الحدود الحساسة.

06

ConfigMaps و Secrets و Service Accounts

Configuration and workload identity
Deep dive

ConfigMap لل configuration غير الحساسة، Secret للبيانات الحساسة، لكن Kubernetes Secret object لا يعني encryption at rest تلقائيًا في كل cluster configuration؛ فعّل encryption provider/managed secrets integration و RBAC ضيق. لا commit base64-encoded secret في Git؛ Base64 encoding ليس encryption. External secret managers/CSI drivers أو workload identity أفضل في كثير من environments.

ServiceAccount identity داخل cluster. استخدم dedicated service account لكل workload، و RBAC Roles/RoleBindings بأقل permissions. لا تشغل app بصلاحية cluster-admin. في cloud managed Kubernetes، اربط workload identity بال cloud IAM بدل service-account key files.

07

Probes و Resources و Graceful Shutdown

Keep traffic away from unready instances
Deep dive

Startup probe تمنح وقت initialization، readiness تتحكم في traffic routing، liveness تعيد تشغيل container عند stuck process. اضبط timeoutSeconds, periodSeconds, failureThreshold و initial delay بناءً على startup/latency data. لا تجعل liveness تفحص database. terminationGracePeriodSeconds يسمح للتطبيق يستقبل SIGTERM ويكمل in-flight requests ويوقف consumers بأمان.

Resource requests تؤثر في scheduling/capacity planning، limits تحدد سقف CPU/memory. CPU limit منخفض قد يسبب throttling و p99 latency، memory limit منخفض يسبب OOMKilled. راقب working set، GC pauses، thread pool و connection pools. HPA يعتمد metrics مثل CPU/custom metrics، ولا يعوض database bottleneck أو lock contention.

08

HPA و PDB و Autoscaling

Scale replicas without losing availability
Deep dive

Horizontal Pod Autoscaler يغير replica count حسب CPU/memory/custom/external metrics. لازم requests تكون مضبوطة حتى utilization percentage لها معنى. Cluster Autoscaler أو provider node autoscaler يضيف/removes nodes عند scheduling pressure. Scaling يحتاج startup capacity، image pull time، database connection budget و queue backlog policy.

PodDisruptionBudget يحدد الحد الأدنى المتاح أثناء voluntary disruptions مثل node drain، لكنه لا يمنع involuntary failures. PDB مع replicas=1 قد يمنع maintenance أو drain. افهم الفرق بين HPA و PDB و readiness و replica count. لا تضاعف replicas من غير حساب external dependencies.

Autoscaling و Storage و Failure Domains

HPA يعتمد عادة على CPU/memory أو custom metrics؛ CPU target لا يعبر دائمًا عن queue backlog أو request concurrency. عند workers استخدم queue depth/oldest message age إذا أمكن، مع حماية من scale oscillation. Cluster Autoscaler يضيف nodes حسب pending pods؛ لا يعني أن كل workload يمكنه التوسع بلا حدود.

Stateful workloads تحتاج PersistentVolume/PersistentVolumeClaim و StorageClass، مع فهم access modes و backup/restore و zone topology. لا تخزن durable uploads داخل Pod filesystem. Database غالبًا managed service خارج cluster أبسط وأكثر أمانًا لفريق صغير، إلا إذا توجد متطلبات تشغيلية قوية لاستضافتها داخليًا.

09

Persistent Volumes و StatefulSets

Do not treat Pods as durable storage
Deep dive

PersistentVolume/Claim يربط workload storage عبر lifecycle مختلف عن Pod. StorageClass تحدد dynamic provisioning. StatefulSet يوفر stable network identity و ordered deployment/storage claims لتطبيقات تحتاج identity ثابتة، لكنه لا يحول database إلى highly available solution تلقائيًا. غالبًا managed database service أبسط وأأمن من تشغيل SQL Server/PostgreSQL بنفسك داخل cluster.

لو تشغل stateful database على Kubernetes، تحتاج backup/restore، replication، failover, storage performance, anti-affinity, disruption budgets, upgrades, encryption, monitoring و operator maturity. لا تضع database في Deployment عادي مع ephemeral filesystem.

10

Helm و Kustomize و Environment Overlays

Package and parameterize Kubernetes manifests
Practical

Helm packages resources في charts مع values/templates، و Kustomize يطبق overlays/patches على base manifests. اختَر واحدًا أو استخدمهما بوضوح؛ لا تجعل templates معقدة لدرجة أن rendered YAML غير مفهوم. احتفظ ب base configuration، واستخدم values لكل environment من غير نسخ ملفات كاملة متضاربة.

Secrets لا تضعها plain text في Helm values أو Git. استخدم external secret manager أو encrypted secrets workflow. راجع rendered manifests قبل apply، وتحقق من image digest و RBAC و network policies/probes/resources.

11

Terraform Fundamentals: Providers و Resources و State

Describe cloud infrastructure as code
Deep dive

Terraform يصف desired infrastructure declaratively. Provider يتكلم مع API مثل AzureRM أو Google أو AWS. Resource يدير object، Data Source يقرأ existing object، Variable parameterizes module، Output يعرض value، Module يجمع reusable configuration. terraform init يهيئ providers/backend، plan يعرض proposed changes، apply ينفذ، destroy يحذف resources managed by state.

Terraform state يربط configuration بالموارد الفعلية ويحتفظ attributes/IDs. State قد يحتوي secrets أو sensitive metadata؛ لا ترفعه إلى Git. استخدم remote backend مع encryption, access control, versioning و state locking حيث backend يدعمها. لا تعدل state file يدويًا إلا بإجراءات مدروسة.

TerraformTerraform: provider and a small Azure resource sketch
terraform {
  required_version = ">= 1.6.0"
  required_providers {
    azurerm = {
      source  = "hashicorp/azurerm"
      version = "~> 4.0"
    }
  }
}

provider "azurerm" {
  features {}
}

resource "azurerm_resource_group" "app" {
  name     = "rg-myshop-dev"
  location = "West Europe"
}

output "resource_group_name" {
  value = azurerm_resource_group.app.name
}

الـ provider version constraint مثال؛ راجع latest provider docs و lockfile. terraform.lock.hcl يثبت provider selections/checksums، بينما state يخزن mapping لل resources. لا تخلط بين lockfile و state.

12

Plan و Apply و Drift و Import

Review changes before mutating infrastructure
Deep dive

Workflow آمن: format/validate، init، plan محفوظ، review، apply نفس plan artifact في controlled pipeline. terraform plan قد يكشف replacement/deletion بسبب immutable attributes أو drift. اقرأ output بعناية؛ لا تعمل apply blindly. terraform refresh semantics تطورت في versions الحديثة؛ عادة plan يقرأ remote state ويكشف drift. استخدم import blocks أو terraform import لإدارة resources موجودة بدل إنشاء duplicate.

BashTerraform review workflow
terraform fmt -check -recursive
terraform init -upgrade=false
terraform validate
terraform plan -out=tfplan
terraform show tfplan
# Apply the reviewed plan only after approval:
terraform apply tfplan

لا تستخدم -auto-approve في production من غير policy/approval gate. -target أداة troubleshooting وليس routine deployment لأنه قد ينتج partial state. لو apply فشل في منتصف العملية، راجع state/remote resources قبل إعادة التشغيل. لا تحذف state lock يدويًا إلا بعد التأكد أن لا عملية apply شغالة.

IaC Change Runbook: Plan ثم Apply ثم Verify

قبل apply: تأكد من workspace/backend الصحيح، credentials والـ subscription/project، plan diff، destructive replacements، cost impact، dependencies، maintenance window، rollback/recovery. terraform plan لا يضمن أن cloud API ستقبل العملية أو أن الخدمة ستعمل؛ هو توقع للتغيير بناءً على state وال provider. بعد apply افحص outputs، health، logs، network reachability، drift، billing.

BashTerraform safe workflow
terraform fmt -check -recursive
terraform init -backend-config=prod.backend.hcl
terraform validate
terraform plan -out=tfplan
terraform show tfplan
# Human approval gate happens here.
terraform apply tfplan
terraform output

لا تحفظ plan file في مكان عام؛ قد يحتوي قيمًا حساسة. لا تشغل apply من laptop غير مضبوط على backend الصحيح. عند فشل apply لا تعِد المحاولة عشوائيًا؛ افحص partial changes و state lock والـ cloud console/API. وثّق import/move/state migration قبل تعديل resource addresses.

13

Terraform Modules و Remote State و Environments

Reuse without hiding infrastructure
Deep dive

Module reusable interface من inputs/outputs، ويجب يكون لها responsibility واضحة. لا تبني module عامة لكل Azure service منذ البداية. استخدم modules لل patterns المتكررة ذات standards مستقرة. افصل root modules لكل environment أو stack حسب blast radius، وشارك modules versioned. لا تجعل module واحدة تدير كل resources في الشركة.

Remote state backend يدير state centrally مع locking/versioning حسب provider. Workspaces ليست دائمًا أفضل طريقة لفصل production عن dev؛ separate backend keys/projects/subscriptions/accounts غالبًا توفر isolation أوضح. لا تعتمد على state outputs لنقل secrets بين teams؛ استخدم secret manager/secure data channel.

Terraform State و Drift و Secrets: لا تتعامل معها كملفات عادية

Terraform state يربط resource address في configuration بالـ real object في cloud. لا تعدّل JSON يدويًا ولا تضع state في Git. استخدم remote backend يدعم locking و encryption و access control، وافصل state بين environments أو stacks حسب blast radius. state قد يحتوي values حساسة حتى لو ظهرت في output مخفي.

TerraformTerraform remote state example (backend depends on platform)
terraform {
  required_version = ">= 1.6.0"
  required_providers {
    azurerm = {
      source  = "hashicorp/azurerm"
      version = "~> 4.0"
    }
  }
  backend "azurerm" {
    resource_group_name  = "tf-state-rg"
    storage_account_name = "companytfstate"
    container_name       = "tfstate"
    key                  = "production/platform.tfstate"
  }
}

backend block أعلاه مثال توضيحي؛ إنشاء storage account وتهيئة authentication يسبقان init، والـ backend configuration قد تُمرر جزئيًا عبر ملف آمن أو CI variables. لا تخزن client secret في الملف. استخدم workload identity/OIDC حيث متاح. راجع plan قبل apply، واحمِ production approval، ولا تشارك state lock بين عمليات متزامنة غير منسقة.

Drift يعني اختلاف الواقع عن configuration/state. شغّل plan دوريًا، لكن لا تطبق تلقائيًا على production من غير فهم سبب التغيير اليدوي. import يربط resource موجودًا بالـ state؛ بعده يجب أن تصف configuration الواقع المراد إدارته. terraform destroy خطر؛ استخدم environment gates و least privilege و policy checks وتأكد من workspace/backend قبل أي apply.

Terraform State و Modules و Environment Isolation

Terraform state تربط resource addresses بالموارد الحقيقية؛ فقدانها أو تعديلها يدويًا قد يؤدي إلى duplicate resources أو destroy غير متوقع. استخدم remote backend يدعم locking/versioning/encryption، ولا ترفع state إلى Git لأنها قد تحتوي secrets. افصل state بين environments، وامنح CI identity صلاحيات محدودة.

Module جيد يعبّر عن capability متماسكة بمدخلات ومخرجات واضحة، لا wrapper لكل resource. ثبّت provider/module versions، واستخدم terraform fmt و validate و plan في CI، وراجع plan بشريًا قبل apply. لا تنفذ apply تلقائيًا من كل branch. drift detection مهم لأن console changes قد تجعل الواقع يختلف عن code.

TerraformReusable Terraform module call
module "api_service" {
  source  = "./modules/container-app"
  name    = "shop-api-${var.environment}"
  image   = var.api_image_digest
  ingress = var.environment == "prod"

  tags = {
    environment = var.environment
    owner       = "commerce-platform"
  }
}

لا تستخدم var.api_image_digest إلا إذا كانت القيمة immutable digest، لا floating tag. راجع module source و version pinning. Secrets لا تمررها ك plain variables إن كانت ستظهر في plan/state؛ استخدم secret references أو provider-native secret resources مع فهم state exposure.

Terraform Remote State و Drift و Secrets

Terraform state يربط الموارد التي أنشأها Terraform بالـ real infrastructure IDs والـ attributes. لو كل developer عنده local state مستقل قد يحدث تعارض أو resource duplication. استخدم remote backend يدعم locking/versioning وحدد ownership واضحًا لكل state.

TerraformRemote backend concept — Azure Storage
terraform {
  backend "azurerm" {
    resource_group_name  = "rg-tfstate"
    storage_account_name = "companytfstate"
    container_name       = "tfstate"
    key                  = "myshop/prod.tfstate"
  }
}
# Supply backend credentials through CI identity/environment,
# never as literals committed to source control.

شغّل terraform fmt -check و terraform validate ثم terraform plan في Pull Request. احتفظ بالـ plan artifact بصلاحيات محدودة لأنه قد يحتوي sensitive values. لا تطبق plan قديمًا بعد تغيّر state؛ أعد plan.

Drift: اختلاف الواقع عن configuration/state المتوقع. استخدم plan دوريًا لاكتشافه، وحدد هل التغيير اليدوي مقصود فيُستوعب في code أم غير مصرح به فيُعاد تطبيق الحالة المطلوبة بعد التحقيق. لا تشغّل apply -auto-approve على كل commit في production.

Secrets: لا تضع passwords أو API keys في literals أو tfvars committed. sensitive = true يخفي العرض في بعض المخرجات لكنه لا يمنع بالضرورة تخزين القيمة في state. استخدم managed identity/workload identity و secret manager، وقيّد قراءة state مع encryption/access control/audit/backups.

عند تبني resource موجود استخدم import workflow ثم راجع plan. وعند نقل resource بين modules استخدم moved block أو terraform state mv بخطة واضحة لتجنب destroy/create غير مقصود. لا تحذف state file يدويًا لحل drift.

14

IaC Security و Policy as Code

Infrastructure changes are code changes
Deep dive

راجع Terraform plan كـ code review: public IPs، open firewall rules، wildcard IAM، unencrypted storage، missing backups، no diagnostics، overly broad service principals، deletion/replacement. استخدم policy checks (OPA/Sentinel/provider policies) و static scanners. لا تضع secret literals في .tf أو .tfvars committed؛ حتى sensitive = true يخفي CLI output لكنه لا يمنع القيمة من الظهور في state.

استخدم short-lived cloud credentials عبر OIDC federation في CI، و least privilege على target scope. افصل plan permissions عن apply permissions حسب workflow. راقب drift بين Terraform state وال portal manual changes؛ التعديل اليدوي قد يخلق drift ويُستبدل في apply لاحق.

GitOps و Policy as Code

GitOps يجعل Git المصدر المعلن للحالة، و controller يراقب الفرق ويطبق desired state. الفائدة: audit/review/reconciliation؛ الخطر: secret leakage أو auto-sync لتغيير غير مراجع أو drift غير مفهوم. افصل repositories/paths أو permissions للـ production، واستخدم promotion workflow. لا تضع plaintext secrets في Git؛ استخدم external secret integration أو sealed/encrypted mechanism موثوقًا.

Policy as Code يفرض guardrails مثل منع privileged pods، image tags غير immutable، missing resource requests، أو public database exposure. ابدأ بسياسات تحمي مخاطر حقيقية، واختبرها في audit/warn mode قبل enforce لتجنب تعطيل deployments مشروعة. راقب policy exceptions مع owner و expiry.

15

Day-2 Operations: Upgrade و Backup و Disaster Recovery

Running the platform after the first deployment
Deep dive

Kubernetes يحتاج upgrades لل control plane/nodes، patching، certificate rotation، admission policies، quotas، resource governance، cluster autoscaler، logging/metrics/traces، network policy، image scanning، RBAC reviews و backup للـ cluster state/configuration. Managed control plane يقلل work لكنه لا يدير application operations بالكامل.

Terraform يحتاج provider upgrades، module versioning، state backup/locking، drift review، import/moved blocks عند refactor، plan review و recovery procedure. اختبر restore لل remote state backend. لا تغير resource addresses في module refactor من غير moved block/import plan حتى لا يعتقد Terraform أن resource يجب حذفها وإعادة إنشائها.

Kubernetes و Terraform: Day-2 Failure Drills

بعد نجاح أول deploy تبدأ المشاكل التشغيلية: Pod في CrashLoopBackOff، readiness لا تنجح، HPA لا يعمل، PVC ممتلئ، أو Terraform state lock عالق. لا تحذف الموارد أو state files كأول رد فعل؛ اجمع evidence وافهم ownership.

Kubernetes triage

BashPod and rollout diagnostics
kubectl get pods -n production -o wide
kubectl describe pod orders-api-7d9c -n production
kubectl logs orders-api-7d9c -n production --previous
kubectl get events -n production --sort-by=.lastTimestamp
kubectl rollout status deployment/orders-api -n production
kubectl rollout history deployment/orders-api -n production
kubectl top pods -n production
  • CrashLoopBackOff: افحص previous logs و exit code و startup config و secret mounts و OOMKilled.
  • Readiness failure: Pod لا تدخل Service endpoints؛ افحص dependency timeout والـ probe path/port و startup duration.
  • Liveness failure: restart متكرر قد يزيد outage؛ لا تجعل liveness تعتمد على database أو external provider.
  • Pending Pod: افحص scheduling events و resource requests و taints/affinity/PVC.
  • HPA لا scales: تحقق من metrics server و resource requests والـ target metric.

Terraform state recovery

State file يربط configuration بالموارد الحقيقية وقد يحتوي secrets. استخدم remote backend مع encryption و locking و access control. لو lock عالق، تحقق أولًا أن العملية السابقة انتهت فعلًا وأن لا يوجد apply نشط. لا تستخدم force-unlock إلا بعد التأكد من lock ID والمالك؛ force unlock أثناء apply آخر قد يفسد state.

BashTerraform safe inspection workflow
terraform init
terraform workspace show
terraform state list
terraform plan -out=tfplan
terraform show tfplan
terraform apply tfplan
terraform plan -refresh-only

راجع plan قبل apply، واحفظ artifact من plan وفق سياسة الوصول؛ plan قد يحتوي قيمًا حساسة. refresh-only يحدّث state لمطابقة الواقع ولا يعني إصلاح configuration drift. لا تعدّل state JSON يدويًا. استخدم import أو moved blocks أو state commands الموثقة مع backup وخطة مراجعة.

في بيئة staging فقط: اجعل readiness endpoint يفشل، قلل memory limit لتلاحظ OOM، ثم استرجع deployment revision. وفي Terraform جرّب تغييرًا يدويًا آمنًا على resource تجريبي، وشاهد drift في plan ثم أصلحه من source of truth. لا تنفذ هذه drills على production.
16

متى لا تستخدم Kubernetes أو Terraform؟

Avoid platform engineering as accidental complexity
Deep dive

لو تطبيق واحد بسيط و PaaS تديره بوضوح، Kubernetes قد يضيف cluster operations و RBAC/networking/Helm/on-call cost بلا فائدة. لو الموارد قليلة ومستقرة ويمكن provision يدويًا بأمان في prototype، Terraform قد يكون premature؛ لكن production repeatability/governance غالبًا تبرره. ابدأ بال requirements: scaling, portability, compliance, deployment topology, team skill, failure recovery, cost.

لا تستخدم Terraform لإدارة كل application runtime configuration أو secret rotation logic. ولا تستخدم Kubernetes Secret كـ replacement لكل secret manager. كل tool لها boundary. قلل عدد control planes التي يحتاج الفريق تشغيلها.

17

اختبر فهمك

Knowledge check
Practical
ما الفرق بين Pod و Deployment؟
Pod execution unit؛ Deployment controller يدير desired replicas و rollouts عبر ReplicaSets.
لماذا نحتاج Service؟
لأن Pod IPs ephemeral؛ Service تقدم stable network endpoint وتختار Pods عبر labels.
هل Kubernetes Secret مشفر تلقائيًا بمجرد Base64؟
لا؛ Base64 encoding ليس encryption. فعّل encryption at rest و RBAC أو استخدم external secret manager.
ما وظيفة HPA مقارنة بـ PDB؟
HPA يغير replica count حسب metrics؛ PDB يحد voluntary disruptions للحفاظ على availability.
ما الفرق بين Terraform state و lockfile؟
State يربط config بالموارد الحقيقية؛ lockfile يثبت provider versions/checksums.
هل terraform plan -out ثم apply يلغي الحاجة للمراجعة؟
لا؛ يجب مراجعة plan artifact قبل apply، خاصة deletions/replacements/permissions.
↗

المراجع والقراءة الإضافية

References & further reading

الدرس بيشرح الفكرة نفسها؛ الروابط دي للتحقق والتعمق والرجوع لتفاصيل الـ API. (محتاجة إنترنت.)

خريطة التغطية: 7 عنصر من الـ Roadmap ومكان شرحه في الدرس
RoadmapContainer Orchestration Concepts§01
RoadmapKubernetes Pods and Deployments§03
RoadmapServices and Configuration§03
RoadmapScaling Fundamentals§03
RoadmapInfrastructure as Code§03
RoadmapTerraform Fundamentals§03
RoadmapCloud Resource Provisioning§03

خلصت الدرس وحليت الأسئلة؟ علّم عليه عشان يتحسب في تقدّمك.

محتويات الدرس