Cách sao chép và chạy một dự án Django cục bộ
Các dự án mã nguồn mở ngày càng có nhu cầu và có một số lượng lớn để bạn phải tham gia. Để bắt đầu làm việc trên một dự án mã nguồn mở, sẽ rất hữu ích nếu bạn có thể dễ dàng sao chép mã nguồn và thiết lập dự án cục bộ.
Mặc dù việc nhân bản có vẻ dễ dàng, nhưng nó có thể là một thách thức với các dự án được xây dựng bằng Django. Django có nhiều phụ thuộc và gói gây ra xung đột khi không được cài đặt.
Bạn phải khắc phục các xung đột trước khi dự án có thể chạy trên máy cục bộ của bạn. Thôi, bạn không phải đau khổ nữa.
Trong các bước tiếp theo, bạn sẽ học cách sao chép, thiết lập và chạy dự án Django của mình với xung đột tối thiểu.
Mục Lục
Những gì bạn sẽ cần
Để tận dụng tối đa hướng dẫn này, bạn nên có những điều sau:
- Python (Python3 trở lên)
- Kiến thức làm việc về Thư viện Python-Django
- Pip3
- Quen thuộc với môi trường ảo Python
- Kiến thức cơ bản về Git và GitHub
- Một tài khoản GitHub
- Git được cài đặt trên máy cục bộ của bạn
- Làm quen với dòng lệnh
Với những yêu cầu này được đáp ứng, bạn đã sẵn sàng sao chép một dự án.
1. Sao chép dự án từ GitHub
Bạn có thể sao chép một dự án mẫu từ GitHub và định cấu hình nó trên máy cục bộ của bạn.
Để sao chép dự án, hãy nhấp vào nút màu xanh lá cây có nhãn Mã số. Trên menu thả xuống, chọn và sao chép các liên kết HTTP hoặc SSH. Các liên kết này là các URL GitHub cho dự án. Bất kỳ ai trong số họ sẽ làm.
Quay lại máy của bạn, thiết lập một thư mục có tên clone_boma. Hãy nhớ điều hướng vào thư mục với cd clone_boma yêu cầu.
Tiếp theo, chạy lệnh sau để sao chép dự án vào thư mục.
git clone <repository-url>Vì vậy, để sao chép dự án mẫu qua HTTP, hãy sử dụng lệnh sau:
git clone https:2. Kiểm tra tệp dự án
Sau khi sao chép, sử dụng lệnh ls để kiểm tra các tệp từ dự án Boma-watch có hiện diện hay không. Loại hình ls để liệt kê tất cả nội dung trong thư mục.
Bạn có thể sử dụng trình soạn thảo văn bản mà bạn chọn để kiểm tra nội dung của từng tệp hoặc xem chúng trên trang web GitHub.
3. Thiết lập môi trường ảo
Bạn cần thiết lập một môi trường ảo cho dự án. Dự án mẫu đi kèm với môi trường Pipenv chỉ định sự phụ thuộc của dự án trong hai tệp: Pipfile và Pipfile.lock.
Bạn sẽ gặp lỗi này nếu bạn chạy dự án với Pipfile cũ:
ModuleNotFoundError: Không có mô-đun nào có tên ‘distutils.core’
Bạn cần xóa môi trường ảo và cài đặt lại nó. Để xóa môi trường ảo và các phụ thuộc của nó, hãy chạy các lệnh sau liên tiếp.
Để xóa môi trường cũ:
pipenv
Để loại bỏ cả hai Pipfiles:
rm Pipfile* Để cài đặt phần phụ thuộc Pipenv của bạn trên phiên bản python của bạn:
pipenv install Tiếp theo, chạy lệnh sau để cài đặt tất cả các gói Pipfiles:
pipenv install requestsSau đó kích hoạt môi trường ảo:
pipenv shellBạn sẽ thấy môi trường ảo được kích hoạt ở phía bên phải của cửa sổ đầu cuối.
Nếu bạn đang sử dụng Venv để tạo môi trường ảo của mình, hãy chạy phần sau để cài đặt các phần phụ thuộc:
pip install -r requirements.txtĐể liệt kê tất cả các phần phụ thuộc đã cài đặt:
pip freeze > requirements.txt4. Tạo cơ sở dữ liệu
Bạn cần cài đặt cơ sở dữ liệu để xử lý dữ liệu của dự án. Bạn có thể chọn bất kỳ loại cơ sở dữ liệu nào phù hợp với nhu cầu của mình. Đối với dự án mẫu, bạn nên sử dụng PostgresSQL.
Tìm hiểu cách cài đặt PostgreSQL trên Ubuntu hoặc cài đặt PostgreSQL trên Windows.
Khi tất cả đã được thiết lập, hãy khởi động trình bao Postgres bằng các lệnh sau:
sudo -i -u postgrespsqlSau đó, tạo một cơ sở dữ liệu có tên new_boma trên máy chủ:
postgres=Máy chủ trả về từ CREATE DATABASE khi nó tạo cơ sở dữ liệu. Xác nhận rằng cơ sở dữ liệu tồn tại bằng cách liệt kê tất cả các cơ sở dữ liệu trong hệ thống bằng lệnh l:
Trong settings.py, bạn cần kết nối cơ sở dữ liệu với ứng dụng. Thực hiện việc này bằng cách thay thế người dùng, tên và mật khẩu cơ sở dữ liệu bằng các giá trị cục bộ của riêng bạn:
DATABASES = {
'default': {
'ENGINE':'django.db.backends.postgresql',
'NAME':'new_boma',
'USER':'postgres',
'PASSWORD':'password',
}
}Ngoài ra, hãy nhớ thay đổi MÚI GIỜ trong tệp settings.py để phù hợp với vị trí của bạn. Điều này sẽ giúp ứng dụng của bạn luôn được cập nhật.
Đảm bảo bạn đã cài đặt Psycopg2 để chứa bất kỳ hình ảnh nào có sẵn:
$ pipenv install psycopg25. Tạo khóa bí mật
Mỗi dự án Django đều có một chìa khoá bí mật. Thông thường, khóa bí mật không bị lộ trực tuyến. Nó phải ở trong một env tệp mà bạn nên đưa vào tệp .gitignore để loại trừ khỏi kho lưu trữ.
Bạn phải tạo một cái mới để chạy dự án của mình. Tạo khóa bí mật mới bằng trình tạo khóa bí mật, như Djecrety.
SECRET_KEY = 'secret-key-comes-here'6. Di chuyển dự án sang cơ sở dữ liệu
Chạy lệnh sau để tạo bảng cho ứng dụng trong cơ sở dữ liệu mới:
python manage.py makemigrations appSau đó, chạy phần sau để di chuyển:
python manage.py migrateKhi bạn chạy python management.py di chuyển lệnh, bạn gặp lỗi. Các lỗi đang thông báo cho bạn về việc thiếu mô-đun. Đảm bảo cài đặt tất cả các mô-đun trước khi bạn di chuyển.
Khi bạn đã cài đặt tất cả các phần phụ thuộc, hãy chạy quá trình di chuyển. Nếu quá trình di chuyển kết thúc, đã đến lúc chạy dự án.
Khi bạn đã cài đặt tất cả các phần phụ thuộc, hãy chạy quá trình di chuyển. Nếu quá trình di chuyển chạy, đã đến lúc chạy dự án.
7. Chạy dự án
Chạy dự án để đảm bảo mọi thứ đều ổn trước khi thêm đóng góp của bạn. Chạy ứng dụng bằng lệnh sau:
python manage.py runserverNếu không có lỗi, hãy mở http://127.0.0.1:8000/ trong trình duyệt web. Bạn sẽ thấy trang đích của dự án như hình bên dưới:
Bí mật để nhân bản một dự án Django
Nhân bản các dự án Django giúp tối ưu hóa thời gian của bạn. Bạn có thể tập trung vào việc phát triển các tính năng mới thay vì bắt đầu một dự án từ đầu.
Bí quyết để sao chép và chạy một dự án Django trên một máy cục bộ là biết cách xử lý các phần phụ thuộc. Sau khi nhân bản, hãy đảm bảo bạn tạo một môi trường ảo mới, cài đặt các phần phụ thuộc và kết nối với hệ thống cơ sở dữ liệu đáng tin cậy.
Django là một thư viện Python mạnh mẽ. Tìm hiểu cách sao chép và sử dụng các dự án của nó để tạo ra các ứng dụng tuyệt vời có tác động đến cộng đồng công nghệ.