RDS - Gorbit Documentation

يوفر استخدام AWS RDS قاعدة بيانات PostgreSQL مُدارة لـ Gorbit. يغطي هذا الدليل المصادقة الأساسية ومصادقة IAM للأمان المحسّن.

الدليل

إنشاء مثيل PostgreSQL RDS

انتقل إلى وحدة تحكم Amazon RDS وأنشئ قاعدة بيانات PostgreSQL جديدة.

انقر Create database
اختر PostgreSQL كنوع المحرك
اختر Standard create كطريقة إنشاء
اختر إصدار PostgreSQL المفضل لديك
اختر قالب Production أو Dev/Test حسب الحاجة

تكوين إعدادات قاعدة البيانات

قم بإعداد معرف قاعدة البيانات وبيانات الاعتماد وتكوين المثيل.الإعدادات:

اضبط DB instance identifier وصفياً مثل gorbit-prod-db
اضبط Master username (مثلاً، postgres)
اضبط Master password قويًا وأكده

تكوين المثيل:

اختر Instance class مناسب (مثلاً، db.t3.micro للاختبار، db.t3.medium للإنتاج)
قم بتكوين حجم Storage وفعّل التوسع التلقائي إذا لزم الأمر

احفظ بيانات اعتماد قاعدة البيانات بشكل آمن - ستحتاجها لتكوين Gorbit.

تكوين الاتصال والأمان

قم بإعداد الوصول إلى الشبكة ومجموعات الأمان لقاعدة البيانات.

اختر VPC و Subnet group
قم بتكوين VPC security group للسماح بالوصول من مثيل Gorbit الخاص بك
اضبط Public access على “No” للإنتاج (موصى به)
اختر Availability Zone المفضل لديك

انقر Create database لتشغيل مثيل RDS.

تكوين متغيرات بيئة Gorbit

بمجرد تشغيل مثيل RDS، قم بتكوين Gorbit للاتصال به.احصل على تفاصيل قاعدة البيانات من وحدة تحكم RDS:

Endpoint: موجود في تفاصيل مثيل RDS
Port: عادةً 5432
Database name: اسم قاعدة البيانات أو postgres إذا كنت تستخدم الافتراضي

لنشر Docker، أضف هذه المتغيرات إلى ملف .env:

USE_IAM_AUTH=false
POSTGRES_HOST=<your-rds-endpoint>
POSTGRES_PORT=5432
POSTGRES_DB=<your-database-name>
POSTGRES_USER=<your-master-username>
POSTGRES_PASSWORD=<your-master-password>

لنشر EKS، أضف هذه إلى ملف values.yaml:

auth:
  secrets:
    POSTGRES_PASSWORD: "<your-master-password>"
configMap:
  USE_IAM_AUTH: "false"
  POSTGRES_HOST: "<your-rds-endpoint>"
  POSTGRES_PORT: "5432"
  POSTGRES_DB: "<your-database-name>"
  POSTGRES_USER: "<your-master-username>"

سيتصل Gorbit الآن بمثيل PostgreSQL RDS باستخدام بيانات الاعتماد هذه.

اختياري: تفعيل مصادقة IAM

للأمان المحسّن، يمكنك تفعيل مصادقة قاعدة بيانات IAM بدلاً من استخدام كلمات مرور ثابتة. يتيح هذا لـ Gorbit الاتصال باستخدام بيانات اعتماد IAM قصيرة العمر.

تفعيل مصادقة IAM على RDS

انتقل إلى مثيل RDS في وحدة تحكم AWS وفعل مصادقة IAM.

اذهب إلى مثيل PostgreSQL RDS
انقر Modify
تحت Database authentication، فعّل IAM database authentication
انقر Continue، ثم Apply immediately

إنشاء مستخدم قاعدة بيانات IAM

اتصل بقاعدة البيانات وأنشئ مستخدمًا لمصادقة IAM.باستخدام بيانات الاعتماد الرئيسية، قم بتشغيل أوامر SQL هذه:

CREATE ROLE gorbituser LOGIN;
GRANT rds_iam TO gorbituser;
ALTER ROLE gorbituser WITH NOINHERIT;
GRANT CREATE ON DATABASE <your-db-name> TO gorbituser;
GRANT USAGE ON SCHEMA public TO gorbituser;
GRANT CREATE ON SCHEMA public TO gorbituser;

تكوين سياسة IAM

أنشئ سياسة IAM للسماح باتصالات قاعدة البيانات.احصل على DbiResourceId أو DbClusterResourceId:

aws rds describe-db-instances \
  --db-instance-identifier <your-db-instance-name> \
  --region <your-region>

أنشئ سياسة IAM هذه، املأ region و account-id و resource-id، وأرفقها بدور مثيل EC2:

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": "rds-db:connect",
      "Resource": "arn:aws:rds-db:<region>:<account-id>:dbuser:<resource-id>/gorbituser"
    }
  ]
}

تحميل شهادة SSL

حمّل حزمة شهادة CA لـ RDS للاتصالات الآمنة.

wget https://s3.amazonaws.com/rds-downloads/rds-combined-ca-bundle.pem

شهادة SSL مطلوبة لكي تعمل مصادقة IAM بشكل صحيح.

تكوين Gorbit لمصادقة IAM

حدّث متغيرات البيئة لاستخدام مصادقة IAM.لنشر Docker، أضف هذه المتغيرات إلى ملف .env:

USE_IAM_AUTH=true
AWS_REGION=<your-region>
POSTGRES_HOST=<your-rds-endpoint>
POSTGRES_PORT=5432
POSTGRES_DB=<your-database-name>
POSTGRES_USER=gorbituser

ثبت شهادة SSL في ملف docker-compose.yml:

docker-compose-prod.yml

services:
  api_server:
    volumes:
      - ./rds-combined-ca-bundle.pem:/app/bundle.pem:ro

لنشر Kubernetes، أضف هذه إلى ملف values.yaml:

configMap:
  USE_IAM_AUTH: "true"
  AWS_REGION: "<your-region>"
  POSTGRES_HOST: "<your-rds-endpoint>"
  POSTGRES_PORT: "5432"
  POSTGRES_DB: "<your-database-name>"
  POSTGRES_USER: "gorbituser"

أنشئ سر لشهادة SSL وثبتها:

kubectl create secret generic bundle-pem-secret --from-file=rds-combined-ca-bundle.pem

بعد ذلك، سنثبت الشهادة في جميع حاوياتنا في ملف values.yaml.انتقل عبر كل حاوية واستبدل volumes و volumeMounts الفارغة بالتالي:

volumes:
- name: rds-ca
    secret:
      secretName: bundle-pem-secret

volumeMounts:
  - name: rds-ca
    mountPath: "/app/bundle.pem"
    subPath: bundle.pem
    readOnly: true

إعادة تشغيل Gorbit

أعِد تشغيل مثيل Gorbit لتطبيق التغييرات.

Docker

docker compose -f docker-compose.dev.yml -p gorbit-stack up -d --build --force-recreate

kubectl

kubectl rollout restart deployment

لمزيد من التفاصيل، راجع وثائق مصادقة IAM لـ AWS RDS.

​الدليل

​اختياري: تفعيل مصادقة IAM

الدليل

اختياري: تفعيل مصادقة IAM