Czytelnicy tacy jak ty pomagają wspierać MUO. Kiedy dokonujesz zakupu za pomocą linków na naszej stronie, możemy otrzymać prowizję partnerską.

Projekty typu open source cieszą się coraz większym zainteresowaniem, a jest ich ogromna liczba, w których można się zatopić. Aby rozpocząć pracę nad projektem typu open source, pomocne jest łatwe sklonowanie kodu źródłowego i skonfigurowanie projektu lokalnie.

Chociaż klonowanie może wydawać się łatwe, może być trudne w przypadku projektów zbudowanych za pomocą Django. Django ma wiele zależności i pakietów, które powodują konflikty, gdy nie są zainstalowane.

Musisz rozwiązać konflikty, zanim projekt będzie mógł działać na komputerze lokalnym. Cóż, nie musisz już cierpieć.

W kolejnych krokach dowiesz się, jak sklonować, skonfigurować i uruchomić projekt Django przy minimalnych konfliktach.

Czego będziesz potrzebować

Aby jak najlepiej wykorzystać ten przewodnik, powinieneś mieć:

  • Python (Python3 i nowsze)
  • Praktyczna znajomość biblioteki Python-Django
  • Pip3
    • instagram viewer
  • Znajomość środowisk wirtualnych Python
  • Podstawowa znajomość Git i GitHub
  • Konto GitHub
  • Git zainstalowany na komputerze lokalnym
  • Znajomość wiersza poleceń

Po spełnieniu tych wymagań możesz przystąpić do sklonowania projektu.

1. Sklonuj projekt z GitHub

Możesz sklonować przykładowy projekt z GitHub i skonfiguruj go na komputerze lokalnym.

Aby sklonować projekt, kliknij zielony przycisk oznaczony etykietą Kod. Z listy rozwijanej wybierz i skopiuj łącza HTTP lub SSH. Te linki to adresy URL GitHub dla projektu. Każdy z nich to zrobi.

Kiedy chcesz przyczynić się do projektu open source za pomocą Git, najpierw będziesz musiał widelec projekt z repozytorium projektu, aby wykonać kopię przed klonowaniem.

Wróć do swojego komputera, skonfiguruj folder o nazwie clone_boma. Pamiętaj, aby przejść do folderu z plikiem cd clone_boma Komenda.

Następnie uruchom następujące polecenie, aby sklonować projekt do folderu.

klon git <adres URL repozytorium>

Tak więc, aby sklonować przykładowy projekt przez HTTP, użyj tego polecenia:

git klon https://github.com/Dindihub/Boma-watch.git

2. Sprawdź pliki projektu

po klonowaniu, użyj polecenia ls aby sprawdzić, czy pliki z projektu Boma-watch są obecne. Typ ls aby wyświetlić całą zawartość folderu.

Możesz użyć wybranego edytora tekstu, aby sprawdzić zawartość każdego pliku lub wyświetlić je w witrynie GitHub.

3. Skonfiguruj środowisko wirtualne

Musisz skonfigurować środowisko wirtualne dla projektu. Przykładowy projekt jest dostarczany ze środowiskiem Pipenv, które określa zależności projektu w dwóch plikach: Plik Pip I Pipfile.lock.

Napotkasz ten błąd, jeśli uruchomisz projekt ze starym Pipfile:

ModuleNotFoundError: Brak modułu o nazwie „distutils.core”

Musisz usunąć środowisko wirtualne i zainstalować je od nowa. Aby usunąć środowisko wirtualne i jego zależności, uruchom kolejno następujące polecenia.

Aby usunąć stare środowisko:

pipenv --rm

Aby usunąć oba pliki Pip:

rm plik Pip*

Aby zainstalować zależności Pipenv w swojej wersji Pythona:

pipenv zainstalować--python 3.10

Następnie uruchom następujące polecenie, aby zainstalować wszystkie pakiety Pipfiles:

pipenv zainstalować upraszanie

Następnie aktywuj środowisko wirtualne:

powłoka pipenv

Zobaczysz aktywowane środowisko wirtualne po prawej stronie okna terminala.

Jeśli używasz Venv do tworzenia środowiska wirtualnego, uruchom następujące polecenie, aby zainstalować zależności:

pypećzainstalować-Rwymagania.tekst

Aby wyświetlić listę wszystkich zainstalowanych zależności:

zamrożenie pipsa > wymagania.txt

4. Utwórz bazę danych

Musisz zainstalować bazę danych do obsługi danych projektu. Możesz wybrać dowolny rodzaj bazy danych, który odpowiada Twoim potrzebom. W przypadku przykładowego projektu należy użyć PostgresSQL.

Nauczyć się jak zainstaluj PostgreSQL na Ubuntu Lub zainstaluj PostgreSQL w systemie Windows.

Gdy wszystko jest ustawione, uruchom powłokę Postgres za pomocą następujących poleceń:

sudo -i -u postgres
psql

Następnie utwórz bazę danych o nazwie nowy_boma na serwerze:

postgres=# utwórz bazę danych new_boma;

Serwer zwraca słowo CREATE DATABASE podczas tworzenia bazy danych. Potwierdź, że baza danych istnieje, wyświetlając listę wszystkich baz danych w systemie za pomocą polecenia \l:

W ustawienia.py, musisz połączyć bazę danych z aplikacją. Zrób to, zastępując użytkownika bazy danych, nazwę i hasło własnymi wartościami lokalnymi:

#...
BAZY DANYCH = {
'domyślny': {
'SILNIK':'django.db.backends.postgresql',
'NAZWA':'nowy_boma',
'UŻYTKOWNIK':'postgres',
'HASŁO':'hasło',
 }
}

Pamiętaj też o zmianie STREFA CZASOWA w pliku settings.py, aby pasował do Twojej lokalizacji. Dzięki temu Twoja aplikacja będzie aktualizowana.

Upewnij się, że zainstalowałeś Psychopg2 aby pomieścić dostępne obrazy:

$ pipenv zainstalować psycopg2

5. Wygeneruj tajny klucz

Każdy projekt Django ma swój unikalny sekretny klucz. Zwykle tajny klucz nie jest ujawniany online. Powinno być w śr plik, do którego należy dołączyć plik .gitignore wykluczyć z repozytorium.

Aby uruchomić projekt, musisz wygenerować nowy. Utwórz nowy tajny klucz za pomocą generatora tajnych kluczy, na przykład Dżecrety.

# OSTRZEŻENIE DOTYCZĄCE BEZPIECZEŃSTWA: zachowaj tajny klucz używany w produkcji w tajemnicy!
SECRET_KEY = 'tajny-klucz-jest-tutaj'

6. Migruj projekt do bazy danych

Uruchom następujące polecenie, aby utworzyć tabele dla aplikacji w nowej bazie danych:

pytonzarządzać.pymigracjeaplikacja

Następnie uruchom następujące polecenie, aby przeprowadzić migrację:

pytonzarządzać.pymigrować

Kiedy uruchamiasz python Manage.py migracja polecenia, wystąpią błędy. Błędy informują o brakujących modułach. Pamiętaj, aby zainstalować wszystkie moduły przed migracją.

Po zainstalowaniu wszystkich zależności uruchom migrację. Jeśli migracje się zakończą, czas uruchomić projekt.

Po zainstalowaniu wszystkich zależności uruchom migrację. Jeśli migracje zostaną uruchomione, nadszedł czas na uruchomienie projektu.

7. Uruchom projekt

Uruchom projekt, aby upewnić się, że wszystko jest w porządku, zanim dodasz swój wkład. Uruchom aplikację za pomocą następującego polecenia:

pytonzarządzać.pyserwer uruchomieniowy

Jeśli nie ma błędów, otwórz http://127.0.0.1:8000/ w przeglądarce internetowej. Zobaczysz stronę docelową projektu, jak pokazano poniżej:

Sekret klonowania projektu Django

Klonowanie projektów Django pomaga zoptymalizować Twój czas. Możesz skoncentrować się na opracowywaniu nowych funkcji zamiast rozpoczynania projektu od zera.

Sekretem klonowania i uruchamiania projektu Django na lokalnej maszynie jest wiedza, jak radzić sobie z zależnościami. Po sklonowaniu upewnij się, że utworzysz nowe środowisko wirtualne, zainstalujesz zależności i połączysz się z niezawodnym systemem bazy danych.

Django to potężna biblioteka Pythona. Dowiedz się, jak klonować i wykorzystywać projekty firmy do tworzenia niesamowitych aplikacji, które mają wpływ na społeczność techniczną.