Merge pull request rails#51880 from Shopify/devcontainer-generator

Make devcontainers opt in and create a devcontainer command

Author: rafaelfranca

.github/workflows/devcontainer-smoke-test.yml

@@ -31,7 +31,7 @@ jobs:
           bundler-cache: true
 
       - name: Generate rails app sqlite3
-        run: bundle exec railties/exe/rails new myapp_sqlite --database="sqlite3" --dev
+        run: bundle exec railties/exe/rails new myapp_sqlite --database="sqlite3" --dev --devcontainer
 
       - name: Remove old deprecated docker-compose
         run: |
@@ -52,7 +52,7 @@ jobs:
         run: docker ps -q | xargs docker stop
 
       - name: Generate rails app postgresql
-        run: bundle exec railties/exe/rails new myapp_postgresql --database="postgresql" --dev
+        run: bundle exec railties/exe/rails new myapp_postgresql --database="postgresql" --dev --devcontainer
 
       - name: Test devcontainer postgresql
         uses: devcontainers/[email protected]
@@ -69,7 +69,7 @@ jobs:
         run: docker ps -q | xargs docker stop
 
       - name: Generate rails app mysql
-        run: bundle exec railties/exe/rails new myapp_mysql --database="mysql" --dev
+        run: bundle exec railties/exe/rails new myapp_mysql --database="mysql" --dev --devcontainer
 
       - name: Test devcontainer mysql
         uses: devcontainers/[email protected]
@@ -86,7 +86,7 @@ jobs:
         run: docker ps -q | xargs docker stop
 
       - name: Generate rails app trilogy
-        run: bundle exec railties/exe/rails new myapp_trilogy --database="trilogy" --dev
+        run: bundle exec railties/exe/rails new myapp_trilogy --database="trilogy" --dev --devcontainer
 
       - name: Test devcontainer trilogy
         uses: devcontainers/[email protected]

guides/source/command_line.md

@@ -67,7 +67,6 @@ If you wish to skip some files from being generated or skip some libraries, you
 | `--skip-bootsnap`       | Skip bootsnap gem                                        |
 | `--skip-dev-gems`       | Skip adding development gems                             |
 | `--skip-rubocop`        | Skip RuboCop setup                                       |
-| `--skip-devcontainer`   | Skip Dev Container setup                                 |
 
 These are just some of the options that `rails new` accepts. For a full list of options, type `rails new --help`.
 

guides/source/getting_started.md

@@ -198,7 +198,6 @@ of the files and folders that Rails creates by default:
 |.gitignore|This file tells git which files (or patterns) it should ignore. See [GitHub - Ignoring files](https://help.github.com/articles/ignoring-files) for more information about ignoring files.|
 |.rubocop.yml|This file contains the configuration for RuboCop.|
 |.ruby-version|This file contains the default Ruby version.|
-|.devcontainer/|This folder contains the Dev Container configuration|
 
 Hello, Rails!
 -------------

railties/lib/rails/commands/devcontainer/devcontainer_command.rb

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+require "rails/generators"
+require "rails/generators/rails/devcontainer/devcontainer_generator"
+
+module Rails
+  module Command
+    class DevcontainerCommand < Base # :nodoc:
+      desc "devcontainer", "Generate a Dev Container setup based on current application configuration"
+      def perform(*)
+        boot_application!
+
+        say "Generating Dev Container with the following options:"
+        devcontainer_options.each do |option, value|
+          say "#{option}: #{value}"
+        end
+
+        Rails::Generators::DevcontainerGenerator.new([], devcontainer_options).invoke_all
+      end
+
+      private
+        def devcontainer_options
+          @devcontainer_options ||= {
+            app_name: Rails.application.railtie_name.chomp("_application"),
+            database: !!defined?(ActiveRecord) && ActiveRecord::Base.connection_db_config.adapter,
+            active_storage: !!defined?(ActiveStorage),
+            redis: !!(defined?(ActionCable) || defined?(ActiveJob)),
+            system_test: File.exist?("test/application_system_test_case.rb"),
+            node: File.exist?(".node-version"),
+          }
+        end
+    end
+  end
+end

railties/lib/rails/generators/app_base.rb

@@ -12,7 +12,6 @@
 module Rails
   module Generators
     class AppBase < Base # :nodoc:
-      include Devcontainer
       include AppName
 
       NODE_LTS_VERSION = "20.11.1"
@@ -109,15 +108,15 @@ def self.add_shared_options_for(name)
         class_option :skip_ci,             type: :boolean, default: nil,
                                            desc: "Skip GitHub CI files"
 
-        class_option :skip_devcontainer,   type: :boolean, default: false,
-                                           desc: "Skip devcontainer files"
-
         class_option :skip_kamal,          type: :boolean, default: false,
                                            desc: "Skip Kamal setup"
 
         class_option :dev,                 type: :boolean, default: nil,
                                            desc: "Set up the #{name} with Gemfile pointing to your Rails checkout"
 
+        class_option :devcontainer,        type: :boolean, default: false,
+                                           desc: "Generate devcontainer files"
+
         class_option :edge,                type: :boolean, default: nil,
                                            desc: "Set up the #{name} with a Gemfile pointing to the #{edge_branch} branch on the Rails repository"
 
@@ -411,7 +410,11 @@ def skip_ci?
       end
 
       def skip_devcontainer?
-        options[:skip_devcontainer]
+        !options[:devcontainer]
+      end
+
+      def devcontainer?
+        options[:devcontainer]
       end
 
       def skip_kamal?
@@ -454,10 +457,6 @@ def to_s
         end
       end
 
-      def gem_ruby_version
-        Gem::Version.new(Gem::VERSION) >= Gem::Version.new("3.3.13") ? Gem.ruby_version : RUBY_VERSION
-      end
-
       def rails_prerelease?
         options.dev? || options.edge? || options.main?
       end

railties/lib/rails/generators/base.rb

@@ -423,6 +423,10 @@ def self.default_generator_root # :doc:
           path = File.expand_path(File.join(base_name, generator_name), base_root)
           path if File.exist?(path)
         end
+
+        def gem_ruby_version
+          Gem::Version.new(Gem::VERSION) >= Gem::Version.new("3.3.13") ? Gem.ruby_version : RUBY_VERSION
+        end
     end
   end
 end

railties/lib/rails/generators/devcontainer.rb

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
 require "rails/generators/app_base"
+require "rails/generators/rails/devcontainer/devcontainer_generator"
 
 module Rails
   module ActionMethods # :nodoc:
@@ -268,11 +269,17 @@ def config_target_version
     end
 
     def devcontainer
-      empty_directory ".devcontainer"
-
-      template ".devcontainer/devcontainer.json"
-      template ".devcontainer/Dockerfile"
-      template ".devcontainer/compose.yaml"
+      devcontainer_options = {
+        database: options[:database],
+        redis: !(options[:skip_action_cable] && options[:skip_active_job]),
+        system_test: depends_on_system_test?,
+        active_storage: !options[:skip_active_storage],
+        dev: options[:dev],
+        node: using_node?,
+        app_name: app_name
+      }
+
+      Rails::Generators::DevcontainerGenerator.new([], devcontainer_options).invoke_all
     end
   end
 

railties/lib/rails/generators/rails/app/app_generator.rb

@@ -18,7 +18,7 @@ default: &default
   # For details on connection pooling, see Rails configuration guide
   # https://guides.rubyonrails.org/configuring.html#database-pooling
   pool: <%%= ENV.fetch("RAILS_MAX_THREADS") { 5 } %>
-<% unless options[:skip_devcontainer] -%>
+<% if devcontainer? -%>
   <%% if ENV["DB_HOST"] %>
   host: <%%= ENV["DB_HOST"] %>
   username: postgres

railties/lib/rails/generators/rails/app/templates/config/databases/postgresql.yml.tt

@@ -1,18 +1,5 @@
 require "test_helper"
 
 class ApplicationSystemTestCase < ActionDispatch::SystemTestCase
-<% if skip_devcontainer? -%>
   driven_by :selenium, using: :headless_chrome, screen_size: [ 1400, 1400 ]
-<% else -%>
-  if ENV["CAPYBARA_SERVER_PORT"]
-    served_by host: "rails-app", port: ENV["CAPYBARA_SERVER_PORT"]
-
-    driven_by :selenium, using: :headless_chrome, screen_size: [ 1400, 1400 ], options: {
-      browser: :remote,
-      url: "http://#{ENV["SELENIUM_HOST"]}:4444"
-    }
-  else
-    driven_by :selenium, using: :headless_chrome, screen_size: [ 1400, 1400 ]
-  end
-<% end -%>
 end