Skip to content

GitHub Action wrapper for Devolv β€” modular DevOps CLI for IAM drift detection, validation, and security.

License

Notifications You must be signed in to change notification settings

devolvdev/devolv-actions

Use this GitHub action with your project
Add this Action to an existing workflow or create a new one
View on Marketplace

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

59 Commits
 
 
 
 
 
 
 
 

Repository files navigation

Devolv GitHub Action

βœ… Run Devolv DevOps Toolkit tools directly in GitHub workflows to secure, validate, and fix your IAM policies β€” automatically.


🌟 What This Action Can Do

πŸ‘‰ Devolv Drift

  • Detect IAM drift between your local files and deployed AWS policies
  • Auto-create GitHub PRs to fix detected drift
  • Open GitHub issues to track misalignments
  • Keep your AWS environment in sync with your source of truth

πŸ‘‰ Devolv Validate

  • Validate IAM JSON/YAML files for security issues (e.g., wildcards, risky permissions)
  • Catch policy misconfigurations before they go live
  • Block PRs with unsafe changes

πŸš€ Example Use Cases

βœ… Keep IAM policies aligned: Stop worrying about manual AWS changes breaking your security posture β€” Devolv Drift finds and fixes them via PRs.

βœ… Prevent bad policies from merging: Devolv Validate ensures only safe IAM policies land in main.

βœ… Automate governance: Replace manual policy reviews with automatic CI/CD checks.

βœ… No more surprise misconfigurations: Everything is caught at PR time β€” before deployment.

βœ… Zero-touch fixes: Devolv creates issues and PRs so your team can focus on code, not IAM drift.


πŸ“Œ Inputs

Input Description Required
tool Which tool to run (drift or validate) βœ… yes
policy-name IAM policy name (required for drift) ❌ no (βœ… yes if drift)
path Path to local policy file or folder βœ… yes

⚑ Example usage

πŸ›‘οΈ Drift detection

- name: Run Devolv Drift Detection
  uses: devolvdev/devolv-actions@v2
  with:
    tool: drift
    policy-name: DevolvTestPolicyHuge
    path: ./test-devolv-policy.json
    approvers: ""  # Empty by default; pass comma-separated list if needed
    github-token: ${{ secrets.GITHUB_TOKEN }}
    approval-anyway: false

πŸ” IAM validation

- name: Run Devolv IAM Validation
  uses: devolvdev/devolv-actions@v2
  with:
    tool: validate
    path: ./sample_policies

πŸ”— Further resources

➑ Devolv Drift Onboarding + CI/CD Guide
➑ Devolv Validate Docs
➑ Devolv Project on GitHub


Built with ❀️ to make IAM security effortless.

About

GitHub Action wrapper for Devolv β€” modular DevOps CLI for IAM drift detection, validation, and security.

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Contributors 2

  •  
  •  

Languages