우분투 18.04 LTS에 PostgreSQL 및 pgAdmin4 설치하는 방법

pgAdmin4는 여러 PostgreSQL 데이터베이스 버전을 위해 설계된 오픈 소스 PostgreSQL 관리 도구입니다. pgAdmin4는 PostgreSQL 서버에서 찾을 수 있는 모든 기능으로 만들어졌습니다. Python과 jQuery로 작성되었으며 Windows, Mac 및 Linux에 설치할 수 있습니다. 여러 배포 모델을 제공하며, 데스크톱 애플리케이션 또는 Apache2와 같은 웹 서버 뒤에서 실행되는 서버 애플리케이션으로 설치할 수 있습니다.

이 튜토리얼에서는 우분투 18.04 서버에서 pgAdmin4 ‘서버 모드‘의 설치 및 구성을 보여드리겠습니다. pgAdmin4는 Apache 웹 서버 뒤에서 uWSGI 서비스로 실행되며, 저장소와 소스에서 pgAdmin4 설치를 모두 다룹니다.

전제 조건

• 우분투 18.04 서버
• 루트 권한
• PostgreSQL 설치에 대한 기본 지식

우분투 18.04 서버에 PostgreSQL 설치하기

먼저 PostgreSQL 데이터베이스 자체의 기본 설치 및 구성을 보여드리겠습니다. 공식 PostgreSQL 저장소와 기본 우분투 저장소에서 설치할 수 있습니다.

공식 저장소에서 PostgreSQL 데이터베이스를 설치하려면 다음 명령을 실행하여 Postgres 키와 저장소를 추가합니다.

wget --quiet -O - https://www.postgresql.org/media/keys/ACCC4CF8.asc | sudo apt-key add -  
sudo sh -c 'echo "deb http://apt.postgresql.org/pub/repos/apt/ `lsb_release -cs`-pgdg main" >> /etc/apt/sources.list.d/pgdg.list'

그 후, 모든 저장소를 업데이트하고 PostgreSQL을 설치합니다.

sudo apt update  
sudo apt -y install postgresql postgresql-contrib

설치 후, ‘postgres’라는 기본 사용자로 로그인하고 ‘psql’ PostgreSQL 명령줄 인터페이스를 실행합니다.

su - postgres  
psql

이제 psql 인터페이스에 다음 쿼리를 실행하여 Postgres 사용자에 대한 새 비밀번호를 추가합니다.

\password postgres  
 TYPE YOUR PASSWORD

저장소에서 pgAdmin4 설치하기

기본적으로 PostgreSQL은 pgAdmin4 패키지를 설치하기 위한 자체 저장소를 제공합니다.

1. PostgreSQL 저장소 추가하기

PostgreSQL 키를 다운로드하고 다음 명령을 실행하여 저장소를 추가합니다.

wget --quiet -O - https://www.postgresql.org/media/keys/ACCC4CF8.asc | sudo apt-key add -  
sudo sh -c 'echo "deb http://apt.postgresql.org/pub/repos/apt/ `lsb_release -cs`-pgdg main" >> /etc/apt/sources.list.d/pgdg.list'

2. pgAdmin4 설치하기

그 후, 모든 사용 가능한 저장소를 업데이트하고 아래의 apt 명령을 사용하여 pgAdmin4 패키지를 설치합니다.

sudo apt update  
sudo apt install pgadmin4 pgadmin4-apache2 -y

설치 중에 이메일 사용자 이름 구성 및 비밀번호 구성이 요청됩니다.

사용할 이메일 주소를 입력합니다.

그런 다음 비밀번호를 입력합니다.

설치가 완료되면 웹 브라우저를 열고 아래와 같이 서버 IP 주소를 입력합니다.

http://10.9.9.15/pgadmin4/

그러면 pgAdmin4 로그인 페이지가 표시됩니다. 이메일 주소와 비밀번호로 로그인합니다.

그리고 pgAdmin 대시보드를 얻습니다.

소스에서 pgAdmin4 설치하기

소스에서 pgAdmin4를 설치하려면 시스템에 일부 패키지 종속성을 설치하고 Apache 웹 서버를 수동으로 구성하여 pgAdmin4 uWSGI 서비스를 제공해야 합니다.

- 사용자 및 디렉토리 만들기

먼저 비루트 사용자로 pgAdmin4를 설치하려고 합니다. 따라서 새 사용자를 만들고 pgAdmin4를 위한 몇 개의 디렉토리를 생성해야 합니다.

다음 명령을 실행하여 ‘ahmad’라는 새 사용자를 만듭니다.

useradd -m -s /bin/bash ahmad  
passwd ahmad

이제 pgAdmin4 로그 디렉토리와 ‘세션’ 및 ‘저장소’를 위한 데이터 디렉토리를 만듭니다.

mkdir -p /var/log/pgadmin4/  
mkdir -p /var/lib/pgadmin4/{sessions,storage}

그 후, 모든 디렉토리의 소유자를 ‘ahmad’ 사용자로 변경합니다.

chown -R ahmad:ahmad /var/log/pgadmin4/ /var/lib/pgadmin4/

- 종속성 설치하기

pgAdmin4 설치에 필요한 모든 패키지 종속성을 설치합니다. Python, Python pip 및 virtualenv와 같은 패키지를 다음 명령을 실행하여 설치합니다.

sudo apt install build-essential libssl-dev libffi-dev libgmp3-dev virtualenv python-pip libpq-dev python-dev -y

그 후, Apache2 웹 서버와 mod_wsgi를 설치합니다.

sudo apt install apache2 apache2-utils libapache2-mod-wsgi libexpat1 ssl-cert python -y

- Python 가상 환경 만들기

이 가이드에서는 pgAdmin4를 Python 가상 환경 내에 설치할 것입니다.

‘ahmad’ 사용자로 로그인하고 ‘pgadmin4’라는 이름의 새로운 Python 가상 환경을 만듭니다.

su - ahmad  
virtualenv pgadmin4

이제 ‘pgadmin4’ 디렉토리로 이동하고 가상 환경을 활성화합니다.

cd pgadmin4/  
source bin/activate

- pgAdmin4 설치하기

Python 가상 환경 내에서 pgAdmin4 whl 패키지 파일을 다운로드합니다.

wget https://ftp.postgresql.org/pub/pgadmin/pgadmin4/v3.6/pip/pgadmin4-3.6-py2.py3-none-any.whl

그런 다음 pip 명령을 사용하여 패키지를 설치합니다.

pip install pgadmin4-3.6-py2.py3-none-any.whl

pgAdmin4 설치를 기다립니다.

‘서버 모드‘에서 pgAdmin4를 실행하려면 Python site-packages 디렉토리에 추가 구성을 추가해야 합니다.

‘lib/python-version/site-packages/pgadmin4’ 디렉토리로 이동하여 ‘config_local.py’라는 이름의 새 구성 파일을 만듭니다.

cd lib/python2.7/site-packages/pgadmin4/  
vim config_local.py

아래 구성을 붙여넣습니다.

LOG_FILE = '/var/log/pgadmin4/pgadmin4.log'
SQLITE_PATH = '/var/lib/pgadmin4/pgadmin4.db'
SESSION_DB_PATH = '/var/lib/pgadmin4/sessions'
STORAGE_DIR = '/var/lib/pgadmin4/storage'
SERVER_MODE = True

저장하고 닫습니다.

그 후, ‘setup.py’ 스크립트를 실행합니다.

python setup.py

그리고 관리자 이메일 및 비밀번호 구성을 요청받습니다. 세부 정보를 입력하면 pgAdmin 설치가 완료됩니다.

참고:

‘psycopg2’ 패키지가 다음 릴리스에서 이름이 변경될 것이라는 알림을 받으면, 패키지의 바이너리 버전을 설치하십시오.

pip install psycopg2-binary

그 후, Python 가상 환경을 비활성화하고 pgAdmin4 로그 및 데이터 디렉토리의 소유자를 ‘www-data’ 사용자로 변경합니다.

deactivate

chown -R www-data:www-data /var/lib/pgadmin4/  
chown -R www-data:www-data /var/log/pgadmin4/

- Apache2 구성하기

이 가이드에서는 Apache2 웹 서버를 pgAdmin4 uWSGI 애플리케이션의 리버스 프록시로 사용할 것입니다.

‘/etc/apache2/sites-available’ 디렉토리로 이동하여 ‘pgadmin4.conf’라는 이름의 새 가상 호스트 파일을 만듭니다.

cd /etc/apache2/sites-available/  
vim pgadmin4.conf

‘서버 이름’을 자신의 도메인 이름으로 변경하고 붙여넣습니다.

    ServerName pgadmin.ahmad-labs.io
    LogLevel debug
    ErrorLog ${APACHE_LOG_DIR}/pgadmin-error.log
    CustomLog ${APACHE_LOG_DIR}/pgadmin-access.log combined

    LoadModule wsgi_module modules/mod_wsgi.so
    WSGIDaemonProcess pgadmin processes=1 threads=25 python-home=/home/ahmad/pgadmin4
    WSGIScriptAlias / /home/ahmad/pgadmin4/lib/python2.7/site-packages/pgadmin4/pgAdmin4.wsgi
 
    
        WSGIProcessGroup pgadmin
        WSGIApplicationGroup %{GLOBAL}
        Require all granted
    

저장하고 닫습니다.

이제 구성을 테스트하고 pgAdmin4 가상 호스트를 활성화합니다.

apachectl configtest  
 a2ensite pgadmin4

오류가 없으면 Apache2 서비스를 재시작합니다.

systemctl restart apache2

마지막으로 pgAdmin4가 이제 Apache 웹 브라우저 뒤에서 uWSGI 서비스로 실행되고 있습니다.

이제 웹 브라우저를 열고 pgAdmin 도메인 이름을 입력합니다.

http://pgadmin.hakase-labs.io/

그러면 아래와 같은 pgAdmin4 로그인 페이지가 표시됩니다.

pgAdmin4로 PostgreSQL 데이터베이스에 연결하기

이메일 주소와 비밀번호를 사용하여 pgAdmin4 대시보드에 로그인합니다.

이제 ‘서버 추가‘ 버튼을 클릭하고 연결할 PostgreSQL 서버 세부 정보를 입력합니다.

그리고 ‘저장’을 클릭합니다.

그 후, 왼쪽 패널에서 PostgreSQL 데이터베이스에 대한 세부 정보를 얻습니다.

마지막으로 pgAdmin4가 이제 우분투 18.04에 설치되었습니다.

링크

• https://www.pgadmin.org/