convox_installer 1.0.8 → 3.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ae064bb3fa4954c0edd52b0d97127477ed73f0059c36b6c71f0f091b5b93608e
-  data.tar.gz: 8cadcac34a2eeaf4b68f323b5e9c2dd9ec528be4cf14a5fe2b9145cb0cb9d8cd
+  metadata.gz: ea8a81c025b1a5046d3145beeee5cba92f8448cc8751182d911f3548b289c31a
+  data.tar.gz: 8eb61f167e06eb67bcd86eada0196d138995b3e61b237ce04f11891f6eb1426c
 SHA512:
-  metadata.gz: b4ba638e5dffe9ab773f4b5f5bad934fc112c2cdc2cede74ca7e8ae2351bf900d33a7681ec20e9bbcbd7813e62e1e4b927aa78ba30041ec0cc3644bd2a753f4e
-  data.tar.gz: a1e4ef7404bf7da3d425c0d5ac0192d035949bf3467a28fee45b244316e07473cff3dcfe361768f7f638984ac1949c5ccdc68d5cb9ddcfc16c1da1bcb9c19186
+  metadata.gz: db7f9e671230b4054a888397461056af9f8ee2d631e0d05fb4eda32a138ae947e7f7fdee8706ea3b9b695254d9fa8b5c2971222a68d8ba4ad8a1326917357f65
+  data.tar.gz: 8dd7d82786491eca18253d6dc405675fbe6c188c0276878ed352e3f9c17770aca9a4906b8819d061dd6940a203832e0808e9f1aa8427bddc9505d89974f39c69

data/.rubocop.yml

@@ -1,7 +1,14 @@
 require: rubocop-rspec
-TargetRubyVersion: "2.3"
 
-Metrics/LineLength:
+AllCops:
+  NewCops: enable
+  TargetRubyVersion: 2.5
+
+Style/MixinUsage:
+  Exclude:
+    - examples/**/*
+
+Layout/LineLength:
   Max: 100
 
 Style/StringLiterals:
@@ -39,3 +46,18 @@ Metrics/BlockLength:
 
 Metrics/BlockNesting:
   Max: 7
+
+RSpec/MessageSpies:
+  Enabled: false
+
+RSpec/StubbedMock:
+  Enabled: false
+
+RSpec/MultipleExpectations:
+  Enabled: false
+
+RSpec/ExampleLength:
+  Enabled: false
+
+RSpec/AnyInstance:
+  Enabled: false

data/.vscode/settings.json

@@ -1,4 +1,5 @@
 {
   "editor.formatOnSave": true,
-  "editor.formatOnSaveTimeout": 5000
-}
+  "editor.formatOnSaveTimeout": 5000,
+  "ruby.rubocop.executePath": "/usr/local/bin/rubocop-daemon-wrapper/"
+}

data/Gemfile

@@ -5,10 +5,11 @@ source 'https://rubygems.org'
 gemspec
 
 group :test do
-  gem 'pry'
-  gem 'pry-byebug'
+  gem 'pry', require: false
+  gem 'pry-byebug', require: false
   gem 'rspec'
   gem 'rubocop'
+  gem 'rubocop-daemon'
   gem 'rubocop-rspec'
   gem 'vcr'
   gem 'webmock'

data/README.md

@@ -1,10 +1,26 @@
 # Convox Installer
 
-A Ruby gem that makes it easier to build a Convox installation script. This is like Chef/Ansible/Terraform for your initial Convox setup.
+A Ruby gem that makes it easier to build a Convox installation script. The main purpose of this gem is to make it easier to set up on-premise installations of your app for enterprise users.
 
-## NOTE: This software is an alpha version
+This gem provides a DSL so that you can write a script that walks your users through setting up Convox and getting your app and running, setting up S3 buckets, etc.
 
-Please note that the code quality is not very good, and the test coverage needs to be improved. However, I've successfully set up a number of test and production deployments using this gem, and everything seems to work very well. The library also facilitates idempotency and crash-resistance, so you can easily re-run your installation script if something goes wrong.
+## Requirements
+
+- MacOS
+- Convox v3 CLI
+- Runtime integration installed in your AWS account. See: https://docs.convox.com/getting-started/introduction/
+
+_Please let us know if you need to run this script on Linux. Linux support should not be too difficult to implement, but unfortunately we probably won't be able to support Windows._
+
+### Requires Convox >= 3
+
+This version of `convox_installer` is only designed to work with Convox 3 and later. You can run `convox version` to check your version. Please install the Convox v3 CLI by following the instructions here: https://docs.convox.com/getting-started/introduction/
+
+_If you want to set up a Convox v2 rack (deprecated), the last version of `convox_installer` that supports the v2 CLI is `1.0.9`. (Take a look at [the `convox2` branch](https://github.com/DocSpring/convox_installer/tree/convox2).)_
+
+## USE AT YOUR OWN RISK! THIS CODE IS PROVIDED WITHOUT ANY WARRANTIES OR GUARANTEES
+
+We have successfully set up a number of test and production deployments using this gem. Everything seems to work very well. The library also facilitates idempotency and crash-resistance, so you can easily re-run your installation script if something goes wrong. However, if anything goes wrong, then you can end up with a large AWS bill if you're not careful. If anything crashes then make sure you double-check everything in your AWS account and shut down any leftover resources. **USE THIS SOFTWARE AT YOUR OWN RISK.**
 
 ## Features
 
@@ -22,7 +38,7 @@ Please note that the code quality is not very good, and the test coverage needs
 
 `convox_installer` is a Ruby gem that makes it much easier to build an installation script for `convox/rack` (the open source PaaS). The Convox CLI is awesome, but it's missing a nice way to script a full deployment. I originally wrote a bash script that made API calls and used [`jq`](https://stedolan.github.io/jq/) and `sed`, but this was very error-prone and it did not have good cross-platform support.
 
-I've rewritten this installation script in Ruby, which provides very good cross-platform support, and also allows me to write tests.
+I've written this installation script in Ruby, which provides very good cross-platform support, and also allows me to write tests.
 
 ## Usage
 
@@ -34,7 +50,7 @@ require 'bundler/inline'
 
 gemfile do
   source 'https://rubygems.org'
-  gem 'convox_installer'
+  gem 'convox_installer', '3.0.0'
 end
 
 require "convox_installer"
@@ -138,10 +154,6 @@ Makes sure that the `convox` and `aws` CLI tools are installed on this system. I
 Loads config from ENV vars, or from saved config at `./.installer_config.json`.
 If any config settings are missing, it prompts the user for input. Finally, it shows a summary of the config, and asks the user if they want to proceed with the installation. If the user enters `y` (or `yes`), the `prompt_for_config` method completes. If they enter `n` (or `no`), we loop over every setting and let them press "enter" to keep the current value, or provide a new value to correct any mistakes.
 
-#### `backup_convox_host_and_rack`
-
-If there are any existing files at `~/.convox/host` or `~/.convox/rack`, this method moves these to `~/.convox/host.bak` and `~/.convox/rack.bak`.
-
 #### `install_convox`
 
 - **Required Config:** `aws_region`, `aws_access_key_id`, `aws_secret_access_key`,
@@ -149,13 +161,13 @@ If there are any existing files at `~/.convox/host` or `~/.convox/rack`, this me
 
 Runs `convox rack install ...`. Has some validations to ensure that all required settings are present.
 
-#### `validate_convox_auth_and_set_host!`
+#### `validate_convox_rack_and_write_current!`
 
-After running `install_convox`, call this method to ensure that the the `~/.convox/auth` file has been updated with the correct details (checks the rack name and AWS region.) Then it sets the rack host in `~/.convox/host` (if not already set.)
+Ensures that the local machine contains a directory for the rack's terraform config, and sets the current rack for Convox CLI commands.
 
-#### `validate_convox_rack!`
+#### `validate_convox_rack_api!`
 
-Calls `convox api get /system` to get the Rack details, then makes sure that everything is correct.
+Makes an API request (`convox api get /system`) to get the rack details, and makes sure that everything is correct.
 
 #### `convox_rack_data`
 
@@ -171,10 +183,14 @@ Checks if the app already exists. If not, calls `convox apps create ... --wait`
 
 Writes the app name into `./.convox/app` (in the current directory.) The `convox` CLI reads this file, so you don't need to specify the `--app` flag for future commands.
 
-#### `create_s3_bucket!`
+#### `add_s3_bucket`
+
+Adds an S3 bucket to your Terraform config.
 
 - **Required Config:** `s3_bucket_name`
 
+NOTE: This method just writes a new Terraform configuration file. You must run `apply_terraform_update!` to apply the changes and create the S3 bucket.
+
 Creates an S3 bucket from the `:s3_bucket_name` config setting. This is not a default setting, so you can add something like this to your custom `@prompts`:
 
 ```ruby
@@ -187,41 +203,97 @@ Creates an S3 bucket from the `:s3_bucket_name` config setting. This is not a de
 
 The `:value` `Proc` will generate a bucket name with a random suffix. (Avoids conflicts when you are setting up multiple deployments for your app.)
 
-`create_s3_bucket!` will also call `set_s3_bucket_cors_policy` automatically, so you don't need to call this manually.
+You can also set a CORS policy for your S3 bucket. (`:s3_bucket_name`)
+We set the `cors_rule` option for the `aws_s3_bucket` resource in the Terraform configuration. Example:
 
-#### `set_s3_bucket_cors_policy`
-
-- **Required Config:** `s3_bucket_name`
+```
+   cors_rule {
+    allowed_headers = ["*"]
+    allowed_methods = ["PUT", "POST"]
+    allowed_origins = ["https://s3-website-test.hashicorp.com"]
+    expose_headers  = ["ETag"]
+    max_age_seconds = 3000
+  }
+```
 
-Set up a CORS policy for your S3 bucket. (`:s3_bucket_name`)
+See: https://registry.terraform.io/providers/hashicorp/aws/3.33.0/docs/resources/s3_bucket#using-cors
 
-_Note: If the `:s3_bucket_cors_policy` setting is not provided, then this method does nothing._
+_Note: If the `:s3_bucket_cors_rule` setting is not provided, then it is skipped._
 
-You should set `:s3_bucket_cors_policy` to a JSON string. Here's how I set this up in my own `install.rb` script:
+Here's how we set up a CORS policy in our own `install.rb` script:
 
 ```ruby
-S3_BUCKET_CORS_POLICY = <<-JSON
-{
-  "CORSRules": [
-    {
-      "AllowedOrigins": ["*"],
-      "AllowedHeaders": ["Authorization", "cache-control", "x-requested-with"],
-      "AllowedMethods": ["PUT", "POST", "GET"],
-      "MaxAgeSeconds": 3000
-    }
-  ]
-}
-JSON
+xxxxc = <<-TERRAFORM
+  cors_rule {
+    allowed_headers = ["Authorization", "cache-control", "x-requested-with"]
+    allowed_methods = ["PUT", "POST", "GET"]
+    allowed_origins = ["*"]
+    expose_headers  = []
+    max_age_seconds = 3000
+  }
+TERRAFORM
 
 @prompts = [
   {
-    key: :s3_bucket_cors_policy,
-    value: S3_BUCKET_CORS_POLICY,
+    key: :s3_bucket_cors_rule,
+    value: S3_BUCKET_CORS_RULE,
     hidden: true,
   }
 ]
 ```
 
+#### `add_rds_database`
+
+Adds an RDS database to your Terraform config.
+
+- **Required Config:**
+  - `database_username`
+  - `database_password`
+- **Optional Config:**
+  - `database_allocated_storage` _(default: 30)_
+  - `database_engine` _(default: 'postgres')_
+  - `database_engine_version` _(default: '14.2')_
+  - `database_instance_class` _(default: 'db.t3.medium')_
+  - `database_multi_az` _(default: true)_
+
+#### `add_add_elasticache_cluster`
+
+Adds an Elasticache cluster to your Terraform config.
+
+- **Optional Config:**
+  - `engine` _(default: 'redis')_
+  - `engine_version` _(default: '6.2.5')_
+  - `node_type` _(default: 'cache.m3.medium')_
+  - `database_instance_class` _(default: 'db.t3.medium')_
+  - `num_cache_nodes` _(default: 1)_
+  - `port` _(default: 6379)_
+
+_IMPORTANT: Make sure you specify a full version string (e.g. `6.2.5`), and not a partial version (e.g. `6.2`.) A partial version will cause Terraform to delete and recreate the cluster on every run._
+
+#### `apply_terraform_update!`
+
+Runs `terraform apply -auto-approve` to apply any changes to your Terraform configuration (add new resources, etc.)
+
+#### `rds_details`
+
+Returns information about the created RDS database resource.
+
+```ruby
+{
+  postgres_url: "Full URL for the RDS database (including auth)",
+}
+```
+
+#### `elasticache_details`
+
+Returns information about the created RDS database resource.
+
+```ruby
+{
+  redis_url: "Full URL for the Redis cluster",
+}
+```
+
 #### `s3_bucket_details`
 
 - **Required Config:** `s3_bucket_name`
@@ -246,13 +318,14 @@ Checks the list of registries to see if `docker_registry_url` has already been a
 
 #### `default_service_domain_name`
 
-- **Required Config:** `convox_app_name`, `default_service`
+- **Required Config:** `convox_app_name`
+- **Optional Config:** `default_service`
 
-Parses the rack router ELB name and region, and returns the default `convox.site` domain for your default service. (You can visit this URL in the browser to access your app.)
+Finds the default `*.convox.cloud` URL for the web service. (You can visit this URL in the browser to access your app.)
 
-Example: `myapp-web.rackname-route-abcdfe123456-123456789.us-west-2.convox.site`
+Example: `web.docspring.dc6bae48c2e36366.convox.cloud`
 
-Set a default service in your config prompts (e.g. `web`):
+You can override the default service name in your config (e.g. `web`):
 
 ```ruby
 @prompts = [

data/convox_installer.gemspec

@@ -1,28 +1,29 @@
 # frozen_string_literal: true
 
-$LOAD_PATH.push File.expand_path("lib", __dir__)
-require "convox_installer/version"
+$LOAD_PATH.push File.expand_path('lib', __dir__)
+require 'convox_installer/version'
 
 Gem::Specification.new do |s|
-  s.name = "convox_installer"
+  s.name = 'convox_installer'
   s.version = ConvoxInstaller::VERSION
   s.platform = Gem::Platform::RUBY
-  s.authors = ["Form Applications Inc."]
-  s.email = ["support@formapi.io"]
-  s.homepage = "https://github.com/FormAPI/convox_installer"
-  s.summary = "Build a Convox installation workflow"
-  s.description = "Build a Convox installation workflow"
-  s.license = "MIT"
-  s.required_ruby_version = ">= 2.3"
+  s.authors = ['Form Applications Inc.']
+  s.email = ['support@formapi.io']
+  s.homepage = 'https://github.com/FormAPI/convox_installer'
+  s.summary = 'Build a Convox installation workflow'
+  s.description = 'Build a Convox installation workflow'
+  s.license = 'MIT'
+  s.required_ruby_version = '>= 2.5'
 
-  s.add_runtime_dependency "highline", ">= 1.7.10"
-  s.add_runtime_dependency "json", ">= 2.2.0"
-  s.add_runtime_dependency "os", ">= 1.0.1"
-  s.add_runtime_dependency "httparty", ">= 0.17.0"
-  s.add_runtime_dependency "activesupport", ">= 5.2.3"
+  s.add_runtime_dependency 'activesupport', '>= 5.2.3'
+  s.add_runtime_dependency 'highline', '>= 1.7.10'
+  s.add_runtime_dependency 'httparty', '>= 0.17.0'
+  s.add_runtime_dependency 'json', '>= 2.2.0'
+  s.add_runtime_dependency 'os', '>= 1.0.1'
 
-  s.files = `git ls-files`.split("\n").uniq.sort.reject(&:empty?) - ["Gemfile.lock"]
+  s.files = `git ls-files`.split("\n").uniq.sort.reject(&:empty?) - ['Gemfile.lock']
   s.test_files = `git ls-files spec test`.split("\n")
   s.executables = []
-  s.require_paths = ["lib"]
+  s.require_paths = ['lib']
+  s.metadata['rubygems_mfa_required'] = 'true'
 end

data/examples/full_installation.rb

@@ -9,82 +9,89 @@
 #   gem "convox_installer"
 # end
 
-$LOAD_PATH << File.expand_path("../../lib", __FILE__)
-require "pry-byebug"
+$LOAD_PATH << File.expand_path('../lib', __dir__)
+require 'pry-byebug'
 
-require "convox_installer"
+require 'convox_installer'
 include ConvoxInstaller
 
 @log_level = Logger::DEBUG
 
-MINIMAL_HEALTH_CHECK_PATH = "/health/site"
-COMPLETE_HEALTH_CHECK_PATH = "/health"
-
-S3_BUCKET_CORS_POLICY = <<-JSON
-{
-  "CORSRules": [
-    {
-      "AllowedOrigins": ["*"],
-      "AllowedHeaders": ["Authorization", "cache-control", "x-requested-with"],
-      "AllowedMethods": ["PUT", "POST", "GET"],
-      "MaxAgeSeconds": 3000
-    }
-  ]
-}
-JSON
+MINIMAL_HEALTH_CHECK_PATH = '/health/site'
+COMPLETE_HEALTH_CHECK_PATH = '/health'
+
+S3_BUCKET_CORS_RULE = <<-TERRAFORM
+  cors_rule {
+    allowed_headers = ["Authorization", "cache-control", "x-requested-with"]
+    allowed_methods = ["PUT", "POST", "GET"]
+    allowed_origins = ["*"]
+    expose_headers  = []
+    max_age_seconds = 3000
+  }
+TERRAFORM
 
 @prompts = ConvoxInstaller::Config::DEFAULT_PROMPTS + [
   {
-    section: "Docker Registry Authentication",
+    section: 'Docker Registry Authentication',
     info: "You should have received authentication details for the Docker Registry\n" \
-    "via email. If not, please contact support@example.com",
+          'via email. If not, please contact support@example.com'
   },
   {
     key: :docker_registry_url,
-    title: "Docker Registry URL",
-    value: "691950705664.dkr.ecr.us-east-1.amazonaws.com",
+    title: 'Docker Registry URL',
+    value: '691950705664.dkr.ecr.us-east-1.amazonaws.com'
   },
   {
     key: :docker_registry_username,
-    title: "Docker Registry Username",
+    title: 'Docker Registry Username'
   },
   {
     key: :docker_registry_password,
-    title: "Docker Registry Password",
+    title: 'Docker Registry Password'
   },
   {
     key: :convox_app_name,
-    title: "Convox App Name",
-    value: "convox-app",
+    title: 'Convox App Name',
+    value: 'convox-app'
   },
   {
     key: :default_service,
-    title: "Default Convox Service (for domain)",
-    value: "web",
-    hidden: true,
+    title: 'Default Convox Service (for domain)',
+    value: 'web',
+    hidden: true
   },
   {
     key: :admin_email,
-    title: "Admin User Email",
-    prompt: "Please enter the email address you would like to use " \
-    "for the default admin user",
-    default: "admin@example.com",
+    title: 'Admin User Email',
+    prompt: 'Please enter the email address you would like to use ' \
+            'for the default admin user',
+    default: 'admin@example.com'
   },
   {
     key: :admin_password,
-    title: "Admin User Password",
-    value: -> () { SecureRandom.hex(8) },
+    title: 'Admin User Password',
+    value: -> { SecureRandom.hex(8) }
   },
   {
     key: :s3_bucket_name,
-    title: "S3 Bucket for Uploads",
-    value: -> () { "app-uploads-#{SecureRandom.hex(4)}" },
+    title: 'S3 Bucket for Uploads',
+    value: -> { "app-uploads-#{SecureRandom.hex(4)}" }
   },
   {
-    key: :s3_bucket_cors_policy,
-    value: S3_BUCKET_CORS_POLICY,
-    hidden: true,
+    key: :s3_bucket_cors_rule,
+    value: S3_BUCKET_CORS_RULE,
+    hidden: true
   },
+  {
+    key: :database_username,
+    value: 'example_app',
+    hidden: true
+  },
+  {
+    key: :database_password,
+    value: -> { SecureRandom.hex(16) },
+    hidden: true
+  }
 ]
 
 ensure_requirements!
@@ -93,78 +100,78 @@ config = prompt_for_config
 backup_convox_host_and_rack
 install_convox
 
-validate_convox_auth_and_set_host!
-validate_convox_rack!
+validate_convox_auth_and_write_host!
+validate_convox_rack_api!
 
 create_convox_app!
 set_default_app_for_directory!
 add_docker_registry!
 create_s3_bucket!
 
-puts "=> Generating secret keys for authentication sessions and encryption..."
+puts '=> Generating secret keys for authentication sessions and encryption...'
 secret_key_base = SecureRandom.hex(64)
 data_encryption_key = SecureRandom.hex(32)
 
 puts "======> Default domain: #{default_service_domain_name}"
-puts "        You can use this as a CNAME record after configuring a domain in convox.yml"
-puts "        (Note: SSL will be configured automatically.)"
+puts '        You can use this as a CNAME record after configuring a domain in convox.yml'
+puts '        (Note: SSL will be configured automatically.)'
 
-puts "=> Setting environment variables to configure the application..."
+puts '=> Setting environment variables to configure the application...'
 
 env = {
-  "HEALTH_CHECK_PATH" => MINIMAL_HEALTH_CHECK_PATH,
-  "DOMAIN_NAME" => default_service_domain_name,
-  "AWS_ACCESS_KEY_ID" => s3_bucket_details.fetch(:access_key_id),
-  "AWS_ACCESS_KEY_SECRET" => s3_bucket_details.fetch(:secret_access_key),
-  "AWS_UPLOADS_S3_BUCKET" => s3_bucket_details.fetch(:name),
-  "AWS_UPLOADS_S3_REGION" => config.fetch(:aws_region),
-  "SECRET_KEY_BASE" => secret_key_base,
-  "DATA_ENCRYPTION_KEY" => data_encryption_key,
-  "ADMIN_NAME" => "Admin",
-  "ADMIN_EMAIL" => config.fetch(:admin_email),
-  "ADMIN_PASSWORD" => config.fetch(:admin_password),
+  'HEALTH_CHECK_PATH' => MINIMAL_HEALTH_CHECK_PATH,
+  'DOMAIN_NAME' => default_service_domain_name,
+  'AWS_ACCESS_KEY_ID' => s3_bucket_details.fetch(:access_key_id),
+  'AWS_ACCESS_KEY_SECRET' => s3_bucket_details.fetch(:secret_access_key),
+  'AWS_UPLOADS_S3_BUCKET' => s3_bucket_details.fetch(:name),
+  'AWS_UPLOADS_S3_REGION' => config.fetch(:aws_region),
+  'SECRET_KEY_BASE' => secret_key_base,
+  'DATA_ENCRYPTION_KEY' => data_encryption_key,
+  'ADMIN_NAME' => 'Admin',
+  'ADMIN_EMAIL' => config.fetch(:admin_email),
+  'ADMIN_PASSWORD' => config.fetch(:admin_password)
 }
 
-env_command_params = env.map { |k, v| "#{k}=\"#{v}\"" }.join(" ")
+env_command_params = env.map { |k, v| "#{k}=\"#{v}\"" }.join(' ')
 run_convox_command! "env set #{env_command_params}"
 
-puts "=> Initial deploy..."
-puts "-----> Documentation: https://docs.convox.com/deployment/builds"
-run_convox_command! "deploy --wait"
+puts '=> Initial deploy...'
+puts '-----> Documentation: https://docs.convox.com/deployment/deploying-changes/'
+run_convox_command! 'deploy --wait'
 
-puts "=> Setting up the database..."
-run_convox_command! "run web rake db:create db:migrate db:seed"
+puts '=> Setting up the database...'
+run_convox_command! 'run web rake db:create db:migrate db:seed'
 
-puts "=> Updating the health check path to include database tests..."
+puts '=> Updating the health check path to include database tests...'
 run_convox_command! "env set --promote --wait HEALTH_CHECK_PATH=#{COMPLETE_HEALTH_CHECK_PATH}"
 
 puts
-puts "All done!"
+puts 'All done!'
 puts
 puts "You can now visit #{default_service_domain_name} and sign in with:"
 puts
 puts "    Email:    #{config.fetch(:admin_email)}"
 puts "    Password: #{config.fetch(:admin_password)}"
 puts
-puts "You can configure a custom domain name, auto-scaling, and other options in convox.yml."
-puts "To deploy your changes, run: convox deploy --wait"
+puts 'You can configure a custom domain name, auto-scaling, and other options in convox.yml.'
+puts 'To deploy your changes, run: convox deploy --wait'
 puts
 puts "IMPORTANT: You should be very careful with the 'resources' section in convox.yml."
-puts "If you remove, rename, or change these resources, then Convox will delete"
-puts "your database. This will result in downtime and a loss of data."
-puts "To prevent this from happening, you can sign into your AWS account,"
-puts "visit the RDS and ElastiCache services, and enable \"Termination Protection\""
-puts "for your database resources."
+puts 'If you remove, rename, or change these resources, then Convox will delete'
+puts 'your database. This will result in downtime and a loss of data.'
+puts 'To prevent this from happening, you can sign into your AWS account,'
+puts 'visit the RDS and ElastiCache services, and enable "Termination Protection"'
+puts 'for your database resources.'
 puts
-puts "To learn more about the convox CLI, run: convox --help"
+puts 'To learn more about the convox CLI, run: convox --help'
 puts
-puts "  * View the Convox documentation:  https://docs.convox.com/"
+puts '  * View the Convox documentation:  https://docs.convox.com/'
 puts
 puts
-puts "To completely uninstall Convox from your AWS account,"
-puts "run the following steps (in this order):"
+puts 'To completely uninstall Convox from your AWS account,'
+puts 'run the following steps (in this order):'
 puts
-puts " 1) Disable \"Termination Protection\" for any resource where it was enabled."
+puts ' 1) Disable "Termination Protection" for any resource where it was enabled.'
 puts
 puts " 2) Delete all files from the #{config.fetch(:s3_bucket_name)} S3 bucket:"
 puts
@@ -176,7 +183,7 @@ puts " 3) Delete the #{config.fetch(:s3_bucket_name)} S3 bucket:"
 puts
 puts "    convox rack resources delete #{config.fetch(:s3_bucket_name)} --wait"
 puts
-puts " 4) Uninstall Convox (deletes all CloudFormation stacks and AWS resources):"
+puts ' 4) Uninstall Convox (deletes all CloudFormation stacks and AWS resources):'
 puts
 puts "    convox rack uninstall aws #{config.fetch(:stack_name)}"
 puts