Bralci, kot ste vi, pomagajo podpirati MUO. Ko opravite nakup prek povezav na našem spletnem mestu, lahko zaslužimo partnersko provizijo.

Odprtokodni projekti so čedalje bolj povpraševani in ogromno jih je, v katere se lahko potopite. Če želite začeti delati na odprtokodnem projektu, vam pomaga, če lahko preprosto klonirate izvorno kodo in projekt nastavite lokalno.

Čeprav se kloniranje morda zdi enostavno, je lahko izziv pri projektih, zgrajenih z Djangom. Django ima veliko odvisnosti in paketov, ki povzročajo konflikte, če niso nameščeni.

Preden lahko projekt deluje na vašem lokalnem računalniku, morate odpraviti spore. Pa saj ti ni treba več trpeti.

V naslednjih korakih se boste naučili, kako klonirati, nastaviti in zagnati svoj projekt Django z minimalnimi konflikti.

Kaj boste potrebovali

Če želite kar najbolje izkoristiti ta vodnik, morate imeti naslednje:

  • Python (Python3 in novejši)
  • Delovno poznavanje knjižnice Python-Django
  • Pip3
  • Poznavanje virtualnih okolij Python
  • Osnovno poznavanje Git in GitHub
    • instagram viewer
  • Račun GitHub
  • Git je nameščen na vašem lokalnem računalniku
  • Poznavanje ukazne vrstice

Ko so te zahteve izpolnjene, ste pripravljeni na kloniranje projekta.

1. Klonirajte projekt iz GitHub

Vzorčni projekt lahko klonirate iz GitHub in ga konfigurirajte na vašem lokalnem računalniku.

Za kloniranje projekta kliknite na zeleni gumb z oznako Koda. V spustnem meniju izberite in kopirajte povezave HTTP ali SSH. Te povezave so URL-ji GitHub za projekt. Vsak od njih bo primeren.

Ko hočeš prispevati k odprtokodnemu projektu z uporabo Gita, boste morali najprej vilice projekt iz repozitorija projekta, da naredite kopijo pred kloniranjem.

Nazaj na svojo napravo nastavite mapo z imenom clone_boma. Ne pozabite se pomakniti do mape z cd clone_boma ukaz.

Nato zaženite naslednji ukaz, da klonirate projekt v mapo.

git klon <repository-url>

Torej, če želite klonirati vzorčni projekt prek HTTP, uporabite ta ukaz:

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

2. Preglejte projektne datoteke

Po kloniranju, uporabite ukaz ls preverite, ali so prisotne datoteke iz projekta Boma-watch. Vrsta ls za seznam celotne vsebine v mapi.

Uporabite lahko urejevalnik besedil po vaši izbiri, da pregledate vsebino vsake datoteke ali si jo ogledate na spletnem mestu GitHub.

3. Nastavite virtualno okolje

Za projekt morate nastaviti virtualno okolje. Vzorčni projekt je opremljen z okoljem Pipenv, ki določa odvisnosti projekta v dveh datotekah: Pipfile in Pipfile.lock.

Če zaženete projekt s starim Pipfileom, boste naleteli na to napako:

ModuleNotFoundError: Ni modula z imenom 'distutils.core'

Morate izbrisati virtualno okolje in ga namestiti na novo. Če želite izbrisati navidezno okolje in njegove odvisnosti, zaporedno zaženite naslednje ukaze.

Če želite odstraniti staro okolje:

pipenv --rm

Če želite odstraniti oba Pipfilea:

rm Pipfile*

Če želite namestiti svoje odvisnosti Pipenv na svojo različico python:

pipenv namestite--python 3.10

Nato zaženite naslednji ukaz za namestitev vseh paketov Pipfiles:

pipenv namestite zahteve

Nato aktivirajte virtualno okolje:

lupina pipenv

Na desni strani terminalskega okna boste videli aktivirano virtualno okolje.

Če uporabljate Venv za ustvarjanje virtualnega okolja, zaženite naslednje za namestitev odvisnosti:

pipnamestite-rzahteve.txt

Za seznam vseh nameščenih odvisnosti:

pip zamrznitev > zahteve.txt

4. Ustvari bazo podatkov

Za obdelavo projektnih podatkov morate namestiti bazo podatkov. Izberete lahko katero koli vrsto baze podatkov, ki ustreza vašim potrebam. Za vzorčni projekt bi morali uporabiti PostgresSQL.

Naučite se namestite PostgreSQL na Ubuntu oz namestite PostgreSQL v sistem Windows.

Ko je vse nastavljeno, zaženite lupino Postgres z naslednjimi ukazi:

sudo -i -u postgres
psql

Nato ustvarite bazo podatkov z imenom nova_boma na strežniku:

postgres=# ustvari bazo podatkov new_boma;

Strežnik vrne besedo CREATE DATABASE, ko ustvari bazo podatkov. Potrdite, da zbirka podatkov obstaja, tako da z ukazom navedete vse baze podatkov v sistemu \l:

notri nastavitve.py, morate bazo podatkov povezati z aplikacijo. To naredite tako, da zamenjate uporabnika baze podatkov, ime in geslo s svojimi lokalnimi vrednostmi:

#...
PODATKOVNE BAZE = {
'privzeto': {
'MOTOR':'django.db.backends.postgresql',
'IME':'nova_boma',
'UPORABNIK':'postgres',
'GESLO':'geslo',
 }
}

Prav tako ne pozabite spremeniti ČASOVNI PAS v datoteki settings.py, da ustreza vaši lokaciji. Tako bo vaša aplikacija posodobljena.

Prepričajte se, da ste namestili Psycopg2 za namestitev vseh razpoložljivih slik:

$ pipenv namestite psycopg2

5. Ustvarite skrivni ključ

Vsak projekt Django ima edinstveno skrivni ključ. Običajno skrivni ključ ni razkrit na spletu. Moralo bi biti v okolj datoteko, v katero bi morali vključiti datoteko .gitignore izključiti iz repozitorija.

Za izvajanje projekta morate ustvariti novega. Ustvarite nov skrivni ključ z generatorjem skrivnih ključev, npr Djecrety.

# VARNOSTNO OPOZORILO: skrivni ključ, uporabljen v proizvodnji, naj bo tajen!
SECRET_KEY = 'skrivni-ključ-pride-sem'

6. Preseli projekt v bazo podatkov

Zaženite naslednji ukaz, da ustvarite tabele za aplikacijo v novi bazi podatkov:

pythonupravljati.pymakemigrationsaplikacija

Nato zaženite naslednje za selitev:

pythonupravljati.pyseliti

Ko zaženete python manage.py migrate ukaz, naletite na napake. Napake vas obveščajo o manjkajočih modulih. Pred selitvijo obvezno namestite vse module.

Ko imate nameščene vse odvisnosti, zaženite selitev. Če se selitve končajo, je čas za zagon projekta.

Ko imate nameščene vse odvisnosti, zaženite selitev. Če se selitve izvajajo, je čas za izvedbo projekta.

7. Zaženite projekt

Zaženite projekt in se prepričajte, da je vse v redu, preden dodate svoj prispevek. Zaženite aplikacijo z naslednjim ukazom:

pythonupravljati.pyrunserver

Če ni napak, odprite http://127.0.0.1:8000/ v spletnem brskalniku. Videli boste ciljno stran projekta, kot je prikazano spodaj:

Skrivnost kloniranja projekta Django

Kloniranje projektov Django pomaga optimizirati vaš čas. Lahko se osredotočite na razvoj novih funkcij, namesto da začnete projekt iz nič.

Skrivnost kloniranja in izvajanja projekta Django na lokalnem računalniku je vedeti, kako ravnati z odvisnostmi. Po kloniranju zagotovite, da ustvarite novo navidezno okolje, namestite odvisnosti in se povežete z zanesljivim sistemom baze podatkov.

Django je zmogljiva knjižnica Python. Naučite se klonirati in uporabiti njegove projekte za ustvarjanje neverjetnih aplikacij, ki vplivajo na tehnično skupnost.