Only use docker for solr and CI

Author: hackartisan

README.md

@@ -77,39 +77,54 @@ See the [Spotlight wiki](https://github.com/projectblacklight/spotlight/wiki) fo
 * The `main` branch is for development of the upcoming 5.0 release.
 * The `4.x` series is on the [release-4.x](https://github.com/projectblacklight/spotlight/tree/release-4.x) branch for backports of features and bug fixes.
 
-## Spotlight
+## Tooling
 
-* is a Rails engine and needs to be used in the context of a Rails application. We use [engine_cart](https://github.com/cbeer/engine_cart) to create an internal test application at .internal_test_app/
-* uses Solr as part of its integration tests. We use [solr_wrapper](https://github.com/cbeer/solr_wrapper) to manage the Solr instance used for development and test.
+* Spotlight is a Rails engine and needs to be used in the context of a Rails application. We use [engine_cart](https://github.com/cbeer/engine_cart) to create an internal test application at .internal_test_app/
+* Spotlight relies on Solr for its integration tests and to run a development instance. [solr_wrapper](https://github.com/cbeer/solr_wrapper) allows us to provide terse commands for development and testing. For more granular control you can run Solr in Docker, then execute services and processes individually.
 
 See more detailed instructions for development environment setup at ["Contributing to Spotlight"](https://github.com/projectblacklight/spotlight/wiki/Contributing-to-Spotlight)
 
 ## Run a development server
 
-### With EngineCart
-```
-$ rake spotlight:server
-```
+After following one of the instructions below, visit http://localhost:3000. A Solr instance will be running on port 8983. When using importmap (the default configuration), JavaScript changes in development should not require [bundling](#updating-the-javascript-bundle) or a server restart.
 
-Then visit http://localhost:3000. A Solr instance will be running on port 8983. When using importmap (the default configuration), JavaScript changes in development should not require [bundling](#updating-the-javascript-bundle) or a server restart.
+### With solr_wrapper
+```sh
+rake spotlight:server
+```
 
 ### With Docker
 
 ```sh
-# because of how docker compose handles named images, running `docker compose up --build` will error when the Rails images have not been built locally
-docker compose build
-docker compose up
+docker compose up -d
+rake engine_cart:generate
+rake spotlight:fixtures
+cd .internal_test_app
+rake spotlight:seed_admin_user
+bin/dev
 ```
 
 ## Tests
 
-### Run all the tests:
+### With solr_wrapper
 
+```sh
+rake
 ```
-$ rake
+
+This runs rubocop style enforcement and then all tests, starting solr and building the testing rails app automatically.
+
+### With Docker
+
+```sh
+docker compose up -d
+rake engine_cart:generate
+rake spotlight:fixtures
+cd .internal_test_app && rake spec:prepare && cd -
+rspec
 ```
 
-This utilizes Solr and the testing rails app automatically.
+Using rspec directly allows you to run individual test files / lines.
 
 ## Translations
 

bin/db-migrate-seed.sh

@@ -1,37 +1,4 @@
 services:
-  web:
-    build:
-      context: .
-    image: spotlight
-    stdin_open: true
-    tty: true
-    restart: always
-    env_file:
-      - .env
-    volumes:
-      - .:/spotlight/engine
-      - spotlight_app:/spotlight/app
-    ports:
-      - 3000:3000
-    depends_on:
-      - db_migrate
-      - solr
-    networks:
-      - spotlight
-
-  db_migrate:
-    image: spotlight
-    env_file:
-      - .env
-    environment:
-      SKIP_TRANSLATION: "yes"
-    entrypoint: sh -c '/spotlight/engine/bin/db-migrate-seed.sh'
-    volumes:
-      - .:/spotlight/engine
-      - spotlight_app:/spotlight/app
-    networks:
-      - spotlight
-
   solr:
     environment:
       - SOLR_PORT # Set via environment variable or use default defined in .env file
@@ -47,14 +14,3 @@ services:
       - solr-precreate
       - blacklight-core
       - /opt/solr/conf
-    networks:
-      - spotlight
-
-volumes:
-  spotlight_app:
-
-networks:
-  spotlight:
-    driver: bridge
-    driver_opts:
-      com.docker.network.bridge.name: br-spotlight