יצירת מכונה וגישה אליה

כדי להתכונן ליצירת מאגרים ולהענקת גישה למשתמשים, צריך ליצור מכונה של Secure Source Manager ולגשת לממשק האינטרנט שלה.

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

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

  3. אם אתם משתמשים בספק זהויות חיצוני (IdP), קודם אתם צריכים להיכנס ל-CLI של gcloud באמצעות המאגר המאוחד לניהול זהויות.

  4. כדי לאתחל את ה-CLI של gcloud, הריצו את הפקודה הבאה:

    gcloud init
  5. יוצרים או בוחרים פרויקט ב- Google Cloud .

    תפקידים שנדרשים כדי לבחור או ליצור פרויקט

    • בחירת פרויקט: כדי לבחור פרויקט לא נדרש תפקיד IAM ספציפי – אתם יכולים לבחור כל פרויקט שקיבלתם בו תפקיד.
    • יצירת פרויקט: כדי ליצור פרויקט, צריך את התפקיד "יצירת פרויקטים" (roles/resourcemanager.projectCreator), שכולל את ההרשאה resourcemanager.projects.create. איך מקצים תפקידים
    • יוצרים פרויקט ב- Google Cloud :

      gcloud projects create PROJECT_ID

      מחליפים את PROJECT_ID בשם של פרויקט Google Cloud שיוצרים.

    • בוחרים את הפרויקט שיצרתם ב- Google Cloud :

      gcloud config set project PROJECT_ID

      מחליפים את PROJECT_ID בשם הפרויקט ב- Google Cloud .

  6. מוודאים שהחיוב מופעל בפרויקט ב- Google Cloud .

  7. מפעילים את Secure Source Manager API, אם הוא עדיין לא מופעל:

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

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

    gcloud services enable securesourcemanager.googleapis.com
  8. התקינו את ה-CLI של Google Cloud.

  9. אם אתם משתמשים בספק זהויות חיצוני (IdP), קודם אתם צריכים להיכנס ל-CLI של gcloud באמצעות המאגר המאוחד לניהול זהויות.

  10. כדי לאתחל את ה-CLI של gcloud, הריצו את הפקודה הבאה:

    gcloud init
  11. יוצרים או בוחרים פרויקט ב- Google Cloud .

    תפקידים שנדרשים כדי לבחור או ליצור פרויקט

    • בחירת פרויקט: כדי לבחור פרויקט לא נדרש תפקיד IAM ספציפי – אתם יכולים לבחור כל פרויקט שקיבלתם בו תפקיד.
    • יצירת פרויקט: כדי ליצור פרויקט, צריך את התפקיד "יצירת פרויקטים" (roles/resourcemanager.projectCreator), שכולל את ההרשאה resourcemanager.projects.create. איך מקצים תפקידים
    • יוצרים פרויקט ב- Google Cloud :

      gcloud projects create PROJECT_ID

      מחליפים את PROJECT_ID בשם של פרויקט Google Cloud שיוצרים.

    • בוחרים את הפרויקט שיצרתם ב- Google Cloud :

      gcloud config set project PROJECT_ID

      מחליפים את PROJECT_ID בשם הפרויקט ב- Google Cloud .

  12. מוודאים שהחיוב מופעל בפרויקט ב- Google Cloud .

  13. מפעילים את Secure Source Manager API, אם הוא עדיין לא מופעל:

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

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

    gcloud services enable securesourcemanager.googleapis.com

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

כדי לקבל את ההרשאות שנדרשות ליצירת מופע של Secure Source Manager, צריך לבקש מהאדמין להקצות לכם את תפקיד ה-IAM‏ Instance Owner (roles/securesourcemanager.instanceOwner) בפרויקט Google Cloud .

התפקידים של Secure Source Manager לא מופיעים במסוף Google Cloud עד שהם מוקצים לחשבון משתמש. במאמר הענקה וביטול של תפקידי IAM מוסבר איך להעניק תפקיד ב-Secure Source Manager בפעם הראשונה.

יצירת מכונה

  1. מריצים את הפקודה הבאה כדי ליצור מכונה בשם my-instance במיקום us-central1. יכול להיות שתתבקשו לאמת את ה-CLI של gcloud.

    gcloud source-manager instances create my-instance \
        --region=us-central1
    

    כאשר:

    • ‫my-instance הוא שם המכונה.
    • ‫us-central1 הוא האזור שבו יוצרים את המכונה.

    מתחילה פעולה ממושכת של יצירת מכונה. הפלט אמור להיראות כך:

    Create request issued for [my-instance].
    done: false
    metadata:
      '@type': type.googleapis.com/google.cloud.securesourcemanager.v1.OperationMetadata
      apiVersion: v1
      createTime: '2023-02-27T20:57:52.315609549Z'
      requestedCancellation: false
      target: projects/PROJECT_ID/locations/us-central1/instances/my-instance
      verb: create
    name: projects/PROJECT_ID/locations/us-central1/operations/operation-1234567894561-5ec69948c0f2b-60dd727f-a9b97a2e
    

    יצירת המכונה יכולה להימשך עד 60 דקות.

  2. שימו לב ל-OPERATION_NAME, שהוא שם המשאב המלא של הפעולה שהתקבלה בתגובה לבקשה שלכם. הפורמט שלו הוא כזה, והוא נדרש כשבודקים את סטטוס הפעולה בשלב הבא:

    projects/PROJECT_ID/locations/LOCATION/operations/OPERATION_ID

    לדוגמה: projects/PROJECT_ID/locations/us-central1/operations/operation-1234567894561-5ec69948c0f2b-60dd727f-a9b97a2e כאשר PROJECT_ID הוא הפרויקט Google Cloud .

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

    gcloud source-manager operations describe OPERATION_NAME \
        --region=us-central1
    

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

    כשהמכונה מוכנה, התגובה תיראה בערך כך:

    {
    "name": "projects/PROJECT_ID/locations/us-central1/operations/operation-123456789012-5ec69948c0f2b-60dd727f-a9b97a2e",
    "metadata": {
      "@type": "type.googleapis.com/google.cloud.securesourcemanager.v1.OperationMetadata",
      "createTime": "2022-11-01T14:31:32.420469714Z",
      "endTime": "2022-11-01T14:48:34.140378114Z",
      "target": "projects/PROJECT_ID/locations/us-central1/instances/my-instance",
      "verb": "create",
      "requestedCancellation": false,
      "apiVersion": "v1"
    },
    "done": true,
    "response": {
      "@type": "type.googleapis.com/google.cloud.securesourcemanager.v1.Instance",
      "name": "projects/PROJECT_ID/locations/us-central1/instances/my-instance",
      "createTime": "2022-11-01T14:31:32.416413630Z",
      "updateTime": "2022-11-01T14:31:32.416413630Z"
      },
      "state": "ACTIVE",
      "hostConfig": {
        "html": "my-instance-098765432109.us-central1.sourcemanager.dev",
        "api": "my-instance-098765432109-api.us-central1.sourcemanager.dev",
        "gitHttp": "my-instance-098765432109-git.us-central1.sourcemanager.dev"
      }
    }
    }
    

    כאשר:

    • ‫my-instance-098765432109.us-central1.sourcemanager.dev היא כתובת ה-URL של המכונה ב-HTML.
    • ‫PROJECT_ID הוא מזהה הפרויקט.
  4. מעתיקים את כתובת ה-URL של ה-HTML מהפקודה לבדיקת הסטטוס שנוצרה בהצלחה. תצטרכו את כתובת ה-URL הזו כדי לגשת למכונה באמצעות דפדפן אינטרנט.

גישה למכונה

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

  1. כדי לקבל את כתובת ה-URL ב-HTML של המכונה, מריצים שוב את הפקודה הבאה:

       gcloud source-manager operations describe OPERATION_NAME \
        --region=us-central1
    
  2. מעתיקים את כתובת ה-URL של ה-HTML מהתגובה המוצלחת של הפקודה gcloud source-manager operations describe ומדביקים אותה בסרגל הכתובות בדפדפן.

  3. מופיע מסך OAuth 2.0 שבו אתם נשאלים אם אתם רוצים לתת ל-sourcemanager.dev גישה לחשבון Google Cloud שלכם.

  4. לחצו על הלחצן Allow (אישור).

  5. ייפתח ממשק האינטרנט של Secure Source Manager. אתם יכולים ליצור מאגרי קוד ולצפות בהם, וגם בכל הבעיות ובקשות המשיכה שמשויכות אליהם, דרך ממשק האינטרנט.

הסרת המשאבים

כדי לא לצבור חיובים בחשבון Google Cloud על המשאבים שבהם השתמשתם בדף הזה, אתם צריכים למחוק את הפרויקט ב- Google Cloud יחד עם המשאבים.

  1. נכנסים לדף Manage resources במסוף Google Cloud .

    כניסה לדף Manage resources

  2. ברשימת הפרויקטים, בוחרים את הפרויקט שרוצים למחוק ולוחצים על Delete.
  3. כדי למחוק את הפרויקט, כותבים את מזהה הפרויקט בתיבת הדו-שיח ולוחצים על Shut down.

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