מגדירים את הסביבה

לפני שתתזמנו ותריצו משימת cron, תצטרכו להגדיר את הפרויקט והסביבה שלכם ב- Google Cloudבשביל Cloud Scheduler.

הפעלה של Cloud Scheduler API

כדי ליצור או לבחור Google Cloud פרויקט ולהפעיל את Cloud Scheduler API, פועלים לפי ההוראות הבאות.

המסוף

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

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

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

  4. Enable the Cloud Scheduler API.

    Roles required to enable APIs

    To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

    Enable the API

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

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

  7. Enable the Cloud Scheduler API.

    Roles required to enable APIs

    To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

    Enable the API

    8.

gcloud

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

  2. התקינו את ה-CLI של Google Cloud.

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

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

    gcloud init

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

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

    • Select a project: כדי לבחור פרויקט לא צריך תפקיד IAM ספציפי – אפשר לבחור כל פרויקט שקיבלתם בו תפקיד.
    • יצירת פרויקט: כדי ליצור פרויקט, צריך את התפקיד Project Creator (יצירת פרויקטים) (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. מפעילים את Cloud Scheduler API:

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

    כדי להפעיל ממשקי API, צריך את תפקיד ה-IAM 'אדמין של Service Usage' (roles/serviceusage.serviceUsageAdmin), שכולל את ההרשאה serviceusage.services.enable. איך מקצים תפקידים 

    gcloud services enable cloudscheduler.googleapis.com

  8. התקינו את ה-CLI של Google Cloud.

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

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

    gcloud init

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

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

    • Select a project: כדי לבחור פרויקט לא צריך תפקיד IAM ספציפי – אפשר לבחור כל פרויקט שקיבלתם בו תפקיד.
    • יצירת פרויקט: כדי ליצור פרויקט, צריך את התפקיד Project Creator (יצירת פרויקטים) (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. מפעילים את Cloud Scheduler API:

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

    כדי להפעיל ממשקי API, צריך את תפקיד ה-IAM 'אדמין של Service Usage' (roles/serviceusage.serviceUsageAdmin), שכולל את ההרשאה serviceusage.services.enable. איך מקצים תפקידים 

    gcloud services enable cloudscheduler.googleapis.com
    14.

מגדירים אימות

האופן שבו מבצעים אימות ב-Cloud Scheduler משתנה לפי הממשק שמשמש לגישה ל-API ולסביבה שבה הקוד פועל.

מידע נוסף זמין במאמרים אימות ל-Cloud Scheduler ושימוש באימות עם HTTP Target.

הוספת אפליקציית App Engine

אם אתם מתכוונים להשתמש ביעד HTTP של App Engine, אתם צריכים להוסיף אפליקציית App Engine לפרויקט. האפליקציה הזו משמשת גם כמיקום של שירות Cloud Scheduler וגם כמיקום של המטפל במשימות עצמו, שמבצע את העבודה שמשויכת למשימה של Cloud Scheduler ומחזיר אישור בתגובה.

אם רוצים להשתמש ב-handler של משימות App Engine שלא נמצא בפרויקט, צריך לבחור במקום זאת יעד HTTP. במקרה כזה, לא צריך אפליקציית App Engine בפרויקט.

המסוף

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

    מעבר אל App Engine

  2. בתיבת הדו-שיח Welcome to App Engine (ברוכים הבאים ל-App Engine), מבצעים אחת מהפעולות הבאות:

    • אם כבר יצרתם אפליקציית App Engine ומוצגת ההודעה Your App Engine application has been created, אתם יכולים לדלג על שאר השלבים בקטע הזה.

      או

    • אם עדיין לא יצרתם אפליקציית App Engine, לוחצים על Create application וממשיכים לשאר השלבים בקטע הזה.

  3. בוחרים אזור לאפליקציה.

    שימו לב שהפרמטרים europe-west ו-us-central נקראים europe-west1 ו-us-central1 בפקודות של Cloud Scheduler.

    אחרי שמגדירים אזור לאפליקציית App Engine, אי אפשר לשנות אותו.

  4. לא בוחרים חשבון שירות, המערכת משתמשת בחשבון השירות שמוגדר כברירת מחדל ב-App Engine.

  5. לוחצים על הבא.

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

  6. אל תורידו את Cloud SDK, אלא לחצו על אעשה זאת מאוחר יותר.

    אמורה להופיע ההודעה Your App Engine application has been created (האפליקציה שלך ב-App Engine נוצרה).

gcloud

  1. כדי ליצור אפליקציית App Engine, מריצים את הפקודה gcloud app create:

    gcloud app create --region=REGION

    מחליפים את REGION במיקום שבו האפליקציה פועלת. שימו לב שהפרמטרים europe-west ו-us-central נקראים europe-west1 ו-us-central1 בפקודות של Cloud Scheduler.

    אחרי שמגדירים אזור לאפליקציית App Engine, אי אפשר לשנות אותו.

  2. כדי לבדוק את האזור של אפליקציה קיימת, משתמשים בפקודה הבאה:

    gcloud app describe

    הערך locationId מציין את האזור. לדוגמה: locationId: us-central.