api.go 28 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085
  1. package docker
  2. import (
  3. "code.google.com/p/go.net/websocket"
  4. "encoding/base64"
  5. "encoding/json"
  6. "fmt"
  7. "github.com/dotcloud/docker/auth"
  8. "github.com/dotcloud/docker/utils"
  9. "github.com/gorilla/mux"
  10. "io"
  11. "io/ioutil"
  12. "log"
  13. "mime"
  14. "net"
  15. "net/http"
  16. "os"
  17. "os/exec"
  18. "regexp"
  19. "strconv"
  20. "strings"
  21. )
  22. const APIVERSION = 1.5
  23. const DEFAULTHTTPHOST = "127.0.0.1"
  24. const DEFAULTHTTPPORT = 4243
  25. const DEFAULTUNIXSOCKET = "/var/run/docker.sock"
  26. type HttpApiFunc func(srv *Server, version float64, w http.ResponseWriter, r *http.Request, vars map[string]string) error
  27. func hijackServer(w http.ResponseWriter) (io.ReadCloser, io.Writer, error) {
  28. conn, _, err := w.(http.Hijacker).Hijack()
  29. if err != nil {
  30. return nil, nil, err
  31. }
  32. // Flush the options to make sure the client sets the raw mode
  33. conn.Write([]byte{})
  34. return conn, conn, nil
  35. }
  36. //If we don't do this, POST method without Content-type (even with empty body) will fail
  37. func parseForm(r *http.Request) error {
  38. if err := r.ParseForm(); err != nil && !strings.HasPrefix(err.Error(), "mime:") {
  39. return err
  40. }
  41. return nil
  42. }
  43. func parseMultipartForm(r *http.Request) error {
  44. if err := r.ParseMultipartForm(4096); err != nil && !strings.HasPrefix(err.Error(), "mime:") {
  45. return err
  46. }
  47. return nil
  48. }
  49. func httpError(w http.ResponseWriter, err error) {
  50. statusCode := http.StatusInternalServerError
  51. if strings.HasPrefix(err.Error(), "No such") {
  52. statusCode = http.StatusNotFound
  53. } else if strings.HasPrefix(err.Error(), "Bad parameter") {
  54. statusCode = http.StatusBadRequest
  55. } else if strings.HasPrefix(err.Error(), "Conflict") {
  56. statusCode = http.StatusConflict
  57. } else if strings.HasPrefix(err.Error(), "Impossible") {
  58. statusCode = http.StatusNotAcceptable
  59. } else if strings.HasPrefix(err.Error(), "Wrong login/password") {
  60. statusCode = http.StatusUnauthorized
  61. } else if strings.Contains(err.Error(), "hasn't been activated") {
  62. statusCode = http.StatusForbidden
  63. }
  64. utils.Debugf("[error %d] %s", statusCode, err)
  65. http.Error(w, err.Error(), statusCode)
  66. }
  67. func writeJSON(w http.ResponseWriter, code int, v interface{}) error {
  68. b, err := json.Marshal(v)
  69. if err != nil {
  70. return err
  71. }
  72. w.Header().Set("Content-Type", "application/json")
  73. w.WriteHeader(code)
  74. w.Write(b)
  75. return nil
  76. }
  77. func getBoolParam(value string) (bool, error) {
  78. if value == "" {
  79. return false, nil
  80. }
  81. ret, err := strconv.ParseBool(value)
  82. if err != nil {
  83. return false, fmt.Errorf("Bad parameter")
  84. }
  85. return ret, nil
  86. }
  87. func matchesContentType(contentType, expectedType string) bool {
  88. mimetype, _, err := mime.ParseMediaType(contentType)
  89. if err != nil {
  90. utils.Debugf("Error parsing media type: %s error: %s", contentType, err.Error())
  91. }
  92. return err == nil && mimetype == expectedType
  93. }
  94. func postAuth(srv *Server, version float64, w http.ResponseWriter, r *http.Request, vars map[string]string) error {
  95. authConfig := &auth.AuthConfig{}
  96. err := json.NewDecoder(r.Body).Decode(authConfig)
  97. if err != nil {
  98. return err
  99. }
  100. status, err := auth.Login(authConfig, srv.HTTPRequestFactory(nil))
  101. if err != nil {
  102. return err
  103. }
  104. if status != "" {
  105. return writeJSON(w, http.StatusOK, &APIAuth{Status: status})
  106. }
  107. w.WriteHeader(http.StatusNoContent)
  108. return nil
  109. }
  110. func getVersion(srv *Server, version float64, w http.ResponseWriter, r *http.Request, vars map[string]string) error {
  111. return writeJSON(w, http.StatusOK, srv.DockerVersion())
  112. }
  113. func postContainersKill(srv *Server, version float64, w http.ResponseWriter, r *http.Request, vars map[string]string) error {
  114. if vars == nil {
  115. return fmt.Errorf("Missing parameter")
  116. }
  117. name := vars["name"]
  118. if err := srv.ContainerKill(name); err != nil {
  119. return err
  120. }
  121. w.WriteHeader(http.StatusNoContent)
  122. return nil
  123. }
  124. func getContainersExport(srv *Server, version float64, w http.ResponseWriter, r *http.Request, vars map[string]string) error {
  125. if vars == nil {
  126. return fmt.Errorf("Missing parameter")
  127. }
  128. name := vars["name"]
  129. if err := srv.ContainerExport(name, w); err != nil {
  130. utils.Debugf("%s", err)
  131. return err
  132. }
  133. return nil
  134. }
  135. func getImagesJSON(srv *Server, version float64, w http.ResponseWriter, r *http.Request, vars map[string]string) error {
  136. if err := parseForm(r); err != nil {
  137. return err
  138. }
  139. all, err := getBoolParam(r.Form.Get("all"))
  140. if err != nil {
  141. return err
  142. }
  143. filter := r.Form.Get("filter")
  144. outs, err := srv.Images(all, filter)
  145. if err != nil {
  146. return err
  147. }
  148. return writeJSON(w, http.StatusOK, outs)
  149. }
  150. func getImagesViz(srv *Server, version float64, w http.ResponseWriter, r *http.Request, vars map[string]string) error {
  151. if err := srv.ImagesViz(w); err != nil {
  152. return err
  153. }
  154. return nil
  155. }
  156. func getInfo(srv *Server, version float64, w http.ResponseWriter, r *http.Request, vars map[string]string) error {
  157. return writeJSON(w, http.StatusOK, srv.DockerInfo())
  158. }
  159. func getEvents(srv *Server, version float64, w http.ResponseWriter, r *http.Request, vars map[string]string) error {
  160. sendEvent := func(wf *utils.WriteFlusher, event *utils.JSONMessage) error {
  161. b, err := json.Marshal(event)
  162. if err != nil {
  163. return fmt.Errorf("JSON error")
  164. }
  165. _, err = wf.Write(b)
  166. if err != nil {
  167. // On error, evict the listener
  168. utils.Debugf("%s", err)
  169. srv.Lock()
  170. delete(srv.listeners, r.RemoteAddr)
  171. srv.Unlock()
  172. return err
  173. }
  174. return nil
  175. }
  176. if err := parseForm(r); err != nil {
  177. return err
  178. }
  179. listener := make(chan utils.JSONMessage)
  180. srv.Lock()
  181. srv.listeners[r.RemoteAddr] = listener
  182. srv.Unlock()
  183. since, err := strconv.ParseInt(r.Form.Get("since"), 10, 0)
  184. if err != nil {
  185. since = 0
  186. }
  187. w.Header().Set("Content-Type", "application/json")
  188. wf := utils.NewWriteFlusher(w)
  189. if since != 0 {
  190. // If since, send previous events that happened after the timestamp
  191. for _, event := range srv.events {
  192. if event.Time >= since {
  193. err := sendEvent(wf, &event)
  194. if err != nil && err.Error() == "JSON error" {
  195. continue
  196. }
  197. if err != nil {
  198. return err
  199. }
  200. }
  201. }
  202. }
  203. for event := range listener {
  204. err := sendEvent(wf, &event)
  205. if err != nil && err.Error() == "JSON error" {
  206. continue
  207. }
  208. if err != nil {
  209. return err
  210. }
  211. }
  212. return nil
  213. }
  214. func getImagesHistory(srv *Server, version float64, w http.ResponseWriter, r *http.Request, vars map[string]string) error {
  215. if vars == nil {
  216. return fmt.Errorf("Missing parameter")
  217. }
  218. name := vars["name"]
  219. outs, err := srv.ImageHistory(name)
  220. if err != nil {
  221. return err
  222. }
  223. return writeJSON(w, http.StatusOK, outs)
  224. }
  225. func getContainersChanges(srv *Server, version float64, w http.ResponseWriter, r *http.Request, vars map[string]string) error {
  226. if vars == nil {
  227. return fmt.Errorf("Missing parameter")
  228. }
  229. name := vars["name"]
  230. changesStr, err := srv.ContainerChanges(name)
  231. if err != nil {
  232. return err
  233. }
  234. return writeJSON(w, http.StatusOK, changesStr)
  235. }
  236. func getContainersTop(srv *Server, version float64, w http.ResponseWriter, r *http.Request, vars map[string]string) error {
  237. if version < 1.4 {
  238. return fmt.Errorf("top was improved a lot since 1.3, Please upgrade your docker client.")
  239. }
  240. if vars == nil {
  241. return fmt.Errorf("Missing parameter")
  242. }
  243. if err := parseForm(r); err != nil {
  244. return err
  245. }
  246. name := vars["name"]
  247. ps_args := r.Form.Get("ps_args")
  248. procsStr, err := srv.ContainerTop(name, ps_args)
  249. if err != nil {
  250. return err
  251. }
  252. return writeJSON(w, http.StatusOK, procsStr)
  253. }
  254. func getContainersJSON(srv *Server, version float64, w http.ResponseWriter, r *http.Request, vars map[string]string) error {
  255. if err := parseForm(r); err != nil {
  256. return err
  257. }
  258. all, err := getBoolParam(r.Form.Get("all"))
  259. if err != nil {
  260. return err
  261. }
  262. size, err := getBoolParam(r.Form.Get("size"))
  263. if err != nil {
  264. return err
  265. }
  266. since := r.Form.Get("since")
  267. before := r.Form.Get("before")
  268. n, err := strconv.Atoi(r.Form.Get("limit"))
  269. if err != nil {
  270. n = -1
  271. }
  272. outs := srv.Containers(all, size, n, since, before)
  273. if version < 1.5 {
  274. outs2 := []APIContainersOld{}
  275. for _, ctnr := range outs {
  276. outs2 = append(outs2, ctnr.ToLegacy())
  277. }
  278. return writeJSON(w, http.StatusOK, outs2)
  279. } else {
  280. return writeJSON(w, http.StatusOK, outs)
  281. }
  282. }
  283. func postImagesTag(srv *Server, version float64, w http.ResponseWriter, r *http.Request, vars map[string]string) error {
  284. if err := parseForm(r); err != nil {
  285. return err
  286. }
  287. repo := r.Form.Get("repo")
  288. tag := r.Form.Get("tag")
  289. if vars == nil {
  290. return fmt.Errorf("Missing parameter")
  291. }
  292. name := vars["name"]
  293. force, err := getBoolParam(r.Form.Get("force"))
  294. if err != nil {
  295. return err
  296. }
  297. if err := srv.ContainerTag(name, repo, tag, force); err != nil {
  298. return err
  299. }
  300. w.WriteHeader(http.StatusCreated)
  301. return nil
  302. }
  303. func postCommit(srv *Server, version float64, w http.ResponseWriter, r *http.Request, vars map[string]string) error {
  304. if err := parseForm(r); err != nil {
  305. return err
  306. }
  307. config := &Config{}
  308. if err := json.NewDecoder(r.Body).Decode(config); err != nil {
  309. utils.Debugf("%s", err)
  310. }
  311. repo := r.Form.Get("repo")
  312. tag := r.Form.Get("tag")
  313. container := r.Form.Get("container")
  314. author := r.Form.Get("author")
  315. comment := r.Form.Get("comment")
  316. id, err := srv.ContainerCommit(container, repo, tag, author, comment, config)
  317. if err != nil {
  318. return err
  319. }
  320. return writeJSON(w, http.StatusCreated, &APIID{id})
  321. }
  322. // Creates an image from Pull or from Import
  323. func postImagesCreate(srv *Server, version float64, w http.ResponseWriter, r *http.Request, vars map[string]string) error {
  324. if err := parseForm(r); err != nil {
  325. return err
  326. }
  327. src := r.Form.Get("fromSrc")
  328. image := r.Form.Get("fromImage")
  329. tag := r.Form.Get("tag")
  330. repo := r.Form.Get("repo")
  331. authEncoded := r.Header.Get("X-Registry-Auth")
  332. authConfig := &auth.AuthConfig{}
  333. if authEncoded != "" {
  334. authJson := base64.NewDecoder(base64.URLEncoding, strings.NewReader(authEncoded))
  335. if err := json.NewDecoder(authJson).Decode(authConfig); err != nil {
  336. // for a pull it is not an error if no auth was given
  337. // to increase compatibility with the existing api it is defaulting to be empty
  338. authConfig = &auth.AuthConfig{}
  339. }
  340. }
  341. if version > 1.0 {
  342. w.Header().Set("Content-Type", "application/json")
  343. }
  344. sf := utils.NewStreamFormatter(version > 1.0)
  345. if image != "" { //pull
  346. metaHeaders := map[string][]string{}
  347. for k, v := range r.Header {
  348. if strings.HasPrefix(k, "X-Meta-") {
  349. metaHeaders[k] = v
  350. }
  351. }
  352. if err := srv.ImagePull(image, tag, w, sf, authConfig, metaHeaders, version > 1.3); err != nil {
  353. if sf.Used() {
  354. w.Write(sf.FormatError(err))
  355. return nil
  356. }
  357. return err
  358. }
  359. } else { //import
  360. if err := srv.ImageImport(src, repo, tag, r.Body, w, sf); err != nil {
  361. if sf.Used() {
  362. w.Write(sf.FormatError(err))
  363. return nil
  364. }
  365. return err
  366. }
  367. }
  368. return nil
  369. }
  370. func getImagesSearch(srv *Server, version float64, w http.ResponseWriter, r *http.Request, vars map[string]string) error {
  371. if err := parseForm(r); err != nil {
  372. return err
  373. }
  374. term := r.Form.Get("term")
  375. outs, err := srv.ImagesSearch(term)
  376. if err != nil {
  377. return err
  378. }
  379. return writeJSON(w, http.StatusOK, outs)
  380. }
  381. func postImagesInsert(srv *Server, version float64, w http.ResponseWriter, r *http.Request, vars map[string]string) error {
  382. if err := parseForm(r); err != nil {
  383. return err
  384. }
  385. url := r.Form.Get("url")
  386. path := r.Form.Get("path")
  387. if vars == nil {
  388. return fmt.Errorf("Missing parameter")
  389. }
  390. name := vars["name"]
  391. if version > 1.0 {
  392. w.Header().Set("Content-Type", "application/json")
  393. }
  394. sf := utils.NewStreamFormatter(version > 1.0)
  395. imgID, err := srv.ImageInsert(name, url, path, w, sf)
  396. if err != nil {
  397. if sf.Used() {
  398. w.Write(sf.FormatError(err))
  399. return nil
  400. }
  401. }
  402. return writeJSON(w, http.StatusOK, &APIID{ID: imgID})
  403. }
  404. func postImagesPush(srv *Server, version float64, w http.ResponseWriter, r *http.Request, vars map[string]string) error {
  405. metaHeaders := map[string][]string{}
  406. for k, v := range r.Header {
  407. if strings.HasPrefix(k, "X-Meta-") {
  408. metaHeaders[k] = v
  409. }
  410. }
  411. if err := parseForm(r); err != nil {
  412. return err
  413. }
  414. authConfig := &auth.AuthConfig{}
  415. authEncoded := r.Header.Get("X-Registry-Auth")
  416. if authEncoded != "" {
  417. // the new format is to handle the authConfig as a header
  418. authJson := base64.NewDecoder(base64.URLEncoding, strings.NewReader(authEncoded))
  419. if err := json.NewDecoder(authJson).Decode(authConfig); err != nil {
  420. // to increase compatibility to existing api it is defaulting to be empty
  421. authConfig = &auth.AuthConfig{}
  422. }
  423. } else {
  424. // the old format is supported for compatibility if there was no authConfig header
  425. if err := json.NewDecoder(r.Body).Decode(authConfig); err != nil {
  426. return err
  427. }
  428. }
  429. if vars == nil {
  430. return fmt.Errorf("Missing parameter")
  431. }
  432. name := vars["name"]
  433. if version > 1.0 {
  434. w.Header().Set("Content-Type", "application/json")
  435. }
  436. sf := utils.NewStreamFormatter(version > 1.0)
  437. if err := srv.ImagePush(name, w, sf, authConfig, metaHeaders); err != nil {
  438. if sf.Used() {
  439. w.Write(sf.FormatError(err))
  440. return nil
  441. }
  442. return err
  443. }
  444. return nil
  445. }
  446. func postContainersCreate(srv *Server, version float64, w http.ResponseWriter, r *http.Request, vars map[string]string) error {
  447. config := &Config{}
  448. out := &APIRun{}
  449. if err := json.NewDecoder(r.Body).Decode(config); err != nil {
  450. return err
  451. }
  452. resolvConf, err := utils.GetResolvConf()
  453. if err != nil {
  454. return err
  455. }
  456. if len(config.Dns) == 0 && len(srv.runtime.Dns) == 0 && utils.CheckLocalDns(resolvConf) {
  457. out.Warnings = append(out.Warnings, fmt.Sprintf("Docker detected local DNS server on resolv.conf. Using default external servers: %v", defaultDns))
  458. config.Dns = defaultDns
  459. }
  460. id, err := srv.ContainerCreate(config)
  461. if err != nil {
  462. return err
  463. }
  464. out.ID = id
  465. if config.Memory > 0 && !srv.runtime.capabilities.MemoryLimit {
  466. log.Println("WARNING: Your kernel does not support memory limit capabilities. Limitation discarded.")
  467. out.Warnings = append(out.Warnings, "Your kernel does not support memory limit capabilities. Limitation discarded.")
  468. }
  469. if config.Memory > 0 && !srv.runtime.capabilities.SwapLimit {
  470. log.Println("WARNING: Your kernel does not support swap limit capabilities. Limitation discarded.")
  471. out.Warnings = append(out.Warnings, "Your kernel does not support memory swap capabilities. Limitation discarded.")
  472. }
  473. if srv.runtime.capabilities.IPv4ForwardingDisabled {
  474. log.Println("Warning: IPv4 forwarding is disabled.")
  475. out.Warnings = append(out.Warnings, "IPv4 forwarding is disabled.")
  476. }
  477. return writeJSON(w, http.StatusCreated, out)
  478. }
  479. func postContainersRestart(srv *Server, version float64, w http.ResponseWriter, r *http.Request, vars map[string]string) error {
  480. if err := parseForm(r); err != nil {
  481. return err
  482. }
  483. t, err := strconv.Atoi(r.Form.Get("t"))
  484. if err != nil || t < 0 {
  485. t = 10
  486. }
  487. if vars == nil {
  488. return fmt.Errorf("Missing parameter")
  489. }
  490. name := vars["name"]
  491. if err := srv.ContainerRestart(name, t); err != nil {
  492. return err
  493. }
  494. w.WriteHeader(http.StatusNoContent)
  495. return nil
  496. }
  497. func deleteContainers(srv *Server, version float64, w http.ResponseWriter, r *http.Request, vars map[string]string) error {
  498. if err := parseForm(r); err != nil {
  499. return err
  500. }
  501. if vars == nil {
  502. return fmt.Errorf("Missing parameter")
  503. }
  504. name := vars["name"]
  505. removeVolume, err := getBoolParam(r.Form.Get("v"))
  506. if err != nil {
  507. return err
  508. }
  509. if err := srv.ContainerDestroy(name, removeVolume); err != nil {
  510. return err
  511. }
  512. w.WriteHeader(http.StatusNoContent)
  513. return nil
  514. }
  515. func deleteImages(srv *Server, version float64, w http.ResponseWriter, r *http.Request, vars map[string]string) error {
  516. if err := parseForm(r); err != nil {
  517. return err
  518. }
  519. if vars == nil {
  520. return fmt.Errorf("Missing parameter")
  521. }
  522. name := vars["name"]
  523. imgs, err := srv.ImageDelete(name, version > 1.1)
  524. if err != nil {
  525. return err
  526. }
  527. if imgs != nil {
  528. if len(imgs) != 0 {
  529. return writeJSON(w, http.StatusOK, imgs)
  530. } else {
  531. return fmt.Errorf("Conflict, %s wasn't deleted", name)
  532. }
  533. } else {
  534. w.WriteHeader(http.StatusNoContent)
  535. }
  536. return nil
  537. }
  538. func postContainersStart(srv *Server, version float64, w http.ResponseWriter, r *http.Request, vars map[string]string) error {
  539. hostConfig := &HostConfig{}
  540. // allow a nil body for backwards compatibility
  541. if r.Body != nil {
  542. if matchesContentType(r.Header.Get("Content-Type"), "application/json") {
  543. if err := json.NewDecoder(r.Body).Decode(hostConfig); err != nil {
  544. return err
  545. }
  546. }
  547. }
  548. if vars == nil {
  549. return fmt.Errorf("Missing parameter")
  550. }
  551. name := vars["name"]
  552. if err := srv.ContainerStart(name, hostConfig); err != nil {
  553. return err
  554. }
  555. w.WriteHeader(http.StatusNoContent)
  556. return nil
  557. }
  558. func postContainersStop(srv *Server, version float64, w http.ResponseWriter, r *http.Request, vars map[string]string) error {
  559. if err := parseForm(r); err != nil {
  560. return err
  561. }
  562. t, err := strconv.Atoi(r.Form.Get("t"))
  563. if err != nil || t < 0 {
  564. t = 10
  565. }
  566. if vars == nil {
  567. return fmt.Errorf("Missing parameter")
  568. }
  569. name := vars["name"]
  570. if err := srv.ContainerStop(name, t); err != nil {
  571. return err
  572. }
  573. w.WriteHeader(http.StatusNoContent)
  574. return nil
  575. }
  576. func postContainersWait(srv *Server, version float64, w http.ResponseWriter, r *http.Request, vars map[string]string) error {
  577. if vars == nil {
  578. return fmt.Errorf("Missing parameter")
  579. }
  580. name := vars["name"]
  581. status, err := srv.ContainerWait(name)
  582. if err != nil {
  583. return err
  584. }
  585. return writeJSON(w, http.StatusOK, &APIWait{StatusCode: status})
  586. }
  587. func postContainersResize(srv *Server, version float64, w http.ResponseWriter, r *http.Request, vars map[string]string) error {
  588. if err := parseForm(r); err != nil {
  589. return err
  590. }
  591. height, err := strconv.Atoi(r.Form.Get("h"))
  592. if err != nil {
  593. return err
  594. }
  595. width, err := strconv.Atoi(r.Form.Get("w"))
  596. if err != nil {
  597. return err
  598. }
  599. if vars == nil {
  600. return fmt.Errorf("Missing parameter")
  601. }
  602. name := vars["name"]
  603. if err := srv.ContainerResize(name, height, width); err != nil {
  604. return err
  605. }
  606. return nil
  607. }
  608. func postContainersAttach(srv *Server, version float64, w http.ResponseWriter, r *http.Request, vars map[string]string) error {
  609. if err := parseForm(r); err != nil {
  610. return err
  611. }
  612. logs, err := getBoolParam(r.Form.Get("logs"))
  613. if err != nil {
  614. return err
  615. }
  616. stream, err := getBoolParam(r.Form.Get("stream"))
  617. if err != nil {
  618. return err
  619. }
  620. stdin, err := getBoolParam(r.Form.Get("stdin"))
  621. if err != nil {
  622. return err
  623. }
  624. stdout, err := getBoolParam(r.Form.Get("stdout"))
  625. if err != nil {
  626. return err
  627. }
  628. stderr, err := getBoolParam(r.Form.Get("stderr"))
  629. if err != nil {
  630. return err
  631. }
  632. if vars == nil {
  633. return fmt.Errorf("Missing parameter")
  634. }
  635. name := vars["name"]
  636. if _, err := srv.ContainerInspect(name); err != nil {
  637. return err
  638. }
  639. in, out, err := hijackServer(w)
  640. if err != nil {
  641. return err
  642. }
  643. defer func() {
  644. if tcpc, ok := in.(*net.TCPConn); ok {
  645. tcpc.CloseWrite()
  646. } else {
  647. in.Close()
  648. }
  649. }()
  650. defer func() {
  651. if tcpc, ok := out.(*net.TCPConn); ok {
  652. tcpc.CloseWrite()
  653. } else if closer, ok := out.(io.Closer); ok {
  654. closer.Close()
  655. }
  656. }()
  657. fmt.Fprintf(out, "HTTP/1.1 200 OK\r\nContent-Type: application/vnd.docker.raw-stream\r\n\r\n")
  658. if err := srv.ContainerAttach(name, logs, stream, stdin, stdout, stderr, in, out); err != nil {
  659. fmt.Fprintf(out, "Error: %s\n", err)
  660. }
  661. return nil
  662. }
  663. func wsContainersAttach(srv *Server, version float64, w http.ResponseWriter, r *http.Request, vars map[string]string) error {
  664. if err := parseForm(r); err != nil {
  665. return err
  666. }
  667. logs, err := getBoolParam(r.Form.Get("logs"))
  668. if err != nil {
  669. return err
  670. }
  671. stream, err := getBoolParam(r.Form.Get("stream"))
  672. if err != nil {
  673. return err
  674. }
  675. stdin, err := getBoolParam(r.Form.Get("stdin"))
  676. if err != nil {
  677. return err
  678. }
  679. stdout, err := getBoolParam(r.Form.Get("stdout"))
  680. if err != nil {
  681. return err
  682. }
  683. stderr, err := getBoolParam(r.Form.Get("stderr"))
  684. if err != nil {
  685. return err
  686. }
  687. if vars == nil {
  688. return fmt.Errorf("Missing parameter")
  689. }
  690. name := vars["name"]
  691. if _, err := srv.ContainerInspect(name); err != nil {
  692. return err
  693. }
  694. h := websocket.Handler(func(ws *websocket.Conn) {
  695. defer ws.Close()
  696. if err := srv.ContainerAttach(name, logs, stream, stdin, stdout, stderr, ws, ws); err != nil {
  697. utils.Debugf("Error: %s", err)
  698. }
  699. })
  700. h.ServeHTTP(w, r)
  701. return nil
  702. }
  703. func getContainersByName(srv *Server, version float64, w http.ResponseWriter, r *http.Request, vars map[string]string) error {
  704. if vars == nil {
  705. return fmt.Errorf("Missing parameter")
  706. }
  707. name := vars["name"]
  708. container, err := srv.ContainerInspect(name)
  709. if err != nil {
  710. return err
  711. }
  712. _, err = srv.ImageInspect(name)
  713. if err == nil {
  714. return fmt.Errorf("Conflict between containers and images")
  715. }
  716. return writeJSON(w, http.StatusOK, container)
  717. }
  718. func getImagesByName(srv *Server, version float64, w http.ResponseWriter, r *http.Request, vars map[string]string) error {
  719. if vars == nil {
  720. return fmt.Errorf("Missing parameter")
  721. }
  722. name := vars["name"]
  723. image, err := srv.ImageInspect(name)
  724. if err != nil {
  725. return err
  726. }
  727. _, err = srv.ContainerInspect(name)
  728. if err == nil {
  729. return fmt.Errorf("Conflict between containers and images")
  730. }
  731. return writeJSON(w, http.StatusOK, image)
  732. }
  733. func postBuild(srv *Server, version float64, w http.ResponseWriter, r *http.Request, vars map[string]string) error {
  734. if version < 1.3 {
  735. return fmt.Errorf("Multipart upload for build is no longer supported. Please upgrade your docker client.")
  736. }
  737. remoteURL := r.FormValue("remote")
  738. repoName := r.FormValue("t")
  739. rawSuppressOutput := r.FormValue("q")
  740. rawNoCache := r.FormValue("nocache")
  741. rawRm := r.FormValue("rm")
  742. repoName, tag := utils.ParseRepositoryTag(repoName)
  743. var context io.Reader
  744. if remoteURL == "" {
  745. context = r.Body
  746. } else if utils.IsGIT(remoteURL) {
  747. if !strings.HasPrefix(remoteURL, "git://") {
  748. remoteURL = "https://" + remoteURL
  749. }
  750. root, err := ioutil.TempDir("", "docker-build-git")
  751. if err != nil {
  752. return err
  753. }
  754. defer os.RemoveAll(root)
  755. if output, err := exec.Command("git", "clone", remoteURL, root).CombinedOutput(); err != nil {
  756. return fmt.Errorf("Error trying to use git: %s (%s)", err, output)
  757. }
  758. c, err := Tar(root, Bzip2)
  759. if err != nil {
  760. return err
  761. }
  762. context = c
  763. } else if utils.IsURL(remoteURL) {
  764. f, err := utils.Download(remoteURL, ioutil.Discard)
  765. if err != nil {
  766. return err
  767. }
  768. defer f.Body.Close()
  769. dockerFile, err := ioutil.ReadAll(f.Body)
  770. if err != nil {
  771. return err
  772. }
  773. c, err := mkBuildContext(string(dockerFile), nil)
  774. if err != nil {
  775. return err
  776. }
  777. context = c
  778. }
  779. suppressOutput, err := getBoolParam(rawSuppressOutput)
  780. if err != nil {
  781. return err
  782. }
  783. noCache, err := getBoolParam(rawNoCache)
  784. if err != nil {
  785. return err
  786. }
  787. rm, err := getBoolParam(rawRm)
  788. if err != nil {
  789. return err
  790. }
  791. b := NewBuildFile(srv, utils.NewWriteFlusher(w), !suppressOutput, !noCache, rm)
  792. id, err := b.Build(context)
  793. if err != nil {
  794. fmt.Fprintf(w, "Error build: %s\n", err)
  795. return err
  796. }
  797. if repoName != "" {
  798. srv.runtime.repositories.Set(repoName, tag, id, false)
  799. }
  800. return nil
  801. }
  802. func postContainersCopy(srv *Server, version float64, w http.ResponseWriter, r *http.Request, vars map[string]string) error {
  803. if vars == nil {
  804. return fmt.Errorf("Missing parameter")
  805. }
  806. name := vars["name"]
  807. copyData := &APICopy{}
  808. contentType := r.Header.Get("Content-Type")
  809. if contentType == "application/json" {
  810. if err := json.NewDecoder(r.Body).Decode(copyData); err != nil {
  811. return err
  812. }
  813. } else {
  814. return fmt.Errorf("Content-Type not supported: %s", contentType)
  815. }
  816. if copyData.Resource == "" {
  817. return fmt.Errorf("Resource cannot be empty")
  818. }
  819. if copyData.Resource[0] == '/' {
  820. copyData.Resource = copyData.Resource[1:]
  821. }
  822. if err := srv.ContainerCopy(name, copyData.Resource, w); err != nil {
  823. utils.Debugf("%s", err.Error())
  824. return err
  825. }
  826. return nil
  827. }
  828. func optionsHandler(srv *Server, version float64, w http.ResponseWriter, r *http.Request, vars map[string]string) error {
  829. w.WriteHeader(http.StatusOK)
  830. return nil
  831. }
  832. func writeCorsHeaders(w http.ResponseWriter, r *http.Request) {
  833. w.Header().Add("Access-Control-Allow-Origin", "*")
  834. w.Header().Add("Access-Control-Allow-Headers", "Origin, X-Requested-With, Content-Type, Accept")
  835. w.Header().Add("Access-Control-Allow-Methods", "GET, POST, DELETE, PUT, OPTIONS")
  836. }
  837. func makeHttpHandler(srv *Server, logging bool, localMethod string, localRoute string, handlerFunc HttpApiFunc) http.HandlerFunc {
  838. return func(w http.ResponseWriter, r *http.Request) {
  839. // log the request
  840. utils.Debugf("Calling %s %s", localMethod, localRoute)
  841. if logging {
  842. log.Println(r.Method, r.RequestURI)
  843. }
  844. if strings.Contains(r.Header.Get("User-Agent"), "Docker-Client/") {
  845. userAgent := strings.Split(r.Header.Get("User-Agent"), "/")
  846. if len(userAgent) == 2 && userAgent[1] != VERSION {
  847. utils.Debugf("Warning: client and server don't have the same version (client: %s, server: %s)", userAgent[1], VERSION)
  848. }
  849. }
  850. version, err := strconv.ParseFloat(mux.Vars(r)["version"], 64)
  851. if err != nil {
  852. version = APIVERSION
  853. }
  854. if srv.enableCors {
  855. writeCorsHeaders(w, r)
  856. }
  857. if version == 0 || version > APIVERSION {
  858. w.WriteHeader(http.StatusNotFound)
  859. return
  860. }
  861. if err := handlerFunc(srv, version, w, r, mux.Vars(r)); err != nil {
  862. utils.Debugf("Error: %s", err)
  863. httpError(w, err)
  864. }
  865. }
  866. }
  867. func createRouter(srv *Server, logging bool) (*mux.Router, error) {
  868. r := mux.NewRouter()
  869. m := map[string]map[string]HttpApiFunc{
  870. "GET": {
  871. "/events": getEvents,
  872. "/info": getInfo,
  873. "/version": getVersion,
  874. "/images/json": getImagesJSON,
  875. "/images/viz": getImagesViz,
  876. "/images/search": getImagesSearch,
  877. "/images/{name:.*}/history": getImagesHistory,
  878. "/images/{name:.*}/json": getImagesByName,
  879. "/containers/ps": getContainersJSON,
  880. "/containers/json": getContainersJSON,
  881. "/containers/{name:.*}/export": getContainersExport,
  882. "/containers/{name:.*}/changes": getContainersChanges,
  883. "/containers/{name:.*}/json": getContainersByName,
  884. "/containers/{name:.*}/top": getContainersTop,
  885. "/containers/{name:.*}/attach/ws": wsContainersAttach,
  886. },
  887. "POST": {
  888. "/auth": postAuth,
  889. "/commit": postCommit,
  890. "/build": postBuild,
  891. "/images/create": postImagesCreate,
  892. "/images/{name:.*}/insert": postImagesInsert,
  893. "/images/{name:.*}/push": postImagesPush,
  894. "/images/{name:.*}/tag": postImagesTag,
  895. "/containers/create": postContainersCreate,
  896. "/containers/{name:.*}/kill": postContainersKill,
  897. "/containers/{name:.*}/restart": postContainersRestart,
  898. "/containers/{name:.*}/start": postContainersStart,
  899. "/containers/{name:.*}/stop": postContainersStop,
  900. "/containers/{name:.*}/wait": postContainersWait,
  901. "/containers/{name:.*}/resize": postContainersResize,
  902. "/containers/{name:.*}/attach": postContainersAttach,
  903. "/containers/{name:.*}/copy": postContainersCopy,
  904. },
  905. "DELETE": {
  906. "/containers/{name:.*}": deleteContainers,
  907. "/images/{name:.*}": deleteImages,
  908. },
  909. "OPTIONS": {
  910. "": optionsHandler,
  911. },
  912. }
  913. for method, routes := range m {
  914. for route, fct := range routes {
  915. utils.Debugf("Registering %s, %s", method, route)
  916. // NOTE: scope issue, make sure the variables are local and won't be changed
  917. localRoute := route
  918. localFct := fct
  919. localMethod := method
  920. // build the handler function
  921. f := makeHttpHandler(srv, logging, localMethod, localRoute, localFct)
  922. // add the new route
  923. if localRoute == "" {
  924. r.Methods(localMethod).HandlerFunc(f)
  925. } else {
  926. r.Path("/v{version:[0-9.]+}" + localRoute).Methods(localMethod).HandlerFunc(f)
  927. r.Path(localRoute).Methods(localMethod).HandlerFunc(f)
  928. }
  929. }
  930. }
  931. return r, nil
  932. }
  933. func ListenAndServe(proto, addr string, srv *Server, logging bool) error {
  934. log.Printf("Listening for HTTP on %s (%s)\n", addr, proto)
  935. r, err := createRouter(srv, logging)
  936. if err != nil {
  937. return err
  938. }
  939. l, e := net.Listen(proto, addr)
  940. if e != nil {
  941. return e
  942. }
  943. if proto == "unix" {
  944. if err := os.Chmod(addr, 0660); err != nil {
  945. return err
  946. }
  947. groups, err := ioutil.ReadFile("/etc/group")
  948. if err != nil {
  949. return err
  950. }
  951. re := regexp.MustCompile("(^|\n)docker:.*?:([0-9]+)")
  952. if gidMatch := re.FindStringSubmatch(string(groups)); gidMatch != nil {
  953. gid, err := strconv.Atoi(gidMatch[2])
  954. if err != nil {
  955. return err
  956. }
  957. utils.Debugf("docker group found. gid: %d", gid)
  958. if err := os.Chown(addr, 0, gid); err != nil {
  959. return err
  960. }
  961. }
  962. }
  963. httpSrv := http.Server{Addr: addr, Handler: r}
  964. return httpSrv.Serve(l)
  965. }