Skip to content

Latest commit

 

History

History
47 lines (31 loc) · 3.4 KB

README.md

File metadata and controls

47 lines (31 loc) · 3.4 KB

Packages Daily run failures Windows 2022 Daily run failures Windows 2019 MyGet version mismatches CI

Virtual Machine Packages

This repository contains the source code for packages supporting the following analysis environment projects:

Packages do not contain actual software distributions. Packages are PowerShell scripts that only contain instructions for obtaining and configuring tools. See Chocolatey legal information for more details.

How does this work?

The packages stored in this repository are automatically built and pushed to a public package feed hosted on MyGet. From this feed FLARE VM and our other binary analysis environments download packages and execute the included scripts to install tools. The installation of packages relies on Chocolatey.

Open Source Packages

Open sourcing the installation packages allows the community to not only suggest new tools, improvements, and report bugs, but to help implement them. It's now transparent how and what gets installed. Moreover, we can use GitHub Actions (free for open-source repositories) for testing and automation. This reduces manual maintenance and simplifies contributions.

Automation using GitHub Actions

Once a package is submitted, our pull request automation test the package to see if it builds and installs correctly. Additionally, we build and test each package on a daily basis to check for any errors. Simply being aware of broken packages should quickly solve a lot of problems VM users faced in the past. To see the daily test results check the Daily Failures and MyGet Version Mismatches wiki pages. The status is also displayed in the badges at the beginning of this README.

We have also automated other task, such as the creation of new packages (using create_package_template.py) and the package updates (using update_package.py).

Documentation

  • Check our CONTRIBUTING guide to learn how to contribute to the project.
  • Check our Wiki for documentation on how to create a package using our established best practices.