api.go 15 KB

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