fleet/website
Eric 5c0894ce0a
Website: Create queries.yml, add vitals and query pages, move policies. (#25701)
Related to: https://github.com/fleetdm/confidential/issues/9096

Changes:
- Created docs/queries.yml. A YAML file that contains the queries from
the standard query library (`kind: query`) and the host vitals queries
(`kind: built-in`).
- Added the `vitals/*` page, a page that displays details about host
vital queries used to gather information about.
- Updated the /queries page to show queries from the new
`docs/queries.yml` file, and moved policies to a new page (/policies)
- Updated the view action for the query-detail page to look for/redirect
to a policy page with a matching slug before returning a 404 response if
a matching query is not found. This behavior will make it so all of the
old URLs for policy pages will redirect users to the new URL.
- Updated the website's "Docs" navigation menu to have links to the new
vitals and policies pages.
2025-01-22 21:10:17 -06:00
..
api Website: Create queries.yml, add vitals and query pages, move policies. (#25701) 2025-01-22 21:10:17 -06:00
assets Website: Create queries.yml, add vitals and query pages, move policies. (#25701) 2025-01-22 21:10:17 -06:00
config Website: Create queries.yml, add vitals and query pages, move policies. (#25701) 2025-01-22 21:10:17 -06:00
generators/landing-page Website: update secondary CTA buttons (#20105) 2024-06-28 16:55:25 -05:00
scripts Website: Create queries.yml, add vitals and query pages, move policies. (#25701) 2025-01-22 21:10:17 -06:00
tasks
views Website: Create queries.yml, add vitals and query pages, move policies. (#25701) 2025-01-22 21:10:17 -06:00
.editorconfig
.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
.htmlhintrc
.lesshintrc
.npmrc
.sailsrc Website: revert changes to .sailsrc (#22620) 2024-10-03 12:43:20 -05:00
app.js
Gruntfile.js
package.json Website: move yaml back to devDependencies (#25577) 2025-01-17 16:09:38 -06:00
Procfile
README.md Website: Update build-static-content to only send GitHub requests if an access token is provided, add command to start website to website/package.json (#18805) 2024-05-13 17:02:00 -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

See https://fleetdm.com/handbook/digital-experience#test-fleetdm-com-locally

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!