"An error occurred while installing pg (X.X.X), and Bundler cannot continue."を解決する

## 背景
DockerでRailsとPostgreSQLの開発環境を作っていたときに直面したエラーです。

buildしようと思ったのですが、
pgのgemインストール時にエラーが起きbuildが完了しませんでた。

## 環境
Ruby（3.2.2）, Rails（7.1.1）, Docker, PostgreSQL

## 発生状況

Rails7.1では自動でDockerfileが生成されるので、
基本的にはそれをベースに構築をしようと考えました。

DBはSQLite3ではなくPostgreSQLを使う予定だったので、
gemに"pg"を追加。

```Dockerfile
# syntax = docker/dockerfile:1

# Make sure RUBY_VERSION matches the Ruby version in .ruby-version and Gemfile
ARG RUBY_VERSION=3.2.2
FROM registry.docker.com/library/ruby:$RUBY_VERSION-slim as base

# Rails app lives here
WORKDIR /rails

# Set production environment
ENV RAILS_ENV="production" \
    BUNDLE_DEPLOYMENT="1" \
    BUNDLE_PATH="/usr/local/bundle" \
    BUNDLE_WITHOUT="development"


# Throw-away build stage to reduce size of final image
FROM base as build

# Install packages needed to build gems
RUN apt-get update -qq && \
    apt-get install --no-install-recommends -y build-essential git libvips pkg-config

# Install application gems
COPY Gemfile Gemfile.lock ./
RUN bundle install && \
    rm -rf ~/.bundle/ "${BUNDLE_PATH}"/ruby/*/cache "${BUNDLE_PATH}"/ruby/*/bundler/gems/*/.git && \
    bundle exec bootsnap precompile --gemfile

# Copy application code
COPY . .

# Precompile bootsnap code for faster boot times
RUN bundle exec bootsnap precompile app/ lib/

# Precompiling assets for production without requiring secret RAILS_MASTER_KEY
RUN SECRET_KEY_BASE_DUMMY=1 ./bin/rails assets:precompile


# Final stage for app image
FROM base

# Install packages needed for deployment
RUN apt-get update -qq && \
    apt-get install --no-install-recommends -y curl libsqlite3-0 libvips && \
    rm -rf /var/lib/apt/lists /var/cache/apt/archives

# Copy built artifacts: gems, application
COPY --from=build /usr/local/bundle /usr/local/bundle
COPY --from=build /rails /rails

# Run and own only the runtime files as a non-root user for security
RUN useradd rails --create-home --shell /bin/bash && \
    chown -R rails:rails db log storage tmp
USER rails:rails

# Entrypoint prepares the database.
ENTRYPOINT ["/rails/bin/docker-entrypoint"]

# Start the server by default, this can be overwritten at runtime
EXPOSE 3000
CMD ["./bin/rails", "server"]
```

## 発生事象
いざbuildをすると、bundle installの時に"pg"のインストールに失敗する。

エラー内容（抜粋）
```terminal
Gem::Ext::BuildError: ERROR: Failed to build gem native extension.
Unable to find PostgreSQL client library.
```

```terminal
An error occurred while installing pg (1.5.4), and Bundler cannot continue.
In Gemfile: pg
```

## 解消方法
パッケージに`libpq-dev`を追加することで解決しました。

```Dockerfile
RUN apt-get update -qq && apt-get install -y build-essential libpq-dev nodejs
```

`libpq-dev `はPostgreSQLクライアントのヘッダやライブラリを含むパッケージで、
開発用にPostgreSQLをインストールするために必要だった模様。

https://zenn.dev/hs7/articles/2cc4d67650ba69

※実は長ーいログの中にヒントがありました。
見落としていて少し時間使ってしまったので反省です。。

```terminal
Please install libpq or postgresql client package like so:
sudo apt install libpq-dev
sudo yum install postgresql-devel
sudo zypper in postgresql-devel
sudo pacman -S postgresql-libs
```

## おまけ
自分がDockerの概念や仕組みを理解するのに役立った資料を載せておきます。
96ページとボリュームはありますが図やイラストで仕組みを解説してくださっていたので
脳内でのイメージが作りやすかったです。

https://www.slideshare.net/zembutsu/what-isdockerdoing