api.go 17 KB

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