search

fleetdm / fleet

Open-source platform for IT, security, and infrastructure teams. (Linux, macOS, Chrome, Windows, cloud, data center)
https://fleetdm.com
Other
2.92k stars 409 forks source link

Update messaging when creating Linux fleet-osquery .deb files #21595

Open ddribeiro opened 2 weeks ago

ddribeiro commented 2 weeks ago

TODO @noahtalerman: Track a higher level objective for this story and link this story and other small UX wins

Problem

Upon successful creation of a fleet-osquery installer, fleetctl displays guidance for how to use the installer to add a device to Fleet.

Generating your fleetd agent...

Success! You generated fleetd at ~/Documents/fleet-osquery_1.31.0_amd64.deb

To add this device to Fleet, double-click to install fleetd.

To add other devices to Fleet, distribute fleetd using Chef, Ansible, Jamf, or Puppet. Learn how: https://fleetdm.com/learn-more-about/enrolling-hosts

However, for .deb installers, the directions to double-click are incorrect. A Linux user would use dpkg -i to install the .deb instead of double-clicking.

Potential solutions

Update the messaging in fleetctl to direct the user to use dpkg -I to add the host to Fleet.

What is the expected workflow as a result of your proposal?

A Linux user would use `fleetctl` to create a `.deb` installer. Upon successful creation, they would be given directions to use `dpkg -i` to add the host to Fleet instead of double-clicking.
JoStableford commented 2 weeks ago

Related to a Slack conversation

noahtalerman commented 2 weeks ago

Hey @ddribeiro, great catch.

Even though it's not workflow blocking, can you please surface this during the next feature fest on 2024-09-12? A copy change here, would be a really quick-win improvement.

I think the "double-click" comes from a macOS bias. We automatically pop open the file explorer when we create a fleetd package on a macOS host.

Also, when you get the chance, can you please record a quick Loom of the experience when creating fleetd on Linux? (.deb) Do we open some file explorer? Does Linux have one?

That would be really helpful for everyone's learning/understanding.