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

cpanm Podman

perl -MCPAN -e shell
install Podman