Teams & multi-userצוותים וריבוי משתמשים
An organisation holds people and machine identities side by side, under the same role model. A key never outranks the human who created it, and everything either kind does is attributable.
ארגון מחזיק אנשים וזהויות מכונה זה לצד זה, תחת אותו מודל תפקידים. מפתח לעולם לא עולה בדרגה על מי שיצר אותו, וכל מה ששני הסוגים עושים ניתן לייחוס.
Rolesתפקידים
ownerEverything, including billing, deleting the organisation and transferring ownership. At least one per organisation, and you cannot remove the last one.הכול, כולל חיוב, מחיקת הארגון והעברת בעלות. לפחות אחד לכל ארגון, ואי אפשר להסיר את האחרון.adminManage projects, members, keys and domains. Deploy anywhere. Cannot touch billing.ניהול פרויקטים, חברים, מפתחות ודומיינים. פריסה לכל מקום. אין גישה לחיוב.developerDeploy to staging freely, to production if granted. Set non-secret variables. Read logs and scan reports.פריסה ל-staging בחופשיות, לייצור אם ניתנה הרשאה. הגדרת משתנים לא-סודיים. קריאת לוגים ודוחות סריקה.viewerRead-only. Sees projects, deployments, logs and reports. Sets nothing, deploys nothing.קריאה בלבד. רואה פרויקטים, פריסות, לוגים ודוחות. לא מגדיר כלום, לא פורס כלום.Inviting peopleהזמנת אנשים
shipyard members invite ariel@example.com --role developer shipyard members list shipyard members set-role ariel@example.com --role admin shipyard members remove ariel@example.com
An invitation expires in seven days and can only be accepted by the address it was sent to. Removing a member immediately revokes their sessions and every key they created, which is the behaviour you want on the day someone leaves and the behaviour that surprises people on every other day. Transfer their keys first if the pipeline depends on one.
הזמנה פגה תוך שבעה ימים וניתנת לאישור רק על ידי הכתובת שאליה נשלחה. הסרת חבר מבטלת מיד את הסשנים שלו וכל מפתח שיצר, וזו ההתנהגות שרוצים ביום שמישהו עוזב וזו ההתנהגות שמפתיעה אנשים בכל יום אחר. העבירו את המפתחות שלו קודם אם הצינור תלוי באחד מהם.
API keysמפתחות API
Create them in the panel under API keys or from the CLI. A key carries an organisation, an inherited role ceiling, and an explicit scope list.
יוצרים אותם בפאנל תחת מפתחות API או מה-CLI. מפתח נושא ארגון, תקרת תפקיד מורשת, ורשימת הרשאות מפורשת.
shipyard keys create "claude-staging" \ --scope deploy:staging \ --scope logs:read \ --project prj_01J8Q2VV7X \ --expires 90d shipyard keys list shipyard keys revoke key_01J8Q3AAB1
deploy:stagingBuild and release to staging.בנייה ושחרור ל-staging.deploy:prodBuild and release to production. Grant deliberately.בנייה ושחרור לייצור. העניקו במודע.logs:readRead logs for permitted projects.קריאת לוגים לפרויקטים מורשים.env:readList variable names and metadata. Not values, ever.רשימת שמות משתנים ומטא-דאטה. לעולם לא ערכים.env:writeSet and unset variables.הגדרה והסרה של משתנים.domains:writeAttach and detach hostnames.חיבור וניתוק שמות מארח.cache:rwTurborepo remote cache. Nothing else.מטמון מרוחק של Turborepo. שום דבר אחר.A key shared between two people, or between a person and their agent, makes the audit log useless at exactly the moment you need it. Keys are free. Make more of them.
מפתח משותף בין שני אנשים, או בין אדם לסוכן שלו, הופך את יומן הביקורת לחסר ערך בדיוק ברגע שבו אתם זקוקים לו. מפתחות הם בחינם. צרו עוד.
Agents as membersסוכנים כחברים
An autonomous agent should get its own key, scoped down, ideally expiring. A useful default for a Claude Code agent doing iterative work:
סוכן אוטונומי צריך לקבל מפתח משלו, מוגבל, ורצוי עם תפוגה. ברירת מחדל שימושית לסוכן Claude Code שעושה עבודה איטרטיבית:
deploy:stagingandlogs:read, nothing more.deploy:stagingו-logs:read, לא יותר.- Bound to one project with
--project.מוגבל לפרויקט אחד עם--project. - A 30 or 90 day expiry, so a forgotten key expires by itself.תפוגה של 30 או 90 יום, כך שמפתח נשכח פג מעצמו.
- Named after the agent and the machine, so the audit log reads like a sentence.שם שכולל את הסוכן ואת המכונה, כך שיומן הביקורת נקרא כמו משפט.
See Claude Code for the wiring and the confirmation guardrails.
ראו Claude Code לחיבור ולמנגנוני האישור.
Audit logיומן ביקורת
Every deploy, rollback, variable change, key creation, key revocation, member change and domain change is recorded with actor, timestamp, source address and result. It is append-only and exportable.
כל פריסה, rollback, שינוי משתנה, יצירת מפתח, ביטול מפתח, שינוי חברות ושינוי דומיין נרשמים עם המבצע, החותמת, כתובת המקור והתוצאה. היומן הוא append-only וניתן לייצוא.
shipyard audit --since 7d shipyard audit --actor key_01J8Q3AAB1 --json