You can download the precompiled binary from releases, or using CLI:
export OS=Darwin # Possible values: Linux,Windows,Darwincurl -L https://github.com/cloudquery/cloudquery/releases/latest/download/cloudquery_${OS}_x86_64 -o cloudquerychmod a+x cloudquery./cloudquery --help​# if you want to download a specific version and not latest use the following endpointexport VERSION= # specifiy a versioncurl -L https://github.com/cloudquery/cloudquery/releases/download/${VERSION}/cloudquery_${OS}_x86_64 -o cloudquery
For mac you can also install cloudquery via hombrew
brew install cloudquery/tap/cloudquery# After initial install you can upgrade the version via:brew upgrade cloudquery
Currently, we support: AWS, Azure, GCP, Okta. If you want us to add a new provider or resource please open an Issue.
First generate a config.yml
file that will describe which resources you want cloudquery to pull, normalize and transform resources to the specified SQL database by running the following command:
./cloudquery gen config aws# ./cloudquery gen config gcp okta # This will generate a config containing gcp and okta providers# ./cloudquery gen config --help # Show all possible auto generated configs and flags
Once your config.yml
is generated run the following command to fetch the resources (you need to be authenticated - see relevant section under each provider):
./cloudquery fetch# ./cloudquery fetch --help # Show all possible fetch flags
If you used the default sqlite
provider you can run the following example queries
SELECT * FROM aws_ec2_images;
SELECT * FROM aws_elbv2_load_balancers WHERE scheme = 'internet-facing';
Running policy packs
cloudquery comes with some ready compliance policy pack which you can use as is or modify to fit your use-case.
Currently, cloudquery support AWS CIS policy pack (it is under active development, so it doesn't cover the whole spec yet).
To run AWS CIS pack enter the following commands (make sure you fetched all the resources beforehand by the fetch
command):
./cloudquery gen policy aws_cis./cloudquery query