Terrafirma aims to be a growing collection of opinionated, modular GitHub Actions to handle mundane tasks as painless as possible. Just plug-and-play the desired Github action in your repo to get started.
Most (if not all) GitHub actions need a GitHub token with just the "right" permissions. Rather than micromanage permissions for each action, you can simply install the Terrafirma GitHub App for your user, repository, or organization.
After installing the app, you'll get an API token that works with our github-app-token action to fetch the Terrafirma GitHub App token for you (check out the example here). Save the API token in your GitHub Actions secrets. It’s valid for 6 months (or indefinitely with consistent use). If you have an issue with API token, you can regenerate it by reinstalling the app. Just remember, uninstalling the app, invalidates API token for existing workflows.
- google-get-secret: retrieves a secret from Google Secret Manager using OIDC (OpenID Connect)
- create-repository: creates a new GitHub repository using common best practices
- generate-tag: generates a semantic version tag based on commit changes vs latest tag in main/master branch
Got an issue or idea? Check out our Contributions Guide and feel free to open issues or submit pull requests. Let’s make DevOps less tedious together. 🙌
This project is licensed under the GPL v3 License. Read the full license and enjoy the open-source goodness.