api.go 31 KB

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