הגדרה של סביבת פיתוח ב-Python

במדריך הזה נסביר איך להכין את המכונה המקומית לפיתוח ב-Python, כולל פיתוח אפליקציות ב-Python שפועלות ב- Google Cloud.

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

טיפ: אם אתם רוצים להתחיל לעבוד במהירות, Cloud Shell Editor מספק תמיכה בסביבת פיתוח משולבת (IDE) למחזור הפיתוח המלא של אפליקציות Google Kubernetes Engine ו-Cloud Run. הכלי Cloud Shell Editor מבוסס על Code OSS, והוא כולל את Google Cloud CLI ואת Cloud Code כשהם מותקנים מראש.

מטרות

  • מתקינים גרסה נתמכת של Python שתואמת ל- Google Cloud.
  • משתמשים ב-venv כדי לבודד יחסי תלות.
  • מתקינים כלי עריכה (אופציונלי).
  • מתקינים את Google Cloud CLI (אופציונלי).
  • מתקינים את ספריות הלקוח של Cloud לשימוש ב-Python (אופציונלי).
  • להתקין כלים שימושיים אחרים.
  • מגדירים אימות (אופציונלי).

התקנת Python

הוראות ההתקנה של Python משתנות בהתאם למערכת ההפעלה. פועלים לפי המדריך למערכת ההפעלה שפועלת בסביבת הפיתוח שלכם, macOS,‏ Windows או Linux.

macOS

מערכת macOS כוללת גרסה של Python כברירת מחדל ומשתמשת בה למטרות שלה. כדי למנוע הפרעה ל-macOS, מומלץ ליצור סביבת פיתוח נפרדת ולהתקין גרסה נתמכת של Python ל- Google Cloud. כדי להתקין את Python, משתמשים ב-homebrew.

  1. כדי להשתמש ב-Homebrew להתקנת חבילות Python, צריך קומפיילר. אפשר לקבל אותו על ידי התקנת כלי שורת הפקודה של Xcode.

    xcode-select --install
    
  2. מתקינים את Homebrew לפי ההוראות בדף הבית של Homebrew, ואז משתמשים ב-Homebrew כדי להתקין את Python באופן הבא:

    brew install pyenv
    pyenv install PYTHON_VERSION
    

    מספר הגרסה של Python צריך להיות בפורמט x.y. לדוגמה:

    pyenv install 3.12
    
  3. אחרי ההתקנה, מוודאים ש-Python 3 זמין בתור python ו-python3, ושגם pip מותקן.

    כדי לוודא ש-Python זמין, מריצים את הפקודה הבאה:

    python3 --version
    

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

    כדי לוודא ש-pip3 זמין, מריצים את הפקודה הבאה:

    pip3 --version
    

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

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

    python -m pip install --upgrade pip
    

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

Windows

  1. כדי להתקין את Python בסביבת Windows, מורידים את מנהל ההתקנה של הגרסה הרצויה של Python מאתר Python. מידע נוסף מופיע במאמר גרסאות Python נתמכות ב- Google Cloud.

  2. כדי לגשת לגרסת Python שלכם, השתמשו ב-Python launcher for Windows.

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

    py
    

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

    py -3
    

    כדי לבדוק את הגרסה הזמינה של pip, מריצים את הפקודה הבאה:

    py -m pip --version
    

    בפלט תופיע הגרסה של C:\users\[USERNAME]\appdata\local\programs\python\python38-32\lib\site-packages.

    בנתוני הגרסה של pip אפשר לקרוא על הגרסה האחרונה של pip.

Linux

רוב ההפצות של Linux כוללות גרסאות עדכניות של Python.

  1. כדי להתקין את Python בסביבת Linux, צריך להתקין את החבילות שמתאימות להפצה שלכם. ב-Debian וב-Ubuntu, החבילות האלה הן python3,‏ python3-dev,‏ python3-venv ו-python3-pip,

    מתקינים את החבילות האלה באמצעות הפקודות הבאות:

    sudo apt update
    sudo apt install python3 python3-dev python3-venv python3-pip
    
  2. אחרי שההתקנות מסתיימות, מוודאים ש-pip מותקן:

    pip3 --version
    

    אפשר לקרוא על הגרסה האחרונה של pip בהערות הגרסה של pip.

שימוש ב-venv כדי לבודד יחסי תלות

‫venv הוא כלי שיוצר סביבות Python מבודדות. בסביבות המבודדות האלה יכולות להיות גרסאות נפרדות של חבילות Python, וכך אפשר לבודד את יחסי התלות של פרויקט אחד מיחסי התלות של פרויקטים אחרים. כשמפתחים באופן מקומי באמצעות Python, מומלץ תמיד להשתמש בסביבה וירטואלית לכל פרויקט.

  1. משתמשים בפקודה venv כדי ליצור עותק וירטואלי של כל ההתקנה של Python. במדריך הזה נוצר עותק וירטואלי בתיקייה בשם env, אבל אתם יכולים לתת לתיקייה כל שם שתרצו.

    macOS

    cd your-project
    python -m venv env
    

    Windows

    cd your-project
    py -m venv env
    

    Linux

    cd your-project
    python3 -m venv env
    
  2. מגדירים את המעטפת כך שתשתמש בנתיבי venv ל-Python על ידי הפעלת הסביבה הווירטואלית:

    macOS

    source env/bin/activate
    

    Windows

    .\env\Scripts\activate
    

    Linux

    source env/bin/activate
    
  3. עכשיו אפשר להתקין חבילות בלי להשפיע על פרויקטים אחרים או על ההתקנה הגלובלית של Python:

    pip install google-cloud-storage
    

    אם רוצים להפסיק להשתמש בסביבה הווירטואלית ולחזור ל-Python הגלובלי, אפשר להשבית אותה:

    deactivate
    

מידע נוסף על venv זמין במסמכי התיעוד של venv.

התקנת עורך

כדי לפתח אפליקציות ב-Python, צריך כלי עריכה. הנה כמה מהעורכים הפופולריים יותר (בסדר אקראי):

התקנת ספריות הלקוח של Cloud לשימוש ב-Python

ספריות הלקוח של Cloud לשימוש ב-Python מאפשרות למפתחי Python לשלב שירותי Google Cloud כמו Datastore ו-Cloud Storage. כדי להתקין את החבילה ל-API ספציפי כמו Cloud Storage, משתמשים בפקודה דומה לזו:

pip install --upgrade google-cloud-storage

התקנת ה-CLI של gcloud

ה-CLI של gcloud הוא קבוצה של כלי שורת הפקודה ל- Google Cloud. הוא מכיל את gcloud ו-bq, שבעזרתם אפשר לגשת ל-Compute Engine, ל-Cloud Storage, ל-BigQuery ולמוצרים ושירותים אחרים משורת הפקודה. אתם יכולים להריץ את הכלים האלה באופן אינטראקטיבי או בסקריפטים האוטומטיים שלכם.

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

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

יוצרים פרטי כניסה לאימות מקומי בחשבון המשתמש:

gcloud auth application-default login

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

מידע נוסף זמין במאמר אימות לצורך שימוש בספריות לקוח.

(אופציונלי) ניראות (observability)

‫Google Cloud Observability כולל שירותי ניטור שעוזרים לכם להבין את ההתנהגות, התקינות והביצועים של אפליקציות Python. מידע נוסף מופיע במאמר Google Cloud Observability לפייתון.

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