package server import ( "net/http" "github.com/containers/libpod/pkg/api/handlers" "github.com/containers/libpod/pkg/api/handlers/generic" "github.com/containers/libpod/pkg/api/handlers/libpod" "github.com/gorilla/mux" ) func (s *APIServer) registerImagesHandlers(r *mux.Router) error { // swagger:operation POST /images/create compat createImage // --- // tags: // - images (compat) // summary: Create an image // description: Create an image by either pulling it from a registry or importing it. // produces: // - application/json // parameters: // - in: query // name: fromImage // type: string // description: needs description // - in: query // name: fromSrc // type: string // description: needs description // - in: query // name: tag // type: string // description: needs description // - in: header // name: X-Registry-Auth // type: string // description: A base64-encoded auth configuration. // - in: body // name: request // schema: // type: string // description: Image content if fromSrc parameter was used // responses: // 200: // $ref: "#/responses/ok" // 404: // $ref: "#/responses/NoSuchImage" // 500: // $ref: "#/responses/InternalError" r.Handle(VersionedPath("/images/create"), s.APIHandler(generic.CreateImageFromImage)).Methods(http.MethodPost).Queries("fromImage", "{fromImage}") r.Handle(VersionedPath("/images/create"), s.APIHandler(generic.CreateImageFromSrc)).Methods(http.MethodPost).Queries("fromSrc", "{fromSrc}") // swagger:operation GET /images/json compat listImages // --- // tags: // - images (compat) // summary: List Images // description: Returns a list of images on the server. Note that it uses a different, smaller representation of an image than inspecting a single image. // parameters: // - name: all // in: query // description: "Show all images. Only images from a final layer (no children) are shown by default." // type: boolean // default: false // - name: filters // in: query // description: | // A JSON encoded value of the filters (a `map[string][]string`) to process on the images list. Available filters: // - `before`=(`[:]`, `` or ``) // - `dangling=true` // - `label=key` or `label="key=value"` of an image label // - `reference`=(`[:]`) // - `since`=(`[:]`, `` or ``) // type: string // - name: digests // in: query // description: Not supported // type: boolean // default: false // produces: // - application/json // responses: // 200: // $ref: "#/responses/DockerImageSummary" // 500: // $ref: '#/responses/InternalError' r.Handle(VersionedPath("/images/json"), s.APIHandler(generic.GetImages)).Methods(http.MethodGet) // swagger:operation POST /images/load compat importImage // --- // tags: // - images (compat) // summary: Import image // description: Load a set of images and tags into a repository. // parameters: // - in: query // name: quiet // type: boolean // description: not supported // - in: body // name: request // description: tarball of container image // schema: // type: string // produces: // - application/json // responses: // 200: // description: no error // 500: // $ref: '#/responses/InternalError' r.Handle(VersionedPath("/images/load"), s.APIHandler(generic.LoadImages)).Methods(http.MethodPost) // swagger:operation POST /images/prune compat pruneImages // --- // tags: // - images (compat) // summary: Prune unused images // description: Remove images from local storage that are not being used by a container // parameters: // - in: query // name: filters // type: string // description: | // filters to apply to image pruning, encoded as JSON (map[string][]string). Available filters: // - `dangling=` When set to `true` (or `1`), prune only // unused *and* untagged images. When set to `false` // (or `0`), all unused images are pruned. // - `until=` Prune images created before this timestamp. The `` can be Unix timestamps, date formatted timestamps, or Go duration strings (e.g. `10m`, `1h30m`) computed relative to the daemon machine’s time. // - `label` (`label=`, `label==`, `label!=`, or `label!==`) Prune images with (or without, in case `label!=...` is used) the specified labels. // produces: // - application/json // responses: // 200: // $ref: "#/responses/DocsImageDeleteResponse" // 500: // $ref: '#/responses/InternalError' r.Handle(VersionedPath("/images/prune"), s.APIHandler(generic.PruneImages)).Methods(http.MethodPost) // swagger:operation GET /images/search compat searchImages // --- // tags: // - images (compat) // summary: Search images // description: Search registries for an image // parameters: // - in: query // name: term // type: string // description: term to search // - in: query // name: limit // type: integer // description: maximum number of results // - in: query // name: filters // type: string // description: | // A JSON encoded value of the filters (a `map[string][]string`) to process on the images list. Available filters: // - `is-automated=(true|false)` // - `is-official=(true|false)` // - `stars=` Matches images that has at least 'number' stars. // produces: // - application/json // responses: // 200: // $ref: "#/responses/DocsSearchResponse" // 400: // $ref: "#/responses/BadParamError" // 500: // $ref: '#/responses/InternalError' r.Handle(VersionedPath("/images/search"), s.APIHandler(handlers.SearchImages)).Methods(http.MethodGet) // swagger:operation DELETE /images/{name:.*} compat removeImage // --- // tags: // - images (compat) // summary: Remove Image // description: Delete an image from local storage // parameters: // - in: path // name: name:.* // type: string // required: true // description: name or ID of image to delete // - in: query // name: force // type: boolean // description: remove the image even if used by containers or has other tags // - in: query // name: noprune // type: boolean // description: not supported. will be logged as an invalid parameter if enabled // produces: // - application/json // responses: // 200: // $ref: "#/responses/DocsImageDeleteResponse" // 404: // $ref: '#/responses/NoSuchImage' // 409: // $ref: '#/responses/ConflictError' // 500: // $ref: '#/responses/InternalError' r.Handle(VersionedPath("/images/{name:.*}"), s.APIHandler(handlers.RemoveImage)).Methods(http.MethodDelete) // swagger:operation GET /images/{name:.*}/get compat exportImage // --- // tags: // - images (compat) // summary: Export an image // description: Export an image in tarball format // parameters: // - in: path // name: name:.* // type: string // required: true // description: the name or ID of the container // produces: // - application/json // responses: // 200: // description: no error // schema: // type: string // format: binary // 500: // $ref: '#/responses/InternalError' r.Handle(VersionedPath("/images/{name:.*}/get"), s.APIHandler(generic.ExportImage)).Methods(http.MethodGet) // swagger:operation GET /images/{name:.*}/history compat imageHistory // --- // tags: // - images (compat) // summary: History of an image // description: Return parent layers of an image. // parameters: // - in: path // name: name:.* // type: string // required: true // description: the name or ID of the container // produces: // - application/json // responses: // 200: // $ref: "#/responses/DocsHistory" // 404: // $ref: "#/responses/NoSuchImage" // 500: // $ref: "#/responses/InternalError" r.Handle(VersionedPath("/images/{name:.*}/history"), s.APIHandler(handlers.HistoryImage)).Methods(http.MethodGet) // swagger:operation GET /images/{name:.*}/json compat inspectImage // --- // tags: // - images (compat) // summary: Inspect an image // description: Return low-level information about an image. // parameters: // - in: path // name: name:.* // type: string // required: true // description: the name or ID of the container // produces: // - application/json // responses: // 200: // $ref: "#/responses/DocsImageInspect" // 404: // $ref: "#/responses/NoSuchImage" // 500: // $ref: "#/responses/InternalError" r.Handle(VersionedPath("/images/{name:.*}/json"), s.APIHandler(generic.GetImage)).Methods(http.MethodGet) // swagger:operation POST /images/{name:.*}/tag compat tagImage // --- // tags: // - images (compat) // summary: Tag an image // description: Tag an image so that it becomes part of a repository. // parameters: // - in: path // name: name:.* // type: string // required: true // description: the name or ID of the container // - in: query // name: repo // type: string // description: the repository to tag in // - in: query // name: tag // type: string // description: the name of the new tag // produces: // - application/json // responses: // 201: // description: no error // 400: // $ref: '#/responses/BadParamError' // 404: // $ref: '#/responses/NoSuchImage' // 409: // $ref: '#/responses/ConflictError' // 500: // $ref: '#/responses/InternalError' r.Handle(VersionedPath("/images/{name:.*}/tag"), s.APIHandler(handlers.TagImage)).Methods(http.MethodPost) // swagger:operation POST /commit compat commitContainer // --- // tags: // - containers (compat) // summary: New Image // description: Create a new image from a container // parameters: // - in: query // name: container // type: string // description: the name or ID of a container // - in: query // name: repo // type: string // description: the repository name for the created image // - in: query // name: tag // type: string // description: tag name for the created image // - in: query // name: comment // type: string // description: commit message // - in: query // name: author // type: string // description: author of the image // - in: query // name: pause // type: boolean // description: pause the container before committing it // - in: query // name: changes // type: string // description: instructions to apply while committing in Dockerfile format // produces: // - application/json // responses: // 201: // description: no error // 404: // $ref: '#/responses/NoSuchImage' // 500: // $ref: '#/responses/InternalError' r.Handle(VersionedPath("/commit"), s.APIHandler(generic.CommitContainer)).Methods(http.MethodPost) // swagger:operation POST /build compat buildImage // --- // tags: // - images // summary: Create image // description: Build an image from the given Dockerfile(s) // parameters: // - in: query // name: dockerfile // type: string // default: Dockerfile // description: | // Path within the build context to the `Dockerfile`. // This is ignored if remote is specified and points to an external `Dockerfile`. // - in: query // name: t // type: string // default: latest // description: A name and optional tag to apply to the image in the `name:tag` format. // - in: query // name: extrahosts // type: string // default: // description: | // TBD Extra hosts to add to /etc/hosts // (As of version 1.xx) // - in: query // name: remote // type: string // default: // description: | // A Git repository URI or HTTP/HTTPS context URI. // If the URI points to a single text file, the file’s contents are placed // into a file called Dockerfile and the image is built from that file. If // the URI points to a tarball, the file is downloaded by the daemon and the // contents therein used as the context for the build. If the URI points to a // tarball and the dockerfile parameter is also specified, there must be a file // with the corresponding path inside the tarball. // (As of version 1.xx) // - in: query // name: q // type: boolean // default: false // description: | // Suppress verbose build output // - in: query // name: nocache // type: boolean // default: false // description: | // Do not use the cache when building the image // (As of version 1.xx) // - in: query // name: cachefrom // type: string // default: // description: | // JSON array of images used to build cache resolution // (As of version 1.xx) // - in: query // name: pull // type: boolean // default: false // description: | // Attempt to pull the image even if an older image exists locally // (As of version 1.xx) // - in: query // name: rm // type: boolean // default: true // description: | // Remove intermediate containers after a successful build // (As of version 1.xx) // - in: query // name: forcerm // type: boolean // default: false // description: | // Always remove intermediate containers, even upon failure // (As of version 1.xx) // - in: query // name: memory // type: integer // description: | // Memory is the upper limit (in bytes) on how much memory running containers can use // (As of version 1.xx) // - in: query // name: memswap // type: integer // description: | // MemorySwap limits the amount of memory and swap together // (As of version 1.xx) // - in: query // name: cpushares // type: integer // description: | // CPUShares (relative weight // (As of version 1.xx) // - in: query // name: cpusetcpus // type: string // description: | // CPUSetCPUs in which to allow execution (0-3, 0,1) // (As of version 1.xx) // - in: query // name: cpuperiod // type: integer // description: | // CPUPeriod limits the CPU CFS (Completely Fair Scheduler) period // (As of version 1.xx) // - in: query // name: cpuquota // type: integer // description: | // CPUQuota limits the CPU CFS (Completely Fair Scheduler) quota // (As of version 1.xx) // - in: query // name: buildargs // type: string // default: // description: | // JSON map of string pairs denoting build-time variables. // For example, the build argument `Foo` with the value of `bar` would be encoded in JSON as `["Foo":"bar"]`. // // For example, buildargs={"Foo":"bar"}. // // Note(s): // * This should not be used to pass secrets. // * The value of buildargs should be URI component encoded before being passed to the API. // // (As of version 1.xx) // - in: query // name: shmsize // type: integer // default: 67108864 // description: | // ShmSize is the "size" value to use when mounting an shmfs on the container's /dev/shm directory. // Default is 64MB // (As of version 1.xx) // - in: query // name: squash // type: boolean // default: false // description: | // Silently ignored. // Squash the resulting images layers into a single layer // (As of version 1.xx) // - in: query // name: labels // type: string // default: // description: | // JSON map of key, value pairs to set as labels on the new image // (As of version 1.xx) // - in: query // name: networkmode // type: string // default: bridge // description: | // Sets the networking mode for the run commands during build. // Supported standard values are: // * `bridge` limited to containers within a single host, port mapping required for external access // * `host` no isolation between host and containers on this network // * `none` disable all networking for this container // * container: share networking with given container // ---All other values are assumed to be a custom network's name // (As of version 1.xx) // - in: query // name: platform // type: string // default: // description: | // Platform format os[/arch[/variant]] // (As of version 1.xx) // - in: query // name: target // type: string // default: // description: | // Target build stage // (As of version 1.xx) // - in: query // name: outputs // type: string // default: // description: | // output configuration TBD // (As of version 1.xx) // produces: // - application/json // responses: // 200: // description: OK (As of version 1.xx) // schema: // type: object // required: // - stream // properties: // stream: // type: string // description: output from build process // example: | // (build details...) // Successfully built 8ba084515c724cbf90d447a63600c0a6 // 400: // $ref: "#/responses/BadParamError" // 500: // $ref: "#/responses/InternalError" r.Handle(VersionedPath("/build"), s.APIHandler(handlers.BuildImage)).Methods(http.MethodPost) /* libpod endpoints */ // swagger:operation GET /libpod/images/{name:.*}/exists libpod libpodImageExists // --- // tags: // - images // summary: Image exists // description: Check if image exists in local store // parameters: // - in: path // name: name:.* // type: string // required: true // description: the name or ID of the container // produces: // - application/json // responses: // 204: // description: image exists // 404: // $ref: '#/responses/NoSuchImage' // 500: // $ref: '#/responses/InternalError' r.Handle(VersionedPath("/libpod/images/{name:.*}/exists"), s.APIHandler(libpod.ImageExists)).Methods(http.MethodGet) // swagger:operation GET /libpod/images/{name:.*}/tree libpod libpodImageTree // --- // tags: // - images // summary: Image tree // description: Retrieve the image tree for the provided image name or ID // parameters: // - in: path // name: name:.* // type: string // required: true // description: the name or ID of the container // - in: query // name: whatrequires // type: boolean // description: show all child images and layers of the specified image // produces: // - application/json // responses: // 200: // $ref: '#/responses/LibpodImageTreeResponse' // 401: // $ref: '#/responses/NoSuchImage' // 500: // $ref: '#/responses/InternalError' r.Handle(VersionedPath("/libpod/images/{name:.*}/tree"), s.APIHandler(libpod.ImageTree)).Methods(http.MethodGet) // swagger:operation GET /libpod/images/{name:.*}/history libpod libpodImageHistory // --- // tags: // - images // summary: History of an image // description: Return parent layers of an image. // parameters: // - in: path // name: name:.* // type: string // required: true // description: the name or ID of the container // produces: // - application/json // responses: // 200: // $ref: "#/responses/DocsHistory" // 404: // $ref: '#/responses/NoSuchImage' // 500: // $ref: '#/responses/InternalError' r.Handle(VersionedPath("/libpod/images/{name:.*}/history"), s.APIHandler(handlers.HistoryImage)).Methods(http.MethodGet) // swagger:operation GET /libpod/images/json libpod libpodListImages // --- // tags: // - images // summary: List Images // description: Returns a list of images on the server // parameters: // - name: all // in: query // description: Show all images. Only images from a final layer (no children) are shown by default. // type: boolean // default: false // - name: filters // in: query // description: | // A JSON encoded value of the filters (a `map[string][]string`) to process on the images list. Available filters: // - `before`=(`[:]`, `` or ``) // - `dangling=true` // - `label=key` or `label="key=value"` of an image label // - `reference`=(`[:]`) // - `since`=(`[:]`, `` or ``) // type: string // produces: // - application/json // responses: // 200: // $ref: "#/responses/DockerImageSummary" // 500: // $ref: '#/responses/InternalError' r.Handle(VersionedPath("/libpod/images/json"), s.APIHandler(libpod.GetImages)).Methods(http.MethodGet) // swagger:operation POST /libpod/images/load libpod libpodImagesLoad // --- // tags: // - images // summary: Load image // description: Load an image (oci-archive or docker-archive) stream. // parameters: // - in: query // name: reference // description: "Optional Name[:TAG] for the image" // type: string // - in: formData // name: upload // description: tarball of container image // type: file // required: true // produces: // - application/json // responses: // 200: // $ref: "#/responses/DocsLibpodImagesLoadResponse" // 400: // $ref: "#/responses/BadParamError" // 500: // $ref: '#/responses/InternalError' r.Handle(VersionedPath("/libpod/images/load"), s.APIHandler(libpod.ImagesLoad)).Methods(http.MethodPost) // swagger:operation POST /libpod/images/import libpod libpodImagesImport // --- // tags: // - images // summary: Import image // description: Import a previously exported tarball as an image. // parameters: // - in: query // name: changes // description: "Apply the following possible instructions to the created image: CMD | ENTRYPOINT | ENV | EXPOSE | LABEL | STOPSIGNAL | USER | VOLUME | WORKDIR. JSON encoded string" // type: array // items: // type: string // - in: query // name: message // description: Set commit message for imported image // type: string // - in: query // name: reference // description: "Optional Name[:TAG] for the image" // type: string // - in: query // name: url // description: Load image from the specified URL // type: string // - in: formData // name: upload // type: file // required: true // description: tarball for imported image // produces: // - application/json // responses: // 200: // $ref: "#/responses/DocsLibpodImagesImportResponse" // 400: // $ref: "#/responses/BadParamError" // 500: // $ref: '#/responses/InternalError' r.Handle(VersionedPath("/libpod/images/import"), s.APIHandler(libpod.ImagesImport)).Methods(http.MethodPost) // swagger:operation POST /libpod/images/pull libpod libpodImagesPull // --- // tags: // - images // summary: Pull images // description: Pull one or more images from a container registry. // parameters: // - in: query // name: reference // description: "Mandatory reference to the image (e.g., quay.io/image/name:tag)" // type: string // - in: query // name: credentials // description: "username:password for the registry" // type: string // - in: query // name: overrideOS // description: Pull image for the specified operating system. // type: string // - in: query // name: overrideArch // description: Pull image for the specified architecture. // type: string // - in: query // name: tlsVerify // description: Require TLS verification. // type: boolean // default: true // - in: query // name: allTags // description: Pull all tagged images in the repository. // type: boolean // produces: // - application/json // responses: // 200: // $ref: "#/responses/DocsLibpodImagesPullResponse" // 400: // $ref: "#/responses/BadParamError" // 500: // $ref: '#/responses/InternalError' r.Handle(VersionedPath("/libpod/images/pull"), s.APIHandler(libpod.ImagesPull)).Methods(http.MethodPost) // swagger:operation POST /libpod/images/prune libpod libpodPruneImages // --- // tags: // - images // summary: Prune unused images // description: Remove images that are not being used by a container // parameters: // - in: query // name: filters // type: string // description: | // filters to apply to image pruning, encoded as JSON (map[string][]string). Available filters: // - `dangling=` When set to `true` (or `1`), prune only // unused *and* untagged images. When set to `false` // (or `0`), all unused images are pruned. // - `until=` Prune images created before this timestamp. The `` can be Unix timestamps, date formatted timestamps, or Go duration strings (e.g. `10m`, `1h30m`) computed relative to the daemon machine’s time. // - `label` (`label=`, `label==`, `label!=`, or `label!==`) Prune images with (or without, in case `label!=...` is used) the specified labels. // produces: // - application/json // responses: // 200: // $ref: "#/responses/DocsImageDeleteResponse" // 500: // $ref: '#/responses/InternalError' r.Handle(VersionedPath("/libpod/images/prune"), s.APIHandler(libpod.PruneImages)).Methods(http.MethodPost) // swagger:operation GET /libpod/images/search libpod libpodSearchImages // --- // tags: // - images // summary: Search images // description: Search registries for images // parameters: // - in: query // name: term // type: string // description: term to search // - in: query // name: limit // type: integer // description: maximum number of results // - in: query // name: filters // type: string // description: | // A JSON encoded value of the filters (a `map[string][]string`) to process on the images list. Available filters: // - `is-automated=(true|false)` // - `is-official=(true|false)` // - `stars=` Matches images that has at least 'number' stars. // produces: // - application/json // responses: // 200: // $ref: "#/responses/DocsSearchResponse" // 500: // $ref: '#/responses/InternalError' r.Handle(VersionedPath("/libpod/images/search"), s.APIHandler(handlers.SearchImages)).Methods(http.MethodGet) // swagger:operation DELETE /libpod/images/{name:.*} libpod libpodRemoveImage // --- // tags: // - images // summary: Remove Image // description: Delete an image from local store // parameters: // - in: path // name: name:.* // type: string // required: true // description: name or ID of image to delete // - in: query // name: force // type: boolean // description: remove the image even if used by containers or has other tags // produces: // - application/json // responses: // 200: // $ref: "#/responses/DocsImageDeleteResponse" // 400: // $ref: "#/responses/BadParamError" // 404: // $ref: '#/responses/NoSuchImage' // 409: // $ref: '#/responses/ConflictError' // 500: // $ref: '#/responses/InternalError' r.Handle(VersionedPath("/libpod/images/{name:.*}"), s.APIHandler(handlers.RemoveImage)).Methods(http.MethodDelete) // swagger:operation GET /libpod/images/{name:.*}/get libpod libpodExportImage // --- // tags: // - images // summary: Export an image // description: Export an image as a tarball // parameters: // - in: path // name: name:.* // type: string // required: true // description: the name or ID of the container // - in: query // name: format // type: string // description: format for exported image // - in: query // name: compress // type: boolean // description: use compression on image // produces: // - application/json // responses: // 200: // description: no error // schema: // type: string // format: binary // 404: // $ref: '#/responses/NoSuchImage' // 500: // $ref: '#/responses/InternalError' r.Handle(VersionedPath("/libpod/images/{name:.*}/get"), s.APIHandler(libpod.ExportImage)).Methods(http.MethodGet) // swagger:operation GET /libpod/images/{name:.*}/json libpod libpodInspectImage // --- // tags: // - images // summary: Inspect an image // description: Obtain low-level information about an image // parameters: // - in: path // name: name:.* // type: string // required: true // description: the name or ID of the container // produces: // - application/json // responses: // 200: // $ref: "#/responses/DocsLibpodInspectImageResponse" // 404: // $ref: '#/responses/NoSuchImage' // 500: // $ref: '#/responses/InternalError' r.Handle(VersionedPath("/libpod/images/{name:.*}/json"), s.APIHandler(libpod.GetImage)).Methods(http.MethodGet) // swagger:operation POST /libpod/images/{name:.*}/tag libpod libpodTagImage // --- // tags: // - images // summary: Tag an image // description: Tag an image so that it becomes part of a repository. // parameters: // - in: path // name: name:.* // type: string // required: true // description: the name or ID of the container // - in: query // name: repo // type: string // description: the repository to tag in // - in: query // name: tag // type: string // description: the name of the new tag // produces: // - application/json // responses: // 201: // description: no error // 400: // $ref: '#/responses/BadParamError' // 404: // $ref: '#/responses/NoSuchImage' // 409: // $ref: '#/responses/ConflictError' // 500: // $ref: '#/responses/InternalError' r.Handle(VersionedPath("/libpod/images/{name:.*}/tag"), s.APIHandler(handlers.TagImage)).Methods(http.MethodPost) return nil }