פריסת אפליקציה ב-GKE באמצעות Cloud Deploy

פריסת אפליקציה ב-GKE באמצעות Cloud Deploy

בדף הזה מוסבר איך להשתמש ב-Cloud Deploy כדי להעביר תמונה של אפליקציה לדוגמה בשם nginx לרצף של שני אשכולות Google Kubernetes Engine.

במדריך למתחילים הזה תבצעו את הפעולות הבאות:

1. יוצרים את שני האשכולות.

2. יוצרים הגדרה של Skaffold ומניפסט של Kubernetes כדי לציין את קובץ האימג' של הקונטיינר (שנוצר מראש) לפריסה.

3. מגדירים את צינור העברת הנתונים ואת יעדי הפריסה ב-Cloud Deploy, שמפנים לשני האשכולות.

4. כדי ליצור את צינור ההפצה, יוצרים גרסת הפצה שמופצת אוטומטית ליעד הראשון.

5. מקדמים את פריט התוכן ליעד השני.

6. אפשר לראות את שתי ההשקות במסוף Google Cloud .

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

נכנסים לחשבון Google Cloud . אנחנו ממליצים למשתמשים חדשים ב- Google Cloud ליצור חשבון כדי שיוכלו להעריך את הביצועים של המוצרים שלנו בתרחישים מהעולם האמיתי. לקוחות חדשים מקבלים בחינם גם קרדיט בשווי 300$ להרצה, לבדיקה ולפריסה של עומסי העבודה.
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.
Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.
Go to project selector
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.
Verify that billing is enabled for your Google Cloud project.
Enable the Cloud Deploy, Cloud Build, GKE, and Cloud Storage 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
Install the Google Cloud CLI.
If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.
To initialize the gcloud CLI, run the following command:
gcloud init
הערה: אתם יכולים להשתמש ב-CLI של gcloud במסוף Google Cloud גם בלי להתקין אותו. כדי להשתמש ב-CLI של gcloud במסוף Google Cloud , צריך להשתמש ב-Cloud Shell.

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.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

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.

Verify that billing is enabled for your Google Cloud project.

Enable the Cloud Deploy, Cloud Build, GKE, and Cloud Storage 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

Install the Google Cloud CLI.

If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

To initialize the gcloud CLI, run the following command:

gcloud init

הערה: אתם יכולים להשתמש ב-CLI של gcloud במסוף Google Cloud גם בלי להתקין אותו. כדי להשתמש ב-CLI של gcloud במסוף Google Cloud , צריך להשתמש ב-Cloud Shell.

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

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

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

• ‫Google Kubernetes Engine Developer (roles/container.developer)
• משתמש בחשבון שירות ב-IAM (roles/iam.serviceAccountUser)
• Cloud Deploy Job Runner (roles/clouddeploy.jobRunner)

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

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

יצירת אשכולות של Google Kubernetes Engine

יוצרים שני אשכולות: qsdev ו-qsprod, עם הגדרות ברירת מחדל. צריך להיות אפשר להגיע לנקודות הקצה של Kubernetes API באשכולות מהאינטרנט הציבורי. כברירת מחדל, יש גישה חיצונית לאשכולות GKE.

gcloud container clusters create-auto quickstart-cluster-qsdev --project=PROJECT_ID --region=us-central1 && gcloud container clusters create-auto quickstart-cluster-qsprod --project=PROJECT_ID --region=us-central1

הכנת ההגדרות של Skaffold ומניפסט Kubernetes

‫Cloud Deploy משתמש ב-Skaffold כדי לספק את הפרטים לגבי מה לפרוס ואיך לפרוס אותו בצורה נכונה עבור יעדים נפרדים.

במדריך למתחילים הזה יוצרים קובץ skaffold.yaml שמזהה את מניפסט Kubernetes שבו יש להשתמש כדי לפרוס את האפליקציה לדוגמה.

1. פותחים חלון טרמינל.

2. יוצרים ספרייה חדשה בשם deploy-gke-quickstart ועוברים אליה.

   mkdir deploy-gke-quickstart
   cd deploy-gke-quickstart
   

3. יוצרים קובץ בשם skaffold.yaml עם התוכן הבא:

   apiVersion: skaffold/v4beta7
   kind: Config
   manifests:
     rawYaml:
     - k8s-*
   deploy:
     kubectl: {}
   

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

   מידע נוסף על הקובץ הזה מופיע בskaffold.yamlמאמרי העזרה.

4. יוצרים קובץ בשם k8s-pod.yaml עם התוכן הבא:

   apiVersion: v1
   kind: Pod
   metadata:
     name: getting-started
   spec:
     containers:
     - name: nginx
       image: my-app-image
   

   הקובץ הזה הוא מניפסט בסיסי של Kubernetes, שמוחל על האשכול כדי לפרוס את האפליקציה. תמונת הקונטיינר לפריסה מוגדרת כאן כ-placeholder, ‏ my-app-image, שמוחלף בתמונה הספציפית כשיוצרים את הגרסה.

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

יצירת צינור העברת נתונים ויעדים

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

1. בספרייה deploy-gke-quickstart, יוצרים קובץ חדש: clouddeploy.yaml, עם התוכן הבא:

   apiVersion: deploy.cloud.google.com/v1
   kind: DeliveryPipeline
   metadata:
     name: my-gke-demo-app-1
   description: main application pipeline
   serialPipeline:
     stages:
     - targetId: qsdev
       profiles: []
     - targetId: qsprod
       profiles: []
   ---
   
   apiVersion: deploy.cloud.google.com/v1
   kind: Target
   metadata:
     name: qsdev
   description: development cluster
   gke:
     cluster: projects/PROJECT_ID/locations/us-central1/clusters/quickstart-cluster-qsdev
   ---
   
   apiVersion: deploy.cloud.google.com/v1
   kind: Target
   metadata:
     name: qsprod
   description: production cluster
   gke:
     cluster: projects/PROJECT_ID/locations/us-central1/clusters/quickstart-cluster-qsprod
   

2. רושמים את צינור עיבוד הנתונים ואת היעדים בשירות Cloud Deploy:

   gcloud deploy apply --file=clouddeploy.yaml --region=us-central1 --project=PROJECT_ID
   

   עכשיו יש לכם צינור, עם יעדים, שמוכן לפריסת האפליקציה ליעד הראשון.

3. מאשרים את הצנרת ואת היעדים:

   במסוף Google Cloud , נכנסים לדף Delivery pipelines של Cloud Deploy כדי לראות רשימה של צינורות העברת הנתונים שזמינים לכם.

   פתיחת הדף Delivery pipelines

   צינור העברת התוכן שיצרתם מוצג, ושני יעדי הטירגוט מופיעים בעמודה יעדים.

   

יצירת גרסה

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

מריצים את הפקודה הבאה מהספרייה deploy-gke-quickstart כדי ליצור משאב release שמייצג את קובץ האימג' של הקונטיינר לפריסה:

gcloud deploy releases create test-release-001 \
  --project=PROJECT_ID \
  --region=us-central1 \
  --delivery-pipeline=my-gke-demo-app-1 \
  --images=my-app-image=gcr.io/google-containers/nginx@sha256:f49a843c290594dcf4d193535d1f4ba8af7d56cea2cf79d1e9554f077f1e7aaa

שימו לב לדגל --images=, שמשמש להחלפת ה-placeholder ‏ (my-app-image) במניפסט בתמונה ספציפית עם חתימת SHA. ‫Google ממליצה ליצור תבניות של קובצי המניפסט בדרך הזו, ולהשתמש בשמות תמונות עם הסמכת SHA כשיוצרים גרסת הפצה.

בדומה לכל פריטי התוכן (אלא אם הם כוללים --disable-initial-rollout), גם Cloud Deploy יוצר באופן אוטומטי משאב פריסת גרסה. האפליקציה נפרסת אוטומטית ביעד הראשון ברצף.

קידום הגרסה

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

1. בדף צינורות להעברת נתונים, לוחצים על צינור my-gke-demo-app-1.

   פתיחת הדף Delivery pipelines

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

   

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

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

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

   הגרסה החדשה נמצאת עכשיו בתור לפריסה ב-qsprod. כשהפריסה מסתיימת, ההדמיה של צינור העברת הנתונים מראה שהיא נפרסה:

   

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

1. במסוף Google Cloud , עוברים לדף Cloud Deploy Delivery pipelines כדי לראות את צינור העברת התוכן my-gke-demo-app-1.

   פתיחת הדף Delivery pipelines

2. לוחצים על השם של צינור העברת הנתונים 'my-gke-demo-app-1'.

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

   

   פריט התוכן יופיע בכרטיסייה פריטי תוכן בקטע פרטים על צינור ההפצה.

3. לוחצים על שם הגרסה, test-release-001.

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

   

הסרת המשאבים

כדי לא לצבור חיובים לחשבון Google Cloud על המשאבים שבהם השתמשתם בדף הזה:

1. מוחקים את מקבץ qsdev:

   gcloud container clusters delete quickstart-cluster-qsdev --region=us-central1 --project=PROJECT_ID
   

2. מוחקים את מקבץ qsprod:

   gcloud container clusters delete quickstart-cluster-qsprod --region=us-central1 --project=PROJECT_ID
   

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

   gcloud deploy delete --file=clouddeploy.yaml --force --region=us-central1 --project=PROJECT_ID
   

4. מוחקים את הקטגוריות של Cloud Storage שנוצרו על ידי Cloud Deploy.

   אחד מסתיים ב-_clouddeploy, והשני הוא [region].deploy-artifacts.[project].appspot.com.

   פתיחת הדף Cloud Storage browser

סיימתם את המדריך למתחילים.

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

• מידע נוסף על Cloud Deploy

• מידע בסיסי על פריסת אפליקציות

• איך מנהלים את קובצי המניפסט

• כאן מוסבר איך משלבים Google Cloud כלי CI/CD כדי לפתח תוכנה ולספק אותה ביעילות ל-GKE.