fleet/website
Rachael Shaw ae669e1749
2023-10-17 Update osquery schema version & regenerate merged schema (#14436)
When running a live query recently, I noticed some columns in the
results that we didn't have documented, and realized we weren't using
the latest osquery schema version when regenerating the merged schema.

According to the docs, [we support the latest version of
osquery](https://fleetdm.com/docs/using-fleet/enroll-hosts#supported-osquery-versions),
so figure we ought to update the schema version to the latest.

---------

Co-authored-by: Eric <eashaw@sailsjs.com>
2023-10-26 18:04:23 -05:00
..
api 2023-10-17 Update osquery schema version & regenerate merged schema (#14436) 2023-10-26 18:04:23 -05:00
assets 4.39.0 release article (#14764) 2023-10-26 15:36:06 -07:00
config 2023-10-17 Update osquery schema version & regenerate merged schema (#14436) 2023-10-26 18:04:23 -05:00
generators/landing-page Website: update template used in landing page generator (#12372) 2023-06-15 16:42:50 -05:00
scripts Update handbook index to only show pages in the /handbook/company/ folder (#14746) 2023-10-26 03:38:33 -05:00
tasks Move fleetdm.com into main Fleet repo (#83) 2020-12-02 14:48:03 -06:00
views Website: Consolidate product categories on homepage. (#14728) 2023-10-25 09:03:45 +09:00
.editorconfig Move fleetdm.com into main Fleet repo (#83) 2020-12-02 14:48:03 -06:00
.eslintignore add back public storybook site build step (#12746) 2023-07-13 17:44:41 +01:00
.eslintrc Website: Create Platform model and use platform record to track mergefreeze status. (#13681) 2023-09-05 16:31:40 -05:00
.gitignore fix gitignore 2021-05-11 16:01:25 -05:00
.htmlhintrc Move fleetdm.com into main Fleet repo (#83) 2020-12-02 14:48:03 -06:00
.lesshintrc Move fleetdm.com into main Fleet repo (#83) 2020-12-02 14:48:03 -06:00
.npmrc Move fleetdm.com into main Fleet repo (#83) 2020-12-02 14:48:03 -06:00
.sailsrc Website: Add landing page generator (#11308) 2023-05-03 18:51:01 -05:00
app.js Move fleetdm.com into main Fleet repo (#83) 2020-12-02 14:48:03 -06:00
Gruntfile.js Move fleetdm.com into main Fleet repo (#83) 2020-12-02 14:48:03 -06:00
package.json Website: Bump framework version (#12909) 2023-07-21 16:38:26 -05:00
Procfile Dedupe setting of env var (#87) 2020-12-03 16:11:46 -06:00
README.md Website README: Add instructions for db migrations (#7161) 2022-08-10 23:23:13 -05:00

fleetdm.com

This is where the code for the public https://fleetdm.com website lives.

Bugs

To report a bug or make a suggestion for the website, click here.

Testing locally

Run the following commands to test the site locally:

npm install -g sails
cd website/
npm install
sails run scripts/build-static-content.js
sails lift

Your local copy of the website is now running at http://localhost:2024!

Deploying the website

To deploy changes to the website to production, merge changes to the main branch. If the changes affect the website's code, or touch any files that the website relies on to build content, such as the query library, osquery schema, docs, handbook, articles, etc., then the website will be redeployed.

Wondering how this works? This is implemented in a GitHub action in this repo. Check out the code there to see how it works! For help understanding what sails run and npm run commands in there do, check the scripts in website/package.json and in website/scripts/.

Changing the database schema

To deploy new code to production that relies on changes to the database schema or other external systems (e.g. Stripe), first put the website in "maintenance mode" in Heroku. Then, make your changes in the database schema. Next, if you have a script to fix/migrate existing data, go ahead and run it now. (e.g. sails run fix-or-migrate-existing-data). Then, merge your changes and wait for the deploy to finish. Finally, switch off "maintenance mode" in Heroku.

Note that entering maintenance mode prevents visitors from using the website, so it should be used sparingly, and ideally at low-traffic times of day.

Warning: Doing an especially sensitive schema migration? There is a potential timing issue to consider, thanks to an infrastructure change that eliminated downtime during deploys by using Heroku's built-in support for hot-swapping. Read more in https://github.com/fleetdm/fleet/issues/6568#issuecomment-1211503881

Wiping the production database

I hope you know what you're doing. The "easiest" kind of database schema migration:

sails_datastores__default__url='REAL_DB_URI_HERE' sails run wipe

Then when you see the sailboat, hit CTRL+C to exit. All done!