mirror of
https://github.com/fleetdm/fleet
synced 2026-04-21 21:47:20 +00:00
36 lines
No EOL
2.7 KiB
Markdown
36 lines
No EOL
2.7 KiB
Markdown
# Manage software using GitOps
|
|
|
|
This guide is a walkthrough on how to manage software using [GitOps](https://fleetdm.com/docs/configuration/yaml-files#gitops). In Fleet, there are three types of software: [Fleet-maintained apps](#fleet-maintained-apps), [App Store (VPP) apps](#app-store-vpp-apps), and [custom packages](#custom-packages).
|
|
|
|
When using GitOps, you can optionally put Fleet in [GitOps mode](https://fleetdm.com/guides/gitops-mode). This prevents you from making changes in the UI that would be overridden by GitOps workflows.
|
|
|
|
## Custom packages
|
|
|
|
To manage custom packages via GitOps, please see the [`packages`](https://fleetdm.com/docs/configuration/yaml-files#packages) in Fleet's GitOps docs.
|
|
|
|
> For script packages (`.sh` and `.ps1` files), the `install_script`, `uninstall_script`, `post_install_script`, and `pre_install_query` fields are not supported and will be ignored. The script file's contents become the install script. Learn more in the [deploy software guide](https://fleetdm.com/guides/deploy-software-packages#script-packages).
|
|
|
|
If you want to use Fleet to host custom packages instead of a third-party package hosting tool (ex. [Artifactory](https://jfrog.com/artifactory/)), first turn GitOps mode on in **Settings > Integration > Change management**
|
|
1. Navigate to **Software** and select a team. Then select **Add Software > Custom package**
|
|
2. Select a team and choose a file to upload and select **Add software**
|
|
3. A modal will appear with YAML instructions.
|
|
1. Create a YAML file with the suggested filename and populate it with the contents below.
|
|
2. Save this file to your repository.
|
|
3. Make sure that the package YAML is referenced from your team YAML.
|
|
4. Download the additional queries and scripts that are linked in the modal and add them to your repository. Make sure to use the paths listed in the contents area above.
|
|
|
|
## App Store (VPP) apps
|
|
|
|
To manage App Store (VPP) apps via GitOps, please see the [`app_store_apps`](https://fleetdm.com/docs/configuration/yaml-files#app-store-apps) in Fleet's best practice GitOps docs. Note that VPP apps must first be added to [Apple Business Manager](https://business.apple.com).
|
|
|
|
## Fleet-maintained apps
|
|
|
|
To manage App Store (VPP) apps via GitOps, please see the [`fleet_maintained_apps`](https://fleetdm.com/docs/configuration/yaml-files#fleet-maintained-apps) in Fleet's best practice GitOps docs.
|
|
|
|
|
|
<meta name="category" value="guides">
|
|
<meta name="authorGitHubUsername" value="noahtalerman">
|
|
<meta name="authorFullName" value="Noah Talerman">
|
|
<meta name="publishedOn" value="2025-04-30">
|
|
<meta name="articleTitle" value="Manage software in GitOps mode">
|
|
<meta name="description" value="Learn how to use Fleet's YAML to manage software in GitOps mode."> |