PackageCloud¶
Documentation¶
kingpin.actors.packagecloud
¶
The packagecloud actor allows you to perform maintenance operations on repositories hosted by packagecloud.io using their API:
https://packagecloud.io/docs/api
Required Environment Variables
PACKAGECLOUD_ACCOUNT: | |
---|---|
packagecloud account name, i.e. https://packagecloud.io/PACKAGECLOUD_ACCOUNT | |
PACKAGECLOUD_TOKEN: | |
packagecloud API Token |
Delete¶
-
class
kingpin.actors.packagecloud.
Delete
(*args, **kwargs)[source] Deletes packages from a PackageCloud repo.
Searches for packages that match the
packages_to_delete
regex pattern and deletes them. Ifnumber_to_keep
is set, we always at least this number of versions of the given package intact in the repo. Also ifnumber_to_keep
is set, the older versions of a package (based on upload time) packages will be deleted first effectively leaving newer packages in the repo.Options
Number_to_keep: Keep at least this number of each package (defaults to 0) Packages_to_delete: Regex of packages to delete, e.g. pkg1|pkg2 Repo: Which packagecloud repo to delete from Examples
{ "desc": "packagecloud Delete example", "actor": "packagecloud.Delete", "options": { "number_to_keep": 10, "packages_to_delete": "deleteme", "repo": "test" } }
DeleteByDate¶
-
class
kingpin.actors.packagecloud.
DeleteByDate
(*args, **kwargs)[source] Deletes packages from a PackageCloud repo older than X.
Adds additional functionality to the
Delete
class with aolder_than
option. Only packages older than that number of seconds will be deleted.Options
Number_to_keep: Keep at least this number of each package (defaults to 0) Older_than: Delete packages created before this number of seconds Packages_to_delete: Regex of packages to delete, e.g. pkg1|pkg2 Repo: Which packagecloud repo to delete from Examples
{ "desc": "packagecloud DeleteByDate example", "actor": "packagecloud.DeleteByDate", "options": { "number_to_keep": 10, "older_than": 600, "packages_to_delete": "deleteme", "repo": "test" } }
WaitForPackage¶
-
class
kingpin.actors.packagecloud.
WaitForPackage
(*args, **kwargs)[source] Searches for a package that matches
name
andversion
until found or a timeout occurs.Options
Name: Name of the package to search for as a regex Version: Version of the package to search for as a regex Repo: Which packagecloud repo to delete from Sleep: Number of seconds to sleep for between each search Examples
{ "desc": "packagecloud WaitForPackage example", "actor": "packagecloud.WaitForPackage", "options": { "name": "findme", "version": "0.1", "repo": "test", "sleep": 10, } }