Αναγνώστες σαν εσάς βοηθούν στην υποστήριξη του MUO. Όταν κάνετε μια αγορά χρησιμοποιώντας συνδέσμους στον ιστότοπό μας, ενδέχεται να κερδίσουμε μια προμήθεια θυγατρικών.

Τα έργα ανοιχτού κώδικα έχουν ολοένα και μεγαλύτερη ζήτηση και υπάρχει τεράστιος αριθμός για να βυθίσετε τα δόντια σας. Για να ξεκινήσετε να εργάζεστε σε ένα έργο ανοιχτού κώδικα, βοηθάτε εάν μπορείτε εύκολα να κλωνοποιήσετε τον πηγαίο κώδικα και να ρυθμίσετε το έργο τοπικά.

Αν και η κλωνοποίηση μπορεί να φαίνεται εύκολη, μπορεί να είναι προκλητική με έργα που έχουν δημιουργηθεί με το Django. Το Django έχει πολλές εξαρτήσεις και πακέτα που προκαλούν συγκρούσεις όταν δεν είναι εγκατεστημένα.

Πρέπει να διορθώσετε τις διενέξεις για να μπορέσει να εκτελεστεί το έργο στον τοπικό σας υπολογιστή. Λοιπόν, δεν χρειάζεται να υποφέρεις άλλο.

Στα επόμενα βήματα, θα μάθετε πώς να κλωνοποιείτε, να ρυθμίζετε και να τρέχετε το έργο Django σας με ελάχιστες διενέξεις.

Τι θα χρειαστείτε

Για να αξιοποιήσετε στο έπακρο αυτόν τον οδηγό, θα πρέπει να έχετε τα εξής:

instagram viewer
  • Python (Python 3 και άνω)
  • Γνώση εργασίας της Python-Django Library
  • Pip3
  • Εξοικείωση με εικονικά περιβάλλοντα Python
  • Βασικές γνώσεις Git και GitHub
  • Ένας λογαριασμός GitHub
  • Το Git είναι εγκατεστημένο στον τοπικό σας υπολογιστή
  • Εξοικείωση με τη γραμμή εντολών

Εφόσον πληρούνται αυτές οι απαιτήσεις, είστε έτοιμοι να κλωνοποιήσετε ένα έργο.

1. Κλωνοποιήστε το έργο από το GitHub

Μπορείτε να κλωνοποιήσετε ένα δείγμα έργου από GitHub και ρυθμίστε το στον τοπικό σας υπολογιστή.

Για να κλωνοποιήσετε το έργο, κάντε κλικ στο πράσινο κουμπί με την ετικέτα Κώδικας. Στο αναπτυσσόμενο μενού, επιλέξτε και αντιγράψτε συνδέσμους HTTP ή SSH. Αυτοί οι σύνδεσμοι είναι οι διευθύνσεις URL του GitHub για το έργο. Οποιοσδήποτε από αυτούς θα κάνει.

Όταν θέλεις συνεισφέρετε σε ένα έργο ανοιχτού κώδικα χρησιμοποιώντας το Git, θα πρέπει πρώτα πιρούνι το έργο από το αποθετήριο του έργου για να δημιουργήσετε ένα αντίγραφο πριν από την κλωνοποίηση.

Επιστρέψτε στο μηχάνημά σας, ρυθμίστε έναν φάκελο με το όνομα clone_boma. Θυμηθείτε να πλοηγηθείτε στον φάκελο με το cd clone_boma εντολή.

Στη συνέχεια, εκτελέστε την ακόλουθη εντολή για να κλωνοποιήσετε το έργο στον φάκελο.

git κλώνος <αποθετήριο-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 --ρμ

Για να αφαιρέσετε και τα δύο Pipfiles:

rm Pipfile*

Για να εγκαταστήσετε τις εξαρτήσεις Pipenv στην έκδοση python:

pipenv εγκαθιστώ--python 3.10

Στη συνέχεια, εκτελέστε την ακόλουθη εντολή για να εγκαταστήσετε όλα τα πακέτα Pipfiles:

pipenv εγκαθιστώ αιτήσεων

Στη συνέχεια, ενεργοποιήστε το εικονικό περιβάλλον:

κέλυφος pipenv

Θα δείτε το εικονικό περιβάλλον ενεργοποιημένο στη δεξιά πλευρά του παραθύρου του τερματικού σας.

Εάν χρησιμοποιείτε το Venv για να δημιουργήσετε το εικονικό σας περιβάλλον, εκτελέστε τα παρακάτω για να εγκαταστήσετε εξαρτήσεις:

κουκούτσιεγκαθιστώ-rαπαιτήσεις.κείμενο

Για να απαριθμήσετε όλες τις εγκατεστημένες εξαρτήσεις:

πάγωμα κουκουτσιών > απαιτήσεις.txt

4. Δημιουργήστε μια βάση δεδομένων

Πρέπει να εγκαταστήσετε μια βάση δεδομένων για να χειριστείτε τα δεδομένα του έργου. Μπορείτε να επιλέξετε οποιοδήποτε είδος βάσης δεδομένων ταιριάζει στις ανάγκες σας. Για το δείγμα έργου, θα πρέπει να χρησιμοποιήσετε το PostgresSQL.

Μάθε πως να εγκαταστήστε το PostgreSQL στο Ubuntu ή εγκαταστήστε το PostgreSQL στα Windows.

Μόλις ρυθμιστούν όλα, ξεκινήστε το κέλυφος Postgres χρησιμοποιώντας τις ακόλουθες εντολές:

sudo -i -u postgres
psql

Στη συνέχεια, δημιουργήστε μια βάση δεδομένων με το όνομα new_boma στον διακομιστή:

postgres=# δημιουργία βάσης δεδομένων new_boma;

Ο διακομιστής επιστρέφει τη λέξη CREATE DATABASE όταν δημιουργεί μια βάση δεδομένων. Επιβεβαιώστε ότι η βάση δεδομένων υπάρχει παραθέτοντας όλες τις βάσεις δεδομένων στο σύστημα με την εντολή \μεγάλο:

Σε settings.py, πρέπει να συνδέσετε τη βάση δεδομένων με την εφαρμογή. Κάντε αυτό αντικαθιστώντας τον χρήστη, το όνομα και τον κωδικό πρόσβασης της βάσης δεδομένων με τις δικές σας τοπικές τιμές:

#...
ΒΑΣΕΙΣ ΔΕΔΟΜΕΝΩΝ = {
'Προκαθορισμένο': {
'ΚΙΝΗΤΗΡΑΣ':'django.db.backends.postgresql',
'ΟΝΟΜΑ':'new_boma',
'ΧΡΗΣΤΗΣ':'postgres',
'ΚΩΔΙΚΟΣ ΠΡΟΣΒΑΣΗΣ':'Κωδικός πρόσβασης',
 }
}

Επίσης, θυμηθείτε να αλλάξετε ΖΩΝΗ ΩΡΑΣ στο αρχείο settings.py για να ταιριάζει στην τοποθεσία σας. Αυτό θα διατηρήσει την εφαρμογή σας ενημερωμένη.

Βεβαιωθείτε ότι έχετε εγκαταστήσει Psycopg2 για να φιλοξενήσετε τυχόν διαθέσιμες εικόνες:

$ pipenv εγκαθιστώ psycopg2

5. Δημιουργήστε ένα μυστικό κλειδί

Κάθε έργο Django έχει ένα μοναδικό μυστικό κλειδί. Συνήθως, το μυστικό κλειδί δεν εκτίθεται στο διαδίκτυο. Θα πρέπει να είναι σε ένα env αρχείο που πρέπει να συμπεριλάβετε ένα αρχείο .gitignore να εξαιρεθεί από το αποθετήριο.

Πρέπει να δημιουργήσετε ένα νέο για να τρέξει το έργο σας. Δημιουργήστε ένα νέο μυστικό κλειδί με μια γεννήτρια μυστικών κλειδιών, όπως Djecrety.

# ΠΡΟΕΙΔΟΠΟΙΗΣΗ ΑΣΦΑΛΕΙΑΣ: κρατήστε μυστικό το μυστικό κλειδί που χρησιμοποιείται στην παραγωγή!
SECRET_KEY = 'μυστικό-κλειδί-έρχεται-εδώ'

6. Μεταφορά έργου στη βάση δεδομένων

Εκτελέστε την ακόλουθη εντολή για να δημιουργήσετε πίνακες για την εφαρμογή στη νέα βάση δεδομένων:

Πύθωνδιαχειρίζονται.pyμεταναστεύσειςεφαρμογή

Στη συνέχεια, εκτελέστε τα εξής για μετεγκατάσταση:

Πύθωνδιαχειρίζονται.pyαποδημώ

Όταν τρέχετε το python management.py μετεγκατάσταση εντολή, αντιμετωπίζετε σφάλματα. Τα σφάλματα σας ειδοποιούν ότι λείπουν μονάδες. Βεβαιωθείτε ότι έχετε εγκαταστήσει όλες τις λειτουργικές μονάδες πριν πραγματοποιήσετε μετεγκατάσταση.

Όταν έχετε εγκαταστήσει όλες τις εξαρτήσεις, εκτελέστε τη μετεγκατάσταση. Εάν ολοκληρωθούν οι μετεγκαταστάσεις, ήρθε η ώρα να εκτελέσετε το έργο.

Όταν έχετε εγκαταστήσει όλες τις εξαρτήσεις, εκτελέστε τη μετεγκατάσταση. Εάν εκτελεστούν οι μετεγκαταστάσεις, ήρθε η ώρα να εκτελέσετε το έργο.

7. Εκτελέστε το έργο

Εκτελέστε το έργο για να βεβαιωθείτε ότι όλα είναι εντάξει πριν προσθέσετε τη συνεισφορά σας. Εκτελέστε την εφαρμογή με την ακόλουθη εντολή:

Πύθωνδιαχειρίζονται.pyδιακομιστής

Εάν δεν υπάρχουν σφάλματα, ανοίξτε http://127.0.0.1:8000/ σε ένα πρόγραμμα περιήγησης ιστού. Θα δείτε τη σελίδα προορισμού του έργου όπως φαίνεται παρακάτω:

Το μυστικό για την κλωνοποίηση ενός έργου Django

Η κλωνοποίηση έργων Django βοηθά στη βελτιστοποίηση του χρόνου σας. Μπορείτε να επικεντρωθείτε στην ανάπτυξη νέων δυνατοτήτων αντί να ξεκινήσετε ένα έργο από την αρχή.

Το μυστικό για την κλωνοποίηση και την εκτέλεση ενός έργου Django σε μια τοπική μηχανή είναι να γνωρίζετε πώς να χειρίζεστε τις εξαρτήσεις. Μετά την κλωνοποίηση, φροντίστε να δημιουργήσετε ένα νέο εικονικό περιβάλλον, να εγκαταστήσετε εξαρτήσεις και να συνδεθείτε σε ένα αξιόπιστο σύστημα βάσης δεδομένων.

Το Django είναι μια ισχυρή βιβλιοθήκη Python. Μάθετε πώς να κλωνοποιείτε και να χρησιμοποιείτε τα έργα της για να δημιουργείτε εκπληκτικές εφαρμογές που επηρεάζουν την τεχνολογική κοινότητα.