איך מפתחים אפליקציות באמצעות buildpacks

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

יש שתי שיטות ליצור קובצי אימג' בקונטיינר באמצעות buildpacks:

• פיתוח מקומי באמצעות ה-CLI ‏pack כדי לבדוק באופן מקומי את האפליקציה ולשנות במהירות את האב טיפוס לפני ההפצה.
• פיתוח מרחוק באמצעות Cloud Build. הפיתוח באמצעות Cloud Build טוב לאפליקציות גדולות עם תהליכי build שצורכים הרבה משאבים, והוא גם יכול לעזור בהגנה על שרשרת האספקה של תוכנות.

פיתוחים מקומיים

משתמשים ב-‎CLI pack כדי לפתח גרסת build מקומית של האפליקציה בתוך קובץ אימג' של קונטיינר.

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

1. מתקינים את Docker Community Edition (CE)‎ בתחנת העבודה. ‏Docker משמש את pack ליצירת קובצי אימג' של OCI.
2. מתקינים את Pack CLI.
3. מתקינים את הכלי Git source control כדי שתהיה אפשרות לטעון אפליקציות לדוגמה מ-GitHub.

פיתוח גרסת build של אפליקציה באופן מקומי

משתמשים בפקודה pack build ומציינים את ה-builder שמוגדר כברירת המחדל --builder=gcr.io/buildpacks/builder, כדי לפתח גרסת build מקומית של קובצי אימג' בקונטיינר.

pack build --builder=gcr.io/buildpacks/builder IMAGE_NAME

מחליפים את IMAGE_NAME בשם של קובץ האימג' בקונטיינר של השירות.

אתם גם יכולים להתאים אישית את קובץ אימג' של קונטיינר באמצעות הרחבה של פיתוח גרסת ה-build והרצה של קובצי אימג'.

פיתוח גרסת build לדוגמה של אפליקציה באופן מקומי

בדוגמאות הבאות מוסבר איך לפתח גרסת build מקומית לדוגמה של אפליקציה.

1. משכפלים את המאגר לדוגמה ומעבירים אותו למכונה המקומית:

   git clone https://github.com/GoogleCloudPlatform/buildpack-samples.git

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

   Go

   cd buildpack-samples/sample-go

   Java

   cd buildpack-samples/sample-java-gradle

   Node.js

   cd buildpack-samples/sample-node

   PHP

   cd buildpack-samples/sample-php

   Python

   cd buildpack-samples/sample-python

   Ruby

   cd buildpack-samples/sample-ruby

   ‎.NET

   cd buildpack-samples/sample-dotnet

3. כדי ליצור את קובץ האימג' של האפליקציה לדוגמה משתמשים ב-pack‏:

   Go

   pack build --builder=gcr.io/buildpacks/builder sample-go

   Java

   pack build --builder=gcr.io/buildpacks/builder sample-java-gradle

   Node.js

   pack build --builder=gcr.io/buildpacks/builder sample-node

   PHP

   pack build --builder=gcr.io/buildpacks/builder sample-php

   Python

   pack build --builder=gcr.io/buildpacks/builder sample-python

   Ruby

   pack build --builder=gcr.io/buildpacks/builder sample-ruby

   ‎.NET

   pack build --builder=gcr.io/buildpacks/builder sample-dotnet

4. מריצים את קובץ האימג' באמצעות docker‏:

   Go

   docker run -p8080:8080 sample-go

   Java

   docker run -it -ePORT=8080 -p8080:8080 sample-java-gradle

   Node.js

   docker run -it -ePORT=8080 -p8080:8080 sample-node

   PHP

   docker run -it --rm -p 8080:8080 sample-php

   Python

   docker run -it -ePORT=8080 -p8080:8080 sample-python

   Ruby

   docker run -it -ePORT=8080 -p8080:8080 sample-ruby

   ‎.NET

   docker run -it -ePORT=8080 -p8080:8080 sample-dotnet

5. עוברים אלlocalhost:8080 כדי להיכנס לאפליקציה שפועלת.

פיתוח גרסאות build מרחוק

מהמיקום שבו מאחסנים ופורסים כל קובץ אימג', משתמשים ב-Cloud Build כדי לפתח גרסת build של האפליקציה בקובץ אימג' בקונטיינר וב-Artifact Registry בתור מאגר קונטיינרים.

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

נכנסים לחשבון 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

Verify that billing is enabled for your Google Cloud project.

Enable the Cloud Build and Artifact Registry APIs.

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 APIs

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

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

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

gcloud init

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

Verify that billing is enabled for your Google Cloud project.

Enable the Cloud Build and Artifact Registry APIs.

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 APIs

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

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

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

gcloud init

אם כבר התקנתם את Google Cloud CLI בעבר, צריך לוודא שפועלת אצלכם הגרסה העדכנית ביותר של gcloud components update.

1. מוודאים שלפרויקט Google Cloud יש גישה למאגר קובצי אימג' של קונטיינר.

   כדי להגדיר גישה למאגר Docker ב-Artifact Registry:

   1. יוצרים מאגר Docker חדש באותו מיקום של הפרויקט Google Cloud .

      gcloud artifacts repositories create REPO_NAME \
      --repository-format=docker \
      --location=REGION --description="DESCRIPTION"

      מחליפים את:
      • REPO_NAME בשם שבחרתם למאגר ב-Docker.
      • ‫REGION עם המיקום בפרויקט או במיקום הקרוב ביותר למיקום הפרויקט. Google Cloud
      • DESCRIPTION בתיאור כלשהו.

      לדוגמה, כדי ליצור מאגר docker ב-us-west2 שהתיאור שלו הוא 'Docker repository', מריצים את הפקודה:

      gcloud artifacts repositories create buildpacks-docker-repo --repository-format=docker \
      --location=us-west2 --description="Docker repository"

   2. מוודאים שהמאגר נוצר:

      gcloud artifacts repositories list

      השם שבחרתם למאגר Docker אמור להופיע ברשימה.

פיתוח גרסת build של אפליקציה מרחוק

משתמשים בפקודה gcloud builds submit כדי ליצור את קובץ האימג' של קונטיינר ולהעלות אותו למאגר.

אפשר לציין את קובץ האימג' של הקונטיינר בפקודה עצמה או להשתמש בקובץ הגדרה.

פיתוח באמצעות פקודה

כדי לבצע build בלי קובץ תצורה, מציינים את הדגל image:

gcloud builds submit --pack image=LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/IMAGE_NAME

מחליפים את:

• LOCATION בשם האזור של מאגר הקונטיינרים. לדוגמה: us-west2
• PROJECT_ID במזהה הפרויקט. Google Cloud
• REPO_NAME בשם המאגר ב-Docker.
• IMAGE_NAME בשם של קובץ האימג' בקונטיינר.

דוגמה:

gcloud builds submit --pack image=us-west2-docker.pkg.dev/my-project-id/my-buildpacks-docker-repo/app-image

יצירת build באמצעות קובצי תצורה

אתם יכולים להשתמש בקובץ הגדרות כדי להגדיר את פרטי ההגדרות של מאגר האימג'ים. קובץ התצורה משתמש בפורמט של קובץ YAML, והוא חייב לכלול שלב build שמשתמש ב-CLI של pack.

1. יוצרים קובץ YAML בשם cloudbuild.yaml שכולל את ה-URI של מאגר קובצי אימג' של קונטיינרים.

    options:
      logging: CLOUD_LOGGING_ONLY
      pool: {}
    projectId: PROJECT_ID
    steps:
    - name: gcr.io/k8s-skaffold/pack
      entrypoint: pack
      args:
      - build
      - LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/IMAGE_NAME
      - --builder
      - gcr.io/buildpacks/builder:latest
      - --network
      - cloudbuild
      - --publish
    - name: gcr.io/cloud-builders/docker
      entrypoint: pack
      args:
      - pull
      - LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/IMAGE_NAME
    images:
    - LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/IMAGE_NAME
   

   מחליפים את:

   • LOCATION בשם האזור של מאגר הקונטיינרים, לדוגמה, us-west2.
   • PROJECT_ID במזהה הפרויקט. Google Cloud
   • REPO_NAME בשם המאגר ב-Docker.
   • IMAGE_NAME בשם של קובץ האימג' בקונטיינר.

2. מפתחים את האפליקציה.

   אם קראתם לקובץ התצורה cloudbuild.yaml, מריצים את הפקודה הבאה:

   gcloud builds submit .
   

   טיפ: אם משתמשים בשם ייחודי לקובץ התצורה, צריך להשתמש בדגל --config.

דוגמה: פיתוח מרחוק של גרסת build לדוגמה של אפליקציה

בדוגמאות הבאות מוסבר איך לפתח מרחוק גרסת build לדוגמה ואז לאמת שקובץ אימג' של קונטיינר הועבר למאגר ב-Artifact Registry.

1. משכפלים את המאגר לדוגמה ומעבירים אותו למכונה המקומית:

   git clone https://github.com/GoogleCloudPlatform/buildpack-samples.git

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

   Go

   cd buildpack-samples/sample-go

   Java

   cd buildpack-samples/sample-java-gradle

   Node.js

   cd buildpack-samples/sample-node

   PHP

   cd buildpack-samples/sample-php

   Python

   cd buildpack-samples/sample-python

   Ruby

   cd buildpack-samples/sample-ruby

   ‎.NET

   cd buildpack-samples/sample-dotnet

3. שולחים את קוד המקור של האפליקציה ל-Cloud Build באמצעות gcloud‏:

   Go

   gcloud builds submit --pack image=LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/sample-go

   Java

   gcloud builds submit --pack image=LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/sample-java-gradle

   Node.js

   gcloud builds submit --pack image=LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/sample-node

   PHP

   gcloud builds submit --pack image=LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/sample-php

   Python

   gcloud builds submit --pack image=LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/sample-python

   Ruby

   gcloud builds submit --pack image=LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/sample-ruby

   ‎.NET

   gcloud builds submit --pack image=LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/sample-dotnet

4. מוודאים שהאפליקציה לדוגמה פורסמה ב-REPO_NAME:

   gcloud artifacts docker images list LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME

   מחליפים את:

   • LOCATION בשם האזור של מאגר הקונטיינרים. לדוגמה: us-west2
   • PROJECT_ID במזהה הפרויקט. Google Cloud
   • REPO_NAME בשם המאגר ב-Docker.

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

• פריסה של קובץ האימג' ב-Cloud Run
• הגדרה של משתני סביבה
• הגדרה של קובצי אימג' בגרסת build
• האצה של גרסאות build באמצעות קובצי אימג' ששמורים במטמון