repository_size

GitHub Undersized Repositories

What It Does

This policy template reports any GitHub repositories under the user-specified GitHub organizations whose size is below a user-specified number of bytes. Optionally, it emails this report.

Input Parameters

• Email Addresses - A list of email addresses to notify.
• GitHub Organizations - A list of GitHub Organizations to check.
• Allow/Deny GitHub Repositories - Whether to treat Allow/Deny GitHub Repositories List parameter as allow or deny list. Has no effect if Allow/Deny GitHub Repositories List is left empty.
• Allow/Deny GitHub Repositories List - Filter results by GitHub repository, either only allowing this list or denying it depending on how the above parameter is set. Leave blank to consider all the GitHub repositories in the specified organizations.
• Minimum Age (Days) - Required minimum age of repository in days to include it in the results. Set to 0 to not filter results by repository age.
• Minimum Size (Bytes) - Required minimum size of repository in bytes.

Policy Actions

• Sends an email notification.

Prerequisites

This Policy Template uses Credentials for authenticating to datasources -- in order to apply this policy you must have a Credential registered in the system that is compatible with this policy. If there are no Credentials listed when you apply the policy, please contact your Flexera Org Admin and ask them to register a Credential that is compatible with this policy. The information below should be consulted when creating the credential(s).

• GitHub Credential (provider=github) which has the following permissions:

  • admin:org

• Flexera Credential (provider=flexera) which has the following roles:

  • billing_center_viewer

The Provider-Specific Credentials page in the docs has detailed instructions for setting up Credentials for the most common providers.

Supported Clouds

• GitHub

Cost

This policy template does not incur any cloud costs.