github.com/containers/podman/v5@v5.1.0-rc1/docs/source/Introduction.rst (about)

     1  .. include:: includes.rst
     2  
     3  Introduction
     4  ==================================
     5  Containers_ simplify the production, distribution, discoverability, and usage of applications with all of their dependencies and default configuration files. Users test drive or deploy a new application with one or two commands instead of following pages of installation instructions. Here's how to find your first `Container Image`_::
     6  
     7      podman search docker.io/busybox
     8  
     9  Output::
    10  
    11      NAME                                         DESCRIPTION
    12      docker.io/library/busybox                    Busybox base image.
    13      docker.io/rancher/busybox
    14      docker.io/openebs/busybox-client
    15      docker.io/antrea/busybox
    16      docker.io/hugegraph/busybox                  test image
    17      ...
    18  
    19  The previous command returned a list of publicly available container images on DockerHub. These container images are easy to consume, but of differing levels of quality and maintenance. Let’s use the first one listed because it seems to be well maintained.
    20  
    21  To run the busybox container image, it’s just a single command::
    22  
    23      podman run -it docker.io/library/busybox
    24  
    25  Output::
    26  
    27      / #
    28  
    29  You can poke around in the busybox container for a while, but you’ll quickly find that running small container with a few Linux utilities in it provides limited value, so exit out::
    30  
    31      exit
    32  
    33  There’s an old saying that “nobody runs an operating system just to run an operating system” and the same is true with containers. It’s the workload running on top of an operating system or in a container that’s interesting and valuable.
    34  
    35  Sometimes we can find a publicly available container image for the exact workload we’re looking for and it will already be packaged exactly how we want. But, more often than not, there’s something that we want to add, remove, or customize. It can be as simple as a configuration setting for security or performance, or as complex as adding a complex workload. Either way, containers make it fairly easy to make the changes we need.
    36  
    37  Container Images aren’t actually images, they’re repositories often made up of multiple layers. These layers can easily be added, saved, and shared with others by using a Containerfile (Dockerfile). This single file often contains all the instructions needed to build a new container image and can easily be shared with others publicly using tools like GitHub.
    38  
    39  Here's an example of how to build a Nginx web server on top of a Debian base image using the Dockerfile maintained by Nginx and published in GitHub::
    40  
    41      podman build -t nginx https://git.io/Jf8ol
    42  
    43  Once, the image build completes, it’s easy to run the new image from our local cache::
    44  
    45      podman run -d -p 8080:80 nginx
    46      curl localhost:8080
    47  
    48  Output::
    49  
    50      ...
    51      <p><em>Thank you for using nginx.</em></p>
    52      ...
    53  
    54  Building new images is great, but sharing our work with others lets them review our work, critique how we built them, and offer improved versions. Our newly built Nginx image can be published at quay.io or docker.io to share it with the world. Everything needed to run the Nginx application is provided in the container image. Others can easily pull it down and use it, or make improvements to it.
    55  
    56  Standardizing on container images and `Container Registries`_ enable a new level of collaboration through simple consumption. This simple consumption model is possible because every major Container Engine and Registry Server uses the Open Containers Initiative (OCI_) format. This allows users to find, run, build, share and deploy containers anywhere they want. Podman and other `Container Engines`_ like CRI-O, Docker, or containerd can create and consume container images from docker.io, quay.io, an on premise registry or even one provided by a cloud provider. The OCI image format facilitates this ecosystem through a single standard.
    57  
    58  For example, if we wanted to share our newly built Nginx container image on quay.io it’s easy. First log in to quay::
    59  
    60      podman login quay.io
    61  Input::
    62  
    63      Username: USERNAME
    64      Password: ********
    65      Login Succeeded!
    66  
    67  Next, tag the image so that we can push it into our user account::
    68  
    69      podman tag localhost/nginx quay.io/USERNAME/nginx
    70  
    71  Finally, push the image::
    72  
    73      podman push quay.io/USERNAME/nginx
    74  
    75  Output::
    76  
    77      Getting image source signatures
    78      Copying blob 38c40d6c2c85 done
    79      Copying blob fee76a531659 done
    80      Copying blob c2adabaecedb done
    81      Copying config 7f3589c0b8 done
    82      Writing manifest to image destination
    83      Copying config 7f3589c0b8 done
    84      Writing manifest to image destination
    85      Storing signatures
    86  
    87  Notice that we pushed four layers to our registry and now it’s available for others to share. Take a quick look::
    88  
    89      podman inspect quay.io/USERNAME/nginx
    90  
    91  Output::
    92  
    93      [
    94          {
    95              "Id": "7f3589c0b8849a9e1ff52ceb0fcea2390e2731db9d1a7358c2f5fad216a48263",
    96              "Digest": "sha256:7822b5ba4c2eaabdd0ff3812277cfafa8a25527d1e234be028ed381a43ad5498",
    97              "RepoTags": [
    98                  "quay.io/USERNAME/nginx:latest",
    99      ...
   100  
   101  To summarize, Podman makes it easy to find, run, build and share containers.
   102  
   103  * Find: whether finding a container on dockerhub.io or quay.io, an internal registry server, or directly from a vendor, a couple of `podman search`_, and `podman pull`_ commands make it easy
   104  * Run: it's easy to consume pre-built images with everything needed to run an entire application, or start from a Linux distribution base image with the `podman run`_ command
   105  * Build: creating new layers with small tweaks, or major overhauls is easy with `podman build`_
   106  * Share: Podman lets you push your newly built containers anywhere you want with a single `podman push`_ command
   107  
   108  For more instructions on use cases, take a look at our :doc:`Tutorials` page.