Kaltaisesi lukijat auttavat tukemaan MUO: ta. Kun teet ostoksen käyttämällä sivustollamme olevia linkkejä, voimme ansaita kumppanipalkkion.

Avoimen lähdekoodin hankkeilla on yhä enemmän kysyntää, ja niitä on valtava määrä. Avoimen lähdekoodin projektin työskentelyn aloittaminen auttaa, jos voit helposti kloonata lähdekoodin ja määrittää projektin paikallisesti.

Vaikka kloonaus saattaa tuntua helpolta, se voi olla haastavaa Djangolla rakennetuissa projekteissa. Djangossa on monia riippuvuuksia ja paketteja, jotka aiheuttavat ristiriitoja, kun niitä ei asenneta.

Sinun on korjattava ristiriidat, ennen kuin projekti voidaan suorittaa paikallisella koneellasi. No, sinun ei tarvitse kärsiä enää.

Seuraavissa vaiheissa opit kloonaamaan, määrittämään ja suorittamaan Django-projektisi minimaalisilla konflikteilla.

Mitä tarvitset

Jotta saat kaiken irti tästä oppaasta, sinulla tulee olla seuraavat asiat:

  • Python (Python3 ja uudemmat)
  • Python-Django-kirjaston työtunti
  • Pip3
  • Python-virtuaaliympäristöjen tuntemus
  • Perustiedot Gitistä ja GitHubista
  • GitHub-tili
  • Git asennettuna paikalliselle koneellesi
  • Komentorivin tuntemus

Kun nämä vaatimukset täyttyvät, olet valmis kloonaamaan projektin.

1. Kloonaa projekti GitHubista

Voit kloonata esimerkkiprojektin kohteesta GitHub ja määritä se paikallisella koneellasi.

Kloonaaksesi projektin, napsauta vihreää painiketta Koodi. Valitse ja kopioi joko HTTP- tai SSH-linkit avattavasta valikosta. Nämä linkit ovat projektin GitHub-URL-osoitteita. Kuka tahansa heistä käy.

Milloin haluat osallistua avoimen lähdekoodin projektiin Gitin avulla, sinun on ensin haarukka projektin arkistosta tehdäkseen kopion ennen kloonausta.

Palaa koneellesi ja aseta kansio nimeltä clone_boma. Muista navigoida kansioon -painikkeella cd clone_boma komento.

Suorita seuraavaksi seuraava komento kloonataksesi projektin kansioon.

git klooni <repository-url>

Joten, jos haluat kloonata esimerkkiprojektin HTTP: n kautta, käytä tätä komentoa:

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

2. Tarkista projektitiedostot

Kloonauksen jälkeen käytä ls-komentoa tarkistaaksesi Boma-watch-projektin tiedostot ovat läsnä. Tyyppi ls listaaksesi kaiken kansion sisällön.

Voit käyttää valitsemaasi tekstieditoria tarkistaaksesi kunkin tiedoston sisällön tai tarkastella niitä GitHub-verkkosivustolla.

3. Luo virtuaalinen ympäristö

Sinun on määritettävä projektia varten virtuaalinen ympäristö. Esimerkkiprojektin mukana tulee Pipenv-ympäristö, joka määrittää projektin riippuvuudet kahdessa tiedostossa: Pipfile ja Pipfile.lock.

Kohtaat tämän virheen, jos suoritat projektia vanhalla Pipfile-tiedostolla:

ModuleNotFoundError: Ei moduulia nimeltä "distutils.core"

Sinun on poistettava virtuaaliympäristö ja asennettava se uudelleen. Voit poistaa virtuaaliympäristön ja sen riippuvuudet suorittamalla seuraavat komennot peräkkäin.

Vanhan ympäristön poistaminen:

pipenv --rm

Voit poistaa molemmat Pip-tiedostot seuraavasti:

rm Pipfile*

Pipenv-riippuvuuksien asentaminen python-versioosi:

pipenv Asentaa--python 3.10

Suorita seuraavaksi seuraava komento asentaaksesi kaikki Pipfiles-paketit:

pipenv Asentaa pyynnöt

Aktivoi sitten virtuaaliympäristö:

pipenv-kuori

Näet virtuaaliympäristön aktivoituna pääteikkunan oikealla puolella.

Jos käytät Venv-sovellusta virtuaaliympäristön luomiseen, asenna riippuvuudet suorittamalla seuraava:

pipAsentaa-rvaatimukset.txt

Voit luetella kaikki asennetut riippuvuudet seuraavasti:

pip jäädyttää > vaatimukset.txt

4. Luo tietokanta

Sinun on asennettava tietokanta käsitelläksesi projektitietoja. Voit valita minkä tahansa tietokannan tarpeisiisi. Esimerkkiprojektissa sinun tulee käyttää PostgresSQL: ää.

Opi kuinka asenna PostgreSQL Ubuntuun tai asenna PostgreSQL Windowsiin.

Kun kaikki on asetettu, käynnistä Postgres-kuori käyttämällä seuraavia komentoja:

sudo -i -u postgres
psql

Luo sitten tietokanta nimeltä uusi_boma palvelimella:

postgres=# luo tietokanta new_boma;

Palvelin palauttaa sanan CREATE DATABASE, kun se luo tietokannan. Varmista, että tietokanta on olemassa luettelemalla kaikki järjestelmän tietokannat komennolla \l:

Sisään settings.py, sinun on yhdistettävä tietokanta sovellukseen. Tee tämä korvaamalla tietokannan käyttäjä, nimi ja salasana omilla paikallisilla arvoillasi:

#...
TIETOKANNAT = {
'oletuksena': {
'MOOTTORI':'django.db.backends.postgresql',
'NIMI':'uusi_boma',
'KÄYTTÄJÄ':'postgres',
'SALASANA':'Salasana',
 }
}

Muista myös vaihtaa AIKAVYÖHYKE Settings.py-tiedostossa sijaintisi mukaan. Tämä pitää sovelluksesi ajan tasalla.

Varmista, että olet asentanut Psycopg2 käytettävissä olevien kuvien sisällyttämiseksi:

$ pipenv Asentaa psycopg2

5. Luo salainen avain

Jokaisella Django-projektilla on ainutlaatuinen salainen avain. Yleensä salaista avainta ei paljasteta verkossa. Sen pitäisi olla an env tiedosto, johon sinun tulee sisällyttää .gitignore-tiedosto sulkea pois arkistosta.

Sinun on luotava uusi, jotta projektisi voidaan suorittaa. Luo uusi salainen avain salaisen avaimen generaattorilla, kuten Djecrety.

# TURVALLISUUSVAROITUS: pidä tuotannossa käytetty salainen avain salassa!
SECRET_KEY = 'salainen avain tulee tänne'

6. Siirrä projekti tietokantaan

Suorita seuraava komento luodaksesi taulukoita sovellukselle uudessa tietokannassa:

pythonhallita.pymuuttavatsovellus

Siirrä sitten suorittamalla seuraava:

pythonhallita.pysiirtyä

Kun käytät python manager.py siirtää komento, saat virheitä. Virheet ilmoittavat puuttuvista moduuleista. Muista asentaa kaikki moduulit ennen siirtoa.

Kun olet asentanut kaikki riippuvuudet, suorita siirto. Jos siirrot päättyvät, on aika suorittaa projekti.

Kun olet asentanut kaikki riippuvuudet, suorita siirto. Jos siirrot suoritetaan, on aika suorittaa projekti.

7. Suorita projekti

Suorita projekti varmistaaksesi, että kaikki on kunnossa, ennen kuin lisäät panoksesi. Suorita sovellus seuraavalla komennolla:

pythonhallita.pyrunserver

Jos virheitä ei ole, avaa http://127.0.0.1:8000/ verkkoselaimessa. Näet projektin aloitussivun alla olevan kuvan mukaisesti:

Django-projektin kloonauksen salaisuus

Django-projektien kloonaus auttaa optimoimaan aikasi. Voit keskittyä uusien ominaisuuksien kehittämiseen sen sijaan, että aloitat projektin tyhjästä.

Django-projektin kloonauksen ja ajamisen salaisuus paikallisella koneella on tietää kuinka käsitellä riippuvuuksia. Varmista kloonauksen jälkeen, että luot uuden virtuaaliympäristön, asennat riippuvuudet ja muodostat yhteyden luotettavaan tietokantajärjestelmään.

Django on tehokas Python-kirjasto. Opi kloonaamaan ja käyttämään sen projekteja uskomattomien sovellusten luomiseen, jotka vaikuttavat teknologiayhteisöön.