פריסת לקוח

חבילת deploy/ היא צרור רזה מבוסס-תמונה להתקנת RedCloud על מארח לקוח, ללא בנייה מהמקור.

מה בחבילה

קובץ	מטרה
`docker-compose.yml`	Compose מבוסס-תמונה (מושך את `${REDCLOUD_IMAGE}`); שני שירותים — `postgres` ו-`redcloud` (פורט `9900`), עם `ENVIRONMENT=production`
`.env.example`	תבנית סביבה ללקוח (רישיון, סודות, תמונה)
`setup.sh`	התקנה מודרכת חד-פעמית
`transfer.sh`	דחיפת ההתקנה למארח מרוחק דרך SSH
`cicd/`	תבניות GitHub Actions ו-GitLab CI

אפשרות א’ — התקנה מודרכת על מארח היעד

cd deploy
./setup.sh

‏setup.sh בודק Docker ו-Compose, יוצר את התיקיות credentials/ ו-out/, מעתיק את .env.example ל-.env, ומייצר אוטומטית ערכים חזקים ל-HMAC_KEY,‏ ENCRYPTION_KEY,‏ API_KEY ו-DB_PASSWORD. לאחר מכן הוא מזכיר לכם:

להגדיר את LICENSE_KEY (פורמט RC-...) ב-.env.
להניח את אישור הענן שלכם ב-credentials/sa-key.json.

לבסוף הוא מריץ docker compose up -d. פתחו http://localhost:9900.

אפשרות ב’ — העברה מרחוק מהמכונה שלכם

cd deploy
./transfer.sh user@host [/opt/redcloud] [--no-start]

‏transfer.sh מבצע rsync של המקור (תוך החרגת caches, סריקות, .env ואישורים), מעתיק בנפרד את קובצי ה-.env והאישורים, ואז מריץ docker compose up -d --build על היעד ומבצע בדיקת בריאות ל-http://host:9900/health.

דרישות היעד: Docker + Compose v2, גישת SSH, והפורטים 9900 (וכן 7700/5432 אם אתם מריצים אותם מקומית) פנויים.

תצורה נדרשת

תבנית הלקוח דורשת את אלה לפני ההפעלה הראשונה:

משתנה	הערות
`LICENSE_KEY`	מפתח הרישיון שלכם (`RC-...`)
`HMAC_KEY`,‏ `API_KEY`,‏ `ENCRYPTION_KEY`	נוצרים על ידי `setup.sh`, או מוגדרים ידנית
`DB_PASSWORD`	סיסמת בסיס נתונים חזקה
`REDCLOUD_IMAGE`	התמונה למשיכה (ברירת מחדל — התג העדכני שפורסם)

ראו את הפניית התצורה המלאה לכל השאר.

אימות

‏docker compose ps מציג את redcloud תקין (healthy).
‏GET http://host:9900/health מחזיר 200.
אתם יכולים להתחבר והרישיון מוצג כתקף.