004 PostgreSQL

1. PostgreSQL 이란?1. PostgreSQL 설치 2. PostgreSQL 사용하기 1. PostrgeSQL 실행 2. 데이터베이스 생성 3. 유저 생성 및 설정 4. 클라이언트 인증 파일 수정 3. 장고에 PostgreSQL 연결

이번에는 PostgreSQL을 터미널에서 세팅해 데이터베이스 생성, 유저권한 및 소유권 변경, Django에 연결을 해보도록 하겠습니다. 아래 내용을 따라 하시다가 어려우시면 PostgreSQL 적용은 나중에 하시는 것을 추천드립니다. 우선 Django의 구조가 익숙해지신 후에 적용하셔도 아무 문제 없습니다.

1. PostgreSQL 이란?

PostgreSQL은 굉장히 각광받고 있는 DB 중 하나입니다.

PostgreSQL

PostgreSQL is a powerful, open source object-relational database system with over 30 years of active development that has earned it a strong reputation for reliability, feature robustness, and performance. There is a wealth of information to be found describing how to install and use PostgreSQL through the official documentation.

https://www.postgresql.org/

문제는 PostgreSQL을 사용하려면 터미널에서 작업을 많이 해야한다는 점입니다. 앞에서 Django 세팅하는 부분을 진행했는데 터미널 세팅하는 부분이 굉장히 어려웠던 분은 이 부분은 패스하셔도 상관없습니다. 패스하시는 분들은 나중에 원하실 때 배우시면 좋을 것 같습니다.

1. PostgreSQL 설치

우선, 터미널로 실행을 하겠습니다.

apt-get을 업데이트해줍니다.


root@goorm:/workspace/instaclone# apt-get update

apt-get을 이용해 postgreSQL을 설치해줍니다.


root@goorm:/workspace/instaclone# apt-get install postgresql
Y

2. PostgreSQL 사용하기

1. PostrgeSQL 실행

PostgreSQL 실행시키겠습니다.


root@goorm:/workspace/instaclone# service postgresql start

PostgreSQL이 작동하는지 확인하겠습니다.


root@goorm:/workspace/instaclone# ps -ef|grep postgres

PostgreSQL은 설치가 되면서, 슈퍼 유저가 생성됩니다. 생성된 슈퍼유저로 접속을 해보겠습니다.


root@goorm:/workspace/instaclone# su - postgres

psql이라 입력하고 데이터베이스 안으로 들어가도록 하겠습니다.

2. 데이터베이스 생성

데이터베이스를 한 번 생성해 보도록 하겠습니다. instaclone이라는 이름의 database를 만드는 명령입니다. ;(세미콜론)을 빠트리면 안 됩니다.


create database instaclone;

CREATE DATABASE 라고 출력되면 성공적으로 database가 만들어 진 것입니다.

데이터베이스가 잘 생성 되었는지 확인해보겠습니다.

\l

instaclone database가 리스트에 있는 것을 볼 수 있습니다.

3. 유저 생성 및 설정

앞으로 계속 슈퍼유저를 사용할 수는 없기 때문에 데이터베이스 접근 권한을 가진 유저를 만들어 보겠습니다.

먼저 이름과 비밀번호를 가진 유저를 생성합니다.


create user username with password '12341234';

유저 이름은 username이고 비밀번호는 '12341234' 인 유저를 만들겠다는 명령어입니다.

username과 password는 본인이 정합니다.

CREATE ROLE 이 출력되면서 명령이 수행되었다고 볼 수 있습니다.

몇 가지 설정을 하도록 하겠습니다.

유저의 인코딩을 utf-8로 바꿉니다.


alter role username set client_encoding to 'utf-8';

유저의 시간을 서울 기준으로 바꿉니다.


alter role username set timezone to 'Asia/Seoul';

instaclone 이라는 database의 권한을 username에게 부여합니다.


grant all privileges on database instaclone to username;

\l 명령어를 통해 바뀐 설정을 확인해봅니다.

Access privileges 접근 권한에 username이 추가된 것을 볼 수 있습니다.

instaclone 유저로서 접근 권한을 가지게 되었지만, Owner가 postgres로 되어 있기 때문에 username으로 데이터베이스에 접속을 할 때 로그인이 안 됩니다. 그래서 username를 오너로 만들어 보겠습니다.

instaclone 이라는 DATABASE의 OWNER를 username으로 변경한다는 명령어입니다.


ALTER DATABASE instaclone OWNER TO username;

이제 instagram 데이터베이스의 Owner가 username으로 변경된 것을 확인할 수 있습니다.

4. 클라이언트 인증 파일 수정

클라이언트 인증에 관한 파일을 수정하도록 하겠습니다. 수정할 파일은 pg_hba.conf 라는 파일입니다.

먼저, 파일이 어디 있는지 확인해보겠습니다.


show hba_file;

pg_hba.conf 의 경로가 나옵니다.

해당 경로의 파일을 vim 에디터를 사용해서 파일 내용을 수정할 것입니다.

\q 명령어를 통해 데이터베이스를 빠져나오겠습니다.

이와 같이 데이터베이스에서 빠져나온 것을 볼 수 있습니다. 여기서 exit 명령어를 치면 postgreSQL을 완전히 종료할 수 있습니다.

아까 해당 경로의 파일을 vim 에디터로 엽니다. 아까 경로를 확인했던 것을 활용합니다. 경로는 버전마다 다를 수 있으니 참고해 주시길 바랍니다.


root@goorm:/workspace/instaclone/instaclone# vim /etc/postgresql/10/main/pg_hba.conf

방향키로 수정할 위치를 찾아가려고 합니다. 그 전에 줄 번호를 표시하려고 합니다. 일단 :(콜론)을 입력합니다.

:(콜론)을 입력하면 화면 하단에 : 이 생깁니다. Vim의 명령어를 입력할 수 있는 상태가 된 것입니다. 여기서 set number 또는 줄여서 set nu을 입력하고 Enter를 쳐봅니다.


:set number
:set nu

그러면 줄 번호가 표시됩니다. 이제 방향키로 파일 내용을 살펴보겠습니다. 방향키로 커서 위치를 조정할 수 있습니다. 아래 부분에 Unix domain socket connections only 라는 부분이 있습니다.

여기에 METHOD가 peer로 되어있습니다. 이것을 아래 항목과 같이 md5로 바꿀 것입니다.

vim 에서 수정모드로 들어가기 위해서는 i(insert) 를 누릅니다. (한영키 확인해주셔야 됩니다.)

i 를 누르면 화면 하단에 — 끼워넣기 — 라고 출력됩니다.

커서를 peer 로 옮겨서 Delete 키로 지우고 m를 입력합니다.

esc 를 눌러서 끼워 넣기 모드에서 빠져나옵니다.

마지막으로 파일을 저장해야 합니다. :(콜론)을 누르고 wq 명령어를 입력합니다.

:wq

wq는 저장(write)하고 나간다(quit)는 의미입니다. 파일을 성공적으로 수정하고 나왔습니다.

변경 사항을 잘 적용시키기 위해서 서버를 재시작 하겠습니다.


root@goorm:/workspace/instaclone/instaclone# service postgresql restart

입력하면, done이 출력되는 것을 볼 수 있습니다.

username 유저로 접속해보겠습니다. 일단 postgres를 실행합니다.


root@goorm:/workspace/instaclone/instaclone# su - postgres

postgres가 실행되면 다음 명령어를 통해 username으로 instaclone 데이터베이스에 접속을 시도합니다.


psql -U username -d instaclone

비밀번호를 입력하라고 나옵니다. 비밀번호는 아까 user를 생성할 때 설정한 것을 말합니다.

비밀번호를 입력하면, 성공적으로 유저로 instaclone 데이터베이스에 접속한 것을 볼 수 있습니다.

현재 username 유저로 접속한 것입니다. 데이터베이스 안에서 해야 되는 세팅은 전부 끝났습니다.

3. 장고에 PostgreSQL 연결

Django 안에 있는 settings.py 를 수정하도록 하겠습니다. 구름 IDE 컨테이너로 돌아가겠습니다.

먼저, 터미널에서 프로젝트 폴더로 디렉토리를 변경합니다.


root@goorm:/workspace/instaclone/instaclone# cd instaclone

이때, (master) 라는 표시는 Git이 추적하는 폴더라는 것을 의미합니다.

가상 환경(venv)을 활성화 합니다. 장고 프로젝트 관련 작업을 하기 전에는 항상 가상 환경이 활성화 되어있는지 확인하는 습관이 필요합니다.


root@goorm:/workspace/instaclone/instaclone# source venv/bin/activate

config/settings.py 파일을 열겠습니다.

config/settings.py 76번째 줄의 DATABASES 변수를 살펴보겠습니다.

이 부분은 Django의 데이터베이스와 관련된 내용을 딕셔너리 형태로 담고 있습니다. 프로젝트 생성시 default 값으로 SQLite3를 데이터베이스로 사용한다고 적혀있습니다. 이것을 수정하지 않으면 PostgreSQL을 설치해도 Django는 SQLite3를 데이터베이스로 사용하게 되는 것입니다.

DATABASES의 'default' 내용을 다음과 같이 수정합니다.

파일명 : config/settings.py


DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.postgresql',
        'NAME': 'instaclone',
        'USER': 'username',
        'PASSWORD': '12341234',
        'HOST': 'localhost',
        'PORT': '',
    }
}

앞으로도 프로젝트를 진행하면서 데이터베이스와 관련된 정보를 이 부분에서 다룰 수 있습니다. Django는 다양한 DB를 사용하기 좋은 환경을 갖고 있습니다. 추후에 다른 DB도 사용해볼 때도 이 부분을 수정하면 되겠습니다.

이제 migrate하면 Django가 PostgreSQL에 맞게 내용을 변경해줍니다.


(venv)root@goorm:/workspace/instaclone/instaclone# python manage.py migrate

하지만 아래와 같이 psycopg2라는 모듈이 없다는 에러가 표시될 수 있습니다.


django.core.exceptions.ImproperlyConfigured: Error loading psycopg2 module: No module named 'psycopg2'

이 경우 pip를 이용해 psycopg2-binary를 설치합니다.


(venv)root@goorm:/workspace/instaclone/instaclone# pip install psycopg2-binary

psycopg2-binary를 성공적으로 설치한 뒤, 다시 migrate를 시도합니다.


(venv)root@goorm:/workspace/instaclone/instaclone# python manage.py migrate

No module named 'imagekit' 라고 출력될 때, django-imagekit를 설치합니다.


root@goorm:/workspace/instaclone/instaclone# pip install django-imagekit

No module named 'PIL' 라고 출력될 때, pillow를 설치합니다.


root@goorm:/workspace/instaclone/instaclone# pip install pillow