אימות ופרסום

התקנת חבילה ציבורית אינה מעניקה גישה לפריסה. הגדירו כתובת HTTPS של הפלטפורמה ובקשו אישור לערוץ הרצוי:

export SHOPLIFTER_API_URL=https://YOUR-PLATFORM-API-HOST
shoplifter login YOUR-CHANNEL-CODE
shoplifter files
shoplifter publication upload YOUR-CHANNEL-CODE
# Use upload's source id, then stage's candidate id, then preview's build id:
shoplifter publication stage YOUR-CHANNEL-CODE SOURCE-ID
shoplifter publication preview YOUR-CHANNEL-CODE CANDIDATE-ID
shoplifter publication status YOUR-CHANNEL-CODE BUILD-ID
shoplifter publication logs YOUR-CHANNEL-CODE BUILD-ID

החליפו כל מזהה בערך שהוחזר מהפעולה הקודמת. כניסה פותחת אישור בלוח הבקרה; השמיטו את הערוץ כדי לבחור שם. הגדירו SHOPLIFTER_NO_BROWSER=1 להצגת קישור האישור. פרטי הגישה תקפים לשעה ונשמרים מחוץ לקוד בתיקיית הגדרות ה־CLI. הפקודה shoplifter logout מבטלת אותם.

ה־CLI קורא לארגומנט המזהה revision, אך כל פעולה מצפה לסוג אחר:

פעולות	מזהה נדרש
stage	מזהה מקור שהוחזר מ־upload
preview, build, publish	מזהה מועמד שהוחזר מ־stage
status, logs, retry, retry-deployment, activate, rollback	מזהה בנייה שהוחזר מ־preview, build או status

פעולת stage מייבאת נכסי ברירת מחדל לערוץ ויוצרת מועמד; היא אינה מפעילה אתר חי. תצוגת ה־CLI משתמשת בהקשר התוכן המפורסם של המועמד. תצוגת טיוטה דרך לוח הבקרה היא תהליך נפרד.

בדיקה לפני עלייה לאוויר

פעולות הפרסום כוללות upload, ‏stage, ‏preview, ‏preview-link, ‏build, ‏publish, ‏status, ‏logs, ‏retry, ‏retry-deployment, ‏activate ו־rollback. בדקו את המצב שהוחזר לפני בחירת הפעולה הבאה; אין להריץ את כולן כרצף עיוור.

הפעולות stage, ‏preview, ‏build, ‏retry, ‏retry-deployment, ‏activate ו־rollback דורשות מזהה. אפשר להוסיף אחריו שפה. בעבודת בדיקה בלבד, עצרו לאחר preview מוצלח ובדיקת התצוגה המוגנת.

הפעולה build מבקשת בניית ייצור ועלולה להפעיל אותה אוטומטית כאשר המקור כבר תואם למקור האתר החי. הפעולה publish מקדמת תוכן טיוטה ומבקשת בניית ייצור, שגם היא עשויה לפעול אוטומטית. הפעולה activate מפעילה במפורש בניית ייצור מוצלחת לאחר בדיקות תצוגה של הקלט המדויק. התייחסו לשלושתן כפעולות העשויות לשנות אתר חי ודורשות הרשאה; build אינה פקודת תצוגה תמימה.

הפקודה shoplifter publication preview-link YOUR-CHANNEL-CODE מבקשת גישה מוגנת לתצוגה מקדימה. הוסיפו --reset רק כדי לבטל דפדפני תצוגה קיימים. אל תפיצו קישורים מוגנים בפומבי.

הפסקות ושחזור

לאחר הפסקת העברה או חידוש כניסה, חזרו על אותה פקודת העלאה. קלט זהה ממשיך מאותה נקודה; קלט ששונה מתחיל העלאה חדשה. שמרו אסימונים וכתובות חתומות מחוץ לפרויקט.

בדקו מצב ויומנים לפני ניסיון חוזר. תיקון קוד מחייב העלאה חדשה. שחזור משתמש בגרסה שמורה ומשנה את האתר החי; ודאו את היעד וההרשאה. בדקו את מצב הפריסה הסופי.