פיתוח קוד באמצעות Posit Workbench (כולל RStudio Pro)

אזהרה: ספק צד שלישי מתחזק את קובץ האימג' של הקונטיינר שמפורט בקטע הזה. Google Cloud לא יוצרת, מתחזקת או תומכת באופן רשמי בקובץ האימג' הזה. חשוב לבדוק היטב כל פתרון לפני שפורסים אותו בסביבת הייצור.

איך מתחילים לפתח קוד באמצעות Posit Workbench ו-RStudio Pro עם Cloud Workstations. במדריך הזה נסביר איך להגדיר את הסביבה, ליצור תחנת עבודה ולהפעיל סשן של RStudio Pro.

לפני שמתחילים

במדריך הזה מוסבר איך אדמינים יכולים להגדיר את Cloud Workstations ואיך מפתחים יכולים להשתמש בתחנות העבודה.

כדי להגדיר את Cloud Workstations:

נכנסים לחשבון Google Cloud . אנחנו ממליצים למשתמשים חדשים ב- Google Cloud ליצור חשבון כדי שיוכלו להעריך את הביצועים של המוצרים שלנו בתרחישים מהעולם האמיתי. לקוחות חדשים מקבלים בחינם גם קרדיט בשווי 300$ להרצה, לבדיקה ולפריסה של עומסי העבודה.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

If you're using an existing project for this guide, verify that you have the permissions required to complete this guide. If you created a new project, then you already have the required permissions.

Verify that billing is enabled for your Google Cloud project.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

If you're using an existing project for this guide, verify that you have the permissions required to complete this guide. If you created a new project, then you already have the required permissions.

Verify that billing is enabled for your Google Cloud project.

1. מפעילים את Cloud Workstations API, אם הוא עדיין לא מופעל.

   התפקידים שנדרשים כדי להפעיל ממשקי API

   כדי להפעיל ממשקי API, צריך את ההרשאה serviceusage.services.enable. אם אתם יצרתם את הפרויקט, סביר להניח שכבר יש לכם את ההרשאה הזו דרך התפקיד "בעלים" (roles/owner). אחרת, אתם יכולים לקבל את ההרשאה הזו דרך התפקיד "אדמין בממשק 'שימוש בשירות'" (roles/serviceusage.serviceUsageAdmin). איך מקצים תפקידים?

   להפעלת ה-API

התפקידים הנדרשים

כדי לקבל את ההרשאות שדרושות לניהול ולשימוש בתחנות עבודה, אתם צריכים לבקש מהאדמין לתת לכם את התפקידים הבאים ב-IAM:

• יצירה וניהול של אשכולות והגדרות של תחנות עבודה: אדמין של Cloud Workstations (roles/workstations.admin) בפרויקט
• יצירת תחנות עבודה באמצעות הגדרה: Cloud Workstations Creator (roles/workstations.workstationCreator) בפרויקט או בהגדרת תחנת העבודה
• שימוש בתחנת עבודה: משתמש ב-Cloud Workstations (roles/workstations.user) בתחנת העבודה. ההרשאה הזו ניתנת באופן אוטומטי בתחנות עבודה שאתם יוצרים.

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

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

במאמר בקרת גישה באמצעות IAM מופיעה סקירה כללית מפורטת של כל התפקידים ב-Cloud Workstations.

יצירת ההגדרות של תחנת העבודה

כדי להשתמש ב-Posit Workbench (כולל RStudio Pro), צריך ליצור הגדרת תחנת עבודה למפתחים בארגון:

1. מאתרים את מפתח הרישיון של Posit Workbench ושומרים אותו בהישג יד, כי תצטרכו אותו בשלב הבא. אם אתם צריכים מפתח רישיון ל-Posit Workbench, פנו לנציג של Posit Customer Success או שלחו אימייל לכתובת [e-mail].

2. פועלים לפי ההוראות ליצירת הגדרה של תחנת עבודה.

   1. כשמגיעים לשלב Environment customization, בוחרים באפשרות Code editors on base images.

   2. בתפריט Code editors, בוחרים באפשרות Posit Workbench (including RStudio Pro) Third-party provided.

   3. לוחצים על החץ להרחבה arrow_drop_down בקטע Advanced container options.

      1. בקטע Environment variables, לוחצים על Add variable.

      2. מזינים את הערך RSW_LICENSE בשדה Key ומדביקים את מפתח הרישיון של Posit Workbench בשדה Value.

         

      3. לוחצים על Continue.

   4. כשמגיעים לשלב הוספת משתמשים, נותנים למפתחים הרשאות גישה ב-IAM של Cloud Workstations להגדרת תחנת העבודה.

   5. כדי ליצור את הגדרת תחנת העבודה ולהוסיף לה את המשתמשים האלה, לוחצים על Create.

      אם בחרתם גם ליצור אשכול חדש, תהליך היצירה יכול להימשך עד 20 דקות.

   עכשיו המפתחים בצוות שלכם יכולים ליצור תחנות עבודה באמצעות Posit Workbench.

הגדרת תחנת העבודה

כדי ליצור תחנת עבודה:

1. במסוף Google Cloud , נכנסים לדף Cloud Workstations > Workstations.

   נכנסים לדף Workstations.

2. לוחצים על add_boxיצירה.

   יכול להיות שהקישור Create יהיה מושבת אם אין הגדרות בפרויקט או אם אין לכם הרשאות לצפות בהן. בקשו מהאדמין של Cloud Workstations בארגון ליצור בשבילכם הגדרות לתחנת עבודה.

3. מזינים את שם תחנת העבודה.

   בוחרים שם ייחודי באשכול תחנות העבודה, בהתאם למוסכמות למתן שמות למשאבים של Compute Engine.

4. לוחצים על החץ להרחבה arrow_drop_down בשדה Configuration ובוחרים את הגדרת סביבת העבודה Posit Workbench (Third-party).

5. לוחצים על Create כדי ליצור את סביבת העבודה.

הפעלת תחנת העבודה

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

1. לוחצים על Workstations.
2. ברשימת תחנות העבודה הזמינות, מוצאים את תחנת העבודה שיצרתם, מסמנים את התיבה שלצידה ולוחצים על Start. הפעולה הזו מפעילה את תחנת העבודה ומתאימה אותה להגדרות של תחנת העבודה הראשית.
3. אם מופיעה בקשה להפעיל את תחנת העבודה, לוחצים על Start כדי לאשר. הסטטוס משתנה ל-Starting וסמל הסטטוס refresh מסתובב בזמן שפעולת ההפעלה מתבצעת. יכול להיות שיעברו כמה דקות עד שתחנת העבודה תתחיל לפעול.
4. כשתחנת העבודה מוכנה, הסטטוס משתנה ל-Running וסמל הסטטוס משתנה לסימן וי check_circle.
5. לוחצים על הפעלה.

הפעלת סשן של Posit Workbench RStudio Pro

1. בדוגמה הבאה מוצג דף הפתיחה של Posit Workbench. יכול להיות שהדף שלכם ייראה אחרת, בהתאם לאופן שבו הארגון מגדיר את תחנת העבודה:

   

2. לוחצים על סשן חדש.

3. בוחרים באפשרות RStudio Pro בתור ה-IDE ומשאירים את Cluster מוגדר ל-Local.

   

   למידע נוסף על Posit Workbench ועל סביבות הפיתוח המשולבות (IDE) שנתמכות בו, כמו Jupyter Notebook,‏ JupyterLab ו-VS Code, קראו את המסמכים של Posit.

4. לוחצים על התחלת הסשן.

5. מחכים שהסשן יתחיל ואז מתחילים לתכנת.

   

העלאת קבצים לתחנת העבודה

1. כדי להעלות קבצים מהמכונה המקומית לתחנת העבודה, לוחצים על Upload.

   

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

3. לוחצים על בחירת קובץ כדי לבחור את הקובץ שרוצים להעלות.

4. כדי להתחיל את ההעלאה, לוחצים על אישור.

כדי להעלות כמה קבצים או ספרייה, צריך ליצור קובץ ZIP. קובץ ה-ZIP מורחב אחרי ההעלאה.

ייבוא קבצים מתחנת העבודה

1. כדי לייבא קבצים מתחנת העבודה, לוחצים על Import dataset ובוחרים את סוג מערך הנתונים.

   

2. עוברים אל קבוצת הנתונים שרוצים לייבא מתחנת העבודה ובוחרים אותה.

   ל-Posit Workbench IDE יש תלויות בחבילות R שונות בשביל תכונות שונות. לדוגמה, אם אתם מעלים קובץ Excel, צריך להתקין חבילות מסוימות. אם מוצגת בקשה להתקין את החבילות הנדרשות, לוחצים על Yes.

3. כדי להתחיל את הייבוא, לוחצים על ייבוא.

קבלת תמיכה לבעיות ב-Posit Workbench

אם נתקלתם בבעיות ב-Posit Workbench או בקובץ האימג' של הקונטיינר של Posit Workbench, דווחו עליהן ל-Posit בכתובת [e-mail].

המאמרים הבאים

• איך מתאימים אישית קובצי אימג' של קונטיינרים לצורכי הארגון.

• מידע נוסף על Posit Workbench זמין במרכז התיעוד של Posit Software.