api.go 16 KB

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