inspec/www
Adam Leff 185786b49a Remove www Gemfile.lock (#2082)
No reason to keep the Gemfile.lock in the www directory under source
control. It adds extra steps to the www release process after an InSpec
release because the release process will fail of the git working tree
is not clean (and since the www Rake tasks rely on InSpec stuff, the
Gemfile.lock will be perpetually out of date).

Signed-off-by: Adam Leff <adam@leff.co>
2017-08-17 16:08:55 +02:00
..
data Add docs for habitat CLI commands 2017-03-28 13:59:38 -04:00
lib Address rubocop violations 2017-02-08 16:49:16 -06:00
source disable particle animation if users prefer reduced motion (#2023) 2017-07-28 21:21:40 -07:00
tutorial Address rubocop violations 2017-02-08 16:49:16 -06:00
.gitignore rake to render all docs to www/ correctly with links 2016-09-26 06:21:05 +02:00
config.rb Fix ServerSpec migration doc rendering 2017-05-01 15:18:49 -05:00
config.ru Fixup rubocop violation in www/ 2016-09-13 15:11:48 +01:00
Gemfile Remove relative path from Gemfile. (#1913) 2017-06-09 07:51:43 -04:00
Rakefile Add rake task for flushing Fastly cache 2017-04-28 14:22:00 -04:00
README.md Add rake task for flushing Fastly cache 2017-04-28 14:22:00 -04:00

InSpec homepage

Development

Get all dependencies:

bundle install

To run it live run:

bundle exec middleman server

For the online tutorial, take a look at www/tutorial.

Building

To build the site to a local static folder (without tutorial):

bundle exec middleman build

To build everything including the online tutorial:

bundle exec rake www:build

Releasing

To build everything and push a new version of the website, be in the www folder of this repository and run:

bundle install
bundle exec rake www

It will clear everything and build from scratch and create a local gh-pages branch with a static version of the website. Before pushing, it will ask you if you are happy with it.

Please verify the site now! To host the current folder you can run:

ruby -run -e httpd . -p 8000

Open your browser to localhost:8000.

If you are happy, you can confirm the site and let the release task push it live.

Flushing the Fastly Cache

The www Rake task will flush the cache at Fastly if you have the following environment variables set:

  • FASTLY_API_KEY
  • FASTLY_SERVICE_ID

These can be found in Chef's shared password manager. If these aren't set, the cache will not be flushed and will expire on its own. The cache can be flushed without doing a full website release by running rake www:flush