overview
img-proof (IPA) provides a command line utility to test images in the Public Cloud (AWS, Azure, GCE, etc.).
With img-proof you can now test custom images in a cloud framework agnostic way with one tool and one API. In the first release, img-proof supports the openSUSE and SLES distributions. It also supports the three largest cloud frameworks (AWS, Azure and GCE). However, it is intended to be distribution agnostic and framework transparent so both are easily extensible.
For each distribution there are specific synchronization points that must be provided. These currently include soft reboot and system update. The synch points not only test functionality but also act as dividers to separate distinct sections of a test suite. For example you can run a test to ensure the proper repos exist before and after a system update. The system update synch point will guarantee the order of tests. Speaking of tests, if you're already familiar with Pytest conventions there's no need to learn a whole new unit testing framework. img-proof is written in Python and leverages the Pytest framework through Testinfra.
Installation
To install the package use the following commands as root:
$ zypper ar http://download.opensuse.org/repositories/Cloud:/Tools:/CI/<distribution>
$ zypper refresh
$ zypper in python-img-proof
Requirements
- boto3
- apache-libcloud
- azure-common
- azure-mgmt-compute
- azure-mgmt-network
- azure-mgmt-resource
- Click
- paramiko
- pytest
- PyYaml
- testinfra
- oci
Docs
Tests
img-proof uses the Testinfra package for writing unit tests. Testinfra leverages Pytest and provides modules such as Package, Process and Service to test the state of images. See the Testinfra Docs for more information on writing infrastructure tests.
img-proof currently passes the Pytest option
-x(stop on first failure) through as--early-exit. If there's an interest or need for any other options/args please submit an issue to Github.
CLI Overview
The CLI provides multiple subcommands to initiate image testing:
-
img-proof testTest image in the given framework using the supplied test files.
-
img-proof resultsInvokes the default show subcommand
img-proof results show 1. -
img-proof results clearClear the results from the history file.
-
img-proof results deleteDelete the specified history item from the history log.
-
img-proof results list`
Display list of results history.
-
img-proof results showDisplay the results or log file for a history item.
-
img-proof listPrint a list of test files or test cases.
Issues/Enhancements
Please submit issues and requests to Github.
Contributing
Contributions to ipa are welcome and encouraged. See CONTRIBUTING for info on getting started.
License
Copyright (c) 2018 SUSE LLC.
Distributed under the terms of GPL-3.0+ license, see LICENSE for details.
2 maintainers
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file img_proof-9.19.0.tar.gz.
File metadata
- Download URL: img_proof-9.19.0.tar.gz
- Upload date:
- Size: 111.2 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.14.6
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
b86c0acb030164e848a36847bf847d0606674b430e7c5bac6c4b3bcfeca72596
|
|
| MD5 |
241c1e3f73e5ba4847a0f46fc3d0e80b
|
|
| BLAKE2b-256 |
d007d1fea22e35fb978a3886b72de2f0c8307ae87ac869a366b39172a7c7e281
|
File details
Details for the file img_proof-9.19.0-py3-none-any.whl.
File metadata
- Download URL: img_proof-9.19.0-py3-none-any.whl
- Upload date:
- Size: 68.4 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.14.6
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
f47275868b8116fba7ca3a223871c8b6d87bd602e255c9aec7d01fa794302d01
|
|
| MD5 |
665d8f23ea1138d819386bfcc413486c
|
|
| BLAKE2b-256 |
0c2c3d2c6323fb20105a3705eacac2f3659cbbaf2199fa179aea576bdc861849
|
