Aws

.github/workflows/test.yml

@@ -2,7 +2,7 @@ name: Test
 
 on:
   push:
-    branches: [ "main", "development" ]
+    branches: [ "main", "development", "AWS" ]
   pull_request:
     branches: [ "main", "development" ]
   workflow_dispatch:
@@ -31,7 +31,7 @@ jobs:
       - name: Install dependencies
         run: |
           python -m pip install --upgrade pip
-          pip install -r requirements.txt
+          pip install -r requirements-aws.txt
           pip install pytest
 
       - name: Install vcsim

Dockerfile

@@ -1,13 +1,16 @@
 FROM python:3.14-slim AS builder
 
 COPY requirements.txt .
+COPY requirements-aws.txt .
 
 ARG VENV=/opt/netbox-sync/venv
+ARG INSTALL_AWS=false
 
 # Install dependencies
 RUN python3 -m venv $VENV && \
     $VENV/bin/python3 -m pip install --upgrade pip && \
     $VENV/bin/pip install -r requirements.txt && \
+    if [ "$INSTALL_AWS" = "true" ]; then $VENV/bin/pip install -r requirements-aws.txt; fi && \
     $VENV/bin/pip install vmware-vcenter==9.1.1.0 && \
     $VENV/bin/python3 -m pip uninstall -y pip && \
     find $VENV -type d -name "__pycache__" -print0 | xargs -0 -n1 rm -rf

README.md

@@ -4,6 +4,7 @@ This is a tool to sync data from different sources to a NetBox instance.
 
 Available source types:
 * VMware vCenter Server
+* AWS EC2, EBS, and network interfaces (see [AWS source](docs/source_aws.md))
 * [bb-ricardo/check_redfish](https://github.com/bb-Ricardo/check_redfish) inventory files
 
 **IMPORTANT: READ INSTRUCTIONS CAREFULLY BEFORE RUNNING THIS PROGRAM**
@@ -38,6 +39,9 @@ This ensures stale objects are removed from NetBox keeping an accurate current s
 * VMWare vCenter >= 6.0
 #### Source: check_redfish (if used)
 * check_redfish >= 1.2.0
+#### Source: AWS (if used)
+* Optional boto3 SDK, AWS read-only credentials, and explicit regions
+* Existing VPC-specific NetBox VRFs for IP import; see [AWS setup](docs/source_aws.md)
 
 # Installing
 * here we assume we install in ```/opt```