82 lines
3.5 KiB
Markdown
82 lines
3.5 KiB
Markdown
<p align="center">
|
|
<img width="200" src="https://docs.driftctl.com/img/driftctl_dark.svg" alt="driftctl">
|
|
</p>
|
|
|
|
<p align="center">
|
|
<img src="https://circleci.com/gh/snyk/driftctl.svg?style=shield"/>
|
|
<img src="https://goreportcard.com/badge/github.com/snyk/driftctl"/>
|
|
<img src="https://img.shields.io/github/license/snyk/driftctl">
|
|
<img src="https://img.shields.io/github/v/release/snyk/driftctl">
|
|
<img src="https://img.shields.io/github/go-mod/go-version/snyk/driftctl">
|
|
<img src="https://img.shields.io/github/downloads/snyk/driftctl/total.svg"/>
|
|
<a href="https://codecov.io/gh/snyk/driftctl">
|
|
<img src="https://codecov.io/gh/snyk/driftctl/branch/main/graph/badge.svg?token=8C5R02G5S7"/>
|
|
</a>
|
|
<img src="https://img.shields.io/docker/pulls/snyk/driftctl"/>
|
|
<img src="https://img.shields.io/docker/image-size/snyk/driftctl"/>
|
|
<a href="https://discord.gg/NMCBxtD7Nd">
|
|
<img src="https://img.shields.io/discord/783720783469871124?color=%237289da&label=discord&logo=discord"/>
|
|
</a>
|
|
</p>
|
|
|
|
<p align="center">
|
|
Measures infrastructure as code coverage, and tracks infrastructure drift.<br>
|
|
<strong>IaC:</strong> Terraform. <strong>Cloud providers:</strong> AWS, GitHub, Azure, GCP.<br>
|
|
:warning: <strong>This tool is still in beta state and will evolve in the future with potential breaking changes</strong> :warning:
|
|
</p>
|
|
|
|
<details>
|
|
<summary>Packaging status</summary>
|
|
<a href="https://repology.org/project/driftctl/versions">
|
|
<img src="https://repology.org/badge/vertical-allrepos/driftctl.svg" alt="Packaging status">
|
|
</a>
|
|
</details>
|
|
|
|
## Why driftctl ?
|
|
|
|
Infrastructure drift is a blind spot and a source of potential security issues.
|
|
Drift can have multiple causes: from team members creating or updating infrastructure through the web console without backporting changes to Terraform, to unexpected actions from authenticated apps and services.
|
|
|
|
You can't efficiently improve what you don't track. We track coverage for unit tests, why not infrastructure as code coverage?
|
|
|
|
Spot discrepancies as they happen: driftctl is a free and open-source CLI that warns of infrastructure drifts and fills in the missing piece in your DevSecOps toolbox.
|
|
|
|
|
|
## Features
|
|
|
|
- **Scan** cloud provider and map resources with IaC code
|
|
- Analyze diffs, and warn about drift and unwanted unmanaged resources
|
|
- Allow users to **ignore** resources
|
|
- Multiple output formats
|
|
|
|
## Links
|
|
|
|
**[Get Started](https://driftctl.com/product/quick-tutorial/)**
|
|
|
|
**[Documentation](https://docs.driftctl.com)**
|
|
|
|
**[Installation](https://docs.driftctl.com/installation)**
|
|
|
|
**[Discord](https://discord.gg/7zHQ8r2PgP)**
|
|
|
|
## Contribute
|
|
|
|
To learn more about compiling driftctl and contributing, please refer to the [contribution guidelines](.github/CONTRIBUTING.md) and the [contributing guide](docs/README.md) for technical details.
|
|
|
|
This project follows the [all-contributors](https://github.com/all-contributors/all-contributors) specification and is brought to you by these [awesome contributors](CONTRIBUTORS.md).
|
|
|
|
Build with ❤️️ from 🇫🇷 🇬🇧 🇯🇵 🇬🇷 🇸🇪 🇺🇸 🇷🇪 🇨🇦 🇮🇱
|
|
|
|
## Helping you get started
|
|
|
|
We have 30 min slots for 1:1 [tech discussions and overviews](https://calendly.com/stephanejourdan/30min) twice a day to help you get started and collect users feedback.
|
|
|
|
Feel free to book a slot.
|
|
|
|
## Security notice
|
|
|
|
All Terraform state and Terraform files in this repository are for unit test
|
|
purposes only. No running code attempts to access these resources (except to
|
|
create and destroy them, in the case of acceptance tests). They are just opaque
|
|
strings.
|