litestream 0.2.0-arm64-darwin → 0.3.0-arm64-darwin

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: cbc4b2b3270f8d3bacc5955d079070b38d187072236da0518179c6bf01bbcba2
-  data.tar.gz: f2404ce88dc567c8939084d0c669b7a98de2345d8cc86ba567b201fa589cdea5
+  metadata.gz: 94fb80f9ef3cd7447ab648e32f9e27335e44873c5d24c1d68164681e7b664abd
+  data.tar.gz: 7edf023bffce57b2897457caa4521e015e831e926cbc96b04b0524d8d228f0d9
 SHA512:
-  metadata.gz: cb2dc8fffdaf734d950f2e4302ce0ddfe39812d83128c6d90ec07a9da0a4b6b0449684ad9d1bd004c0dc084411b14b4db75f070fd736a526cf00489714b47b3e
-  data.tar.gz: c9d09c933a53684d46ac99e7b446394ce98b3c2c859bc984b9653513882bd6bf6d07d9e9766075b13e7c6e1cee665dc26bbecca8e5b0e4b2ead75e14f205a5e7
+  metadata.gz: 5244cac74de5e9273e0a49a84d048d0232b8af3df90b1d8097f684427fb8ff297787d0893b3cbece8b76bd48e5fcef259816c29d895e37f5e3fc3ea077047712
+  data.tar.gz: b685df8c78e38f77cc532e2c7e8405d118aa2c8dfaac1a6d82c37d4f6cfb6dd8cfcb0a08a1493f0bfbb058fed8e8e883259771c5e2d366d94ea8d0488751ae73

data/README.md

@@ -82,6 +82,37 @@ Again, however, you can take full manual control over the replication process an
 
 The full set of commands available to the `litestream` executable are covered in Litestream's [command reference](https://litestream.io/reference/). Currently, only the `replicate` command is provided as a rake task by the gem.
 
+### Using in development
+
+By default, installing the gem does not update your `Procfile.dev` file, and so Litestream will not be started in development. If you would like to test that your configuration is properly setup, you can manually add the `litestream:replicate` rake task to your `Procfile.dev` file. Just copy the `litestream` definition from the production `Procfile`. Then, in order to have a replication bucket for Litestream to point to, you can use a Docker instance of [MinIO](https://min.io/). MinIO is an S3-compatible object storage server that can be run locally. You can run a MinIO server with the following command:
+
+```sh
+docker run -p 9000:9000 -p 9001:9001 minio/minio server /data --console-address ":9001"
+```
+
+This gets us up and running quickly but it will only persist the data for as long as the Docker container is running, which is fine for local development testing.
+
+To simplify local development, you can add this command to your `Procfile.dev` file as well. This would allow you to start a MinIO server and a Litestream replication process in your local development environment with the single `bin/dev` command.
+
+Once you have a MinIO server running, you can create a bucket for Litestream to use. You can do this by visiting the MinIO console at [http://localhost:9001](http://localhost:9001) and logging in with the default credentials of `minioadmin` and `minioadmin`. Once logged in, you can create a bucket named `mybkt` by clicking the `+` button in the bottom right corner of the screen. You can then use the following configuration in your `config/initializers/litestream.rb` file:
+
+```ruby
+Litestream.configure do |config|
+  config.database_path = ActiveRecord::Base.connection_db_config.database
+  config.replica_url = "s3://mybkt.localhost:9000/"
+  config.replica_key_id = "minioadmin"
+  config.replica_access_key = "minioadmin"
+end
+```
+
+With Litestream properly configured and the MinIO server and Litestream replication process running, you should see something like the following in your terminal logs when you start the `bin/dev` process:
+
+```sh
+time=YYYY-MM-DDTHH:MM:SS level=INFO msg=litestream version=v0.3.xx
+time=YYYY-MM-DDTHH:MM:SS level=INFO msg="initialized db" path=/path/to/your/app/storage/development.sqlite3
+time=YYYY-MM-DDTHH:MM:SS level=INFO msg="replicating to" name=s3 type=s3 sync-interval=1s bucket=mybkt path="" region=us-east-1 endpoint=http://localhost:9000
+```
+
 ## Development
 
 After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake test` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.

data/lib/litestream/commands.rb

@@ -73,12 +73,12 @@ module Litestream
     end
 
     def self.replicate
-      return if Litestream.configuration.nil?
-
-      ENV["LITESTREAM_DATABASE_PATH"] = Litestream.configuration.database_path
-      ENV["LITESTREAM_REPLICA_URL"] = Litestream.configuration.replica_url
-      ENV["LITESTREAM_ACCESS_KEY_ID"] = Litestream.configuration.replica_key_id
-      ENV["LITESTREAM_SECRET_ACCESS_KEY"] = Litestream.configuration.replica_access_key
+      if Litestream.configuration
+        ENV["LITESTREAM_DATABASE_PATH"] = Litestream.configuration.database_path
+        ENV["LITESTREAM_REPLICA_URL"] = Litestream.configuration.replica_url
+        ENV["LITESTREAM_ACCESS_KEY_ID"] = Litestream.configuration.replica_key_id
+        ENV["LITESTREAM_SECRET_ACCESS_KEY"] = Litestream.configuration.replica_access_key
+      end
 
       system(executable, "replicate", "--config", Rails.root.join("config", "litestream.yml").to_s)
     end

data/lib/litestream/generators/litestream/templates/litestream.rb

@@ -1,8 +1,38 @@
-litestream_credentials = Rails.application.credentials.litestream
+# Use this hook to configure the litestream-ruby gem.
+# All configuration options will be available as environment variables, e.g.
+# config.database_path becomes LITESTREAM_DATABASE_PATH
+# This allows you to configure Litestream using Rails encrypted credentials,
+# or some other mechanism where the values are only avaialble at runtime.
 
 Litestream.configure do |config|
-  config.database_path = ActiveRecord::Base.connection_db_config.database
-  config.replica_url = litestream_credentials.replica_url
-  config.replica_key_id = litestream_credentials.replica_key_id
-  config.replica_access_key = litestream_credentials.replica_access_key
+  # An example of using Rails encrypted credentials to configure Litestream.
+  # litestream_credentials = Rails.application.credentials.litestream
+  #
+  # The absolute or relative path to a SQLite database file.
+  # Litestream will monitor this file for changes and replicate them to the
+  # any of the configured replicas specified for this database in the
+  # `litestream.yml` configuration file.
+  # When using SQLite as your database engine for ActiveRecord, you should always
+  # set this to the path of your SQLite database file. You can do so using Rails'
+  # existing knowledge of the database path.
+  # config.database_path = ActiveRecord::Base.connection_db_config.database
+
+  # Short-hand form of specifying a replica location.
+  # When using S3, a value will look like "s3://mybkt.litestream.io/db"
+  # Litestream also supports Azure Blog Storage, Backblaze B2, DigitalOcean Spaces,
+  # Scaleway Object Storage, Google Cloud Storage, Linode Object Storage, and
+  # any SFTP server.
+  # In this example, we are using Rails encrypted credentials to store the URL to
+  # our storage provider bucket.
+  # config.replica_url = litestream_credentials.replica_url
+
+  # Replica-specific authentication key.
+  # Litestream needs authentication credentials to access your storage provider bucket.
+  # In this example, we are using Rails encrypted credentials to store the access key ID.
+  # config.replica_key_id = litestream_credentials.replica_key_id
+
+  # Replica-specific secret key.
+  # Litestream needs authentication credentials to access your storage provider bucket.
+  # In this example, we are using Rails encrypted credentials to store the secret access key.
+  # config.replica_access_key = litestream_credentials.replica_access_key
 end

data/lib/litestream/generators/litestream/templates/litestream.yml

@@ -1,3 +1,7 @@
+# This is the actual configuration file for litestream.
+# Edit this file as needed to configure your needs for litestream repication.
+#
+# For more details, see: https://litestream.io/reference/config/
 dbs:
   - path: $LITESTREAM_DATABASE_PATH
     replicas:

data/lib/litestream/version.rb

@@ -1,3 +1,3 @@
 module Litestream
-  VERSION = "0.2.0"
+  VERSION = "0.3.0"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: litestream
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.3.0
 platform: arm64-darwin
 authors:
 - Stephen Margheim
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2023-12-11 00:00:00.000000000 Z
+date: 2023-12-21 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rubyzip
@@ -98,7 +98,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.4.19
+rubygems_version: 3.5.1
 signing_key:
 specification_version: 4
 summary: Integrate Litestream with the RubyGems infrastructure.