מה זה HomeCloud?

HomeCloud הוא control plane לענן פרטי: קונסול ווב אחד, CLI אחד ו-SDK אחד לשירותים שצריך כדי להריץ אפליקציות — אחסון, תורים, מסדי נתונים, פונקציות, קונטיינרים, דוא״ל ועוד.

עובדים בתוך חשבון. חשבון הוא workspace מבודד. משאבים שיוצרים — buckets, תורים, מסדי נתונים, אפליקציות — שייכים לחשבון הזה ואינם משותפים עם חשבונות אחרים אלא אם מעניקים גישה במפורש.

למי זה מיועד

• בעלי חשבון שפתחו tenant וצריכים להזמין צוות
• מפתחים שפורסים אפליקציות, דוחפים images או קוראים ל-APIs מהקוד
• DevOps / משתמשי פלטפורמה שמאוטמטים עם ה-CLI ו-CI

אם אתם מפעילים את התשתית עצמה של HomeCloud (צמתי K3s, Traefik, operators) — זה מחוץ להיקף כאן. המדריכים מניחים שהפלטפורמה כבר רצה ושיש לכם כתובת קונסול.

ארבע דרכים לעבוד

1. קונסול ווב

פתחו https://console.{apex} (לדוגמה https://console.holab.abrdns.com).

השתמשו בקונסול כדי:

• ליצור ולעיין במשאבים (buckets, תורים, מסדי נתונים, פונקציות, …)
• להזמין חברים ולנהל IAM
• לערוך קוד פונקציות, לכתוב דוא״ל, לבדוק לוגים ומדדים
• להעתיק מחרוזות חיבור ו-URIs מסוג so://

כמעט לכל שירות יש דף רשימה ודף פרטים (אותו דפוס כמו «buckets → objects» או «queues → messages»).

2. CLI (homecloud)

התקינו פעם אחת (התקנה), ואז:

homecloud configure          # save Access Key for data-plane work
homecloud login              # browser/password session for management
homecloud so sync ./dist so://my-site/
homecloud mq send orders --body '{"id":1}'
homecloud fn invoke hello --payload '{"name":"Ada"}'

ראו את מדריך ה-CLI.

3. SDK (Python / Node.js)

לאפליקציות ואוטומציה שלא אמורות לפתוח דפדפן:

from homecloud import HomeCloud

client = HomeCloud.from_env()   # HC_ACCESS_KEY_ID / HC_SECRET_ACCESS_KEY
client.so.upload("docs", "./readme.md", key="readme.md")
client.mq.send("orders", {"id": 1})

ראו את מדריך ה-SDK.

4. Terraform / OpenTofu

פרוויז'ן של תורים, באקטים, סודות, IAM, מסדי נתונים, פונקציות ומחשוב מ-CI. השתמשו ב-Access Key הקשור למשתמש, או ב-GitHub OIDC (HC_ROLE_ARN) כדי ש-CI לא ישמור סוד ארוך-טווח. ראו Terraform.

מודל מנטלי: control plane מול data plane

אין צורך באדריכלות הפנימית — רק בהבחנה הזו:

Plane	דוגמאות	Auth
Control plane	יצירת bucket, רשימת תורים, הזמנת משתמש, פריסת גרסת פונקציה	סשן קונסול (homecloud login) או Access Key ב-SigV1 על ה-console API (Terraform)
Data plane	העלאת אובייקט, שליחת הודעה, משיכת image, invoke לפונקציה חמה	Access Key (בקשות חתומות על so. / mq. / …)

כלל אצבע: יצירה והגדרה של משאבים → קונסול / login / Terraform. העברת נתונים בזמן ריצה → Access Key על מארחי data-plane.

אזורים, קטלוג, בידוד

מקומות ב-HomeCloud הם אזורים (homelab, eu-central, …) — לא שמות ספק. בורר האזור בקונסול מצמצם רשימות אזוריות. ראו אזורים.

עמוד השירותים והסיידבר מציגים את קטלוג החשבון: שירותים ששוחררו intersect עם הרשאות IAM. מוצר שלא שוחרר נראה כאילו אינו קיים עדיין. מוצר ששוחרר אבל לא הוענק מופיע כ-workspace ריק — לא כעמוד Access Denied. ראו IAM.

בקווי ייצור ה-Event Bus משתמש ב-PLATFORM_NATS_URL. תורי tenant משתמשים ב-TENANT_NATS_URL / NATS_URL. המוצר הוא Compute (מכונות), SO (so://), MDB, MQ.

מזהה החשבון אוטומטי

Access Keys כבר מוגבלים לחשבון אחד. ה-CLI וה-SDK מזהים את החשבון מהמפתח — אין צורך להעביר account_id בכל פקודה.

שירותים במבט מהיר

שירות	שם קצר	למה משתמשים בו
Object Storage	SO	קבצים, גיבויים, אתרים סטטיים (so://bucket/key)
Compute	Compute	מכונות וירטואליות באזור HomeCloud
Message Queues	MQ	משימות אסינכרוניות, fan-out, DLQ
Managed Databases	MDB	PostgreSQL, MySQL, MongoDB
Redis	Redis	מטמון מנוהל
Functions	FN	handlers ב-Python / Node ב-serverless
Applications	Apps	פריסה מתבנית (API, fullstack, static, worker)
Kubernetes	K8s	עיון והגדלת עומסים ב-namespace של החשבון
Image Registry	IR	תמונות OCI פרטיות (docker push)
Mail	Mail	תיבות דואר, תבניות, אוטומציות
Secrets	Secrets	ערכי סוד בשם לאפליקציות ופונקציות
IAM	IAM	תפקידים, מדיניות, Access Keys, תפקידי קונסול
Domains	Domains	הבאת דומיין משלכם + רשומות DNS
SSL	SSL	צפייה בתעודות שהונפקו לחשבון

עמודי how-to מלאים נמצאים תחת מדריכים.

הצעדים הבאים

1. פתיחת חשבון (או קבלת הזמנה)
2. סיור בקונסול
3. יצירת Access Key והתקנת ה-CLI
4. עקבו אחרי מדריך שירות — התחילו ב-Object Storage, Compute, או אזורים