ניהול סודות באמצעות Secret Manager ב-Cloud Code ל-VS Code

בעזרת השילוב של Secret Manager ב-Cloud Code, אתם יכולים ליצור סודות, להציג אותם, לעדכן אותם ולהשתמש בהם בסביבת הפיתוח המשולבת (IDE) שלכם, בלי לאחסן אותם בבסיס הקוד.

בדף הזה מוסבר איך לגשת ל-Secret Manager בסביבת הפיתוח המשולבת (IDE) ואיך להתחיל ליצור ולנהל סודות.

הפעלה של Secret Manager API

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

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

  2. לוחצים על Cloud Code ומרחיבים את הסייר Secret Manager.

  3. אם לא הפעלתם את Secret Manager API, לוחצים על Enable Secret Manager API (הפעלת Secret Manager API) בסייר Secret Manager.

יצירת סודות

כדי ליצור סוד באמצעות הכלי Secret Manager Explorer, מבצעים את השלבים הבאים:

  1. ב-IDE, לוחצים על Cloud Code ואז מרחיבים את הסייר Secret Manager.

  2. לוחצים על add Create Secret (הוספה יצירת סוד) בסייר של Secret Manager.

    בתיבת הדו-שיח Create Secret (יצירת סוד), מגדירים את הפרויקט, השם, הערך והאזור של הסוד, ומציינים תוויות לארגון הסודות.

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

  1. פותחים קובץ שמכיל טקסט שרוצים לאחסן כסוד בכלי העריכה.
  2. מדגישים את הטקסט שרוצים לשמור כ-Secret, לוחצים לחיצה ימנית ואז לוחצים על יצירת Secret ב-Secret Manager.
  3. בתיבת הדו-שיח Create Secret (יצירת Secret), מתאימים אישית את הפרויקט, השם, הערך, האזור והתוויות של ה-Secret.

יצירת גרסאות חדשות של סודות

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

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

  2. בתיבת הדו-שיח Create Version (יצירת גרסה), מגדירים את הערך החדש של הסוד הקיים באמצעות השדה Secret value (ערך הסוד) או על ידי ייבוא קובץ.

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

  4. לוחצים על Create Version (יצירת גרסה). הגרסה שלכם נוספת, ואפשר לראות את הגרסה הסודית האחרונה ואת הגרסאות הקודמות ברשימות הנפתחות Versions.

אפשרות אחרת היא ליצור גרסה חדשה של סוד בעורך:

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

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

ניהול גרסאות של סודות

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

הצגת סודות

כדי לראות סודות, בוחרים סוד מהרשימה בסייר Secret Manager. פרטים על הסוד, כמו השם, מדיניות השכפול, חותמת הזמן של היצירה ומזהה המשאב, מפורטים מתחת לשם הסוד.

הצגת סודות במסוף Google Cloud

לחלופין, אפשר לראות את הסודות במסוף Google Cloud . לשם כך, לוחצים לחיצה ימנית על הסוד בסייר Secret Manager ולוחצים על Open in Cloud console.

לוחצים לחיצה ימנית על סוד ב-Secret Manager כדי לראות את האפשרות Open in Google Cloud console. התפריט הנפתח Properties (מאפיינים) מוצג גם בתצוגה של Secret Manager.

הצגת סודות בכלי Kubernetes Explorer

כדי לראות סודות ב-Kubernetes Explorer, פועלים לפי השלבים הבאים:

  1. לוחצים על Cloud Code ואז מרחיבים את הסייר Kubernetes.
  2. מרחיבים את האוסף ואז מרחיבים את Secrets.
  3. מרחיבים את הסוד כדי לראות את הפרטים שלו.

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

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

כדי לגשת לסוד מהאפליקציה:

  1. מתקינים את ספריית הלקוח של Secret Manager.

    1. לוחצים על Cloud Code ואז מרחיבים את Cloud APIs Explorer.

    2. מרחיבים את האפשרות Cloud Security > Secret Manager API ופועלים לפי ההוראות שבקטע Install Client Library (התקנת ספריית לקוח) בשפה שבה אתם משתמשים.

  2. מתאימים אישית את קטע הקוד הרלוונטי ומוסיפים אותו לקוד של האפליקציה.

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

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

    • פיתוח מקומי: אם אתם מפתחים באשכול מקומי (כמו minikube או Docker Desktop) או באמולטור מקומי, אתם צריכים לבצע את השלבים שמפורטים בקטע בנושא פיתוח מקומי שרלוונטיים לתהליך העבודה שלכם.
    • פיתוח מרחוק: אם אתם משתמשים באשכול GKE או בשירות Cloud Run באפליקציה, אתם צריכים לבצע את השלבים שמפורטים בקטע בנושא פיתוח מרחוק שרלוונטיים לתהליך העבודה שלכם, כולל ההוראות הספציפיות ל-Secret Manager להגדרת התפקידים הנדרשים בחשבון השירות.

הוספת סוד כמשתנה סביבה

כדי להוסיף סוד של Kubernetes קיים לפריסה כמשתנה סביבה:

  1. לוחצים על Cloud Code ואז מרחיבים את הסייר Kubernetes.
  2. מרחיבים את אשכול minikube ואז מרחיבים את Secrets.
  3. לוחצים לחיצה ימנית על סוד שמייצג אובייקט פריסה ואז לוחצים על הוספת סוד כמשתנה סביבה.

צירוף סוד כנפח

כדי לטעון סוד של Kubernetes קיים כנפח אחסון בקונטיינר של הפריסה, פועלים לפי השלבים הבאים:

  1. לוחצים על Cloud Code ואז מרחיבים את הסייר Kubernetes.
  2. מרחיבים את אשכול minikube ואז מרחיבים את Secrets.
  3. לוחצים לחיצה ימנית על Secret שמייצג אובייקט פריסה ואז לוחצים על Mount Secret as Volume (הוספת Secret כנפח אחסון).

מחיקת סודות

כדי למחוק סוד באמצעות Secret Manager ב-Cloud Code:

  1. לוחצים על Cloud Code ומרחיבים את הסייר Secret Manager.

  2. לוחצים לחיצה ימנית על סוד קיים ובוחרים באפשרות Open in Cloud Console (פתיחה במסוף Cloud).

  3. בדף Secret details (פרטי הסוד), לוחצים על DELETE (מחיקה) ופועלים לפי ההנחיות כדי למחוק את הסוד.

תמיכה

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