פריסת VPC באמצעות Terraform

אתם יכולים לפרוס רשת VPC באמצעות Infrastructure Manager ומסוףGoogle Cloud . המדריך למתחילים הזה מיועד לאדמינים של Cloud, למהנדסי פלטפורמות ולמפתחים שרוצים לנהל את התשתית של Google Cloud כקוד. רשת VPC מספקת רשת מבודדת למשאבים כמו מכונות וירטואליות (VM), מסדי נתונים ואפליקציות.

ב-Infra Manager, מגדירים את הרשת בתצורה של Terraform במקום ליצור אותה באופן ידני. ‫Infra Manager מריץ את Terraform בשבילכם ושומר את המצב של Terraform. כתוצאה מכך, אתם יכולים לשחזר, לעדכן ולמחוק את התשתית באופן עקבי. מידע נוסף זמין במאמר סקירה כללית על Terraform ב- Google Cloud.

במדריך למתחילים הזה תראו איך ליצור פריסה מקובץ תצורה של Terraform במאגר GitHub ציבורי, ואיך להציג אותה בתצוגה מקדימה.

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

  1. 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.

    Go to project selector

  2. 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.

  3. Verify that billing is enabled for your Google Cloud project.

  4. Enable the Infrastructure Manager and Compute Engine APIs, if any are not already enabled.

    Roles required to enable APIs

    To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.

    Enable the APIs

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

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

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

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

תצוגה מקדימה ויצירה של פריסה

כשיוצרים פריסה, Infra Manager מקצה את המשאבים שמוגדרים ב-Terraform. לפני שיוצרים את הפריסה, יוצרים תצוגה מקדימה כדי לוודא אילו משאבים Infra Manager מתכנן להקצות.

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

  1. נכנסים לדף Infrastructure Manager במסוף Google Cloud .

    כניסה ל-Infrastructure Manager

  2. לוחצים על Create new deployment.

  3. בדף Create new Terraform deployment, בקטע Deployment details, מזינים את הערכים הבאים:

    • מזהה פריסה: quickstart-preview
    • אזור: us-central1
    • גרסת Terraform‏: 1.5.7
    • ‫Service account: יוצרים חשבון שירות חדש בשם im-quickstart-sa. כדי ליצור את חשבון השירות ולהקצות לו את התפקידים הנדרשים:

      1. ברשימה Service account, לוחצים על New service account. הדף Create service account נפתח בכרטיסייה חדשה.
      2. בשדה Service account name, מזינים את הערך im-quickstart-sa ולוחצים על Create and continue.
      3. בקטע Grant this service account access to project, משתמשים ברשימה Select a role כדי להקצות את התפקידים הבאים: כדי להוסיף את התפקיד השני, לוחצים על Add another role.

        • ‫Cloud Infrastructure Manager Agent ‏(roles/config.agent): מאפשר ל-Infra Manager להריץ את Terraform ולאחסן את המצב והיומנים של הפריסה.
        • אדמין של רשת Compute ‏(roles/compute.networkAdmin): מאפשר ל-Infra Manager ליצור ולנהל את רשת ה-VPC.

        מידע נוסף על התפקידים ב-Infra Manager זמין במאמר בקרת גישה באמצעות IAM.

      4. לוחצים על המשך ואז על סיום.

      5. סוגרים את הכרטיסייה וחוזרים לדף Create new Terraform deployment.

      6. ברשימה Service account, לוחצים על Refresh list ואז על im-quickstart-sa.

    • מקור ההגדרות של Terraform: Git

    • מאגר Git‏: https://github.com/terraform-google-modules/terraform-google-network

    • ספריית Git‏: modules/vpc

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

  5. בקטע Terraform details, בקטע Input values, מזינים את הערכים הבאים למשתני המודול שאוכלסו מראש:

    • בשורה של המפתח project_id, בשדה Value מזינים את הערך <var>PROJECT_ID</var>. אל תכללו מירכאות.
    • בשורה של המפתח network_name, בשדה Value מזינים את הערך quickstart-vpc. אל תכללו מירכאות.

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

  6. לוחצים על יצירת תצוגה מקדימה.

  7. בדף הפרטים של התצוגה המקדימה של quickstart-preview-<var>UUID</var>, מוודאים שהערך בשורה State הוא Succeeded.

  8. כדי ליצור פריסה שמשתמשת בערכים מהתצוגה המקדימה, לוחצים על Create deployment.

  9. בשדה Deployment ID, מזינים את הערך quickstart-deployment.

  10. לוחצים על Create deployment.

    ‫Infra Manager מקצה את רשת ה-VPC. בסיום הפריסה תופיע הודעה במסוף Google Cloud .

יצרתם פריסה באמצעות Infra Manager. בקטעים הבאים תאמתו את הפריסה, תציגו את הרשת שהוקצתה ותבדקו את המשימה ב-Cloud Build שהריצה את Terraform.

בדיקת הסטטוס של הפריסה

אחרי ש-Infra Manager יוצר את הפריסה, אתם יכולים לראות פרטים עליה, כמו המצב שלה, הגרסה האחרונה שלה והמקור של הגדרות ה-Terraform שלה.

כדי לראות את פרטי הפריסה:

  1. נכנסים לדף Infrastructure Manager במסוף Google Cloud .

    כניסה ל-Infrastructure Manager

  2. בעמודה מזהה, לוחצים על quickstart-deployment.

  3. בדף פרטי הפריסה, מוודאים שהערך בשורה State הוא Active.

הצגת רשת ה-VPC שהוקצתה

כדי לוודא ש-Infra Manager הקצה את הרשת שמוגדרת ב-Terraform, פותחים את הרשת במסוף Google Cloud :

  1. במסוף Google Cloud , נכנסים לדף רשתות VPC.

    כניסה לדף VPC networks

    רשימת הרשתות כוללת את quickstart-vpc, שהיא הרשת שהוקצתה על ידי Infra Manager. ברשימה מוצגים פרטים על הרשת, כמו מצב היצירה של תת-הרשת, יחידת השידור המקסימלית (MTU) ומצב הניתוב הדינמי.

  2. כדי לראות פרטים נוספים על הרשת, כמו רשתות המשנה, כללי חומת האש והמסלולים, לוחצים על quickstart-vpc.

הצגת תוצאות ה-build ב-Cloud Build

‫Infra Manager משתמש ב-Cloud Build כדי להריץ את Terraform לכל גרסת פריסה. כדי לבדוק את פקודות Terraform שיצרו את הפריסה, או כדי לפתור בעיות בפריסה שנכשלה, אפשר לעיין ביומני ה-build של Cloud Build:

  1. נכנסים לדף Build history במסוף Google Cloud .

    כניסה לדף Build history

  2. בטבלת ה-builds, מאתרים את ה-build האחרון עם האזור us-central1. ברשימה הזו מופיעים גרסאות build של התצוגה המקדימה של quickstart-preview-<var>UUID</var> ושל הפריסה של quickstart-deployment.

  3. לוחצים על מזהה ה-build כדי לפתוח את הדף Build details.

    בדף Build details מוצגים הסטטוס של כל שלב ב-build ויומן ה-build, שכולל את הפלט של פקודות Terraform. אם הפריסה נכשלת, אפשר להשתמש ביומן ה-build כדי לזהות את הסיבה. פתרון בעיות שקשורות לשגיאות בפריסה

אפשר גם לפתוח את ה-build של פריסה מדף הפרטים של הפריסה ב-Infra Manager, בלחיצה על הקישור Cloud Build logs.

הסרת המשאבים

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

מחיקת הפריסה

מוחקים את הפריסה ואת רשת ה-VPC שהוקצתה:

כדי למחוק את הפריסה:

  1. נכנסים לדף Infrastructure Manager במסוף Google Cloud .

    כניסה ל-Infrastructure Manager

  2. בעמודה מזהה, לוחצים על quickstart-deployment.

  3. בדף פרטי הפריסה, לוחצים על Delete.

  4. בתיבת הדו-שיח לאישור, מזינים את הערך quickstart-deployment ולוחצים על Confirm.

מחיקת חשבון השירות

אחרי ש-Infra Manager מוחק את הפריסה, מוחקים את חשבון השירות im-quickstart-sa כדי שהוא לא ישמור על התפקידים שלו בפרויקט:

  1. נכנסים לדף Service accounts במסוף Google Cloud .

    כניסה לדף Service accounts

  2. מסמנים את התיבה לצד im-quickstart-sa ולוחצים על Delete.

  3. בתיבת הדו-שיח, לוחצים על מחיקה.

אופציונלי: מחיקת הפרויקט

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

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

    כניסה לדף Manage resources

  2. ברשימת הפרויקטים, בוחרים את הפרויקט שרוצים למחוק ולוחצים על Delete.

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

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