קוראים כמוך עוזרים לתמוך ב-MUO. כאשר אתה מבצע רכישה באמצעות קישורים באתר שלנו, אנו עשויים להרוויח עמלת שותף.

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

למרות שהשיבוט עשוי להיראות קל, זה יכול להיות מאתגר עם פרויקטים שנבנו עם Django. ל-Django יש תלות וחבילות רבות שגורמות להתנגשויות כאשר אינן מותקנות.

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

בשלבים הבאים, תלמד כיצד לשכפל, להגדיר ולהפעיל את פרויקט ה-Django שלך עם מינימליים של התנגשויות.

מה שאתה תצטרך

כדי להפיק את המרב מהמדריך הזה, אתה צריך את הדברים הבאים:

  • Python (Python3 ומעלה)
  • ידע פעיל בספריית Python-Django
  • פיפ3
  • היכרות עם סביבות וירטואליות של Python
  • ידע בסיסי ב-Git וב-GitHub
  • חשבון GitHub
  • Git מותקן במחשב המקומי שלך
  • היכרות עם שורת הפקודה

כשדרישות אלו מתמלאות, אתה מוכן לשכפל פרויקט.

1. שכפל את הפרויקט מ-GitHub

אתה יכול לשכפל פרויקט לדוגמה GitHub ולהגדיר אותו במחשב המקומי שלך.

instagram viewer

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

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

חזרה למכשיר שלך, הגדר תיקיה בשם clone_boma. זכור לנווט לתוך התיקיה עם ה cd clone_boma פקודה.

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

שיבוט git <repository-url>

אז, כדי לשכפל את פרויקט הדוגמה על HTTP, השתמש בפקודה הזו:

git שיבוט https://github.com/Dindihub/Boma-watch.git

2. בדוק את קבצי הפרויקט

לאחר שיבוט, השתמש בפקודה ls כדי לבדוק אם קיימים קבצים מפרויקט Boma-watch. סוּג ls כדי לרשום את כל התוכן בתיקייה.

אתה יכול להשתמש בעורך טקסט לבחירתך כדי לבדוק את התוכן של כל קובץ או להציג אותם באתר GitHub.

3. הגדר סביבה וירטואלית

עליך להגדיר סביבה וירטואלית עבור הפרויקט. הפרויקט לדוגמה מגיע עם סביבת Pipenv אשר מציינת את התלות של הפרויקט בשני קבצים: Pipfile ו Pipfile.lock.

אתה תיתקל בשגיאה זו אם תפעיל את הפרויקט עם Pipfile הישן:

ModuleNotFoundError: אין מודול בשם 'distutils.core'

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

כדי להסיר את הסביבה הישנה:

pipenv --rm

כדי להסיר את שני קבצי Pip:

rm Pipfile*

כדי להתקין את התלות ב-Pipenv שלך בגרסת ה-python שלך:

pipenv להתקין--python 3.10

לאחר מכן, הפעל את הפקודה הבאה כדי להתקין את כל חבילות Pipfiles:

pipenv להתקין בקשות

לאחר מכן הפעל את הסביבה הוירטואלית:

פגז pipenv

תראה את הסביבה הוירטואלית מופעלת בצד ימין של חלון המסוף שלך.

אם אתה משתמש ב-Venv כדי ליצור את הסביבה הוירטואלית שלך, הפעל את הפעולות הבאות כדי להתקין תלות:

צִפצוּףלהתקין-רדרישות.טקסט

כדי לפרט את כל התלות המותקנות:

הקפאת פיפס > requirements.txt

4. צור מסד נתונים

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

למד איך ל התקן PostgreSQL על אובונטו אוֹ התקן PostgreSQL ב-Windows.

לאחר שהכל מוגדר, הפעל את מעטפת Postgres באמצעות הפקודות הבאות:

sudo -i -u postgres
psql

לאחר מכן צור מסד נתונים בשם new_boma בשרת:

postgres=# צור מסד נתונים new_boma;

השרת מחזיר את המילה CREATE DATABASE כאשר הוא יוצר מסד נתונים. אשר שבסיס הנתונים קיים על ידי רשימת כל מסדי הנתונים במערכת באמצעות הפקודה \l:

ב settings.py, עליך לחבר את מסד הנתונים ליישום. עשה זאת על ידי החלפת המשתמש, השם והסיסמה של מסד הנתונים בערכים המקומיים שלך:

#...
מסדי נתונים = {
'בְּרִירַת מֶחדָל': {
'מנוע':'django.db.backends.postgresql',
'שֵׁם':'new_boma',
'מִשׁתַמֵשׁ':'postgres',
'סיסמה':'סיסמה',
 }
}

כמו כן, זכרו לשנות אזור זמן בקובץ settings.py כדי להתאים למיקום שלך. זה ישאיר את האפליקציה שלך מעודכנת.

ודא שהתקנת Psychopg2 כדי להתאים את כל התמונות הזמינות:

$ pipenv להתקין psychopg2

5. צור מפתח סודי

לכל פרויקט ג'נגו יש ייחודיות מפתח סודי. בדרך כלל, המפתח הסודי אינו חשוף באינטרנט. זה צריך להיות ב- env קובץ שכדאי לכלול בו קובץ ‎.gitignore להחריג מהמאגר.

אתה צריך ליצור אחד חדש כדי שהפרויקט שלך יפעל. צור מפתח סודי חדש עם מחולל מפתח סודי, כמו דז'קרטי.

# אזהרת אבטחה: שמור בסוד את המפתח הסודי המשמש בייצור!
SECRET_KEY = 'מפתח סודי-מגיע-הנה'

6. העבר את הפרויקט למסד הנתונים

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

פִּיתוֹןלנהל.pyהגירותאפליקציה

לאחר מכן הפעל את הפעולות הבאות כדי להעביר:

פִּיתוֹןלנהל.pyלהגר

כאשר אתה מפעיל את python manage.py להעביר פקודה, אתה נתקל בשגיאות. השגיאות מודיעות לך על מודולים חסרים. הקפד להתקין את כל המודולים לפני המעבר.

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

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

7. הפעל את הפרויקט

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

פִּיתוֹןלנהל.pyשרת ריצה

אם אין שגיאות, פתח http://127.0.0.1:8000/ בדפדפן אינטרנט. תוכלו לראות את דף הנחיתה של הפרויקט כפי שמוצג להלן:

הסוד לשיבוט פרויקט ג'נגו

שיבוט פרויקטים של Django עוזר לייעל את הזמן שלך. אתה יכול להתרכז בפיתוח תכונות חדשות במקום להתחיל פרויקט מאפס.

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

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