הורדה ופריסה של Terraform

ב-Application Design Center אתם יכולים ליצור קוד Terraform לתבניות ולאפליקציות שלכם, ולייצא אותו למחשב מקומי או למאגר ב-GitHub.

ייצוא קוד Terraform מאפשר לכם לתחזק ולפרוס אפליקציות באמצעות כלי CI/CD משלכם. קובצי Terraform שמיוצאים רושמים באופן אוטומטי את האפליקציה ב-App Hub כדי לאפשר מעקב בזמן ריצה ב-Security Command Center. אפליקציות שנפרסו באופן חיצוני נחשבות לאפליקציות לא מנוהלות. כדי להשתמש בתכונות המנוהלות של Google Cloud שמתמקדות באפליקציות, כמו הערכות אבטחה בזמן התכנון ומעקב אחרי ממצאי אבטחה עד למקור שלהם, פורסים אפליקציה באמצעות App Design Center.

המערכת יוצרת את קובצי Terraform הבאים:

  • ‫main.tf: קוד תשתית שכולל מודול לכל רכיב בתבנית.
  • ‫outputs.tf: חשיפת מידע על רכיבי התשתית שנפרסו.
  • ‫variables.tf: הצהרה על השם, הסוג והתיאור של המשתנים שמשמשים בקובץ main.tf.
  • ‫input.tfvars: הגדרת ערכים למשתנים שמשמשים בקובץ main.tf.
  • ‫providers.tf: מגדיר תוויות שעוזרות ל-Terraform לקיים אינטראקציה עם ממשקי ה-API והמשאבים של Google Cloud .

למידע רקע, ראו סקירה כללית על Terraform ב-Google Cloud.

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

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

משימה התפקידים הנדרשים
ייצוא קוד שנוצר ב-Terraform באופן מקומי או למאגר של מערכת לניהול גרסאות אדמין של אפליקציה (roles/designcenter.applicationAdmin) או עריכת אפליקציה (roles/designcenter.applicationEditor)

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

ייצוא קוד Terraform

אם אתם רוצים לנהל את התבניות והאפליקציות מחוץ ל- Google Cloud, אתם יכולים ליצור קוד ב-Terraform ולייצא אותו למכונה המקומית או למאגר המקורות של הקוד.

ייצוא למכשיר

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

תבנית

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

    אל "תבניות"

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

  3. לוחצים על קבלת קוד.

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

בקשת הצטרפות

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

    מעבר אל Applications

  2. לוחצים על שם האפליקציה שרוצים לייצא.

  3. לוחצים על קבלת קוד.

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

ייצוא למאגר שלכם

כדי לנהל את התבניות דרך מאגר ניהול קוד המקור, אתם יכולים לייצא תבניות ואפליקציות ל-GitHub. אחר כך תוכלו להשתמש בתהליכי העבודה הקיימים של ניהול הגרסאות, ולהפעיל גרסאות build, בדיקות ופריסות באמצעות צינור עיבוד הנתונים של CI/CD.

התחברות למאגר

כדי ליצור חיבור Developer Connect בין המאגר ב-GitHub לבין הפרויקט לניהול:

  1. משנים את מדיניות הארגון כדי להוסיף את השירותים הבאים לרשימת ההיתרים:

    1. developerconnect.googleapis.com.
    2. secretmanager.googleapis.com.

    במאמר שימוש באילוץ Restrict Resource Service Usage מוסבר איך לשנות את מדיניות הארגון.

  2. יוצרים חיבור של Developer Connect למאגר ב-GitHub, כולל:

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

    במאמר קישור ל-GitHub מוסבר איך יוצרים חיבור ומקשרים מאגר.

  3. כדי להעתיק את ה-URI של המאגר:

    1. פותחים את הדף Developer Connect Git repositories.
    2. בטבלה Repositories, לוחצים על More Options ובוחרים באפשרות Copy resource path.

יצירה וייצוא

כדי ליצור קוד ב-Terraform ולייצא אותו למאגר ב-GitHub:

תבנית

  1. מזהים את מזהה המרחב.

    gcloud design-center spaces list \
        --project=PROJECT \
        --location=LOCATION
    

    מחליפים את מה שכתוב בשדות הבאים:

  2. מזהים את מזהה התבנית של התבנית שרוצים לייצא.

    gcloud design-center spaces application-templates list \
        --space=SPACE \
        --project=PROJECT \
        --location=LOCATION
    

    מחליפים את מה שכתוב בשדות הבאים:

    • ‫SPACE: מזהה המרחב המשותף.
    • ‫PROJECT: מזהה הפרויקט לניהול.
    • ‫LOCATION: מזהה המיקום שלכם.
  3. יוצרים את קוד ה-Terraform של התבנית ומייצאים אותו ל-GitHub.

    gcloud design-center spaces application-templates generate APPLICATION_TEMPLATE \
        --space=SPACE \
        --project=PROJECT \
        --location=LOCATION \
        --developer-connect-export-config-repo-uri=DEVELOPER_CONNECT_EXPORT_CONFIG_REPO_URI \
        --developer-connect-export-config-dir=DEVELOPER_CONNECT_EXPORT_CONFIG_DIR \
        --developer-connect-export-config-branch=DEVELOPER_CONNECT_EXPORT_CONFIG_BRANCH
    

    מחליפים את מה שכתוב בשדות הבאים:

    • ‫APPLICATION_TEMPLATE: המזהה של התבנית שרוצים לייצא.
    • ‫SPACE: מזהה המרחב המשותף.
    • ‫PROJECT: מזהה הפרויקט לניהול.
    • ‫LOCATION: מזהה המיקום שלכם.
    • ‫DEVELOPER_CONNECT_EXPORT_CONFIG_REPO_URI: הנתיב למשאב של המאגר ב-Developer Connect שהעתקתם בקטע קישור למאגר, למשל projects/my-project/locations/us-central1/connections/my-connection/gitRepositoryLinks/my-repo. הקישור למאגר צריך להיות באותו מיקום (LOCATION) כמו המרחב המשותף.
    • ‫DEVELOPER_CONNECT_EXPORT_CONFIG_DIR: הנתיב לספרייה ביחס לשורש של מאגר GitHub, למשל terraform/my-template (או / לספריית השורש).
    • ‫DEVELOPER_CONNECT_EXPORT_CONFIG_BRANCH: ההסתעפות במאגר שלכם ב-GitHub.

    למידע נוסף, ראו הפקודה gcloud design-center spaces application-templates generate.

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

בקשת הצטרפות

  1. מזהים את מזהה המרחב.

    gcloud design-center spaces list \
        --project=PROJECT \
        --location=LOCATION
    

    מחליפים את מה שכתוב בשדות הבאים:

  2. מזהים את מזהה האפליקציה שרוצים לייצא.

    gcloud design-center spaces applications list \
        --space=SPACE \
        --project=PROJECT \
        --location=LOCATION
    

    מחליפים את מה שכתוב בשדות הבאים:

    • ‫SPACE: מזהה המרחב המשותף.
    • ‫PROJECT: מזהה הפרויקט לניהול.
    • ‫LOCATION: מזהה המיקום שלכם.
  3. יוצרים את קוד Terraform של האפליקציה ומייצאים אותו ל-GitHub.

    gcloud design-center spaces applications generate APPLICATION \
        --space=SPACE \
        --project=PROJECT \
        --location=LOCATION \
        --developer-connect-export-config-repo-uri=DEVELOPER_CONNECT_EXPORT_CONFIG_REPO_URI \
        --developer-connect-export-config-dir=DEVELOPER_CONNECT_EXPORT_CONFIG_DIR \
        --developer-connect-export-config-branch=DEVELOPER_CONNECT_EXPORT_CONFIG_BRANCH
    

    מחליפים את מה שכתוב בשדות הבאים:

    • ‫APPLICATION: מזהה האפליקציה שרוצים לייצא.
    • ‫SPACE: מזהה המרחב המשותף.
    • ‫PROJECT: מזהה הפרויקט לניהול.
    • ‫LOCATION: מזהה המיקום שלכם.
    • ‫DEVELOPER_CONNECT_EXPORT_CONFIG_REPO_URI: הנתיב למשאב של המאגר ב-Developer Connect שהעתקתם בקטע קישור למאגר, למשל projects/my-project/locations/us-central1/connections/my-connection/gitRepositoryLinks/my-repo. הקישור למאגר צריך להיות באותו מיקום (LOCATION) כמו המרחב המשותף.
    • ‫DEVELOPER_CONNECT_EXPORT_CONFIG_DIR: הנתיב לספרייה ביחס לשורש של מאגר GitHub, למשל terraform/my-app (או / לספריית השורש).
    • ‫DEVELOPER_CONNECT_EXPORT_CONFIG_BRANCH: ההסתעפות במאגר שלכם ב-GitHub.

    למידע נוסף, ראו הפקודה gcloud design-center spaces applications generate.

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

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