NAME

Podman::Image - Create and control image.

SYNOPSIS

    # Pull image from registry
    use Podman::Image qw(pull);
    my $image = pull('docker.io/library/hello-world');

    # Build new image from File
    my $image = Podman::Image::build('localhost/goodbye', '/tmp/Dockerfile');

    # Retrieve advanced image information
    my $info = $image->inspect;

    # Remove local stored image
    $image->remove;

DESCRIPTION

Inheritance

    Podman::Image
        isa Podman::Client

Podman::Image provides functionality to create and control an image.

ATTRIBUTES

Podman::Image implements following attributes.

name

    my $image = Podman::Image->new();
    $image->name('docker.io/library/hello-world');

Unique image name or other identifier.

FUNCTIONS

Podman::Image implements the following functions, which can be imported individually.

    use Podman::Image qw(build);
    my $image = build('localhost/goodbye', '/tmp/Dockerfile', %options);

Build and store named image from given build file and additional build options. All further recrusive available files in the directory level of the build file are included.

pull

    use Podman::Image qw(pull);
    my $image = pull('docker.io/library/hello-world' 'linux', %options);

Pull named image with optional tag, defaults to latest, and additional options from registry into store.

METHODS

Podman::Image implements following methods.

inspect

    my $Info = $image->inspect();

Return advanced image information.

remove

    $image->remove();

Remove image from store.

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.

cpanm Podman

perl -MCPAN -e shell
install Podman