api.go 17 KB

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