הפעלת IAP לקטגוריות של Cloud Storage

במאמר הזה מוסבר איך להציג תוכן סטטי מאובטח מ-Cloud Storage באמצעות Cloud Run ושרת proxy לאימות זהויות (IAP).

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

אירוח אתרים סטטיים ב-Cloud Storage מציג רק תוכן ציבורי, וצריך לתת גישת קריאה ל-allUsers. אם הארגון שלכם מגביל קטגוריות ציבוריות באמצעות כללי מדיניות כמו מניעת גישה ציבורית או שיתוף מוגבל לדומיין, התכונה המובנית של Cloud Storage לאירוח אתרים סטטיים לא זמינה. במקום זאת, כדאי להשאיר את הקטגוריה פרטית, לפרוס שרת אינטרנט של NGINX ב-Cloud Run כשהקטגוריה מוגדרת כנפח אחסון, ולהשתמש ב-IAP כדי לשלוט בגישה לשירות Cloud Run.

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

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

  • פרויקט ב- Google Cloud שהחיוב מופעל בו. כניסה למסוף Google Cloud

  • קטגוריה פרטית של Cloud Storage שמכילה את הקבצים הסטטיים (לדוגמה, index.html, CSS ותמונות). מוודאים שהקטגוריה לא גלויה לכולם.

  • Google Cloud CLI מותקן.

מתן גישה לקטגוריה של Cloud Storage

ל-Cloud Run נדרשת הרשאה לקרוא קבצים מהקטגוריה הפרטית שלכם ב-Cloud Storage. אתם צריכים להקצות לזהות של שירות Cloud Run את התפקיד "צפייה באובייקטים של אחסון" (roles/storage.objectViewer) בקטגוריה.

אנחנו ממליצים להשתמש בחשבון שירות בניהול המשתמש בשירות Cloud Run, במקום בחשבון השירות שמוגדר כברירת מחדל ב-Compute Engine.

  1. יוצרים חשבון שירות שישמש כזהות השירות:

    gcloud iam service-accounts create RUN_SERVICE_ACCOUNT \
        --description="Service account for Cloud Run serving Cloud Storage" \
        --display-name="Cloud Run Cloud Storage Reader"
    
  2. מקצים לחשבון השירות את התפקיד "צפייה באובייקט אחסון" (roles/storage.objectViewer) בקטגוריה:

    gcloud storage buckets add-iam-policy-binding gs://BUCKET_NAME \
        --member="serviceAccount:RUN_SERVICE_ACCOUNT@PROJECT_ID." \
        --role="roles/storage.objectViewer"
    

פריסת השירות של Cloud Run

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

כדי לטעון את הקטגוריה, פורסים את השירות עם דגלי ווליום:

gcloud run deploy SERVICE_NAME \
    --image=nginx \
    --port=80 \
    --execution-environment=gen2 \
    --service-account=RUN_SERVICE_ACCOUNT@PROJECT_ID. \
    --add-volume=name=static,type=cloud-storage,bucket=BUCKET_NAME,readonly=true \
    --add-volume-mount=volume=static,mount-path=/usr/share/nginx/html \
    --no-allow-unauthenticated

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

  • ‫SERVICE_NAME: השם של שירות Cloud Run

  • ‫RUN_SERVICE_ACCOUNT: חשבון השירות שיצרתם בשלב הקודם

  • ‫PROJECT_ID: מזהה הפרויקט ב- Google Cloud

  • ‫BUCKET_NAME: השם של הקטגוריה של Cloud Storage

הקטגוריה נטענת אל /usr/share/nginx/html, שהיא הספרייה שבה NGINX מחפש נכסים סטטיים כברירת מחדל. כלומר, הקבצים בקטגוריה ממופים ישירות לנתיב הבסיס של השירות. לדוגמה, קובץ שמאוחסן ב-gs://BUCKET_NAME/index.html נגיש ב-https://SERVICE_URL/index.html.

כדי לאמת את הפריסה, בודקים שהשירות חוסם גישה לא מאומתת ומחזיר סטטוס 403 Forbidden כשניגשים אליו בלי פרטי כניסה:

curl -I SERVICE_URL

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

curl -H "Authorization: Bearer $(gcloud auth print-identity-token)" SERVICE_URL

מחליפים את SERVICE_URL בכתובת ה-URL של שירות Cloud Run.

הפעלת IAP

אחרי שפורסים את שירות Cloud Run, אפשר להפעיל את IAP כדי לאבטח אותו.

מומלץ להפעיל את IAP ישירות בשירות Cloud Run. הוראות מפורטות זמינות במאמר הגדרת IAP ל-Cloud Run.

לחלופין, אם אתם משתמשים במאזן עומסים חיצוני של HTTPS לפני שירות Cloud Run, אתם יכולים להפעיל את IAP בשירות לקצה העורפי. הוראות מפורטות מופיעות במאמר הפעלת IAP משירות לקצה העורפי או ממאזן עומסים.

שמירה במטמון וביצועים

כשמשתמשים ב-Cloud Storage כנפח אחסון, כל קובץ שנקרא על ידי Cloud Run מתורגם לקריאה ל-API של Cloud Storage. כדי לצמצם את זמן האחזור ואת עלויות ה-API, אתם יכולים להגדיר שמירה במטמון בשרת האינטרנט (לדוגמה, באמצעות הוראות לשמירה במטמון של NGINX) או להגדיר אפשרויות טעינה של Cloud Storage FUSE.

אם אתם משתמשים במאזן עומסים חיצוני מסוג HTTPS, אתם יכולים גם להפעיל את Cloud CDN בשירות לקצה העורפי. אי אפשר להשתמש ב-IAP וב-Cloud CDN באותו שירות לקצה העורפי, אז אם אתם צריכים את שניהם, יכול להיות שתצטרכו לשנות את המבנה של הארכיטקטורה בהתאם.

מגבלות

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

תרחישים אחרים לדוגמה

אתם יכולים להשתמש בנקודות טעינה של Cloud Storage גם בתרחישים אחרים:

  • פונקציות מבוססות-אירועים: פונקציה שקוראת קבצים שהועלו ישירות ממערכת הקבצים.

  • אפליקציות של AI גנרטיבי: אפליקציה טוענת מסד נתונים וקטורי (כמו Chroma) מקטגוריה של Cloud Storage באמצעות קריאות רגילות של מערכת הקבצים.

חלופה: טעינת נפחי NFS

אם הקבצים שלכם מאוחסנים ב-Filestore או בשרת NFS באירוח עצמי, אתם יכולים לטעון אמצעי אחסון של NFS לשירות Cloud Run במקום לקטגוריות של Cloud Storage. מידע נוסף זמין במאמר התקנת נפחי NFS.