ليه تدرس GCP وأنت .NET Developer؟
الهدف مش حفظ أسماء كل 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 يحتاجها.
Projects و Billing و IAM
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 متاحًا.
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 بلا داعٍ.
Cloud Run: Services و Jobs و Worker Pools
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.
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.
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.
Cloud SQL و Cloud Storage
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.
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 alertSecret Manager و Runtime Configuration
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.
Pub/Sub و Cloud Tasks
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 بلا حد.
Artifact Registry و Cloud Build
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.
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 من مسار قريب من المستخدم.
VPC Networking و Cloud Logging/Monitoring
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.
Azure ↔ GCP Mapping للمطور
| Capability | Azure example | Google Cloud example | ما الذي يجب مراجعته؟ |
|---|---|---|---|
| Container PaaS | Azure Container Apps / App Service | Cloud Run | Scale-to-zero, revisions, concurrency, ingress, jobs |
| Managed SQL | Azure SQL / Azure Database for PostgreSQL | Cloud SQL | Engine versions, HA, backups, network, connection limits |
| Object storage | Blob Storage | Cloud Storage | IAM, signed URLs, lifecycle, retention, redundancy |
| Secrets | Key Vault | Secret Manager | Identity, versioning, rotation, audit |
| Messaging | Service Bus / Event Hubs | Pub/Sub / Cloud Tasks | Ordering, retries, DLQ, duplicate delivery, throughput |
| Container registry | Azure Container Registry | Artifact Registry | Image digest, auth, scanning, replication |
| Observability | Azure Monitor / App Insights | Cloud Monitoring / Logging | Trace 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 والتكلفة بدل مقارنة أسماء المنتجات.
Cost و Security Checklist
- حدد 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.
Deploy كامل: ASP.NET Core على Cloud Run مع Cloud SQL و Secret Manager
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 بيبعت
PORTenv var؛ ASP.NET Core container images الحديثة بتسمع على 8080 افتراضيًا، فاتأكد إنهم متطابقين (ASPNETCORE_HTTP_PORTS). - CI بدون مفاتيح: Workload Identity Federation من GitHub Actions بدل JSON key طويل العمر — نفس فكرة OIDC في CI/CD.
GCP والـ AI: Vertex AI بنظرة المطور
على 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).
| الاحتياج | Azure | GCP |
|---|---|---|
| LLM مُدار | Azure OpenAI / AI Foundry | Vertex AI (Gemini، Model Garden) |
| Vector/hybrid search | Azure AI Search | Vertex AI Vector Search، أو AlloyDB/Cloud SQL + pgvector |
| Container serverless | Container Apps | Cloud Run (يدعم GPUs في regions محددة) |
| Queue | Service Bus | Pub/Sub، Cloud Tasks |
أخطاء شائعة على GCP
--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 أو موديل غالي.
اختبر فهمك
ما الفرق بين deployer identity و Cloud Run service identity؟
هل Cloud Run filesystem persistent؟
هل Pub/Sub يضمن business side effect مرة واحدة؟
هل service account JSON key أفضل من ADC؟
ما الفرق بين Cloud Run Service و Job؟
المراجع والقراءة الإضافية
الدرس بيشرح الفكرة نفسها؛ الروابط دي للتحقق والتعمق والرجوع لتفاصيل الـ API. (محتاجة إنترنت.)
التوثيق الرسمي — Official documentation
خريطة التغطية: 12 عنصر من الـ Roadmap ومكان شرحه في الدرس
خلصت الدرس وحليت الأسئلة؟ علّم عليه عشان يتحسب في تقدّمك.