Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Overhaul README and related updates #313

Merged
merged 6 commits into from
Apr 11, 2024
Merged

Conversation

onetimesecret
Copy link
Owner

@onetimesecret onetimesecret commented Apr 11, 2024

This pull request updates the README.md, docker-compose.yaml, and ruby matrix workflow for the v0.13.0 release of Onetime Secret.

Changes

Docker compose

  • Add detailed comments explaining usage and initial setup steps to docker-compose.yml
  • Provide an example command for customizing the runtime configuration.

Docker

  • Minor formatting changes to Dockerfile

README.md

  • Add links to the latest v0.13.0-RC2 release for Ruby 3+ and v0.12.1 release for Ruby 2.6/2.7.
  • Expand the installation instructions with system requirements, Docker Compose, and manual installation steps.
  • Clarify the instructions for running the web app.
  • Add a "Debugging" section with instructions for running in debug mode.
  • Update the configuration section with details on the config files and their respective settings.
  • Remove outdated or redundant sections.

These updates aim to provide clearer and more comprehensive documentation for installing, configuring, and running Onetime Secret, especially for the latest v0.13.0 release with Ruby 3+ support.

.github/workflows/ruby.yaml

Updates the Ruby versions matrix to specify the bundled and rubygem versions to use for each Ruby version. This ensures consistent dependencies.

  • Removes the step to manually update Rubygems, since the specific versions are now defined in the matrix.
  • Adds a step to setup a tmate debugging session when the workflow is run with the "debug_enabled" input.
  • Moves installing bundler to be part of the Ruby setup step using the pre-cached versions from the matrix.
  • Enables automatic caching of the bundle install output using the "bundler-cache" option.
  • Adds a cleanup step at the end to remove the test configuration file, to ensure a clean environment for subsequent runs.

@delano delano self-assigned this Apr 11, 2024
@delano delano added documentation ruby3 Related to ruby version 3+ ops Operational issues labels Apr 11, 2024
@delano delano added this to the Ruby 3+ Support milestone Apr 11, 2024
@onetimesecret
Copy link
Owner Author

onetimesecret commented Apr 11, 2024

PR Review

(Review updated until commit ed0b589)

⏱️ Estimated effort to review [1-5]

2, as the changes are mostly documentation updates and minor formatting changes to the Dockerfile.

🧪 Relevant tests

No

🔍 Possible issues

No

🔒 Security concerns

No

@onetimesecret
Copy link
Owner Author

Persistent review updated to latest commit ed0b589


When you send people sensitive info like passwords and private links via email or chat, there are copies of that information stored in many places. If you use a one-time link instead, the information persists for a single viewing which means it can't be read by someone else later. This allows you to send sensitive information in a safe way knowing it's seen by one person only. Think of it like a self-destructing message.

## How to install

## Installation
Copy link
Owner Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Consider adding a section on "Upgrading" with instructions on how to upgrade to a newer version of Onetime Secret. This could include steps like backing up the config files, pulling the latest Docker image, and any database migrations that may be required. [medium]

Ruby, Rubygems, and Bundler.
@delano delano changed the title Update README.md Overhaul README and related updates Apr 11, 2024
---
Run ruby/setup-ruby@v1
Modifying PATH
Downloading Ruby
Extracting  Ruby
Print Ruby version
Updating RubyGems
Installing Bundler
> bundle install
/opt/hostedtoolcache/Ruby/3.2.0/x64/bin/bundle config --local path /home/runner/work/onetimesecret/onetimesecret/vendor/bundle
/opt/hostedtoolcache/Ruby/3.2.0/x64/bin/bundle config --local deployment true
Cache key: setup-ruby-bundler-cache-v6-ubuntu-22.04-x64-ruby-3.2.0-wd-/home/runner/work/onetimesecret/onetimesecret-with--without--only--Gemfile.lock-4129b5b29d25d36df50d02bd4e134d7d5987e7656d15fd828b6922acc99e7746
/opt/hostedtoolcache/Ruby/3.2.0/x64/bin/bundle install --jobs 4
Fetching gem metadata from https://rubygems.org/.
Resolving dependencies...
Fetching bundler-graph 0.2.1
Installing bundler-graph 0.2.1
Installed plugin bundler-graph
The Ruby version ruby 3.2 from
/home/runner/work/onetimesecret/onetimesecret/Gemfile.lock could not be parsed.
Try running bundle update --ruby to resolve this.
Error: The process '/opt/hostedtoolcache/Ruby/3.2.0/x64/bin/bundle' failed with exit code 20
@delano delano marked this pull request as ready for review April 11, 2024 06:52
@delano delano merged commit aead963 into develop Apr 11, 2024
10 checks passed
@delano delano deleted the onetime/20240411-update-readme branch April 11, 2024 06:52
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation ops Operational issues Review effort [1-5]: 2 ruby3 Related to ruby version 3+
Projects
Status: Done
Development

Successfully merging this pull request may close these issues.

None yet

2 participants