diff --git a/.woodpecker/netlify.yml b/.woodpecker/netlify.yml new file mode 100644 index 0000000..4782c21 --- /dev/null +++ b/.woodpecker/netlify.yml @@ -0,0 +1,20 @@ +when: + event: push + branch: main + +pipeline: + build: + image: python:3.9 + commands: + - pip3 install -r requirements.txt + - mkdocs build --site-dir publish + + deploy: + image: node:18 + environment: + - NETLIFY_SITE_ID=a41006ac-4870-484f-9fef-2d45e9546837 + secrets: + - NETLIFY_AUTH_TOKEN + commands: + - npm install -D netlify-cli + - npx netlify deploy --site=$NETLIFY_SITE_ID --dir=publish --prod diff --git a/docs/assets/get-it-on-codeberg.svg b/docs/assets/get-it-on-codeberg.svg new file mode 100644 index 0000000..e921c6c --- /dev/null +++ b/docs/assets/get-it-on-codeberg.svg @@ -0,0 +1,19 @@ + \ No newline at end of file diff --git a/docs/index.md b/docs/index.md new file mode 100644 index 0000000..5db17cd --- /dev/null +++ b/docs/index.md @@ -0,0 +1,51 @@ +# IPAM + +IPAM is a cli based [IP Address Management](https://en.wikipedia.org/wiki/IP_address_management) built with [Go](https://go.dev/) using [Cobra](https://cobra.dev/) and [Viper](https://github.com/spf13/viper) with optional [PowerDNS](https://www.powerdns.com/auth.html) API integration. + + + + +## Features + +`ipam` is a cli based IPAM. It supports: + +- Adding, listing, viewing and deleting subnets +- Adding, viewing and deleting single IP addresses with FQDNs +- automatic addition and deletion of forward and reverse records +- import and export configuration + +## But why? + +In my career as a Network Engineer I worked at a company that developed their own internal CMDB that was set up as a cli application. I really liked the ease of use and the way you could quickly do stuff. + +So I sat down and started my first Go project and started developing this ipam. + +## Usage + +`ipam` is built as a cli app. Once you installed `ipam` and added it to your `$PATH`, you can + +- add prefixes with `ipam subnet add 192.168.0.0/24 fancy-subnet-name` +- add IPs to those prefixes with `ipam ip add 192.168.0.1 fqdn.example.com` +- add the next free IP in a prefix with `ipam ip add 192.168.0.0/24 fqdn2.example.com` +- much more (see `ipam (command) --help` for examples) + +If PowerDNS integration is enabled in `$HOME/.ipam/ipam.yml`, forward and reverse DNS records are automatically managed when you add or delete IP addresses with hostnames. + +## CLI Example +
+ +
+ +## Contributing + +The main development is happening at [https://codeberg.org/lauralani/ipam](https://codeberg.org/lauralani/ipam). + +If you find a bug or would like a feature to get added you can [create a new issue](https://codeberg.org/lauralani/ipam/issues) or collaborate by forking the repository and [create a new pull request](https://codeberg.org/lauralani/ipam/pulls). + +If you have any questions please also feel free to create a new Issue! + +## License + +Copyright 2023 Laura Kalb