Update dev instructions

[dfmcphee]

This updates the instructions for setting up your local dev environment to get the portal running.

I also added a sample file with local dev environment variables to make configuration a bit easier.

@jeffmaher and @TonyLeeVT can you try following these updated instructions and see if that resolves the issues you were seeing in #61 and #62?

[TonyLeeVT]

I cloned this branch and I still get this OpenSSL::Cipher::CipherError.

portal_1 | Caused by:
portal_1 | OpenSSL::Cipher::CipherError:
portal_1 | /usr/local/bundle/gems/activesupport-6.0.3.1/lib/active_support/message_encryptor.rb:201:in final' portal_1 | /usr/local/bundle/gems/activesupport-6.0.3.1/lib/active_support/message_encryptor.rb:201:in _decrypt'
portal_1 | /usr/local/bundle/gems/activesupport-6.0.3.1/lib/active_support/message_encryptor.rb:157:in decrypt_and_verify' portal_1 | /usr/local/bundle/gems/activesupport-6.0.3.1/lib/active_support/messages/rotator.rb:21:in decrypt_and_verify'
portal_1 | /usr/local/bundle/gems/activesupport-6.0.3.1/lib/active_support/encrypted_file.rb:80:in decrypt' portal_1 | /usr/local/bundle/gems/activesupport-6.0.3.1/lib/active_support/encrypted_file.rb:43:in read'
portal_1 | /usr/local/bundle/gems/activesupport-6.0.3.1/lib/active_support/encrypted_configuration.rb:21:in read' portal_1 | /usr/local/bundle/gems/activesupport-6.0.3.1/lib/active_support/encrypted_configuration.rb:33:in config'
portal_1 | /usr/local/bundle/gems/activesupport-6.0.3.1/lib/active_support/encrypted_configuration.rb:38:in options' portal_1 | /usr/local/bundle/gems/activesupport-6.0.3.1/lib/active_support/core_ext/module/delegation.rb:303:in method_missing'
portal_1 | /usr/local/bundle/gems/railties-6.0.3.1/lib/rails/application.rb:424:in secret_key_base' portal_1 | /usr/local/bundle/gems/railties-6.0.3.1/lib/rails/application.rb:177:in key_generator'
portal_1 | /usr/local/bundle/gems/globalid-0.4.2/lib/global_id/railtie.rb:28:in block (2 levels) in <class:Railtie>' portal_1 | /usr/local/bundle/gems/activesupport-6.0.3.1/lib/active_support/lazy_load_hooks.rb:68:in block in execute_hook'
portal_1 | /usr/local/bundle/gems/activesupport-6.0.3.1/lib/active_support/lazy_load_hooks.rb:61:in with_execution_control' portal_1 | /usr/local/bundle/gems/activesupport-6.0.3.1/lib/active_support/lazy_load_hooks.rb:66:in execute_hook'
portal_1 | /usr/local/bundle/gems/activesupport-6.0.3.1/lib/active_support/lazy_load_hooks.rb:52:in block in run_load_hooks' portal_1 | /usr/local/bundle/gems/activesupport-6.0.3.1/lib/active_support/lazy_load_hooks.rb:51:in each'
portal_1 | /usr/local/bundle/gems/activesupport-6.0.3.1/lib/active_support/lazy_load_hooks.rb:51:in run_load_hooks' portal_1 | /usr/local/bundle/gems/railties-6.0.3.1/lib/rails/application/finisher.rb:129:in block in module:Finisher'
portal_1 | /usr/local/bundle/gems/railties-6.0.3.1/lib/rails/initializable.rb:32:in instance_exec' portal_1 | /usr/local/bundle/gems/railties-6.0.3.1/lib/rails/initializable.rb:32:in run'
portal_1 | /usr/local/bundle/gems/railties-6.0.3.1/lib/rails/initializable.rb:61:in block in run_initializers' portal_1 | /usr/local/bundle/gems/railties-6.0.3.1/lib/rails/initializable.rb:60:in run_initializers'
portal_1 | /usr/local/bundle/gems/railties-6.0.3.1/lib/rails/application.rb:363:in initialize!' portal_1 | /app/config/environment.rb:5:in

'
portal_1 | /usr/local/bundle/gems/bootsnap-1.4.6/lib/bootsnap/load_path_cache/core_ext/kernel_require.rb:23:in require' portal_1 | /usr/local/bundle/gems/bootsnap-1.4.6/lib/bootsnap/load_path_cache/core_ext/kernel_require.rb:23:in block in require_with_bootsnap_lfi'
portal_1 | /usr/local/bundle/gems/bootsnap-1.4.6/lib/bootsnap/load_path_cache/loaded_features_index.rb:92:in register' portal_1 | /usr/local/bundle/gems/bootsnap-1.4.6/lib/bootsnap/load_path_cache/core_ext/kernel_require.rb:22:in require_with_bootsnap_lfi'
portal_1 | /usr/local/bundle/gems/bootsnap-1.4.6/lib/bootsnap/load_path_cache/core_ext/kernel_require.rb:31:in require' portal_1 | /usr/local/bundle/gems/zeitwerk-2.3.0/lib/zeitwerk/kernel.rb:23:in require'
portal_1 | /usr/local/bundle/gems/activesupport-6.0.3.1/lib/active_support/dependencies.rb:324:in block in require' portal_1 | /usr/local/bundle/gems/activesupport-6.0.3.1/lib/active_support/dependencies.rb:291:in load_dependency'
portal_1 | /usr/local/bundle/gems/activesupport-6.0.3.1/lib/active_support/dependencies.rb:324:in require' portal_1 | /usr/local/bundle/gems/railties-6.0.3.1/lib/rails/application.rb:339:in require_environment!'
portal_1 | /usr/local/bundle/gems/railties-6.0.3.1/lib/rails/application.rb:523:in block in run_tasks_blocks' portal_1 | /usr/local/bundle/gems/sprockets-rails-3.2.1/lib/sprockets/rails/task.rb:62:in block (2 levels) in define'
portal_1 | /usr/local/bundle/gems/railties-6.0.3.1/lib/rails/commands/rake/rake_command.rb:23:in block in perform' portal_1 | /usr/local/bundle/gems/railties-6.0.3.1/lib/rails/commands/rake/rake_command.rb:20:in perform'
portal_1 | /usr/local/bundle/gems/railties-6.0.3.1/lib/rails/command.rb:48:in invoke' portal_1 | /usr/local/bundle/gems/railties-6.0.3.1/lib/rails/commands.rb:18:in '
portal_1 | /usr/local/bundle/gems/bootsnap-1.4.6/lib/bootsnap/load_path_cache/core_ext/kernel_require.rb:23:in require' portal_1 | /usr/local/bundle/gems/bootsnap-1.4.6/lib/bootsnap/load_path_cache/core_ext/kernel_require.rb:23:in block in require_with_bootsnap_lfi'
portal_1 | /usr/local/bundle/gems/bootsnap-1.4.6/lib/bootsnap/load_path_cache/loaded_features_index.rb:92:in register' portal_1 | /usr/local/bundle/gems/bootsnap-1.4.6/lib/bootsnap/load_path_cache/core_ext/kernel_require.rb:22:in require_with_bootsnap_lfi'
portal_1 | /usr/local/bundle/gems/bootsnap-1.4.6/lib/bootsnap/load_path_cache/core_ext/kernel_require.rb:31:in require' portal_1 | /usr/local/bundle/gems/activesupport-6.0.3.1/lib/active_support/dependencies.rb:324:in block in require'
portal_1 | /usr/local/bundle/gems/activesupport-6.0.3.1/lib/active_support/dependencies.rb:291:in load_dependency' portal_1 | /usr/local/bundle/gems/activesupport-6.0.3.1/lib/active_support/dependencies.rb:324:in require'
portal_1 | bin/rails:4:in `'
portal_1 | Tasks: TOP => environment
portal_1 | (See full trace by running task with --trace)
portal_1 | rails aborted!

[dfmcphee]

Are you trying to run in a production environment or with docker-compose @TonyLeeVT? The changes and instructions in #73 may help with that. The error looks related to the rails credentials.

[kpeatt]

I tested this with the following steps:

1. brew install mysql
2. brew services start mysql
3. Copied config.yml as per instructions
4. rvm use 2.7.1
5. bundle install
6. yarn install
7. bundle exec rake db:create bundle exec rake db:migrate bundle exec rake db:seed
8. bundle exec rails server

Works.

[dfmcphee]

The failing build is for an unrelated security vulnerability. Will fix that in another PR as soon as a new version of lodash is released.