Photo by Denny Müller on Unsplash
AWS Automated Inventory ( aws-auto-inventory )
Automates creation of detailed inventories from AWS resources.
Table of Contents
Screenshots
Expand
 |
|---|
| How to run |
 |
|---|
| EC2 Inventory Result |
Usage
Expand
aws-auto-inventory --help
usage: aws-auto-inventory [-h] --name NAME
Automates creation of detailed inventories from AWS resources.
optional arguments:
-h, --help show this help message and exit
--name NAME, -n NAME inventory name
Problem
Projects usually have several resources and fetching all the information about these resources manually is a very time-consuming task. This issue is intensified when the same project have multiple account and/or environments, e.g.: NonProd, QA and/or Prod.
Solution
Provide a simple way to fetch the required information and generate a spreadsheet. The information can be filtered, e.g. filter results by tag:x, vpc, subnets, etc. Additionally, inventories can be generated related to many services, which are collected and organized per sheet in the spreadsheet.
Development
# Linux/MacOS:
# clone the project and enter cloned directory
make init build
./dist/aws-auto-inventory --name <your-inventory-name>
Installing
Expand
You will need to create a config.yaml file in order to tell the tool how to generate your inventory, here are the default search paths for each platform:
- OS X:
~/.config/aws-auto-inventory/config.yamlor~/Library/Application Support/aws-auto-inventory/config.yaml - Other Unix:
$XDG_CONFIG_HOME/aws-auto-inventory/config.yamlor~/.config/aws-auto-inventory/config.yaml - Windows:
%APPDATA%\aws-auto-inventory\config.yamlwhere theAPPDATAenvironment variable falls back to%HOME%\AppData\Roaming\config.yamlif undefined
You can use the config-sample as an example. A snippet can be found below:
inventories:
- name: your-inventory-name
aws:
profile: your-aws-profile
region:
- us-east-1
excel:
transpose: true
sheets:
- name: EC2 # sheet name on Excel
service: ec2 # the boto3 client of an AWS service
function: describe_instances # the client method of the service defined above
result_key: Reservations # [optional]: The first key of the response dict
- name: EBS
service: ec2
function: describe_volumes
result_key: Volumes
If you are interested in building an inventory for multiple AWS Accounts (within your AWS organization) with the same sheets, you can use the config-sample-for-organization for simplicity. Code snippet:
Sheets: &sheets
- name: CloudFrontDistros
service: cloudfront
function: list_distributions
result_key: DistributionList
- name: S3Buckets
service: s3
function: list_buckets
result_key: Buckets
inventories:
- name: your-org-master
aws:
profile: your-org
region:
- us-east-1
excel:
transpose: true
sheets: *sheets
- name: your-org-account1
aws:
profile: your-org-account1
region:
- us-east-1
excel:
transpose: true
sheets: *sheets
- name: your-org-account2
aws:
profile: your-org-account2
region:
- us-east-1
excel:
transpose: true
sheets: *sheets
Then you need to run the auto-inventory script multiple times for your accounts as follows:
./dist/aws-auto-inventory --name your-org-master
./dist/aws-auto-inventory --name your-org-account1
./dist/aws-auto-inventory --name your-org-account1
Now, download the binary according to your operating system and platform and execute it, informing which inventory you want to generate. The tool will create a folder aws-auto-inventory-report, in the current path, with the inventory report inside.
Testing
Expand
AWS-Auto-Inventory uses boto3. You can use any service that contains any list or describe method to fetch information about your resources.
Parameters
You can use boto3 parameters to narrow down your search results.
Filter by tag:Name
sheets:
- name: VPC
service: ec2
function: describe_vpcs
result_key: Vpcs
parameters:
Filters:
- Name: tag:Name
Values:
- my-vpc
Filter by vpc-id
sheets:
- name: Subnets
service: ec2
function: describe_subnets
result_key: Subnets
parameters:
Filters:
- Name: vpc-id
Values:
- vpc-xxx
Find a particular RDS instance
sheets:
- name: RDS
service: rds
function: describe_db_instances
result_key: DBInstances
parameters:
DBInstanceIdentifier: the-name-of-my-rds-instance
Find EC2 instances by a particular tag
sheets:
- name: EC2
service: ec2
function: describe_instances
result_key: Reservations
parameters:
Filters:
- Name: tag:ApplicationName
Values:
- my-application
Find a particular IAM Role
sheets:
- name: IAM.Role
service: iam
function: get_role
result_key: Role
parameters:
RoleName: my-role
Contributors
Expand
| Name | Role | |
|---|---|---|
| Silva, Valter | [email protected] | AWS Professional Services - Cloud Architect |
Security
See CONTRIBUTING for more information.
References
License
This project is licensed under the Apache License 2.0.
For more information please read LICENSE.
Copyright
Amazon, Inc. or its affiliates. All Rights Reserved.
1 Jul 04, 2022
3 Feb 20, 2022
5 Dec 09, 2021
3 Dec 21, 2022
31 Dec 07, 2022
1 Jan 10, 2022
3 Sep 30, 2022
21 May 31, 2022
682 Dec 28, 2022
130 Dec 27, 2022
4 Dec 13, 2021
0 May 13, 2022
8 Dec 19, 2022
4 Dec 22, 2021
6 Nov 24, 2022
414 Nov 16, 2022
4 Aug 20, 2022
605 Dec 14, 2022
2 Nov 01, 2021
10 Feb 10, 2022