fleet
fleet copied to clipboard
Update "Learn how to use Fleet" for Fleet Sandbox
Addresses:
- #7044
Changes:
- Update "Learn how to use Fleet" docs page to walk a Fleet Sandbox user through adding their device and running a query
- Add a "Get operating system information" query to standard query library for the "Learn how to use Fleet" walkthrough
- Update Fleet's top level README to point users who want to try Fleet to Fleet Sandbox
- Update "How to install osquery..." (macOS, Windows, Linux) blog posts to point users who want to try Fleet to Fleet Sandbox
- Move
fleetctl previewquestions to "Contributing" FAQ section in docs. This is becausefleetctl previewis now a testing tool for Fleet contributors - Update "Deploying" docs to point users who want to try Fleet to Fleet Sandbox
Hey @Desmi-Dizney I added you as a reviewer. Can you please take an editor pass on this PR? Thanks :)
Hey @GuillaumeRoss I added you as a reviewer. Can you please take a look at the query I added to the standard query library.
This query will be referenced in the "Learn how to use Fleet" docs.
Hey @DominusKelvin I added you as a reviewer. Can you please take a look at the changes I made to the "How to install osquery..." (macOS, Windows, Linux) guides?
I updated these to point users who want to try Fleet to Fleet Sandbox.
Hey @DominusKelvin I added you as a reviewer. Can you please take a look at the changes I made to the "How to install osquery..." (macOS, Windows, Linux) guides?
I updated these to point users who want to try Fleet to Fleet Sandbox.
Hey @DominusKelvin I added you as a reviewer. Can you please take a look at the changes I made to the "How to install osquery..." (macOS, Windows, Linux) guides?
I updated these to point users who want to try Fleet to Fleet Sandbox.
Got it. Approved ✅
@noahtalerman the query is good - but should it also go in the constants file?
the query is good - but should it also go in the constants file?
@GuillaumeRoss ah, I don't think there's a constant files for queries (we don't have a list of query templates in the UI). Is there?
There is a constants file for policies.
I'm adding a query, not a policy, in this PR.
It's not clear to me what is the expected journey of the reader through this... Can you elaborate on that?
@zhumo definitely. The expected journey starts on fleetdm.com where a Fleet sandbox user signs up for sandbox. Then, the Fleet user sees the Home page in Fleet sandbox:
The user clicks "Learn how to use Fleet" and is taken to the "Learn how to use Fleet" page in the docs.
This journey can definitely be improved. The goal of these changes is to unblock Fleet sandbox by making the least amount of changes to "Learn how to use Fleet" and other areas of the docs/articles now that Fleet sandbox is the recommended way to try Fleet.
The changes made to docs/articles other than "Learn how to use Fleet" were the result of the following decision:
fleetctl preview is now a tool used by Fleet contributors to test changes to Fleet. This is because Fleet sandbox is the recommended way to try Fleet.
I'll coordinate this getting used in Sandbox once its merged alongside @rfairburn. Just letting you know its on my radar and that I'll need to do stuff to get it out there.
Just letting you know its on my radar and that I'll need to do stuff to get it out there.
@zwinnerman-fleetdm can you help me understand what you'll need to do?
This PR should only contain changes to markdown files (articles, docs, and proposals).
Just letting you know its on my radar and that I'll need to do stuff to get it out there.
@zwinnerman-fleetdm can you help me understand what you'll need to do?
This PR should only contain changes to markdown files (articles, docs, and proposals).
Oh ok, then I won't need to do anything lol sorry about that.
No worries! Sorry for the confusion.