メインコンテンツへスキップ
見出し画像

【IT】VMware Fusion上の Ubuntu に pgAdmin4 を Docker で導入・起動する手順

    皆さま
    こんにちは

    今回は、
    Mac (Apple Silicon )の
    VMware Fusion 上に
    ゲストOS:Ubuntu 22.04 LTS(ARM64)
    にpgAdmin4を導入します。

    pgAdminのサイトを確認するとx86_64版しかなく、
    arm64版は存在しません。

    今回は、Docker上にpgAdminを導入することしました。


    1.作業用ディレクトリを作成・移動

    任意のユーザでログインし、作業します。

    $ mkdir -p ~/pgadmin
    $ cd ~/pgadmin

    2. `docker-compose.yml` を作成・編集

    $ vi docker-compose.yml

    以下を貼り付け:
    ログイン名(メールアドレス)とパスワードは適宜変更ください。
    自動起動は、systemdで行いますので
    restart: always でなく、restart: no とします。

    services:
      pgadmin:
        image: dpage/pgadmin4
        container_name: pgadmin4
        restart: no
        ports:
          - "8099:80"
        environment:
          PGADMIN_DEFAULT_EMAIL: your-email@example.com
          PGADMIN_DEFAULT_PASSWORD: your-password
        volumes:
          - pgadmin_data:/var/lib/pgadmin
    
    volumes:
      pgadmin_data:

    3.コンテナの起動

    $ docker compose up -d

    4. 起動状態を確認

    $ docker ps

    出力例:

    CONTAINER ID   IMAGE            COMMAND            CREATED          STATUS          PORTS                                              NAMES
    abc123456789   dpage/pgadmin4   "/entrypoint.sh"   15 minutes ago   Up 14 minutes   443/tcp, 0.0.0.0:8099->80/tcp, [::]:8099->80/tcp   pgadmin4

    5. ブラウザでアクセス

    以下に、ブラウザーでアクセスします。
    但し、chromeで何故かアクセスできなため、
    今回は、サファリでアクセスします。

    http://<UbuntuのIPアドレス>:8099

    先ほど設定した、メールアドレスとパスワードを入力し、言語をJapanneseを選択し、`Login`をクリックします。

    画像

    ログインできましたのでこのあとサーバを追加してください。

    画像

    🔁 再起動後も自動起動させたい場合(systemdを使用)

    ・serviceファイルを作成します。

    $ sudo vi /etc/systemd/system/pgadmin4.service
    
    記載例
    -------------------------------------------
    [Unit]
    Description=pgAdmin4 via Docker Compose
    After=network.target docker.service
    Requires=docker.service
    
    [Service]
    Type=oneshot
    WorkingDirectory=/home/youruser/pgadmin
    ExecStart=/usr/bin/docker compose up -d
    ExecStop=/usr/bin/docker compose down
    RemainAfterExit=true
    
    [Install]
    WantedBy=multi-user.target
    -------------------------------------------
     
     WorkingDirectory は docker-compose.yml を置いているディレクトリに合わせて変更してください。

    ・以下、コマンドで有効化します。

    sudo systemctl daemon-reexec       # 念のため再読込
    sudo systemctl daemon-reload       # 新規作成・編集後はこれ
    sudo systemctl enable pgadmin4     # OS起動時に自動起動
    sudo systemctl start pgadmin4      # 起動

    ・起動しない場合は、以下のコマンドで確認します。

    sudo systemctl status pgadmin4
    journalctl -u pgadmin4.service

    🧼 補足:再インストールしたい場合

    以下で完全に消してやり直せます:

    docker compose down -v
    docker image rm dpage/pgadmin4
    rm -rf ./pgadmin_data  # ローカルに残っていれば

    🔐 Firewallが有効な場合

    • Firewallを直接解放の場合

    Firewallが有効の場合で、ゲストOSへ直接アクセスの場合は、
    以下のコマンドで許可します。

    sudo ufw allow 8099
    • SSHトンネルをの場合:(Mac上で実施)

    SSHトンネルを使用の場合は、Mac上のChromeからもアクセスできます。

    ssh -L 割り当てしたいPort番号:localhost:ローカルのポート番号 username @仮想サーバのIPアドレス   
    
    例 
    ssh -L 15432:localhost:8099 user@192.168.99.55



    ✅ トラブル時メモ

     `docker ps -a` :コンテナの状態確認(`Exited` 状態も表示) 
     `docker logs pgadmin4` : エラーログ確認 
     `docker compose config` :構文エラーがないか確認 
    `netstat -lpnt`:リッスンしているかの確認


    ✅ Chromeでアクセスする場合のメモ

    今回のようなローカルIPの場合、Chromeの仕様によりアクセスできない場合があります。
    以下のコマンドにてアクセスできますが、セキュリティ無効モードのためFireFoxやサファリ等を使用されることをおすすめします。

    Applications/Google\ Chrome.app/Contents/MacOS/Google\ Chrome \
    > --disable-web-security --user-data-dir="/tmp/chrome-dev"


    では

     
     
    インフラエンジニアとして実務メモを、 写真作家として写真物語を、 童話作家として物語を書いています。 写真作品は、ポートフォリオサイトとしてまとめていく予定です。

    あなたへのおすすめ