Como Instalar PostgreSQL e pgAdmin4 no Ubuntu 18.04 LTS

pgAdmin4 é uma ferramenta de gerenciamento de PostgreSQL de código aberto projetada para várias versões do banco de dados PostgreSQL. O pgAdmin4 foi criado com todos os recursos que podem ser encontrados no servidor PostgreSQL. Escrito em python e jquery, pode ser instalado no Windows, Mac e Linux. Ele fornece múltiplos modelos de implantação, podendo ser instalado como um aplicativo de desktop ou um aplicativo de servidor executando atrás do servidor web, como o Apache2.

Neste tutorial, vamos mostrar a instalação e configuração do pgAdmin4 ‘Modo Servidor’ no servidor Ubuntu 18.04. O pgAdmin4 será executado como um serviço uWSGI atrás do servidor web Apache, e cobriremos ambas as instalações do pgAdmin4 a partir do repositório e a partir do código-fonte.

Pré-requisitos

Ubuntu 18.04 Server
Privilégios de root
Conhecimento básico sobre a instalação do PostgreSQL

Instalar PostgreSQL no Servidor Ubuntu 18.04

Primeiramente, vamos mostrar a instalação e configuração básica do banco de dados PostgreSQL em si. Ele pode ser instalado a partir do repositório oficial do PostgreSQL e do repositório padrão do Ubuntu.

Se você deseja instalar o banco de dados PostgreSQL a partir do repositório oficial, adicione a chave e o repositório do Postgres executando os seguintes comandos.

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'

Depois disso, atualize todos os repositórios e instale o PostgreSQL.

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

Após a instalação, faça login no usuário padrão chamado ‘postgres’ e execute a interface de linha de comando ‘psql’ do PostgreSQL.

su - postgres  
 psql

Agora adicione uma nova senha para o usuário Postgres executando a seguinte consulta na interface psql.

\password postgres  
 DIGITE SUA SENHA

Instalar pgAdmin4 a partir do Repositório

Por padrão, o PostgreSQL fornece seu próprio repositório para instalar os pacotes pgAdmin4.

1. Adicionar Repositório do PostgreSQL

Baixe a chave do PostgreSQL e adicione o repositório executando o seguinte comando.

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. Instalar pgadmin4

Depois disso, atualize todos os repositórios disponíveis e instale os pacotes pgAdmin4 usando o comando apt abaixo.

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

Durante a instalação, você será solicitado a configurar o nome de usuário do e-mail e a configuração da senha.

Digite seu próprio endereço de e-mail que será usado como nome de usuário.

Em seguida, digite a senha.

Uma vez que a instalação esteja completa, abra seu navegador web e digite o endereço IP do servidor como abaixo.

http://10.9.9.15/pgadmin4/

E você verá a página de login do pgAdmin4. Faça login com seu endereço de e-mail e senha.

E você verá o painel do pgAdmin.

Instalar pgAdmin4 a partir do Código-Fonte

Para instalar o pgAdmin4 a partir do código-fonte, precisamos instalar algumas dependências de pacotes no sistema e configurar manualmente o servidor web Apache para servir o serviço uWSGI do pgAdmin4.

- Criar Usuário e Diretórios

Primeiramente, queremos instalar o pgAdmin4 em um usuário não-root. Portanto, precisamos criar um novo usuário e criar alguns diretórios para o pgAdmin4.

Crie um novo usuário chamado ‘ahmad’ executando o seguinte comando.

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

Agora crie o diretório de log do pgAdmin4 e os diretórios de dados para ‘sessions’ e ‘storage’.

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

Depois disso, mude o proprietário de todos esses diretórios para o usuário ‘ahmad’.

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

- Instalar Dependências

Instale todas as dependências de pacotes necessárias, como Python, Python pip e virtualenv para a instalação do pgAdmin4, executando os seguintes comandos.

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

Depois disso, instale o servidor web Apache2 e o mod_wsgi.

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

- Criar Ambiente Virtual Python

Para este guia, vamos instalar o pgAdmin4 dentro de um ambiente virtual python.

Faça login no usuário ‘ahmad’ e crie um novo ambiente virtual python chamado ‘pgadmin4’.

su - ahmad  
 virtualenv pgadmin4

Agora vá para o diretório ‘pgadmin4’ e ative o ambiente virtual.

cd pgadmin4/  
 source bin/activate

- Instalar pgadmin4

Dentro do ambiente virtual python, baixe o arquivo do pacote pgAdmin4 whl.

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

Em seguida, instale o pacote usando o comando pip.

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

Aguarde a instalação do pgAdmin4.

Para executar o pgAdmin4 no ‘Modo Servidor’, precisamos adicionar uma configuração adicional ao diretório de pacotes do site python.

Vá para o diretório ‘lib/python-version/site-packages/pgadmin4’ e crie um novo arquivo de configuração chamado ‘config_local.py’.

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

Cole a configuração abaixo.

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

Salve e feche.

Depois disso, execute o script ‘setup.py’.

python setup.py

E você será solicitado a configurar o e-mail e a senha do administrador. Digite seus dados e a instalação do pgAdmin está completa.

Nota:

Se você receber uma notificação sobre o pacote ‘psycopg2’ que será renomeado na próxima versão, basta instalar a versão binária do pacote.

pip install psycopg2-binary

Depois disso, desative o ambiente virtual python e mude o proprietário dos diretórios de log e dados do pgAdmin4 para o usuário ‘www-data’.

deactivate

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

- Configurar Apache2

Para este guia, o servidor web Apache2 será usado como um proxy reverso para a aplicação uWSGI pgAdmin4.

Vá para o diretório ‘/etc/apache2/sites-available’ e crie um novo arquivo de host virtual chamado ‘pgadmin4.conf’.

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

Altere o ‘ServerName’ com seu próprio nome de domínio e cole nele.


    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

Salve e feche.

Agora teste a configuração e ative os hosts virtuais do pgAdmin4.

apachectl configtest  
 a2ensite pgadmin4

Certifique-se de que não há erro, então reinicie o serviço Apache2.

systemctl restart apache2

Finalmente, o pgAdmin4 agora está ativo e funcionando como um serviço uWSGI atrás do navegador web Apache.

Agora abra seu navegador web e digite o nome de domínio do pgadmin.

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

E você verá a página de login do pgAdmin4 como abaixo.

Conectar ao Banco de Dados PostgreSQL com pgAdmin4

Faça login no Painel do pgAdmin4 usando seu endereço de e-mail e senha.

Agora clique no botão ‘Adicionar Servidor’, digite os detalhes do Servidor PostgreSQL que você deseja conectar.

E clique em ‘Salvar’.

Depois disso, você obterá detalhes sobre seu banco de dados PostgreSQL no painel lateral esquerdo.

Finalmente, o pgAdmin4 agora está instalado no Ubuntu 18.04