api.go 15 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589
  1. package docker
  2. import (
  3. "encoding/json"
  4. "fmt"
  5. "github.com/dotcloud/docker/auth"
  6. "github.com/gorilla/mux"
  7. "github.com/shin-/cookiejar"
  8. "io"
  9. "log"
  10. "net/http"
  11. "strconv"
  12. "strings"
  13. )
  14. func hijackServer(w http.ResponseWriter) (io.ReadCloser, io.Writer, error) {
  15. conn, _, err := w.(http.Hijacker).Hijack()
  16. if err != nil {
  17. return nil, nil, err
  18. }
  19. // Flush the options to make sure the client sets the raw mode
  20. conn.Write([]byte{})
  21. return conn, conn, nil
  22. }
  23. //If we don't do this, POST method without Content-type (even with empty body) will fail
  24. func parseForm(r *http.Request) error {
  25. if err := r.ParseForm(); err != nil && !strings.HasPrefix(err.Error(), "mime:") {
  26. return err
  27. }
  28. return nil
  29. }
  30. func httpError(w http.ResponseWriter, err error) {
  31. if strings.HasPrefix(err.Error(), "No such") {
  32. http.Error(w, err.Error(), http.StatusNotFound)
  33. } else {
  34. http.Error(w, err.Error(), http.StatusInternalServerError)
  35. }
  36. }
  37. func getAuth(srv *Server, w http.ResponseWriter, r *http.Request) ([]byte, error) {
  38. var out auth.AuthConfig
  39. out.Username = srv.runtime.authConfig.Username
  40. out.Email = srv.runtime.authConfig.Email
  41. b, err := json.Marshal(out)
  42. if err != nil {
  43. return nil, err
  44. }
  45. return b, nil
  46. }
  47. func postAuth(srv *Server, w http.ResponseWriter, r *http.Request) ([]byte, error) {
  48. var config auth.AuthConfig
  49. if err := json.NewDecoder(r.Body).Decode(&config); err != nil {
  50. return nil, err
  51. }
  52. if config.Username == srv.runtime.authConfig.Username {
  53. config.Password = srv.runtime.authConfig.Password
  54. }
  55. newAuthConfig := auth.NewAuthConfig(config.Username, config.Password, config.Email, srv.runtime.root)
  56. status, err := auth.Login(newAuthConfig)
  57. if err != nil {
  58. return nil, err
  59. } else {
  60. srv.runtime.graph.getHttpClient().Jar = cookiejar.NewCookieJar()
  61. srv.runtime.authConfig = newAuthConfig
  62. }
  63. if status != "" {
  64. b, err := json.Marshal(ApiAuth{status})
  65. if err != nil {
  66. return nil, err
  67. }
  68. return b, nil
  69. }
  70. w.WriteHeader(http.StatusNoContent)
  71. return nil, nil
  72. }
  73. func getVersion(srv *Server, w http.ResponseWriter, r *http.Request) ([]byte, error) {
  74. m := srv.DockerVersion()
  75. b, err := json.Marshal(m)
  76. if err != nil {
  77. return nil, err
  78. }
  79. return b, nil
  80. }
  81. func postContainersKill(srv *Server, w http.ResponseWriter, r *http.Request) ([]byte, error) {
  82. vars := mux.Vars(r)
  83. name := vars["name"]
  84. if err := srv.ContainerKill(name); err != nil {
  85. return nil, err
  86. }
  87. w.WriteHeader(http.StatusNoContent)
  88. return nil, nil
  89. }
  90. func getContainersExport(srv *Server, w http.ResponseWriter, r *http.Request) ([]byte, error) {
  91. vars := mux.Vars(r)
  92. name := vars["name"]
  93. in, out, err := hijackServer(w)
  94. if err != nil {
  95. return nil, err
  96. }
  97. defer in.Close()
  98. fmt.Fprintf(out, "HTTP/1.1 200 OK\r\nContent-Type: application/vnd.docker.raw-stream\r\n\r\n")
  99. if err := srv.ContainerExport(name, out); err != nil {
  100. fmt.Fprintf(out, "Error: %s\n", err)
  101. }
  102. return nil, nil
  103. }
  104. func getImages(srv *Server, w http.ResponseWriter, r *http.Request) ([]byte, error) {
  105. if err := parseForm(r); err != nil {
  106. return nil, err
  107. }
  108. viz := r.Form.Get("viz") == "1"
  109. if viz {
  110. in, out, err := hijackServer(w)
  111. if err != nil {
  112. return nil, err
  113. }
  114. defer in.Close()
  115. fmt.Fprintf(out, "HTTP/1.1 200 OK\r\nContent-Type: application/vnd.docker.raw-stream\r\n\r\n")
  116. if err := srv.ImagesViz(out); err != nil {
  117. fmt.Fprintf(out, "Error: %s\n", err)
  118. }
  119. return nil, nil
  120. }
  121. all := r.Form.Get("all") == "1"
  122. filter := r.Form.Get("filter")
  123. only_ids := r.Form.Get("only_ids") == "1"
  124. outs, err := srv.Images(all, only_ids, filter)
  125. if err != nil {
  126. return nil, err
  127. }
  128. b, err := json.Marshal(outs)
  129. if err != nil {
  130. return nil, err
  131. }
  132. return b, nil
  133. }
  134. func getInfo(srv *Server, w http.ResponseWriter, r *http.Request) ([]byte, error) {
  135. out := srv.DockerInfo()
  136. b, err := json.Marshal(out)
  137. if err != nil {
  138. return nil, err
  139. }
  140. return b, nil
  141. }
  142. func getImagesHistory(srv *Server, w http.ResponseWriter, r *http.Request) ([]byte, error) {
  143. vars := mux.Vars(r)
  144. name := vars["name"]
  145. outs, err := srv.ImageHistory(name)
  146. if err != nil {
  147. return nil, err
  148. }
  149. b, err := json.Marshal(outs)
  150. if err != nil {
  151. return nil, err
  152. }
  153. return b, nil
  154. }
  155. func getContainersChanges(srv *Server, w http.ResponseWriter, r *http.Request) ([]byte, error) {
  156. vars := mux.Vars(r)
  157. name := vars["name"]
  158. changesStr, err := srv.ContainerChanges(name)
  159. if err != nil {
  160. return nil, err
  161. }
  162. b, err := json.Marshal(changesStr)
  163. if err != nil {
  164. return nil, err
  165. }
  166. return b, nil
  167. }
  168. func getContainers(srv *Server, w http.ResponseWriter, r *http.Request) ([]byte, error) {
  169. if err := parseForm(r); err != nil {
  170. return nil, err
  171. }
  172. all := r.Form.Get("all") == "1"
  173. trunc_cmd := r.Form.Get("trunc_cmd") != "0"
  174. only_ids := r.Form.Get("only_ids") == "1"
  175. since := r.Form.Get("since")
  176. before := r.Form.Get("before")
  177. n, err := strconv.Atoi(r.Form.Get("limit"))
  178. if err != nil {
  179. n = -1
  180. }
  181. outs := srv.Containers(all, trunc_cmd, only_ids, n, since, before)
  182. b, err := json.Marshal(outs)
  183. if err != nil {
  184. return nil, err
  185. }
  186. return b, nil
  187. }
  188. func postImagesTag(srv *Server, w http.ResponseWriter, r *http.Request) ([]byte, error) {
  189. if err := parseForm(r); err != nil {
  190. return nil, err
  191. }
  192. repo := r.Form.Get("repo")
  193. tag := r.Form.Get("tag")
  194. vars := mux.Vars(r)
  195. name := vars["name"]
  196. force := r.Form.Get("force") == "1"
  197. if err := srv.ContainerTag(name, repo, tag, force); err != nil {
  198. return nil, err
  199. }
  200. w.WriteHeader(http.StatusCreated)
  201. return nil, nil
  202. }
  203. func postCommit(srv *Server, w http.ResponseWriter, r *http.Request) ([]byte, error) {
  204. if err := parseForm(r); err != nil {
  205. return nil, err
  206. }
  207. var config Config
  208. if err := json.NewDecoder(r.Body).Decode(&config); err != nil {
  209. Debugf("%s", err.Error())
  210. }
  211. repo := r.Form.Get("repo")
  212. tag := r.Form.Get("tag")
  213. container := r.Form.Get("container")
  214. author := r.Form.Get("author")
  215. comment := r.Form.Get("comment")
  216. id, err := srv.ContainerCommit(container, repo, tag, author, comment, &config)
  217. if err != nil {
  218. return nil, err
  219. }
  220. b, err := json.Marshal(ApiId{id})
  221. if err != nil {
  222. return nil, err
  223. }
  224. w.WriteHeader(http.StatusCreated)
  225. return b, nil
  226. }
  227. func postImages(srv *Server, w http.ResponseWriter, r *http.Request) ([]byte, error) {
  228. if err := parseForm(r); err != nil {
  229. return nil, err
  230. }
  231. src := r.Form.Get("fromSrc")
  232. image := r.Form.Get("fromImage")
  233. repo := r.Form.Get("repo")
  234. tag := r.Form.Get("tag")
  235. in, out, err := hijackServer(w)
  236. if err != nil {
  237. return nil, err
  238. }
  239. defer in.Close()
  240. fmt.Fprintf(out, "HTTP/1.1 200 OK\r\nContent-Type: application/vnd.docker.raw-stream\r\n\r\n")
  241. if image != "" { //pull
  242. registry := r.Form.Get("registry")
  243. if err := srv.ImagePull(image, tag, registry, out); err != nil {
  244. fmt.Fprintf(out, "Error: %s\n", err)
  245. }
  246. } else { //import
  247. if err := srv.ImageImport(src, repo, tag, in, out); err != nil {
  248. fmt.Fprintf(out, "Error: %s\n", err)
  249. }
  250. }
  251. return nil, nil
  252. }
  253. func getImagesSearch(srv *Server, w http.ResponseWriter, r *http.Request) ([]byte, error) {
  254. if err := parseForm(r); err != nil {
  255. return nil, err
  256. }
  257. term := r.Form.Get("term")
  258. outs, err := srv.ImagesSearch(term)
  259. if err != nil {
  260. return nil, err
  261. }
  262. b, err := json.Marshal(outs)
  263. if err != nil {
  264. return nil, err
  265. }
  266. return b, nil
  267. }
  268. func postImagesInsert(srv *Server, w http.ResponseWriter, r *http.Request) ([]byte, error) {
  269. if err := parseForm(r); err != nil {
  270. return nil, err
  271. }
  272. url := r.Form.Get("url")
  273. path := r.Form.Get("path")
  274. vars := mux.Vars(r)
  275. name := vars["name"]
  276. in, out, err := hijackServer(w)
  277. if err != nil {
  278. return nil, err
  279. }
  280. defer in.Close()
  281. fmt.Fprintf(out, "HTTP/1.1 200 OK\r\nContent-Type: application/vnd.docker.raw-stream\r\n\r\n")
  282. if err := srv.ImageInsert(name, url, path, out); err != nil {
  283. fmt.Fprintf(out, "Error: %s\n", err)
  284. }
  285. return nil, nil
  286. }
  287. func postImagesPush(srv *Server, w http.ResponseWriter, r *http.Request) ([]byte, error) {
  288. if err := parseForm(r); err != nil {
  289. return nil, err
  290. }
  291. registry := r.Form.Get("registry")
  292. vars := mux.Vars(r)
  293. name := vars["name"]
  294. in, out, err := hijackServer(w)
  295. if err != nil {
  296. return nil, err
  297. }
  298. defer in.Close()
  299. fmt.Fprintf(out, "HTTP/1.1 200 OK\r\nContent-Type: application/vnd.docker.raw-stream\r\n\r\n")
  300. if err := srv.ImagePush(name, registry, out); err != nil {
  301. fmt.Fprintln(out, "Error: %s\n", err)
  302. }
  303. return nil, nil
  304. }
  305. func postBuild(srv *Server, w http.ResponseWriter, r *http.Request) ([]byte, error) {
  306. in, out, err := hijackServer(w)
  307. if err != nil {
  308. return nil, err
  309. }
  310. defer in.Close()
  311. fmt.Fprintf(out, "HTTP/1.1 200 OK\r\nContent-Type: application/vnd.docker.raw-stream\r\n\r\n")
  312. if err := srv.ImageCreateFromFile(in, out); err != nil {
  313. fmt.Fprintln(out, "Error: %s\n", err)
  314. }
  315. return nil, nil
  316. }
  317. func postContainers(srv *Server, w http.ResponseWriter, r *http.Request) ([]byte, error) {
  318. var config Config
  319. if err := json.NewDecoder(r.Body).Decode(&config); err != nil {
  320. return nil, err
  321. }
  322. id, memoryW, swapW, err := srv.ContainerCreate(config)
  323. if err != nil {
  324. return nil, err
  325. }
  326. var out ApiRun
  327. out.Id = id
  328. if memoryW {
  329. out.Warnings = append(out.Warnings, "Your kernel does not support memory limit capabilities. Limitation discarded.")
  330. }
  331. if swapW {
  332. out.Warnings = append(out.Warnings, "Your kernel does not support memory swap capabilities. Limitation discarded.")
  333. }
  334. b, err := json.Marshal(out)
  335. if err != nil {
  336. return nil, err
  337. }
  338. w.WriteHeader(http.StatusCreated)
  339. return b, nil
  340. }
  341. func postContainersRestart(srv *Server, w http.ResponseWriter, r *http.Request) ([]byte, error) {
  342. if err := parseForm(r); err != nil {
  343. return nil, err
  344. }
  345. t, err := strconv.Atoi(r.Form.Get("t"))
  346. if err != nil || t < 0 {
  347. t = 10
  348. }
  349. vars := mux.Vars(r)
  350. name := vars["name"]
  351. if err := srv.ContainerRestart(name, t); err != nil {
  352. return nil, err
  353. }
  354. w.WriteHeader(http.StatusNoContent)
  355. return nil, nil
  356. }
  357. func deleteContainers(srv *Server, w http.ResponseWriter, r *http.Request) ([]byte, error) {
  358. if err := parseForm(r); err != nil {
  359. return nil, err
  360. }
  361. vars := mux.Vars(r)
  362. name := vars["name"]
  363. v := r.Form.Get("v") == "1"
  364. if err := srv.ContainerDestroy(name, v); err != nil {
  365. return nil, err
  366. }
  367. w.WriteHeader(http.StatusNoContent)
  368. return nil, nil
  369. }
  370. func deleteImages(srv *Server, w http.ResponseWriter, r *http.Request) ([]byte, error) {
  371. vars := mux.Vars(r)
  372. name := vars["name"]
  373. if err := srv.ImageDelete(name); err != nil {
  374. return nil, err
  375. }
  376. w.WriteHeader(http.StatusNoContent)
  377. return nil, nil
  378. }
  379. func postContainersStart(srv *Server, w http.ResponseWriter, r *http.Request) ([]byte, error) {
  380. vars := mux.Vars(r)
  381. name := vars["name"]
  382. if err := srv.ContainerStart(name); err != nil {
  383. return nil, err
  384. }
  385. w.WriteHeader(http.StatusNoContent)
  386. return nil, nil
  387. }
  388. func postContainersStop(srv *Server, w http.ResponseWriter, r *http.Request) ([]byte, error) {
  389. if err := parseForm(r); err != nil {
  390. return nil, err
  391. }
  392. t, err := strconv.Atoi(r.Form.Get("t"))
  393. if err != nil || t < 0 {
  394. t = 10
  395. }
  396. vars := mux.Vars(r)
  397. name := vars["name"]
  398. if err := srv.ContainerStop(name, t); err != nil {
  399. return nil, err
  400. }
  401. w.WriteHeader(http.StatusNoContent)
  402. return nil, nil
  403. }
  404. func postContainersWait(srv *Server, w http.ResponseWriter, r *http.Request) ([]byte, error) {
  405. vars := mux.Vars(r)
  406. name := vars["name"]
  407. status, err := srv.ContainerWait(name)
  408. if err != nil {
  409. return nil, err
  410. }
  411. b, err := json.Marshal(ApiWait{status})
  412. if err != nil {
  413. return nil, err
  414. }
  415. return b, nil
  416. }
  417. func postContainersAttach(srv *Server, w http.ResponseWriter, r *http.Request) ([]byte, error) {
  418. if err := parseForm(r); err != nil {
  419. return nil, err
  420. }
  421. logs := r.Form.Get("logs") == "1"
  422. stream := r.Form.Get("stream") == "1"
  423. stdin := r.Form.Get("stdin") == "1"
  424. stdout := r.Form.Get("stdout") == "1"
  425. stderr := r.Form.Get("stderr") == "1"
  426. vars := mux.Vars(r)
  427. name := vars["name"]
  428. in, out, err := hijackServer(w)
  429. if err != nil {
  430. return nil, err
  431. }
  432. defer in.Close()
  433. fmt.Fprintf(out, "HTTP/1.1 200 OK\r\nContent-Type: application/vnd.docker.raw-stream\r\n\r\n")
  434. if err := srv.ContainerAttach(name, logs, stream, stdin, stdout, stderr, in, out); err != nil {
  435. fmt.Fprintf(out, "Error: %s\n", err)
  436. }
  437. return nil, nil
  438. }
  439. func getContainersByName(srv *Server, w http.ResponseWriter, r *http.Request) ([]byte, error) {
  440. vars := mux.Vars(r)
  441. name := vars["name"]
  442. container, err := srv.ContainerInspect(name)
  443. if err != nil {
  444. return nil, err
  445. }
  446. b, err := json.Marshal(container)
  447. if err != nil {
  448. return nil, err
  449. }
  450. return b, nil
  451. }
  452. func getImagesByName(srv *Server, w http.ResponseWriter, r *http.Request) ([]byte, error) {
  453. vars := mux.Vars(r)
  454. name := vars["name"]
  455. image, err := srv.ImageInspect(name)
  456. if err != nil {
  457. return nil, err
  458. }
  459. b, err := json.Marshal(image)
  460. if err != nil {
  461. return nil, err
  462. }
  463. return b, nil
  464. }
  465. func ListenAndServe(addr string, srv *Server) error {
  466. r := mux.NewRouter()
  467. log.Printf("Listening for HTTP on %s\n", addr)
  468. m := map[string]map[string]func(*Server, http.ResponseWriter, *http.Request) ([]byte, error){
  469. "GET": {
  470. "/auth": getAuth,
  471. "/version": getVersion,
  472. "/containers/{name:.*}/export": getContainersExport,
  473. "/images": getImages,
  474. "/info": getInfo,
  475. "/images/search": getImagesSearch,
  476. "/images/{name:.*}/history": getImagesHistory,
  477. "/containers/{name:.*}/changes": getContainersChanges,
  478. "/containers": getContainers,
  479. "/images/{name:.*}/json": getImagesByName,
  480. "/containers/{name:.*}/json": getContainersByName,
  481. },
  482. "POST": {
  483. "/auth": postAuth,
  484. "/containers/{name:.*}/kill": postContainersKill,
  485. "/images/{name:.*}/tag": postImagesTag,
  486. "/commit": postCommit,
  487. "/images": postImages,
  488. "/images/{name:*.}/insert": postImagesInsert,
  489. "/images/{name:*.}/push": postImagesPush,
  490. "/build": postBuild,
  491. "/containers": postContainers,
  492. "/containers/{name:.*}/restart": postContainersRestart,
  493. "/containers/{name:.*}/start": postContainersStart,
  494. "/containers/{name:.*}/stop": postContainersStop,
  495. "/containers/{name:.*}/wait": postContainersWait,
  496. "/containers/{name:.*}/attach": postContainersAttach,
  497. },
  498. "DELETE": {
  499. "/containers/{name:.*}": deleteContainers,
  500. "/images/{name:.*}": deleteImages,
  501. },
  502. }
  503. for method, routes := range m {
  504. for route, fct := range routes {
  505. Debugf("Registering %s, %s", method, route)
  506. // NOTE: scope issue, make sure the variables are local and won't be changed
  507. localRoute := route
  508. localMethod := method
  509. localFct := fct
  510. r.Path(localRoute).Methods(localMethod).HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
  511. Debugf("Calling %s %s", localMethod, localRoute)
  512. log.Println(r.Method, r.RequestURI)
  513. if strings.Contains(r.Header.Get("User-Agent"), "Docker-Client/") {
  514. userAgent := strings.Split(r.Header.Get("User-Agent"), "/")
  515. if len(userAgent) == 2 && userAgent[1] != VERSION {
  516. Debugf("Warning: client and server don't have the same version (client: %s, server: %s)", userAgent[1], VERSION)
  517. }
  518. }
  519. json, err := localFct(srv, w, r)
  520. if err != nil {
  521. httpError(w, err)
  522. }
  523. if json != nil {
  524. w.Header().Set("Content-Type", "application/json")
  525. w.Write(json)
  526. }
  527. })
  528. }
  529. }
  530. return http.ListenAndServe(addr, r)
  531. }