v2 copy endpoints

add copy endpoint inputs and outputs.  these endpoints are not implemented yet, nor are any bindings.  this allows us to update this later without having to change our api version.

Signed-off-by: Brent Baude <bbaude@redhat.com>

4 files changed, 196 insertions, 0 deletions

diff --git a/pkg/api/handlers/compat/containers_archive.go b/pkg/api/handlers/compat/containers_archive.go
new file mode 100644
index 000000000..c3a26873e
--- /dev/null
+++ b/pkg/api/handlers/compat/containers_archive.go
@@ -0,0 +1,12 @@
+package compat
+
+import (
+	"errors"
+	"net/http"
+
+	"github.com/containers/libpod/pkg/api/handlers/utils"
+)
+
+func Archive(w http.ResponseWriter, r *http.Request) {
+	utils.Error(w, "not implemented", http.StatusNotImplemented, errors.New("not implemented"))
+}
diff --git a/pkg/api/handlers/libpod/copy.go b/pkg/api/handlers/libpod/copy.go
new file mode 100644
index 000000000..a3b404bce
--- /dev/null
+++ b/pkg/api/handlers/libpod/copy.go
@@ -0,0 +1,12 @@
+package libpod
+
+import (
+	"net/http"
+
+	"github.com/containers/libpod/pkg/api/handlers/utils"
+	"github.com/pkg/errors"
+)
+
+func Archive(w http.ResponseWriter, r *http.Request) {
+	utils.Error(w, "not implemented", http.StatusNotImplemented, errors.New("not implemented"))
+}
diff --git a/pkg/api/server/register_archive.go b/pkg/api/server/register_archive.go
new file mode 100644
index 000000000..a1d5941bc
--- /dev/null
+++ b/pkg/api/server/register_archive.go
@@ -0,0 +1,171 @@
+package server
+
+import (
+	"net/http"
+
+	"github.com/containers/libpod/pkg/api/handlers/compat"
+	"github.com/containers/libpod/pkg/api/handlers/libpod"
+	"github.com/gorilla/mux"
+)
+
+func (s *APIServer) registerAchiveHandlers(r *mux.Router) error {
+	// swagger:operation POST /containers/{name}/archive compat putArchive
+	// ---
+	//  summary: Put files into a container
+	//  description: Put a tar archive of files into a container
+	//  tags:
+	//   - containers (compat)
+	//  produces:
+	//  - application/json
+	//  parameters:
+	//   - in: path
+	//     name: name
+	//     type: string
+	//     description: container name or id
+	//     required: true
+	//   - in: query
+	//     name: path
+	//     type: string
+	//     description: Path to a directory in the container to extract
+	//     required: true
+	//   - in: query
+	//     name: noOverwriteDirNonDir
+	//     type: string
+	//     description: if unpacking the given content would cause an existing directory to be replaced with a non-directory and vice versa (1 or true)
+	//   - in: query
+	//     name: copyUIDGID
+	//     type: string
+	//     description: copy UID/GID maps to the dest file or di (1 or true)
+	//   - in: body
+	//     name: request
+	//     description: tarfile of files to copy into the container
+	//     schema:
+	//       type: string
+	//  responses:
+	//    200:
+	//      description: no error
+	//    400:
+	//      $ref: "#/responses/BadParamError"
+	//    403:
+	//      description: the container rootfs is read-only
+	//    404:
+	//      $ref: "#/responses/NoSuchContainer"
+	//    500:
+	//      $ref: "#/responses/InternalError"
+
+	// swagger:operation GET /containers/{name}/archive compat getArchive
+	// ---
+	//  summary: Get files from a container
+	//  description: Get a tar archive of files from a container
+	//  tags:
+	//   - containers (compat)
+	//  produces:
+	//  - application/json
+	//  parameters:
+	//   - in: path
+	//     name: name
+	//     type: string
+	//     description: container name or id
+	//     required: true
+	//   - in: query
+	//     name: path
+	//     type: string
+	//     description: Path to a directory in the container to extract
+	//     required: true
+	//  responses:
+	//    200:
+	//      description: no error
+	//      schema:
+	//       type: string
+	//       format: binary
+	//    400:
+	//      $ref: "#/responses/BadParamError"
+	//    404:
+	//      $ref: "#/responses/NoSuchContainer"
+	//    500:
+	//      $ref: "#/responses/InternalError"
+	r.HandleFunc(VersionedPath("/containers/{name}/archive"), s.APIHandler(compat.Archive)).Methods(http.MethodGet, http.MethodPost)
+	// Added non version path to URI to support docker non versioned paths
+	r.HandleFunc("/containers/{name}/archive", s.APIHandler(compat.Archive)).Methods(http.MethodGet, http.MethodPost)
+
+	/*
+		Libpod
+	*/
+
+	// swagger:operation POST /libpod/containers/{name}/copy libpod libpodPutArchive
+	// ---
+	//  summary: Copy files into a container
+	//  description: Copy a tar archive of files into a container
+	//  tags:
+	//   - containers
+	//  produces:
+	//  - application/json
+	//  parameters:
+	//   - in: path
+	//     name: name
+	//     type: string
+	//     description: container name or id
+	//     required: true
+	//   - in: query
+	//     name: path
+	//     type: string
+	//     description: Path to a directory in the container to extract
+	//     required: true
+	//   - in: query
+	//     name: pause
+	//     type: boolean
+	//     description: pause the container while copying (defaults to true)
+	//     default: true
+	//   - in: body
+	//     name: request
+	//     description: tarfile of files to copy into the container
+	//     schema:
+	//       type: string
+	//  responses:
+	//    200:
+	//      description: no error
+	//    400:
+	//      $ref: "#/responses/BadParamError"
+	//    403:
+	//      description: the container rootfs is read-only
+	//    404:
+	//      $ref: "#/responses/NoSuchContainer"
+	//    500:
+	//      $ref: "#/responses/InternalError"
+
+	// swagger:operation GET /libpod/containers/{name}/copy libpod libpodGetArchive
+	// ---
+	//  summary: Copy files from a container
+	//  description: Copy a tar archive of files from a container
+	//  tags:
+	//   - containers (compat)
+	//  produces:
+	//  - application/json
+	//  parameters:
+	//   - in: path
+	//     name: name
+	//     type: string
+	//     description: container name or id
+	//     required: true
+	//   - in: query
+	//     name: path
+	//     type: string
+	//     description: Path to a directory in the container to extract
+	//     required: true
+	//  responses:
+	//    200:
+	//      description: no error
+	//      schema:
+	//       type: string
+	//       format: binary
+	//    400:
+	//      $ref: "#/responses/BadParamError"
+	//    404:
+	//      $ref: "#/responses/NoSuchContainer"
+	//    500:
+	//      $ref: "#/responses/InternalError"
+	r.HandleFunc(VersionedPath("/libpod/containers/{name}/copy"), s.APIHandler(libpod.Archive)).Methods(http.MethodGet, http.MethodPost)
+	r.HandleFunc(VersionedPath("/libpod/containers/{name}/archive"), s.APIHandler(libpod.Archive)).Methods(http.MethodGet, http.MethodPost)
+
+	return nil
+}
diff --git a/pkg/api/server/server.go b/pkg/api/server/server.go
index 9cbc66e87..499a4c58a 100644
--- a/pkg/api/server/server.go
+++ b/pkg/api/server/server.go
@@ -102,6 +102,7 @@ func newServer(runtime *libpod.Runtime, duration time.Duration, listener *net.Li
 
 	for _, fn := range []func(*mux.Router) error{
 		server.registerAuthHandlers,
+		server.registerAchiveHandlers,
 		server.registerContainersHandlers,
 		server.registerDistributionHandlers,
 		server.registerEventsHandlers,