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