Documentation ¶
Overview ¶
Package server supports a RESTful API for the Libpod library
This documentation describes the Podman v2.x+ RESTful API. It consists of a Docker-compatible API and a Libpod API providing support for Podman’s unique features such as pods.
To start the service and keep it running for 5,000 seconds (-t 0 runs forever):
podman system service -t 5000 &
You can then use cURL on the socket using requests documented below.
NOTE: if you install the package podman-docker, it will create a symbolic link for /run/docker.sock to /run/podman/podman.sock
NOTE: Some fields in the API response JSON are encoded as omitempty, which means that if said field has a zero value, they will not be encoded in the API response. This is a feature to help reduce the size of the JSON responses returned via the API.
NOTE: Due to the limitations of [go-swagger](https://github.com/go-swagger/go-swagger), some field values that have a complex type show up as null in the docs as well as in the API responses. This is because the zero value for the field type is null. The field description in the docs will state what type the field is expected to be for such cases.
See podman-service(1) for more information.
Quick Examples: 'podman info' curl --unix-socket /run/podman/podman.sock http://d/v4.0.0/libpod/info 'podman pull quay.io/containers/podman' curl -XPOST --unix-socket /run/podman/podman.sock -v 'http://d/v4.0.0/images/create?fromImage=quay.io%2Fcontainers%2Fpodman' 'podman list images' curl --unix-socket /run/podman/podman.sock -v 'http://d/v4.0.0/libpod/images/json' | jq
Terms Of Service:
https://github.com/containers/podman/blob/913caaa9b1de2b63692c9bae15120208194c9eb3/LICENSE
Schemes: http, https Host: podman.io BasePath: / Version: 4.0.0 License: Apache-2.0 https://opensource.org/licenses/Apache-2.0 Contact: Podman <podman@lists.podman.io> https://podman.io/community/ InfoExtensions: x-logo: - url: https://raw.githubusercontent.com/containers/libpod/main/logo/podman-logo.png - altText: "Podman logo" Produces: - application/json - application/octet-stream - text/plain Consumes: - application/json - application/x-tar
swagger:meta
Index ¶
Constants ¶
const ( DefaultCorsHeaders = "" DefaultServiceDuration = 300 * time.Second UnlimitedServiceDuration = 0 * time.Second )
Number of seconds to wait for next request, if exceeded shutdown server
Variables ¶
This section is empty.
Functions ¶
func ListenUnix ¶
ListenUnix follows stdlib net.Listen() API, providing a unix listener for given path
ListenUnix will delete and create files/directories as needed
func VersionedPath ¶
VersionedPath prepends the version parsing code any handler may override this default when registering URL(s)
Types ¶
type APIServer ¶
type APIServer struct { http.Server // The HTTP work happens here net.Listener // mux for routing HTTP API calls to libpod routines *libpod.Runtime // Where the real work happens *schema.Decoder // Decoder for Query parameters to structs context.CancelFunc // Stop APIServer context.Context // Context to carry objects to handlers CorsHeaders string // Inject Cross-Origin Resource Sharing (CORS) headers PProfAddr string // Binding network address for pprof profiles // contains filtered or unexported fields }
func NewServerWithSettings ¶
func NewServerWithSettings(runtime *libpod.Runtime, listener net.Listener, opts entities.ServiceOptions) (*APIServer, error)
NewServerWithSettings will create and configure a new API server using provided settings
func (*APIServer) APIHandler ¶
func (s *APIServer) APIHandler(h http.HandlerFunc) http.HandlerFunc
APIHandler is a wrapper to enhance HandlerFunc's and remove redundant code
Source Files ¶
- doc.go
- handler_api.go
- handler_logging.go
- handler_panic.go
- handler_rid.go
- listener_api.go
- register_archive.go
- register_auth.go
- register_containers.go
- register_distribution.go
- register_events.go
- register_exec.go
- register_generate.go
- register_healthcheck.go
- register_images.go
- register_info.go
- register_manifest.go
- register_monitor.go
- register_networks.go
- register_ping.go
- register_play.go
- register_plugins.go
- register_pods.go
- register_secrets.go
- register_swagger.go
- register_swarm.go
- register_system.go
- register_version.go
- register_volumes.go
- server.go