https://github.com/cavaliercoder/vpc-free

Find free IP address blocks in AWS EC2.
https://github.com/cavaliercoder/vpc-free

aws vpc

Last synced: 3 months ago
JSON representation

Find free IP address blocks in AWS EC2.

• Host: GitHub
• URL: https://github.com/cavaliercoder/vpc-free
• Owner: cavaliercoder
• License: other
• Created: 2017-05-30T10:04:27.000Z (over 7 years ago)
• Default Branch: master
• Last Pushed: 2019-06-26T00:24:45.000Z (over 5 years ago)
• Last Synced: 2024-07-11T16:44:26.881Z (4 months ago)
• Topics: aws, vpc
• Language: Python
• Homepage:
• Size: 306 KB
• Stars: 56
• Watchers: 3
• Forks: 19
• Open Issues: 1
• Metadata Files:
  • Readme: README.rst
  • License: COPYING

Awesome Lists containing this project

README

        
vpc-free

========

This script searches for the largest available IP subnets within the unallocated

spaces between your VPC subnets, or between VPCs for a given CIDR block.

.. image:: assets/screen.png

   :alt: free address blocks in a VPC

Installation

------------

Install ``vpc-free`` to ``/usr/local/bin`` with:

.. code-block:: shell

    $ pip install vpc-free

The script uses the Amazon AWS SDK (``boto3``) to connect to AWS. The SDK must

be configured with credentials to connect to the AWS APIs. Please see the `Boto3

documentation`_ for instruction.

.. _Boto3 Documentation: http://boto3.readthedocs.io/en/latest/guide/quickstart.html#configuration

Usage

-----

.. code-block:: shell

    $ vpc-free -h

    usage: vpc-free [-h] TARGET

    Find free IP blocks in AWS EC2.

    positional arguments:

      TARGET      CIDR, VPC ID or VPC Name to search

    optional arguments:

      -h, --help  show this help message and exit

Examples

--------

.. code-block:: shell

    # search for unallocated blocks between VPCs in 10.0.0.0/8

    $ vpc-free 10.0.0.0/8

    MIN IP    MAX IP         MASK SIZE     BEST         LABEL

    10.0.0.0  10.63.255.255  /10  4194304  10.0.0.0/10  FREE

    10.64.0.0 10.64.255.255  /16  65536                 vpc-c4871ca0 (Demo)

    10.65.0.0 10.255.255.255      12517376 10.128.0.0/9 FREE

    # search for unallocated blocks between subnets in a VPC

    $ vpc-free vpc-c4671caf

    10.64.0.0  10.64.15.255  /20  4096                 subnet-74247002 (Subnet 1)

    10.64.16.0 10.64.31.255  /20  4096                 subnet-d32421a5 (Subnet 2)

    10.64.32.0 10.64.47.255  /20  4096  10.64.32.0/20  FREE

    10.64.48.0 10.64.63.255  /20  4096                 subnet-0a257077 (Subnet 4)

    10.64.64.0 10.64.255.255      49152 10.64.128.0/17 FREE