Discharge7443/fleet
1
0
Fork 0
Code Issues Pull Requests Actions 22 Packages Projects Releases Wiki Activity

Document current auto-update behavior for Fleet-maintained apps set via GitOps (#30345)

Browse Source
This commit is contained in:
Ian Littman
2025-06-27 13:08:43 -05:00
committed by GitHub
parent 17245b04e5
commit 1b20c5bae6
2 changed files with 7 additions and 5 deletions
Download Patch File Download Diff File Expand all files Collapse all files
articles/fleet-maintained-apps.md
+4 -2
View File
@@ -67,9 +67,11 @@ A streamlined flow for pulling the latest version of a Fleet-maintained app is [
## Manage apps with GitOps
To manage Fleet-maintained apps using Fleet's best practice GitOps, check out the `software` key in the [GitOps reference documentation](https://fleetdm.com/docs/using-fleet/gitops#software). There is a `fleet_maintained_apps` key you can use to specify via slug a list of apps. This makes it even more simple to add additional apps available for your fleet.
To manage Fleet-maintained apps using Fleet's best practice GitOps, check out `fleet_maintained_apps`, found under the
`software` key, in the
[GitOps reference documentation](https://fleetdm.com/docs/configuration/yaml-files#fleet-maintained-apps).
> Note: with GitOps enabled, any Fleet-maintained apps added using the web UI will not persist.
> Note: with GitOps enabled, any Fleet-maintained apps added using the web UI will not persist if not also added in YAML.
## How does Fleet maintain these apps?
docs/Configuration/yaml-files.md
+3 -3
View File
@@ -414,7 +414,7 @@ The `software` section allows you to configure packages, Apple App Store apps, a
- `app_store_apps` is a list of Apple App Store apps.
- `fleet_maintained_apps` is a list of Fleet-maintained apps.
Currently, you can specify `install_software` in the [`policies` YAML](#policies) to automatically install a custom package or App Store app when a host fails a policy. Support for Fleet-maintained apps is coming soon.
Currently, you can specify `install_software` in the [`policies` YAML](#policies) to automatically install a custom package or App Store app when a host fails a policy. [Automatic install support for Fleet-maintained apps](https://github.com/fleetdm/fleet/issues/29584) is coming soon.
#### Example
@@ -514,9 +514,9 @@ Currently, one app for each of an App Store app's supported platforms are added.
### fleet_maintained_apps
- `fleet_maintained_apps` is a list of Fleet-maintained apps. To find the `slug`, head to **Software > Add software** and select a Fleet-maintained app. From there, select **Show details**. You can also see the list [here in GitHub](https://github.com/fleetdm/fleet/blob/main/ee/maintained-apps/outputs/apps.json).
- `fleet_maintained_apps` is a list of Fleet-maintained apps. Provide the `slug` field to include a Fleet-maintained app on a team. To find the `slug`, head to **Software > Add software** and select a Fleet-maintained app, then select **Show details**. You can also see the [list of app slugs on GitHub](https://github.com/fleetdm/fleet/blob/main/ee/maintained-apps/outputs/apps.json).
Currently, Fleet-maintained apps do not auto-update. To update to the latest version of a Fleet-maintained app, head to the Fleet UI, find the software on the **Software** page, and delete the app (**Actions > Delete**). Then, on the next GitOps run, the latest version will be added.
Currently, Fleet-maintained apps will be updated to the latest version published by Fleet when GitOps runs, [with the exception of Chrome](https://github.com/fleetdm/fleet/issues/30325).
Fleet-maintained apps have default categories. You can see the default categories in the [Fleet-maintained app metadata on GitHub](https://github.com/fleetdm/fleet/tree/main/ee/maintained-apps/outputs). If you do not specify `categories` when adding a self-service Fleet-maintained app, the default categories will be used.