Ubuntu 24.04 に pgAdmin 4 PostgreSQL 管理ツールをインストールする方法

このチュートリアルはこれらの OS バージョン用に存在します

Ubuntu 24.04 (Noble Numbat)
Ubuntu 18.04 (バイオニックビーバー)

このページでは

前提条件
PostgreSQLサーバーのインストール
PostgreSQL データベースとユーザーのセットアップ
pgAdmin4のインストール
pgAdmin4へのアクセス
結論

pgAdmin4 は、PostgreSQL 用の使いやすい無料のオープンソースグラフィカル管理ツールです。 PostgreSQL 9.6 以降をサポートし、Windows、macOS、Linux などの複数のオペレーティングシステム上で実行できます。 pgAdmin4 は、デスクトップユーザー向けのデスクトップモードと、Web ブラウザ経由でどこからでもアクセスできるサーバーモードの 2 つのモードで実行できます。

このチュートリアルでは、Ubuntu 24.04 に pgAdmin4 サーバーモードをインストールする方法を学習します。 pgAdmin4 は systemd サービスとしてバックグラウンドで実行され、Web ブラウザーからアクセスできます。このチュートリアルでは、公式 PostgreSQL リポジトリを介した Ubuntu への PostgreSQL のインストールと、PostgreSQL でデータベースとユーザーを設定する方法についても説明します。

前提条件

始める前に、以下のものがあることを確認してください。

Ubuntu 24.04 サーバー
管理者権限を持つ非 root ユーザー

PostgreSQLサーバーのインストール

pgAdmin4 をインストールする前に、公式 PostgreSQL リポジトリを通じて PostgreSQL サーバーをインストールしましょう。

まず、以下のコマンドを実行して PostgreSQL リポジトリの GPG キーをダウンロードし、「/usr/share/keyrings/postgresql-key.gpg」にエクスポートします。

curl https://www.postgresql.org/media/keys/ACCC4CF8.asc | gpg --dearmor | sudo tee /usr/share/keyrings/postgresql-key.gpg >/dev/null

次のコマンドを使用して、PostgreSQL リポジトリを Ubuntu システムに追加します。

sudo sh -c 'echo "deb [signed-by=/usr/share/keyrings/postgresql-key.gpg arch=amd64] http://apt.postgresql.org/pub/repos/apt $(lsb_release -cs)-pgdg main" > /etc/apt/sources.list.d/pgdg.list'

次に、以下の「apt」コマンドを実行して、Ubuntu パッケージのインデックスを更新し、PostgreSQL サーバーをインストールします。「Y」と入力してインストールを確認します。

sudo apt update && sudo apt install postgresql postgresql-contrib

インストールが完了したら、以下のコマンドを使用して 'postgresql' サービスのステータスを確認します。 PostgreSQL が有効になっており、ステータス「終了」で実行されていることがわかります。

sudo systemctl is-enabled postgresql
sudo systemctl status postgresql

PostgreSQL データベースとユーザーのセットアップ

PostgreSQL をインストールした後、PostgreSQL サーバー内に新しいユーザーとデータベースを作成する必要があります。この例では、「psql」または PostgreSQL シェルを使用して、新しい PostgreSQL データベースとユーザーを作成します。

以下の「psql」コマンドを使用して、PostgreSQL サーバーにログインします。

sudo -u postgres psql

次のクエリを実行して、パスワード「alicepassword」を持つ新しいユーザー 「alice」を作成し、PostgreSQL サーバー上のユーザーのリストを確認します。ユーザー名とパスワードは自分の情報で変更できます。

CREATE ROLE alice WITH SUPERUSER CREATEDB CREATEROLE LOGIN ENCRYPTED PASSWORD 'alicepassword';
\du

以下では、ユーザー「alice」が PostgreSQL で作成されたことがわかります。

ここで、次のクエリを実行して新しいデータベース 'alice を作成し、そのデータベース権限をユーザー 'alice ' に付与します。

CREATE DATABASE alice;
GRANT ALL PRIVILEGES ON DATABASE alice TO alice;

以下のクエリを使用して、PostgreSQL 上のデータベースのリストを確認します。

\l

新しいデータベース「alice」が作成されたことがわかります。

pgAdmin4のインストール

PostgreSQL サーバーのインストールと構成が完了したので、「pgAdmin4-web」サーバーモードをインストールする準備が整いました。これは、公式 pgAdmin4 リポジトリを通じてインストールできます。

次のコマンドを使用して、pgAdmin4 リポジトリの GPG キーをダウンロードします。

curl -fsSL https://www.pgadmin.org/static/packages_pgadmin_org.pub | sudo gpg --dearmor -o /usr/share/keyrings/pgadmin4.gpg

次に、以下のコマンドを使用して、Ubuntu システムの pgAdmin4 リポジトリを追加します。

sudo echo "deb [arch=amd64 signed-by=/usr/share/keyrings/pgadmin4.gpg] https://ftp.postgresql.org/pub/pgadmin/pgadmin4/apt/$(lsb_release -cs) pgadmin4 main"\
| sudo tee /etc/apt/sources.list.d/pgadmin4.list

次に、以下の「apt」コマンドを実行して Ubuntu パッケージインデックスを更新し、「pgadmin4-web」パッケージをインストールします。「Y」と入力してインストールを確認します。

sudo apt update && sudo apt install pgadmin4-web

インストールが完了したら、「setup-web.sh」スクリプトを実行して、pgAdmin4 インストールを構成します。

/usr/pgadmin4/bin/setup-web.sh

次に、以下の pgAdmin4 構成を尋ねられます。

pgAdmin4の認証に使用するメールアドレスとパスワードを入力してください
Apache をリバースプロキシとして構成するには、「y」と入力します。
「y」と入力して Apache Web サーバーを再起動し、変更を適用します。

pgAdmin4へのアクセス

Web ブラウザを開いて http://192.168.10.60/pgadmin4 にアクセスします。インストールが成功すると、pgAdmin4 ログインページが表示されます。

メールアドレスとパスワードを使用して pgAdmin4 ダッシュボードにログインします。

正しい電子メールアドレスとパスワードを持っている場合は、次のような pgAdmin4 ダッシュボードが表示されます。

pgAdmin4 にログインしたら、PostgreSQL サーバーに接続する必要があります。ダッシュボードの [新しいサーバーの追加] メニューをクリックします。

[全般] タブに接続名を入力します。
[接続] タブ内に PostgreSQL サーバーの詳細を入力します。
[パスワードを保存] オプションをオンにします。
[保存] をクリックします。

PostgreSQL サーバーに接続すると、次のようなページが表示されます。

結論

おめでとう！ Ubuntu 24.04 サーバーへの pgAdmin4 サーバーモードのインストールが完了しました。公式 PostgreSQL リポジトリを通じて PostgreSQL サーバーをインストールして構成し、リバースプロキシとして Apache を使用して pgAdmin4 をインストールしました。 pgAdmin4 ダッシュボードから PostgreSQL サーバーに接続する方法も学習しました。