مستند فنی پک PostgreSQL HA

helm repo add kubit-packs https://repo.sabz.dev/artifactory/kubit-packs

clusterName: <نام-کلاستر>
debug: <true|false>
image:
  repository: <آدرس-ریپازیتوری-ایمیج>
  tag: <نسخه-ایمیج>
superuserUsername: <نام-کاربر-سوپر یوزر>
superuserPassword: <رمز-عبور-سوپر یوزر>
# سایر پارامترهای مورد نیاز

kubectl create ns test-postgresql-ha || true
helm upgrade --install -n test-postgresql-ha my-postgresql-ha kubit-packs/postgresql-ha -f my-postgresql-ha.values.yaml

helm delete -n test-postgresql-ha my-postgresql-ha

apiVersion: k8s.kubit.ir/v1alpha1
kind: Pack
metadata:
  name: my-postgresql-ha
  namespace: test-postgresql-ha

spec:
  chart:
    repository:
      kind: ClusterPackRepository
      name: kubit-packs
    name: postgresql-ha
    version: ~=0.6.14

  values:
    clusterName: <نام-کلاستر>
    debug: <true|false>
    image: {}
    superuserUsername: <نام-کاربر-سوپر یوزر>
    superuserPassword: <رمز-عبور-سوپر یوزر>
    # سایر مقادیر لازم

kubectl create ns test-postgresql-ha || true
kubectl create -f my-postgresql-ha.pack.yaml

kubectl -n test-postgresql-ha delete pack my-postgresql-ha

image:
  tag: v0.17.0-pg13

mode: standalone

superuserUsername: postgres
superuserPassword: my-postgres-password
replicationUsername: replica
replicationPassword: my-replica-password

persistence:
  storageClassName: my-storage-class
  size: 5Gi

etcd:
  enabled: true

etcd:
  enabled: false # پیش‌فرض

store:
  backend: etcdv2 # پیش‌فرض
  endpoints: http://my-etcd-endpoint:port

global:
  commonImageRegistry: my-docker.io

databases:
  - database: my-database
    username: my-username
    password: my-password
    extensions:
      - my-extension-1
      - my-extension-2
    databaseCreationExtraArguments: my-arguments

mode: standby
replicationUsername: my-master-pg-replication-username
replicationPassword: my-master-pg-replication-password
standbyConfig:
  host: my-master-pg-host
  port: 5432

mode: standalone # پیش‌فرض

keeper:
  resources:
    requests:
      memory: 1Gi
      cpu: 100m
proxy:
  resources:
    requests:
      memory: 50Mi
      cpu: 50m
sentinel:
  resources:
    requests:
      memory: 10Mi
      cpu: 10m

postgresqlUpgrade:
  enabled: true
  oldVersion: 11
  newVersion: 13

postgresqlUpgrade:
  enabled: false # پیش‌فرض

adminer:
  enabled: true
  ingress:
    host: my-adminer.com
    secretName: my-secret-tls
  theme: pappu687 # پیش‌فرض

pgParameters:
  shared_buffers: '0.5GB' # نیم حافظه درخواست شده keeper
  log_checkpoints: 'on'
  log_lock_waits: 'on'
  checkpoint_completion_target: '0.9'
  min_wal_size: '2GB'
  shared_preload_libraries: 'pg_stat_statements'
  pg_stat_statements.track: 'all'

apiVersion: k8s.kubit.ir/v1alpha1
kind: Pack
metadata:
  name: my-postgresql-ha # نام این پکیج/چارت در کلاستر کوبرنتیز
  namespace: test-postgres-ha # فضای نام (namespace) که منابع در آن ساخته می‌شوند
spec:
  chart:
    repository:
      kind: ClusterPackRepository
      name: kubit-packs # نام ریپازیتوری چارت‌ها
    name: postgresql-ha # نام چارت مورد استفاده که PostgreSQL HA را فراهم می‌کند
    version: ~=0.6.0 # نسخه چارت، اینجا مشخص شده نسخه 0.6.x

  vars:
    DOCKER_REGISTRY: registry.s # رجیستری داکر سفارشی برای تصاویر (Docker registry)
    DATABASE_ROOT_PASSWORD: | # پسورد اصلی دیتابیس که رمزنگاری شده و به Vault ارجاع داده شده است
      $KUBIT_VAULT;1.2;AES256;pass
      3663663832383838623116130366432

  values:
    global:
      commonImageRegistry: '{{ vars.DOCKER_REGISTRY }}' # استفاده از متغیر رجیستری داکر به صورت سراسری

    image:
      tag: 16 # نسخه ایمیج postgres/stolon (Postgres 16)
      pullPolicy: Always # همیشه ایمیج جدید از رجیستری کشیده شود (مناسب برای توسعه و استیجینگ)

    # بخش Backup فعال شده و تنظیمات مرتبط:
    backup:
      enabled: true # فعال بودن مکانیزم بکاپ خودکار (CronJob)
      maxBackups: 7 # نگه داشتن 7 نسخه آخر بکاپ و حذف بقیه
      s3:
        existingSecret: postgresbackupcreds # استفاده از Secret موجود برای دسترسی به S3 (اعتبارنامه‌ها)

    # تنظیمات حجم ذخیره‌سازی و کلاس آن برای Persistent Volume:
    persistence:
      storageClassName: zfs-ssd # کلاس ذخیره‌سازی مورد استفاده (مثلا دیسک SSD با ZFS)
      size: 10Gi # حجم 10 گیگابایت برای فضای ذخیره‌سازی داده‌ها

    # اطلاعات دسترسی به دیتابیس:
    superuserUsername: postgres # نام کاربر superuser
    superuserPassword: '{{ vars.DATABASE_ROOT_PASSWORD }}' # رمز عبور کاربر اصلی (از Vault خوانده می‌شود)
    replicationUsername: postgres # کاربر کپی‌برداری (replication) که اغلب یکی است
    replicationPassword: '{{ vars.DATABASE_ROOT_PASSWORD }}' # رمز کپی‌برداری (معمولا همان root)

    # تعریف دیتابیس‌ها و کاربران مورد نیاز همراه با رمزنگاری پسوردها:
    databases:
      - database: db1
        username: user1
        password: |
          $KUBIT_VAULT;1.2;AES256;pass
          3339333933313633316437306661306233643934336163343862383037326338
          37343639626238323561316165383932303865373535313433653765616165623464

      - database: db2
        username: user2
        password: |
          $KUBIT_VAULT;1.2;AES256;pass
          33356165303238353562353766333831376135366138633230393661313366666630383261313332
          61356138636232353732646335643837616332376566633566343331386238
          6337333034636264633231353761393836623734643663386531

    # منابع درخواستی (Resource Requests) برای Keeper (پادهایی که پایگاه داده را نگهداری می‌کنند)
    keeper:
      resources:
        requests:
          memory: 300Mi # درخواست 300 مگابایت رم برای هر keeper
          cpu: 100m # درخواست 100 میلی‌هسته پردازنده

    # بخش مربوط به ذخیره‌سازی داده Stolon (backend برای کلاستر کردن)
    # استفاده از etcdv2 و آدرس سرویس etcd در کلاستر کوبرنتیز
    store:
      backend: etcdv2
      endpoints: http://stolon-etcd.svc.cluster.local:xxxx # آدرس سرویس etcd (port باید جایگزین شود)

    # پارامترهای postgres.conf سفارشی (بهینه سازی تنظیمات پایگاه داده)
    pgParameters:
      shared_buffers: '150MB' # حافظه اشتراکی برای کش داده‌ها (کمتر از نیمی از رم درخواستی keeper)
      log_checkpoints: 'on' # ثبت لاگ نقاط چکپوینت برای عیب‌یابی
      log_lock_waits: 'on' # لاگ قفل‌های طولانی برای تشخیص مشکلات
      checkpoint_completion_target: '0.9' # هدف تکمیل چکپوینت (نسبت زمانی)
      autovacuum_max_workers: '1' # تعداد کارگران autovacuum
      min_wal_size: '2GB' # حداقل سایز WAL برای کارایی بهتر
      wal_buffers: '16MB' # حافظه بافر WAL
      shared_preload_libraries: 'pg_stat_statements' # لود افزونه برای مانیتورینگ پرس و جوها
      pg_stat_statements.track: 'all' # فعال‌سازی ردیابی همه کوئری‌ها
      max_connections: '1500' # حداکثر تعداد کانکشن‌های همزمان (توجه: باید کمتر از نصف حافظه keeper باشد)

# توضیحات اضافی درباره Backup (در فایل config جداگانه)

backup:
  enabled: false # مکانیزم بکاپ خودکار را خاموش می‌کند (در تنظیمات اصلی فعال است)
  schedule: '0 0 * * *' # زمان‌بندی اجرای کرون جاب (هر شب ساعت 12)
  activeDeadlineSeconds: 14400 # حداکثر زمان اجرای هر کار بکاپ به ثانیه (4 ساعت)
  strategy: 'only-standby' # انتخاب keeper مناسب برای بکاپ (ترجیحا از standby)
  maxBackups: 0 # تعداد بکاپ‌هایی که نگه داشته می‌شود (0 یعنی پاکسازی فعال نیست)
  provider: 's3' # نوع ذخیره‌سازی بکاپ (s3 یا local)
# اطلاعات دسترسی s3 در بخش s3.existingSecret تعریف می‌شود