Skip to main content

destroy cloud infrastructure in a hurry

Project description

Build Status

/əˈ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 automisation, and it happens to be the language I feel most comfortable with.

How to use agipy

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.

How to use the azure provider

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

Then you can call the provider via:

agipy azure --prefix=${RG_PREFIX}

How to Test

The test suite is based on the great ``pytest` <https://docs.pytest.org/en/latest/>`_ library. Once installed, the automatic test discovery can be used via

pytest agipy

How to Contribute

This project is released under the GPL license, so I am happy for contributions, forks, and feedback! This can be done on 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` <https://docs.pytest.org/en/latest/>`_ 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/

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

agipy-0.2.0.tar.gz (5.6 kB view hashes)

Uploaded Source

Built Distribution

agipy-0.2.0-py3-none-any.whl (19.8 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page