rails new で自動生成されたDockerfileと付随したパス問題

Question

自分で作ったDockerfileか、自動生成されるDockerfileか

状況

学習目的で、dockerでrailsの環境構築を試みています。Dockerfileからコンテナを作成しているわけですが、rails 7.1 から、rails new コマンドを実行するとDockerfileが自動生成されるようになったみたいです。そのため、コンテナで rails new を実行すると競合します。
コンテナ作成時には必要最小限のGemfileの記述だったこともあり、rails new 時に --force オプションをつけていたため、Dockerfileが書き換えられました。

相談したい点

自分の作ったDockerfileのままにするのか、生成されたDockerfileを利用すれば良いのか、良し悪しがわからず決めかねています。
初学者が作ったDockerfileなんかよりはまともなものなのだろうとは思いますが(自分のDockerfileがベースで作られてはいる？)、学習目的のためこれで良いものかという感もあります。

新しい方の機能ではあるため資料も少なく、判断しかねています。
どなたかお力添えを頂ければと思います。

自分が書いたDockerfileとdocker-compose.yml

FROM ruby:3.3.1

RUN mkdir /api
WORKDIR /api

COPY Gemfile /api/Gemfile
COPY Gemfile.lock /api/Gemfile.lock

RUN bundle install

COPY . /api

COPY entrypoint.sh /usr/bin/
RUN chmod +x /usr/bin/entrypoint.sh

ENTRYPOINT ["/usr/bin/entrypoint.sh"]

EXPOSE 3000

CMD ["rails", "server", "-b", "0.0.0.0"]

services:
  db:
    image: mysql:8.0.36
    environment:
      MYSQL_ROOT_PASSWORD: password
    volumes:
      - mysql-db:/var/lib/mysql
    ports:
      - "3306:3306"
  
  api:
    build:
      context: ./backend
    command: /bin/bash -c "rm -f tmp/pids/server.pid && bundle exec rails server -b '0.0.0.0'"
    volumes:
      - ./backend:/api
    environment:
      TZ: Asia/Tokyo
      RAILS_ENV: development
    depends_on:
      - db
    ports:
      - 3001:3000

volumes:
  mysql-db:

ファイルができた時点で、
$ docker compose run api rails new . --api --force --no-deps --database=mysql

を実行し、プロジェクトテンプレートが作成されると同時に、Dockerfileが自動生成され、forceオプションのため書き換えられました。

自動生成されたDockerfile

# syntax = docker/dockerfile:1

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

# Rails app lives here
WORKDIR /rails

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


# 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 default-libmysqlclient-dev 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/


# 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 default-mysql-client 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"]

Dockerfileが自動生成されたので、とりあえずこれで動くのか気になって、
$ docker compose build を実行しました。後述する問題は発生しましたが、ビルド&スタート自体は問題なく動きました。

付随して発生した問題

これに起因するものかわかりませんが、コンテナでrails コマンドが見つからない、というエラーが起きています。

❯ docker compose exec api rails db:create
OCI runtime exec failed: exec failed: unable to start container process: exec: "rails": executable file not found in $PATH: unknown

$ docker compose exec api bash
からコンテナに入り、$ gem environment を実行した結果は以下のようになりました。

RubyGems Environment:
  - RUBYGEMS VERSION: 3.5.9
  - RUBY VERSION: 3.3.1 (2024-04-23 patchlevel 55) [aarch64-linux]
  - INSTALLATION DIRECTORY: /usr/local/bundle
  - USER INSTALLATION DIRECTORY: /home/rails/.local/share/gem/ruby/3.3.0
  - RUBY EXECUTABLE: /usr/local/bin/ruby
  - GIT EXECUTABLE: 
  - EXECUTABLE DIRECTORY: /usr/local/bundle/bin
  - SPEC CACHE DIRECTORY: /home/rails/.cache/gem/specs
  - SYSTEM CONFIGURATION DIRECTORY: /usr/local/etc
  - RUBYGEMS PLATFORMS:
     - ruby
     - aarch64-linux
  - GEM PATHS:
     - /usr/local/bundle
     - /home/rails/.local/share/gem/ruby/3.3.0
     - /usr/local/lib/ruby/gems/3.3.0
  - GEM CONFIGURATION:
     - :update_sources => true
     - :verbose => true
     - :backtrace => true
     - :bulk_threshold => 1000
     - "install" => "--no-document"
     - "update" => "--no-document"
  - REMOTE SOURCES:
     - https://rubygems.org/
  - SHELL PATH:
     - /usr/local/bundle/bin
     - /usr/local/sbin
     - /usr/local/bin
     - /usr/sbin
     - /usr/bin
     - /sbin
     - /bin

rails@e77f9145448a:/rails$ rails -v
bash: rails: command not found

どの部分を見れば良いのかわかりません。
どなたか、お力添えをいただけますと幸いです。

Answer 1

自動生成されたDockerfileを読み、さまざまな記事やドキュメントを参考にしまして、自分なりの環境構築が完了したので、自己解決とします。

自動生成されたDockerfileは、本番環境向けのものだと思いますから、とりあえず開発環境を作る目的と合っていないので、自分が書いたものを Dockerfile.devに、自動生成されるものを Dockerfile.prodとして、2つ用意する方針にしました。
自動生成されるものは 「Dockerfile」ですから、forceオプションでの rails new で名前のバッティングは起きません。
その上で、compose.yamlにて、

build:
  context: ./backend
  dockerfile: Dockerfile.dev

以下略

とすることで、読むDockerfileを指定しました。

結論

開発環境として使うのは自分が書いた Dockerfileで、
自動生成されたDockerfileは名前を変えて残しておくという、どっちつかずな方法を取ることになってしまいました。
自動生成されたDockerfileの中身をじっくり調べることで、Dockerfileにどのような要素が必要なのか少しわかった気がします。
今後開発が進んでいく中で、自分のプロジェクトにあったコードの取捨選択ができるようになっていくのではないかと思います。

今回は回答はつきませんでしたが、読んで考えてくださった方いらっしゃいましたら、お時間を使っていただいてありがとうございました。

補足

結局、自分で作ったDockerfileからは、パス問題は起きませんでした。なんだったんだ。