יצירת מדריכים פרטיים ב-Cloud Shell

ב-Cloud Shell יש תמיכה ביצירת מדריכים פרטיים, כך שאתם יכולים לתכנן מדריכים במיוחד לקהל שלכם.

אחרי שכותבים מדריכים באמצעות המדריך כתיבת מדריכים ב-Cloud Shell ומיישמים את השיטות המומלצות שמפורטות במדריך הסגנון לכתיבת מדריכים, אפשר לארח את המדריך במאגר Git פרטי כדי להפוך אותו לזמין למשתמשים.

אירוח של שיעורים פרטיים

כדי להפוך את המדריך לפרטי, צריך מאגר Git פרטי לאירוח שלו. אתם יכולים להשתמש בכל שירות אירוח מאגרי Git שתרצו. במדריך הזה נשתמש ב-Cloud Source Repositories, מאגרי Git פרטיים שמתארחים ב- Google Cloud.

כדי ליצור מאגר Cloud Source Repositories לאירוח המדריך הפרטי:

  1. מפעילים את הטרמינל של Cloud Shell. כדי להשתמש בסשן עצמאי של Cloud Shell, משתמשים בכתובת shell.cloud.google.com.

  2. יצירת מאגר פרטי:

    gcloud source repos create REPO_NAME

  3. משכפלים את המאגר ל-Cloud Shell:

    gcloud source repos clone REPO_NAME

  4. מעבירים את קובץ ההדרכה למאגר שנוצר באופן מקומי:

    mv PATH/TO/TUTORIAL REPO_NAME/PATH/TO/TUTORIAL

  5. עוברים למאגר המקומי:

    cd REPO_NAME

  6. מוסיפים את המדריך לביצוע:

    git add .

  7. מבצעים Commit של הקבצים למאגר עם תגובה שמתארת את ההיסטוריה של הפעולה הזו:

    git commit -m "Add private tutorial to Cloud Source Repositories"

  8. באמצעות הפקודה git push, מוסיפים את התוכן של המאגר המקומי ל-Cloud Source Repositories:

    git push origin master

  9. כדי לראות את המאגר ואת התוכן שלו במסוף Google Cloud :

    פתיחת Cloud Source Repositories

כדי לעזור למשתמשים שלכם להגיע למדריך, אתם יכולים להשתמש בתכונה 'פתיחה ב-Cloud Shell' של Cloud Shell, שמאפשרת לכם להגדיר איך המשתמשים ניגשים למדריך. פרטים על התאמה אישית של הקישור זמינים במדריך פתיחה ב-Cloud Shell.

כדי להשתמש במדריך שמתארח במאגר של Cloud Source Repositories, צריך להגדיר את הפרמטר cloudshell_git_repo עם כתובת ה-URL של המאגר.

דוגמה לקישור עם הגדרה של cloudshell_git_repo:

https://ssh.cloud.google.com/cloudshell/editor?cloudshell_git_repo=https://source.developers.google.com/p/project_name/r/repo_name

אפשר להגדיר את הקישור הזה ככפתור להטמעה במסמכים כדי שהמשתמשים יוכלו למצוא אותו בקלות:

[![Open in Cloud Shell](https://gstatic.com/cloudssh/images/open-btn.svg)](https://ssh.cloud.google.com/cloudshell/editor?cloudshell_git_repo=https://source.developers.google.com/p/project_name/r/repo_name)

התאמה אישית של מדריכים באמצעות כלי תוספים

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

כדי לעשות את זה, אפשר ליצור קובץ אימג' של Docker שמתפקד כסביבת Cloud Shell מותאמת אישית עם כל החבילות הנוספות וההגדרות המותאמות אישית שרוצים להפוך לזמינות למשתמש.