NAME
Podman - Library of bindings to use the RESTful API of https://podman.io service.
SYNOPSIS
# Build and store image
use Podman qw(build);
my $image = build('localhost/goodbye', '/tmp/goodbye/Dockerfile');
# List stored images name
say $_->name for $Podman::images;
# Show version information
use Podman qw(:all);
say version->{Version};
DESCRIPTION
Podman is a library of bindings to use the RESTful API of https://podman.io service. It is currently under development and contributors are welcome!
FUNCTIONS
Podman::Image implements the following functions, which can be imported individually or colletctively.
build
my $image = Podman::build('localhost/goodbye', '/tmp/goodbye/Dockerfile', %opts);
Build and store named image from given build file and additional build options.
containers
use Podman qw(containers);
say $_->inspect->{Id} for containers->each;
Return Mojo::Collection of available containers.
create
use Podman qw(:all);
my $container = create('nginx', 'docker.io/library/nginx', %opts);
Create named container based on given image and additional create options.
images
say Podman::images->size;
Return Mojo::Collection of stored images.
pull
my $image = Podman::pull('docker.io/library/hello-world');
Pull and store named image from registry.
version
use Podman qw(version);
say version->{APIVersion};
Obtain a dictionary of versions for the Podman service components.
AUTHORS
Tobias Schäfer, <tschaefer@blackox.org>
COPYRIGHT AND LICENSE
Copyright (C) 2022-2022, Tobias Schäfer.
This program is free software, you can redistribute it and/or modify it under the terms of the Artistic License version 2.0.
SEE ALSO
https://github.com/tschaefer/podman-perl, https://docs.podman.io/en/v3.0/_static/api.html