معرفی شرکت ها
aws-cidr-finder-0.2.3
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشترتوضیحات
A CLI tool for finding unused CIDR blocks in AWS VPCs.
| ویژگی | مقدار |
|---|---|
| سیستم عامل | OS Independent |
| نام فایل | aws-cidr-finder-0.2.3 |
| نام | aws-cidr-finder |
| نسخه کتابخانه | 0.2.3 |
| نگهدارنده | [] |
| ایمیل نگهدارنده | [] |
| نویسنده | cooperwalbrun |
| ایمیل نویسنده | mail@cooperwalbrun.io |
| آدرس صفحه اصلی | https://github.com/cooperwalbrun/aws-cidr-finder |
| آدرس اینترنتی | https://pypi.org/project/aws-cidr-finder/ |
| مجوز | - |
# aws-cidr-finder   [](https://codecov.io/gh/cooperwalbrun/aws-cidr-finder)
1. [Overview](#overview)
1. [An Example](#an-example)
2. [Installation](#installation)
3. [Configuration](#configuration)
4. [Contributing](#contributing)
## Overview
`aws-cidr-finder` is a Python CLI tool which finds unused CIDR blocks (supports both IPv4 and IPv6)
in your AWS VPCs and outputs them to STDOUT. It is very simple, but can be quite useful for users
who manage many subnets across one or more VPCs.
Use `aws-cidr-finder -h` to see command options.
### An Example
It is easiest to see the value of this tool through an example. Pretend that we have the following
VPC setup in AWS:
* A VPC whose CIDR is `172.31.0.0/16`, with a `Name` tag of `Hello World`
* Six subnets in that VPC whose CIDRs are:
* `172.31.0.0/20`
* `172.31.16.0/20`
* `172.31.32.0/20`
* `172.31.48.0/20`
* `172.31.64.0/20`
* `172.31.80.0/20`
* An [AWS CLI profile](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-profiles.html)
named `myprofile`
`aws-cidr-finder` allows you to quickly compute the CIDRs that you still have available in the VPC
without having to do a lot of annoying/tedious octet math. If we issue this command:
```bash
aws-cidr-finder --profile myprofile
```
We should see this output:
```
Here are the available CIDR blocks in the 'Hello World' VPC (VPC CIDR block '172.31.0.0/16'):
CIDR IP Count
--------------- ----------
172.31.96.0/19 8192
172.31.128.0/17 32768
Total 40960
```
You should notice that by default, `aws-cidr-finder` will automatically "simplify" the CIDRs
by merging adjacent free CIDR blocks so that the resulting table shows the maximum contiguous space
per CIDR (in other words, the resulting table has the fewest number of rows possible). This is why
the result of the command displayed only two CIDRs: a `/19` and a `/17`.
>Note that the first CIDR is `/19` instead of, for example, `/18`, because the `/18` CIDR would
>mathematically have to begin at IP address `172.31.64.0`, and that IP address is already taken by a
>subnet!
However, we can change this "simplification" behavior by specifying the `--prefix` CLI flag:
```bash
aws-cidr-finder --profile myprofile --prefix 20
```
Now, the expected output should look something like this:
```
Here are the available CIDR blocks in the 'Hello World' VPC (VPC CIDR block '172.31.0.0/16'):
CIDR IP Count
--------------- ----------
172.31.96.0/20 4096
172.31.112.0/20 4096
172.31.128.0/20 4096
172.31.144.0/20 4096
172.31.160.0/20 4096
172.31.176.0/20 4096
172.31.192.0/20 4096
172.31.208.0/20 4096
172.31.224.0/20 4096
172.31.240.0/20 4096
Total 40960
```
With the `--prefix` argument, we can now query our available network space to our desired level of
detail. Note that if we specify a `--prefix` with a value lower than any of the prefixes in the
originally-returned list, those CIDRs will be skipped. For example, if we run the following:
```bash
aws-cidr-finder --profile myprofile --prefix 18
```
We should see this output:
```
Note: skipping CIDR '172.31.96.0/19' because its prefix (19) is larger than the requested prefix (18)
Here are the available CIDR blocks in the 'Hello World' VPC (VPC CIDR block '172.31.0.0/16'):
CIDR IP Count
--------------- ----------
172.31.128.0/18 16384
172.31.192.0/18 16384
Total 32768
```
The CIDR that was skipped was the `172.31.96.0/19` CIDR because it is impossible to convert a `/19`
CIDR into one or more `/18` CIDRs.
## Installation
If you have Python >=3.10 and <4.0 installed, `aws-cidr-finder` can be installed from PyPI using
something like
```bash
pip install aws-cidr-finder
```
## Configuration
All that needs to be configured in order to use this CLI is an
[AWS CLI profile](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-profiles.html) or
a keypair. The former may be specified using the `--profile` argument on the CLI, while the keypair
must be specified in environment variables. If both are available simultaneously, `aws-cidr-finder`
will prefer the profile.
The environment variables for the keypair approach are `AWS_ACCESS_KEY_ID` and
`AWS_SECRET_ACCESS_KEY` (the same values Boto uses).
You should also ensure that the profile/keypair you are using has the AWS IAM access needed to make
the underlying API calls via Boto. Here is a minimal IAM policy document that fills this
requirement:
```json
{
"Effect": "Allow",
"Action": [
"ec2:DescribeVpcs",
"ec2:DescribeSubnets"
],
"Resource": "*"
}
```
Read more about the actions shown above
[here](https://docs.aws.amazon.com/service-authorization/latest/reference/list_amazonec2.html).
## Contributing
See [CONTRIBUTING.md](CONTRIBUTING.md) for developer-oriented information.
نیازمندی
| مقدار | نام |
|---|---|
| <2,>=1.21 | boto3 |
| - | importlib-metadata |
| <1,>=0.8.9 | tabulate |
| - | pytest |
| - | pytest-cov |
| - | pytest-mock |
| - | tox |
| - | yapf |
| - | pytest |
| - | pytest-cov |
| - | pytest-mock |
| - | tox |
| - | tox-gh-actions |
| - | pytest |
| - | pytest-cov |
| - | pytest-mock |
| - | tox |
زبان مورد نیاز
| مقدار | نام |
|---|---|
| <4,>=3.10 | Python |
نحوه نصب
نصب پکیج whl aws-cidr-finder-0.2.3:
pip install aws-cidr-finder-0.2.3.whl
نصب پکیج tar.gz aws-cidr-finder-0.2.3:
pip install aws-cidr-finder-0.2.3.tar.gz