1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170
|
# Copyright 2020 Red Hat, Inc.
#
# Licensed under the Apache License, Version 2.0 (the "License"); you may
# not use this file except in compliance with the License. You may obtain
# a copy of the License at
#
# http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
# License for the specific language governing permissions and limitations
# under the License.
#
"""Images integration tests."""
import io
import os
import platform
import tarfile
import types
import unittest
import podman.tests.integration.base as base
from podman import PodmanClient
from podman.domain.images import Image
from podman.errors import APIError, ImageNotFound
# @unittest.skipIf(os.geteuid() != 0, 'Skipping, not running as root')
class ImagesIntegrationTest(base.IntegrationTest):
"""images call integration test"""
def setUp(self):
super().setUp()
self.client = PodmanClient(base_url=self.socket_uri)
self.addCleanup(self.client.close)
@unittest.skipIf(os.uname().machine == 'riscv64', 'quay.io/libpod/alpine does not include riscv64.')
def test_image_crud(self):
"""Test Image CRUD.
Notes:
Written to maximize reuse of pulled image.
"""
with self.subTest("Pull Alpine Image"):
image = self.client.images.pull("quay.io/libpod/alpine", tag="latest")
self.assertIsInstance(image, Image)
self.assertIn("quay.io/libpod/alpine:latest", image.tags)
self.assertTrue(self.client.images.exists(image.id))
with self.subTest("Inspect Alpine Image"):
image = self.client.images.get("quay.io/libpod/alpine")
self.assertIsInstance(image, Image)
self.assertIn("quay.io/libpod/alpine:latest", image.tags)
with self.subTest("Retrieve Image history"):
ids = [i["Id"] for i in image.history()]
self.assertIn(image.id, ids)
with self.subTest("Export Image to tarball (in memory)"):
buffer = io.BytesIO()
for chunk in image.save():
buffer.write(chunk)
buffer.seek(0, 0)
with tarfile.open(fileobj=buffer, mode="r") as tar:
items = tar.getnames()
self.assertIn("manifest.json", items)
self.assertIn("repositories", items)
with self.subTest("List images"):
image_list = self.client.images.list()
self.assertTrue(
any([i for i in image_list if "quay.io/libpod/alpine:latest" in i.tags]),
f"pulled image 'quay.io/libpod/alpine:latest' not listed, {image_list}.",
)
with self.subTest("Tag and reload() Image"):
self.assertTrue(image.tag("localhost/alpine", "unittest"))
image.reload()
self.assertIn("localhost/alpine:unittest", image.tags)
with self.subTest("Delete Image"):
actual = self.client.images.remove(image.id, force=True)
deleted = [d["Deleted"] for d in actual if "Deleted" in d]
self.assertIn(image.id, deleted)
untagged = [d["Untagged"] for d in actual if "Untagged" in d]
self.assertIn(image.tags[0], untagged)
exit_code = [d["ExitCode"] for d in actual if "ExitCode" in d]
self.assertIn(0, exit_code)
with self.assertRaises(ImageNotFound):
# verify image deleted before loading below
self.client.images.get(image.id)
with self.subTest("Load Image previously deleted"):
buffer.seek(0, 0)
new_image = next(iter(self.client.images.load(buffer.getvalue())))
self.assertEqual(image.id, new_image.id)
with self.subTest("Deleted unused Images"):
actual = self.client.images.prune()
deleted = [d.get("Deleted") for d in actual["ImagesDeleted"]]
self.assertIn(image.id, deleted)
self.assertGreater(actual["SpaceReclaimed"], 0)
with self.subTest("Export Image to tarball (in memory) with named mode"):
alpine_image = self.client.images.pull("quay.io/libpod/alpine", tag="latest")
image_buffer = io.BytesIO()
for chunk in alpine_image.save(named=True):
image_buffer.write(chunk)
image_buffer.seek(0, 0)
with tarfile.open(fileobj=image_buffer, mode="r") as tar:
items_in_tar = tar.getnames()
# Check if repositories file is available in the tarball
self.assertIn("repositories", items_in_tar)
# Extract the 'repositories' file
repositories_file = tar.extractfile("repositories")
if repositories_file is not None:
# Check the content of the "repositories" file.
repositories_content = repositories_file.read().decode("utf-8")
# Check if "repositories" file contains the name of the Image (named).
self.assertTrue("alpine" in str(repositories_content))
def test_search(self):
# N/B: This is an infrequently used feature, that tends to flake a lot.
# Just check that it doesn't throw an exception and move on.
self.client.images.search("alpine")
@unittest.skip("Needs Podman 3.1.0")
def test_corrupt_load(self):
with self.assertRaises(APIError) as e:
next(self.client.images.load(b"This is a corrupt tarball"))
self.assertIn("payload does not match", e.exception.explanation)
@unittest.skipUnless(base.HAVE_FUSE, 'This test requires a working fuse setup.')
def test_build(self):
buffer = io.StringIO("""FROM quay.io/libpod/alpine_labels:latest""")
image, stream = self.client.images.build(fileobj=buffer)
self.assertIsNotNone(image)
self.assertIsNotNone(image.id)
@unittest.skipIf(platform.architecture()[0] == "32bit", "no 32-bit image available")
def test_pull_stream(self):
generator = self.client.images.pull("ubi8", tag="latest", stream=True)
self.assertIsInstance(generator, types.GeneratorType)
@unittest.skipIf(platform.architecture()[0] == "32bit", "no 32-bit image available")
def test_pull_stream_decode(self):
generator = self.client.images.pull("ubi8", tag="latest", stream=True, decode=True)
self.assertIsInstance(generator, types.GeneratorType)
def test_scp(self):
with self.assertRaises(APIError) as e:
next(
self.client.images.scp(
source="randuser@fake.ip.addr:22::quay.io/libpod/alpine", quiet=False
)
)
self.assertRegex(
e.exception.explanation,
r"failed to connect: dial tcp: lookup fake\.ip\.addr.+no such host",
)
|