/əˈ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.
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
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.
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 IDAZURE_CLIENT_SECRET
, the service principal secretAZURE_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}]
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.
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.
agipy enables you to destroy cloud infrastructure in a hurry. Copyright (C) 2019 Nils Müller [email protected]
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/