Pembaca seperti Anda membantu mendukung MUO. Saat Anda melakukan pembelian menggunakan tautan di situs kami, kami dapat memperoleh komisi afiliasi.

Proyek open-source semakin diminati, dan ada banyak sekali proyek yang bisa Anda manfaatkan. Untuk mulai mengerjakan proyek sumber terbuka, ada baiknya jika Anda dapat dengan mudah mengkloning kode sumber dan mengatur proyek secara lokal.

Meskipun kloning kelihatannya mudah, ini dapat menjadi tantangan dengan proyek yang dibangun dengan Django. Django memiliki banyak dependensi dan paket yang menyebabkan konflik saat tidak dipasang.

Anda harus memperbaiki konflik tersebut sebelum proyek dapat berjalan di mesin lokal Anda. Nah, Anda tidak perlu menderita lagi.

Di langkah selanjutnya, Anda akan mempelajari cara mengkloning, menyiapkan, dan menjalankan proyek Django Anda dengan konflik minimal.

Apa yang Akan Anda Butuhkan

Untuk mendapatkan hasil maksimal dari panduan ini, Anda harus memiliki yang berikut ini:

  • Python (Python3 dan yang lebih baru)
  • Pengetahuan tentang Pustaka Python-Django
  • Pip3
  • Keakraban dengan lingkungan virtual Python
  • Pengetahuan dasar tentang Git dan GitHub
  • Akun GitHub
  • Git terinstal di mesin lokal Anda
  • Keakraban dengan baris perintah

Dengan terpenuhinya persyaratan ini, Anda siap mengkloning proyek.

1. Menggandakan Proyek Dari GitHub

Anda dapat mengkloning proyek sampel dari GitHub dan konfigurasikan di mesin lokal Anda.

Untuk mengkloning proyek, klik tombol hijau berlabel Kode. Pada tarik-turun, pilih dan salin tautan HTTP atau SSH. Tautan ini adalah URL GitHub untuk proyek tersebut. Salah satu dari mereka akan melakukannya.

Bila Anda mau berkontribusi pada proyek sumber terbuka menggunakan Git, Anda harus melakukannya terlebih dahulu garpu proyek dari repositori proyek untuk membuat salinan sebelum kloning.

Kembali ke mesin Anda, siapkan folder bernama clone_boma. Ingatlah untuk menavigasi ke folder dengan cd clone_boma memerintah.

Selanjutnya, jalankan perintah berikut untuk mengkloning proyek ke dalam folder.

klon git <repositori-url>

Jadi, untuk mengkloning proyek sampel melalui HTTP, gunakan perintah ini:

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

2. Periksa File Proyek

Setelah kloning, gunakan perintah ls untuk memeriksa apakah ada file dari proyek Boma-watch. Jenis ls untuk mencantumkan semua konten dalam folder.

Anda dapat menggunakan editor teks pilihan Anda untuk memeriksa konten setiap file atau melihatnya di situs web GitHub.

3. Siapkan Lingkungan Virtual

Anda perlu menyiapkan lingkungan virtual untuk proyek tersebut. Proyek sampel hadir dengan lingkungan Pipenv yang menentukan dependensi proyek dalam dua file: Pipfile Dan Pipfile.lock.

Anda akan menemukan kesalahan ini jika Anda menjalankan proyek dengan Pipfile lama:

ModuleNotFoundError: Tidak ada modul bernama 'distutils.core'

Anda perlu menghapus lingkungan virtual dan menginstalnya kembali. Untuk menghapus lingkungan virtual dan dependensinya, jalankan perintah berikut secara berurutan.

Untuk menghapus lingkungan lama:

pipenv --rm

Untuk menghapus kedua file Pip:

rm Pipifile*

Untuk menginstal dependensi Pipenv Anda pada versi python Anda:

pipenv Install--python 3.10

Selanjutnya, jalankan perintah berikut untuk menginstal semua paket Pipfiles:

pipenv Install permintaan

Kemudian aktifkan lingkungan virtual:

shell pipenv

Anda akan melihat lingkungan virtual diaktifkan di sisi kanan jendela terminal Anda.

Jika Anda menggunakan Venv untuk membuat lingkungan virtual Anda, jalankan perintah berikut untuk menginstal dependensi:

pipInstall-Rpersyaratan.txt

Untuk mencantumkan semua dependensi yang diinstal:

pembekuan pip > persyaratan.txt

4. Buat Basis Data

Anda perlu menginstal database untuk menangani data proyek. Anda dapat memilih jenis database yang sesuai dengan kebutuhan Anda. Untuk proyek contoh, Anda harus menggunakan PostgresSQL.

Pelajari caranya instal PostgreSQL di Ubuntu atau instal PostgreSQL di Windows.

Setelah semuanya diatur, mulai shell Postgres menggunakan perintah berikut:

sudo -i -u postgres
psql

Kemudian buat database bernama new_boma di server:

postgres=# buat basis data new_boma;

Server mengembalikan kata CREATE DATABASE saat membuat database. Konfirmasikan bahwa database ada dengan mencantumkan semua database dalam sistem dengan perintah \l:

Di dalam pengaturan.py, Anda perlu menghubungkan database ke aplikasi. Lakukan ini dengan mengganti pengguna database, nama, dan kata sandi dengan nilai lokal Anda sendiri:

#...
DATABASE = {
'bawaan': {
'MESIN':'django.db.backends.postgresql',
'NAMA':'new_boma',
'PENGGUNA':'postgres',
'KATA SANDI':'kata sandi',
 }
}

Juga, ingatlah untuk berubah ZONA WAKTU di file settings.py agar sesuai dengan lokasi Anda. Ini akan membuat aplikasi Anda diperbarui.

Pastikan Anda telah menginstal Psycopg2 untuk mengakomodasi setiap gambar yang tersedia:

$ pipenv Install psycopg2

5. Hasilkan Kunci Rahasia

Setiap proyek Django memiliki keunikan kunci rahasia. Biasanya, kunci rahasia tidak diekspos secara online. Itu harus dalam lingkungan file yang harus Anda sertakan file .gitignore untuk dikecualikan dari repositori.

Anda harus membuat yang baru agar proyek Anda dapat berjalan. Buat kunci rahasia baru dengan pembuat kunci rahasia, seperti Jecrety.

# PERINGATAN KEAMANAN: rahasiakan kunci rahasia yang digunakan dalam produksi!
RAHASIA_KUNCI = 'kunci rahasia datang ke sini'

6. Migrasi Proyek ke Database

Jalankan perintah berikut untuk membuat tabel untuk aplikasi di database baru:

pythonmengelola.pymakemigrationsaplikasi

Kemudian jalankan perintah berikut untuk bermigrasi:

pythonmengelola.pymigrasi

Ketika Anda menjalankan python manage.py bermigrasi perintah, Anda mengalami kesalahan. Kesalahan memberi tahu Anda tentang modul yang hilang. Pastikan untuk menginstal semua modul sebelum Anda bermigrasi.

Ketika Anda telah menginstal semua dependensi, jalankan migrasi. Jika migrasi selesai, saatnya menjalankan proyek.

Ketika Anda telah menginstal semua dependensi, jalankan migrasi. Jika migrasi berjalan, saatnya menjalankan proyek.

7. Jalankan Proyek

Jalankan proyek untuk memastikan semuanya baik-baik saja sebelum menambahkan kontribusi Anda. Jalankan aplikasi dengan perintah berikut:

pythonmengelola.pyrunserver

Jika tidak ada kesalahan, buka http://127.0.0.1:8000/ di peramban web. Anda akan melihat halaman arahan proyek seperti yang ditunjukkan di bawah ini:

Rahasia Mengkloning Proyek Django

Mengkloning proyek Django membantu mengoptimalkan waktu Anda. Anda dapat berkonsentrasi pada pengembangan fitur baru alih-alih memulai proyek dari awal.

Rahasia untuk mengkloning dan menjalankan proyek Django di mesin lokal adalah mengetahui cara menangani dependensi. Setelah kloning, pastikan Anda membuat lingkungan virtual baru, menginstal dependensi, dan terhubung ke sistem database yang andal.

Django adalah perpustakaan Python yang kuat. Pelajari cara mengkloning dan menggunakan proyeknya untuk membuat aplikasi luar biasa yang memengaruhi komunitas teknologi.