[Django] 01 - 가상 환경을 사용하여 장고 프로젝트를 생성하고 접속해 보기

회사 일 때문에 익히고 있는데, 어차피 정리해야 하는 거 조금만 더 정성 들여서 써 본다. 깃헙 저장소를 하나 생성해서, 매 포스트마다 브랜치를 하나씩 만들 것이다.

목적
- 가상 환경 구성하고 진입하기
- 새 장고 프로젝트를 생성한 다음 실행하기
- 관리자 계정 만들고, 관리자 페이지에 들어가 보
- pip 패키지를 텍스트 파일로 빼거나 텍스트 파일에서 pip 패키지 설치하기
환경
- 인프라: AWS EC2 인스턴스. 편의를 위해 Elastic IP 하나 붙여 놓았다.
- OS: Ubuntu 22.04.3 LTS (Jammy Jellyfish)
- 편집기: VS Code
- Python: 3.11.0rc1
  - 24년 1월 기준으로, 위 OS 버전에서 `sudo apt update` 후 `sudp apt install python3.11` 실행하면 이 버전으로 설치된다.
  - 이전 버전도 동작에 큰 차이는 없을 것이다. 3.11 아래의 마이너 버전 차이는 무시해도 괜찮다.
Github 링크
- https://github.com/13-76003965/django-study/tree/01-initialization

가상 환경 구성
1. 가상 환경 설치
  지금은 막 쓰고 버려도 되는 EC2 인스턴스 위에서 돌리지만, 실제로는 그리 녹록치가 않다. 특히 여러 프로젝트가 한 개발 서버 위에 올라가 있으면서 프로젝트 별로 쓰는 패키지가 다를 수 있으며, 특히 서로 다른 버전의 같은 패키지를 사용하면 피곤해진다.
  1. 우선 루트 디렉토리 밑에 `venv`란 이름의 디렉토리를 하나 만들어 준다. .git과 README.md 같은 건 깃헙 저장소 생성 시 딸려온 녀석들이니 무시해도 괜찮다.
  2. 이 안에서 아래 명령을 실행하여 가상 환경 한 개를 만든다. 맨 앞의 python3.11 부분은 환경에 따라 다를 수 있다. 본인은 실제 업무 환경에서 쓰는 버전이 3.11이라, Ubuntu 22.04 설치 시 기본으로 나오는 3.10 버전을 무시하고 새로 하나 설치해서 쓰고 있다. `-m venv` 부분은 고정이고, 맨 마지막은 원하는 가상 환경 이름을 지정해 주면 된다.
```
# 파이썬 가상 환경 용 패키지 설치
$ sudo apt install python3.11-venv

# python3.11이란 이름의 가상 환경 생성
$ python3.11 -m venv python3.11
```
  3. 그럼 아래처럼 폴더 하나가 예쁘게 만들어진다.
2. 가상 환경 진입
  1. 위에서 생성한 가상 환경 안에 `bin` 디렉토리가 있다. 본 글과 마찬가지로 Ubuntu 환경이라면, source 명령어로 `activate` 파일을 지정해 주면 된다.
```
# 가상 환경 진입
$ source ~/dev/django-study/venv/python3.11/bin/activate

# 가상 환경에서 나가기
$ deactivate
```
    진입 후, CLI에서 맨 왼쪽에 가상 환경 이름이 같이 표시된다! 그 다음 `which` 명령을 아래와 같이 사용해 보면, 시스템 자체의 파이썬이 아닌 가상 환경 내부의 것을 사용한다는 것도 함께 확인 가능하다. 만약 여기서 `/usr/bin/python3.11` 이런 게 나온다면.. 다시 해 보자.
  2. 팁 - 편하게 가상 환경 진입하기
    1. 매번 source 어쩌고 치는 것도 고역이라, `~/.bashrc` 파일을 열어 alias를 지정해 주면 로그인을 아주 편하게 할 수 있다. venv 부분은 원하는 명령어를, source 뒷부분의 경로는 환경에 맞게 지정해 주면 된다. 심지어 얘는 ven 치고 탭 누르는 것도 그대로 가능하다. 저장 하고서 사용자 로그아웃 했다가 다시 들어와야 적용된다.
```
$ alias venv='source /home/ubuntu/dev/django-study/venv/python3.11/bin/activate'
```
3. git에서 가상 환경 디렉토리를 무시하도록 `.gitignore`에 추가
  가상 환경은 굳이 깃헙에 올릴 필요가 없으니, `.gitignore` 파일을 저장소의 루트 디렉토리에 하나 만들고 아래와 같이 입력한다. venv 외의 내용들은 일단 적어 두자. 나중에 필요하다.
새 장고 프로젝트 생성하고 실행
1. 장고 프로젝트 및 앱 관리는 `django-admin`이란 명령어로 해결한다. 이 명령어는 pip 패키지인 Django 내에 들어 있다.
```
# 버전 지정하여 장고 설치
$ pip3.11 install Django==5.0

# config란 이름의 프로젝트를 생성한다. 왜 이렇게 했는지는 후술.
$ django-admin startproject config
```
2. 기쁜 마음으로 디렉토리를 까 보면 이렇게 생겼다.
  1. manage.py
    1. 실제 장고 구동에 쓰이는 파일이다. 직접 건드릴 것은 많지 않다.
      가운데 위쯤에 있는 'config.settings'가 중요한데, 여기의 config는 위의 디렉토리 트리에서 보이는 config 아래의 config이다. startproject 명령어로 임의의 이름을 가진 프로젝트를 생성하면, 그 이름이 여기의 config 대신 들어갈 것이다. 그런데 어차피 기본 설정들이 들어가는 위치인데 굳이 다른 이름으로 냅두어 봐야 헷갈리기만 하더라.
      "그러면 그냥 프로젝트는 너 원하는 대로 하고 그 안의 저 디렉토리 이름을 바꾸면 되는 거 아님?" 근데 아래 코드에 있는 'config.settings'부분에 들어갈 녀석부터, settings.py, wsgi.py, asgi.py까지 'config.settings', 'config.urls', 블라블라.. 고칠 것들이 조금 있었다. 하려면 할 수 있겠지만, 그냥 프로젝트 루트 디렉토리 이름 하나 딱 고치는 게 편해서 위에서 한 대로 프로젝트 이름을 config로 해 버렸다.
```
#!/usr/bin/env python
"""Django's command-line utility for administrative tasks."""
import os
import sys


def main():
    """Run administrative tasks."""
    os.environ.setdefault('DJANGO_SETTINGS_MODULE', 'config.settings')
    try:
        from django.core.management import execute_from_command_line
    except ImportError as exc:
        raise ImportError(
            "Couldn't import Django. Are you sure it's installed and "
            "available on your PYTHONPATH environment variable? Did you "
            "forget to activate a virtual environment?"
        ) from exc
    execute_from_command_line(sys.argv)


if __name__ == '__main__':
    main()
```
      그래서 무엇을 해 보고 싶은지 생각을 해 보았는데, 인프라 부서 인간으로서 ITSM 페이지를 만들어 보고 싶어 디렉토리 이름을 itsm으로 고쳤다. to-do list는 많이 해 보기도 했고 그거 해 본 사람이 한국에만 해도 만 명 단위로 있을 것이다.
  2. 이제 준비가 되었다. 아래 명령어로 장고를 실행해 보자.
```
$ python3.11 ~/dev/django-study/itsm/manage.py runserver 0.0.0.0:8000
Watching for file changes with StatReloader
Performing system checks...

System check identified no issues (0 silenced).

You have 18 unapplied migration(s). Your project may not work properly until you apply the migrations for app(s): admin, auth, contenttypes, sessions.
Run 'python manage.py migrate' to apply them.
January 03, 2024 - 08:54:09
Django version 5.0, using settings 'config.settings'
Starting development server at http://0.0.0.0:8000/
Quit the server with CONTROL-C.
```
    You have로 시작되는 부분이 걸릴 수 있는데, 장고에 디폴트로 들어있는 Model 정보가 디비로 안 가 있는 것이다. 지금 당장 0.0.0.0:8000으로 확인해 보아도 되지만 일단 컨트롤 C 눌러서 나간 다음 아래 명령을 돌린다. 대충 설명하자면, makemigrations는 나중에 설명할 Model이라고 하는 DB 비슷한 것의 변경 사항을 감지하는 역할을, migrate는 그 변경 내역을 실제 DB에 반영하는 것이라 보면 된다.
    
    이후에 다시 장고를 실행해 보면 처음 나온 migrations 관련 경고가 안 뜰 것이다.
관리자 계정을 만들어 관리자 페이지에 들어가 보기
1. 장고의 갓 기능이다. DB를 직접 조작하는 짓을 이 관리자 페이지에서도 할 수 있다 .그러기 위해서는 우선 슈퍼 유저 하나를 만들어야 한다. 아래의 명령을 실행하고, 계정을 하나 만든다.
2. 그리고 장고를 실행한 다음, 0.0.0.0:8000/admin에 들어가 보자.
3. 이런 장고 관리자 페이지 메인 화면이 뜰 것이다. 이 부분부턴 다음 글에 씀.
pip 패키지 편하게 관리하기
1. 지금까지 pip에 설치한 패키지가 Django 하나뿐이다. 사실 의존성 있는 다른 패키지 둘도 더 있긴 하다.
2. `pip3.11 freeze > requirements.txt`로 빼 두면, 그 파일을 그대로 사용해서 다른 서버 등의 환경에서 동일하게 패키지를 설치할 수 있다.
```
$ pip3.11 install -r requirements.txt
```

code and chord

[Django] 01 - 가상 환경을 사용하여 장고 프로젝트를 생성하고 접속해 보기

티스토리툴바