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

Google Cloud للمطور .NET: مقارنة عملية وفهم الخدمات الأساسية

Google Cloud Platform — Practical Overview for .NET Developers

Projects/IAM/service accounts/Cloud Run services-jobs-worker pools/Cloud SQL/Cloud Storage/Secret Manager/PubSub/Artifact Registry/Cloud Build/Monitoring/VPC/cost and Azure comparison.

  • Advanced
  • ~15 min read
  • 14 sections
  • 6 code examples
  • 1 diagrams
  • 5 questions
  • Priority L3 · Optional
  • Google Cloud Platform · Cloud Run · gcloud CLI

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

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

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

BASICSDo not learn Azure and GCP deeply at the same time initially.

01

ليه تدرس GCP وأنت ‎.NET Developer؟

Learn the cloud concepts, then map the provider services
Deep dive

الهدف مش حفظ أسماء كل Google Cloud product. المطلوب تفهم cloud primitives وتعرف تقارن provider choices: compute، identity، network، storage، relational/NoSQL data، messaging، secrets، observability، deployment و cost. نفس application architecture تقدر تعمل لها mapping على Azure أو GCP أو AWS، لكن تفاصيل identity/network/scaling/billing تختلف.

لو شغلك الأساسي Azure/‎.NET، خلي GCP awareness عملية: اعرف Cloud Run و Cloud SQL و Cloud Storage و Secret Manager و Pub/Sub و Artifact Registry و Cloud Build و Cloud Monitoring. جرب deploy container بسيط، ثم افهم IAM و service identity و logging. لا تتعلم كل service بعمق قبل وجود workload يحتاجها.

02

Projects و Billing و IAM

Project boundaries and least privilege
Deep dive

Google Cloud resource hierarchy عادة Organization → Folders → Projects → Resources. Project يجمع APIs/resources/IAM/billing linkage. Service account هو identity للـ workload، وليس user account لشخص. امنح كل service account أقل roles لازمة وعلى resource scope مناسب. تجنب Project Editor/Owner لكل runtime service؛ استخدم roles محددة مثل Storage Object Viewer أو Pub/Sub Subscriber عند الحاجة.

افصل deployer identity عن runtime service identity. الأولى تنشر وتدير resource؛ الثانية يستخدمها التطبيق للوصول إلى Google APIs أثناء التشغيل. Cloud Run يدعم service identity و Application Default Credentials (ADC)؛ client libraries تستطيع اكتشاف credentials من metadata environment. لا تضع service-account JSON key داخل container أو GitHub repo إذا كان Workload Identity Federation متاحًا.

Bashgcloud: choose project and inspect identity context
gcloud auth login
gcloud projects list
gcloud config set project YOUR_PROJECT_ID
gcloud config list
gcloud services list --enabled

الأوامر تتطلب gcloud CLI وصلاحيات مناسبة. تأكد من project ID قبل أي create/delete، لأن project selection في CLI قد يختلف عن project الظاهر في Console tab آخر.

GCP IAM و Service Accounts و Secret Manager

كل service تعمل بهوية service account مخصصة، وبأقل roles على الموارد المطلوبة. لا تستخدم default compute identity بصلاحيات واسعة ولا تنزّل JSON key file وتضعها داخل image. في بيئة Google Cloud استخدم attached service account/Application Default Credentials، وفي CI استخدم Workload Identity Federation بدل static service account keys حيث ممكن.

Secret Manager يخزن القيم السرية مع IAM و versioning و audit logs. امنح التطبيق secretAccessor على secret المحددة لا على كل المشروع. خطط لل rotation وتحديث runtime؛ لا تطبع secret في logs أو exceptions. فرّق بين configuration العامة و secret material، ولا تجعل كل config يمر عبر secret manager بلا داعٍ.

03

Cloud Run: Services و Jobs و Worker Pools

Serverless container platform
Deep dive

Cloud Run منصة managed لتشغيل containers. Service تتلقى HTTP/gRPC requests وتملك HTTPS endpoint وتعمل autoscale، ويمكن أن scale to zero حسب configuration/billing. Job تشغل task حتى completion، يدويًا أو بجدولة/Workflow. Worker pool مناسبة workloads pull-based أو long-running workers، وخصائص scaling مختلفة عن service. لا تخلط API service مع background consumer بلا فهم lifecycle.

Cloud Run instances disposable: filesystem writable overlay لا يعتبر persistent storage، وقد يتم إنهاء instance عند scale-in. احفظ data في Cloud SQL/Cloud Storage/Firestore أو external storage. تعامل مع SIGTERM gracefully، ولا تحتفظ state مهمة في memory بين requests. لو تحتاج always-on/min instances، قيّم cold start مقابل cost.

BashDeploy a .NET container to Cloud Run
gcloud run deploy myshop-api \
  --image us-central1-docker.pkg.dev/PROJECT_ID/apps/myshop-api:1.0.0 \
  --region us-central1 \
  --port 8080 \
  --service-account myshop-runtime@PROJECT_ID.iam.gserviceaccount.com

الأمر مثال؛ لازم image موجودة في Artifact Registry، والـ service account موجودة ولها roles، والـ API تستمع على port المحدد. لا تضف --allow-unauthenticated إلا لو endpoint public مقصود. لو API تحتاج internal access فقط، اضبط ingress و IAM policy بدل فتحها للعالم.

Cloud Run يدعم traffic splitting عبر revisions، ويمكنك نشر revision جديدة ثم توزيع traffic تدريجيًا. اختبر readiness/startup behavior، min/max instances، concurrency per instance، CPU/memory، request timeout و startup latency. رفع concurrency قد يحسن utilization لكنه يضغط على DbContext/connection pool و memory لو التطبيق غير مستعد.

Cloud Run لـ ASP.NET Core: Container Contract و Scaling

Cloud Run يشغل container كـ service أو job. الخدمة تستقبل HTTP وتُوسّع instances وفق concurrency/traffic configuration؛ job مناسبة لعمل ينفذ ثم ينتهي، لا لخادم ينتظر requests. التطبيق يجب أن يستمع على port الذي توفره المنصة عبر PORT environment variable، وأن يعمل non-root عند استخدام image مناسبة، وأن يتعامل مع termination والـ statelessness.

حدد concurrency بناءً على طبيعة API: CPU-bound endpoints قد تحتاج concurrency أقل، و I/O-bound endpoints قد تستفيد من قيمة أعلى بشرط connection pools و SQL capacity. max instances تحمي downstream database من انفجار الاتصالات، و min instances تقلل cold starts لكنها ترفع التكلفة. لا تضبط concurrency و max instances دون load test ومراقبة latency.

Cloud Run filesystem مؤقت؛ لا تحفظ uploads أو state عليه. استخدم Cloud Storage و Cloud SQL و Secret Manager. Cloud SQL connection strategy يجب أن تراعي connection limits و pooling؛ زيادة instances قد تفتح اتصالات كثيرة. استخدم Cloud SQL connector أو اتصال private IP حسب network design وإرشادات المنصة الحالية.

Cloud Run: تشغيل API و Worker Containers

Cloud Run مناسب لخدمات HTTP أو jobs/worker patterns المدعومة عندما تريد تشغيل container دون إدارة VM أو Kubernetes cluster. التطبيق يجب يستمع على port الذي توفره البيئة (PORT غالبًا)، ويستجيب بسرعة لبدء التشغيل، ويتعامل مع scale-to-zero و concurrency و termination signals. لا تفترض أن instance واحدة دائمة أو أن local filesystem تخزين دائم.

اختَر concurrency بناءً على طبيعة العمل: API I/O-bound قد تتحمل requests متزامنة أكثر، أما CPU-heavy inference أو عمليات memory-heavy فتحتاج concurrency أقل و instance size مناسب. اختبر cold start و startup time و max instances. ضع maximum instances لحماية قاعدة البيانات من connection storm عند burst traffic.

DockerfileContainer listens on Cloud Run provided port
FROM mcr.microsoft.com/dotnet/aspnet:8.0
WORKDIR /app
COPY ./publish/ .
ENV ASPNETCORE_URLS=http://0.0.0.0:8080
USER $APP_UID
ENTRYPOINT ["dotnet", "MyApi.dll"]

لو تستخدم PORT dynamic، اقرأه من environment واربط Kestrel به بدل hard-coded port، وتأكد من توافق إعدادات container/service. Cloud Run service و Cloud Run Job لهما execution models مختلفة؛ لا تشغل long-running daemon كأنه HTTP service دون مراجعة limits والـ request lifecycle.

04

Cloud SQL و Cloud Storage

Managed relational database and object storage
Deep dive

Cloud SQL يدير MySQL/PostgreSQL/SQL Server instances مع backup/HA/network connectivity options حسب edition/configuration. أنت مسؤول عن schema/index/query tuning، IAM/network configuration، backup retention، restore tests، connection budget و database migrations. Serverless compute scale-out قد يضاعف concurrent DB connections؛ استخدم connection pool limits و Cloud SQL connectors/proxy patterns حسب environment.

Cloud Storage object storage مناسب uploads/documents/media/backups. استخدم bucket-level IAM، uniform bucket-level access، lifecycle policies، retention/versioning عند الحاجة، encryption و signed URLs قصيرة العمر. لا تجعل bucket public افتراضيًا. local filesystem داخل Cloud Run لا يحفظ data عند instance termination.

Cloud SQL و Pub/Sub: الاتصالات والـ At-Least-Once Delivery

Cloud SQL يقدم managed relational database لكن التطبيق ما زال مسؤولًا عن pooling و timeouts و migrations و backup verification. استخدم connector/proxy أو private IP وفق network model. ضع connection budget لكل replica؛ autoscaling قد يفتح اتصالات أكثر من الحد. لا ترفع max pool size دون حساب إجمالي instances والـ database limit.

Pub/Sub غالبًا يوفر at-least-once delivery؛ duplicate messages متوقعة، وقد يصل message أكثر من مرة أو out of order حسب الإعداد. Consumer يجب يكون idempotent، ويستخدم message ID أو business key مع durable deduplication. Ack بعد نجاح side effect الدائم، واضبط retry/dead-letter policy و monitor backlog/oldest unacked age.

TextPub/Sub consumer reliability flow
Receive message
  -> validate schema and version
  -> begin database transaction
  -> insert inbox row with unique message ID
  -> if already exists: commit/no-op
  -> apply business state change
  -> commit
  -> acknowledge message

Transient failure -> retry with bounded policy
Poison message -> dead-letter topic + operator alert
05

Secret Manager و Runtime Configuration

Store secrets outside images and repositories
Deep dive

Secret Manager يخزن secrets بإصدارات و IAM controls و audit logs. أعطِ runtime service account access إلى secret محدد فقط. لا تضع service-account key أو DB password في Dockerfile/env baked into image. Runtime environment variables يمكن أن تكون مناسبة لل configuration، لكنها ليست secret vault بذاتها. افهم secret version pinning vs latest alias، rotation، caching و refresh behavior.

عند rotation، خطط overlap بين credential القديم والجديد، وتأكد أن app instances تلتقط القيمة الجديدة. لا تطبع secret أثناء startup أو diagnostics. استخدم secret access audit logs و alerting على unusual reads/denials.

06

Pub/Sub و Cloud Tasks

Asynchronous messaging and task delivery
Deep dive

Pub/Sub messaging service لنشر messages إلى topics ثم subscriptions، مع push/pull delivery semantics. Cloud Tasks مناسب dispatch task إلى HTTP endpoint مع scheduling/retry/rate controls. الاختيار يعتمد على fan-out/event streaming vs targeted task invocation. لا تفترض exactly-once business effect؛ consumers يجب أن تكون idempotent، وتتعامل مع duplicate delivery و ack deadline و dead-letter strategy.

في ‎.NET، افصل message contract عن EF entity، version schema، trace/correlation ID، و tenant/security context. Outbox يحفظ event intent مع DB transaction، publisher ينشر إلى Pub/Sub، consumer يطبق inbox/dedup. لا تجعل message تحتوي secrets أو بيانات أكثر مما يحتاج consumer.

GCP IAM و Pub/Sub و Cloud Tasks: فرق الرسالة عن المهمة

GCP Project هو boundary للفوترة والموارد و IAM policies. Service Account هو هوية workload؛ أعطه roles ضيقة على resource المحدد، ولا تستخدم Owner أو Editor في runtime. افصل deploy identity عن runtime identity، وفضّل Workload Identity Federation في CI بدل service account key JSON طويل العمر.

Pub/Sub مناسب event messaging و fan-out؛ Cloud Tasks مناسب dispatch لعمل HTTP task مع schedule/retry/rate control. كلاهما قد يكرر delivery، لذلك consumer يجب أن يكون idempotent. لا تفترض exactly-once business effect لمجرد اختيار broker؛ صمم deduplication key و ack semantics و dead-letter handling و retry limits.

اختبر IAM من service account الفعلية، لا من حسابك الشخصي الذي يملك صلاحيات واسعة. راقب subscription backlog و oldest unacked message و delivery attempts، وضع DLQ workflow لإصلاح الرسائل وإعادة تشغيلها بأمان. لا تعِد نشر رسالة poison إلى queue بلا حد.

07

Artifact Registry و Cloud Build

Build and store immutable artifacts
Practical

Artifact Registry يخزن container images/packages، و Cloud Build ينفذ build pipelines. استخدم immutable digest، tags مفهومة، vulnerability scanning، SBOM/provenance حيث متاح. اربط GitHub عبر Workload Identity Federation بدل static JSON key. نفس artifact الذي اختبرته يجب ترقيته بين environments.

YAMLCloud Build minimal container pipeline sketch
steps:
  - name: gcr.io/cloud-builders/docker
    args: ['build', '-t', 'us-central1-docker.pkg.dev/$PROJECT_ID/apps/api:$SHORT_SHA', '.']
  - name: gcr.io/cloud-builders/docker
    args: ['push', 'us-central1-docker.pkg.dev/$PROJECT_ID/apps/api:$SHORT_SHA']
images:
  - 'us-central1-docker.pkg.dev/$PROJECT_ID/apps/api:$SHORT_SHA'

الملف sketch ويحتاج Artifact Registry repository/IAM setup و build config وربط deploy stage. لا تستخدم $SHORT_SHA وحده كضمان immutability لو registry يسمح overwrite؛ سجل digest الناتج. افصل build permissions عن deploy permissions.

GCP Deployment و Rollback و Operational Checklist

ادفع image إلى Artifact Registry مع tag مرتبط بـ Git SHA، ثم انشر digest محددًا إلى Cloud Run. افصل service account الخاصة بالـ build عن runtime identity. استخدم revision traffic splitting لنشر تدريجي أو rollback إلى revision سابقة. بعد deployment راقب 5xx و latency و container startup و instance count و database connections.

قبل production: تحقق من IAM roles، secret access، VPC egress، Cloud SQL connections، min/max instances، concurrency، request timeout، CPU allocation، log retention، budgets، quotas، backup/restore، و alerting. لا تعتبر نجاح gcloud run deploy إثباتًا أن user journey تعمل؛ نفذ smoke test من مسار قريب من المستخدم.

08

VPC Networking و Cloud Logging/Monitoring

Private connectivity and operational signals
Deep dive

VPC networks/subnets/firewall rules/Private Service Connect أو Serverless VPC Access/Direct VPC egress حسب المنتج تحدد الاتصال بالموارد الخاصة. افهم ingress (من يدخل إلى الخدمة) و egress (إلى أين تتصل الخدمة). لا تفتح كل ingress/egress للعالم لمجرد حل connectivity error؛ حدد source/destination/port/protocol.

Cloud Logging يجمع logs ويتيح search/routing/retention، و Cloud Monitoring يجمع metrics/dashboards/alerts/synthetic uptime checks. استخدم structured JSON logs، trace IDs، resource labels، و SLIs مثل error rate و latency/queue backlog. راقب log ingestion cost و PII redaction. Alert يجب يكون actionable وله owner/runbook.

09

Azure ↔ GCP Mapping للمطور

Comparable concepts, different semantics
Deep dive
CapabilityAzure exampleGoogle Cloud exampleما الذي يجب مراجعته؟
Container PaaSAzure Container Apps / App ServiceCloud RunScale-to-zero, revisions, concurrency, ingress, jobs
Managed SQLAzure SQL / Azure Database for PostgreSQLCloud SQLEngine versions, HA, backups, network, connection limits
Object storageBlob StorageCloud StorageIAM, signed URLs, lifecycle, retention, redundancy
SecretsKey VaultSecret ManagerIdentity, versioning, rotation, audit
MessagingService Bus / Event HubsPub/Sub / Cloud TasksOrdering, retries, DLQ, duplicate delivery, throughput
Container registryAzure Container RegistryArtifact RegistryImage digest, auth, scanning, replication
ObservabilityAzure Monitor / App InsightsCloud Monitoring / LoggingTrace propagation, retention, pricing, alerting

لا تفترض equivalence 1:1. Cloud Run concurrency model مثلًا يختلف عن Container Apps replica settings؛ IAM role semantics تختلف؛ Cloud SQL connector behavior يختلف عن Azure SQL managed identity. قارن requirements وال failure behavior والتكلفة بدل مقارنة أسماء المنتجات.

10

Cost و Security Checklist

Prevent accidental exposure and surprise bills
Practical
  • حدد budgets/alerts، وراجع spend by project/service/label.
  • ضع min/max instances و request timeout و CPU/memory limits.
  • استخدم service account منفصلة لكل workload مع least privilege.
  • لا ترفع service-account JSON keys أو secrets إلى Git/Docker images.
  • اجعل ingress internal أو authenticated إذا كان endpoint خاصًا.
  • استخدم private networking للـ databases وال cache عند الحاجة.
  • راجع logs retention و metrics cardinality و egress cost.
  • اختبر backup restore و regional failure strategy.

Scale-to-zero يقلل idle compute لكنه قد يزيد cold start. Min instances تقلل cold start وتزيد cost. Egress و logging و managed database storage قد تشكل cost أكبر من compute؛ راقب الفاتورة الفعلية.

GCP Operations: Regions و Quotas و Cost Controls

اختَر region بناءً على latency للمستخدمين، data residency، service availability، price، والـ disaster recovery objectives. Multi-region لا يعني تلقائيًا high availability؛ data replication consistency و failover orchestration و DNS/client retry كلها مطلوبة. راجع quotas قبل launch، خصوصًا API rate limits و IP addresses و database connections.

استخدم labels للتكلفة حسب environment/team/service، budgets وتنبيهات، وراجع idle resources و log ingestion volume. اختبر restore و regional failover عمليًا؛ backup موجود لا يساوي recovery proven. وثّق RTO/RPO، واحتفظ بخطة rollback للـ deployment والـ schema.

11

Deploy كامل: ASP.NET Core على Cloud Run مع Cloud SQL و Secret Manager

End-to-end deployment walkthrough
Practical
GitHub ActionsWorkload Identity Fed.Artifact Registryimage@sha256Cloud Run serviceSA: shop-api@…min 1, max 20, concurrency 80Secret ManagerCloud SQL (Postgres)Cloud Logging / Trace
Cloud Run service with a dedicated service account, secrets from Secret Manager, Cloud SQL over the connector
Bashthe essential commands (names are examples)
gcloud iam service-accounts create shop-api --display-name="Shop API runtime"
gcloud secrets create db-password --replication-policy=automatic
printf '%s' "$DB_PASSWORD" | gcloud secrets versions add db-password --data-file=-
gcloud secrets add-iam-policy-binding db-password \
  --member="serviceAccount:shop-api@$PROJECT.iam.gserviceaccount.com" --role=roles/secretmanager.secretAccessor
gcloud projects add-iam-policy-binding $PROJECT \
  --member="serviceAccount:shop-api@$PROJECT.iam.gserviceaccount.com" --role=roles/cloudsql.client

gcloud run deploy shop-api \
  --image=$REGION-docker.pkg.dev/$PROJECT/apps/shop-api@$DIGEST \
  --service-account=shop-api@$PROJECT.iam.gserviceaccount.com \
  --add-cloudsql-instances=$PROJECT:$REGION:shop-db \
  --set-secrets=ConnectionStrings__DbPassword=db-password:latest \
  --min-instances=1 --max-instances=20 --concurrency=80 --cpu=1 --memory=512Mi \
  --region=$REGION --no-allow-unauthenticated
  • Service account مخصص بأقل صلاحيات، مش الـ default compute SA اللي غالبًا صلاحياته واسعة.
  • Image by digest مش :latest — نفس الـ bits اللي اتختبرت هي اللي اتعمل لها deploy.
  • min-instances=1 بيقلل cold starts للـ API التفاعلي مقابل تكلفة ثابتة؛ الـ workers ممكن تبقى 0.
  • الـ port: Cloud Run بيبعت PORT env var؛ ASP.NET Core container images الحديثة بتسمع على 8080 افتراضيًا، فاتأكد إنهم متطابقين (ASPNETCORE_HTTP_PORTS).
  • CI بدون مفاتيح: Workload Identity Federation من GitHub Actions بدل JSON key طويل العمر — نفس فكرة OIDC في CI/CD.
12

GCP والـ AI: Vertex AI بنظرة المطور

AI services on GCP
Basics

على GCP، الموديلات (Gemini وموديلات تانية في Model Garden) والـ embeddings والـ vector search متاحة عبر Vertex AI. من ‎.NET تقدر تستخدم الـ SDK الرسمي أو تعامله من خلال IChatClient abstraction (Microsoft.Extensions.AI) عشان كود التطبيق ما يتربطش بـ provider. نفس قرارات Azure AI: region للـ data residency، quotas للـ tokens/min، service account بصلاحية محددة، وتسجيل التكلفة لكل tenant. أسماء الموديلات والـ SDKs بتتغير بسرعة — راجع docs Vertex AI وقت التنفيذ (reviewed 2026-11-18).

الاحتياجAzureGCP
LLM مُدارAzure OpenAI / AI FoundryVertex AI (Gemini، Model Garden)
Vector/hybrid searchAzure AI SearchVertex AI Vector Search، أو AlloyDB/Cloud SQL + pgvector
Container serverlessContainer AppsCloud Run (يدعم GPUs في regions محددة)
QueueService BusPub/Sub، Cloud Tasks
13

أخطاء شائعة على GCP

Common mistakes
Basics
  • --allow-unauthenticated لخدمة داخلية ← endpoint عام على الإنترنت.
  • Service account keys (JSON) في الـ repo أو الـ CI secrets بدل workload identity.
  • Pub/Sub consumer مش idempotent — Pub/Sub at-least-once بيعيد الرسايل.
  • Connection pool كبير × max-instances كبير ← Cloud SQL يوصل لحد الـ connections. احسب: instances × pool size ≤ حد الـ DB.
  • مفيش budget alerts ← فاتورة مفاجئة من loop أو موديل غالي.
14

اختبر فهمك

Knowledge check
Practical
ما الفرق بين deployer identity و Cloud Run service identity؟
الأولى تنشر وتدير resource؛ الثانية runtime identity التي يستخدمها التطبيق للوصول إلى Google APIs.
هل Cloud Run filesystem persistent؟
لا؛ container filesystem disposable، استخدم Cloud Storage أو database/volume مناسب.
هل Pub/Sub يضمن business side effect مرة واحدة؟
لا؛ consumer idempotency و dedup/inbox ضرورية للتعامل مع duplicate delivery.
هل service account JSON key أفضل من ADC؟
لا؛ استخدم runtime service identity/ADC أو federation بدل static long-lived keys متى أمكن.
ما الفرق بين Cloud Run Service و Job؟
Service تتعامل مع requests/events عبر endpoint؛ Job تنفذ task حتى completion.
↗

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

References & further reading

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

خريطة التغطية: 12 عنصر من الـ Roadmap ومكان شرحه في الدرس
RoadmapProjects and Resources§01
RoadmapIAM§01
RoadmapCompute Options§02
RoadmapCloud Run§03
RoadmapDeployment Concepts§03
RoadmapCloud SQL§02
RoadmapCloud Storage§02
RoadmapSecret Manager§02
RoadmapLogging and Monitoring§02
RoadmapNetworking§03
RoadmapCost Management§04
RoadmapAzure vs GCP Common Concepts§01

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

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