agipy
/əˈdʒɪˈpaɪ/, portmanteau of AgI (chemical formula of silver iodide) and Python
agipy
enables you to destroy cloud infrastructure in a hurry. Whether you want to destroy a demo
environment you no longer need or want to purge artifacts a colleague left behind, agipy
is here
to help you dissolving your cloud problems.
About the name
agipy
is a portmanteau of the chemical formula AgI for silver iodide and the word Python.
Silver iodide is a chemical used for cloud seeding. Cloud seeding is a weather modification that changes the amount or type of precipitation that falls from clouds; in my opinion that is an appropriate metaphor for deleting cloud infrastructure, especially compared to alternatives that include "nukes" or "EMPs".
Python is the language agipy
is implemented in. It is a great language for
everything concerning cloud infrastructure and automation, and it happens to be the language I feel most
comfortable with.
agipy
How to use agipy
is available on PyPI, so you can install it using pip
:
pip install --user agipy
In addition you can clone the repository and then install it from source via:
python3 setup.py install
To find out how the CLI works, use the built-in help function:
agipy --help
agipy
is based on the concept of providers: For each public cloud provider, a agipy
-specific
provider module has to be implemented. At the moment, the following provider modules exist:
Because each provider has its own semantics, please refer to the respective subsection.
azure
provider
How to use the As of yet, the azure
provider is capable of deleting all resource groups with a specific prefix.
For using the provider, you have to set the following environment variables:
-
AZURE_CLIENT_ID
, the service principal ID -
AZURE_CLIENT_SECRET
, the service principal secret AZURE_SUBSCRIPTION_ID
AZURE_TENANT_ID
Alternatively you can provide any of these values via command line arguments, see below.
You can call the provider via:
agipy azure --prefix=${RG_PREFIX} [--client-id=${AZURE_CLIENT_ID}] [--client-secret=${AZURE_CLIENT_SECRET}] [--subscription-id=${AZURE_SUBSCRIPTION_ID}] [--tenant-id=${AZURE_TENANT_ID}]
How to Test
The test suite is based on the great pytest
library. Once installed, the automatic test
discovery can be used via
pytest agipy
In order to keep the tests clean and run smoothly, I try to use subtests and patches where possible.
How to Contribute
This project is released under the GPL license, so I am happy for contributions, forks, and feedback! This can be done in many ways:
- Open PRs with improvements,
- add issues if you find bugs,
- add issues for new features,
- use
agipy
and spread the word.
PRs have to comply with:
New features must be covered by proper tests (idealy unit tests and functional tests) using the pytest
library.
Contributors
License
agipy enables you to destroy cloud infrastructure in a hurry. Copyright (C) 2019 Nils Müller shimst3r@gmail.com
This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with this program. If not, see https://www.gnu.org/licenses/