api.go 28 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041104210431044104510461047104810491050105110521053105410551056105710581059106010611062106310641065106610671068106910701071107210731074107510761077107810791080
  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, &APIID{ID: image.ID})
  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. repoName, tag := utils.ParseRepositoryTag(repoName)
  742. var context io.Reader
  743. if remoteURL == "" {
  744. context = r.Body
  745. } else if utils.IsGIT(remoteURL) {
  746. if !strings.HasPrefix(remoteURL, "git://") {
  747. remoteURL = "https://" + remoteURL
  748. }
  749. root, err := ioutil.TempDir("", "docker-build-git")
  750. if err != nil {
  751. return err
  752. }
  753. defer os.RemoveAll(root)
  754. if output, err := exec.Command("git", "clone", remoteURL, root).CombinedOutput(); err != nil {
  755. return fmt.Errorf("Error trying to use git: %s (%s)", err, output)
  756. }
  757. c, err := Tar(root, Bzip2)
  758. if err != nil {
  759. return err
  760. }
  761. context = c
  762. } else if utils.IsURL(remoteURL) {
  763. f, err := utils.Download(remoteURL, ioutil.Discard)
  764. if err != nil {
  765. return err
  766. }
  767. defer f.Body.Close()
  768. dockerFile, err := ioutil.ReadAll(f.Body)
  769. if err != nil {
  770. return err
  771. }
  772. c, err := mkBuildContext(string(dockerFile), nil)
  773. if err != nil {
  774. return err
  775. }
  776. context = c
  777. }
  778. suppressOutput, err := getBoolParam(rawSuppressOutput)
  779. if err != nil {
  780. return err
  781. }
  782. noCache, err := getBoolParam(rawNoCache)
  783. if err != nil {
  784. return err
  785. }
  786. b := NewBuildFile(srv, utils.NewWriteFlusher(w), !suppressOutput, !noCache)
  787. id, err := b.Build(context)
  788. if err != nil {
  789. fmt.Fprintf(w, "Error build: %s\n", err)
  790. return err
  791. }
  792. if repoName != "" {
  793. srv.runtime.repositories.Set(repoName, tag, id, false)
  794. }
  795. return nil
  796. }
  797. func postContainersCopy(srv *Server, version float64, w http.ResponseWriter, r *http.Request, vars map[string]string) error {
  798. if vars == nil {
  799. return fmt.Errorf("Missing parameter")
  800. }
  801. name := vars["name"]
  802. copyData := &APICopy{}
  803. contentType := r.Header.Get("Content-Type")
  804. if contentType == "application/json" {
  805. if err := json.NewDecoder(r.Body).Decode(copyData); err != nil {
  806. return err
  807. }
  808. } else {
  809. return fmt.Errorf("Content-Type not supported: %s", contentType)
  810. }
  811. if copyData.Resource == "" {
  812. return fmt.Errorf("Resource cannot be empty")
  813. }
  814. if copyData.Resource[0] == '/' {
  815. copyData.Resource = copyData.Resource[1:]
  816. }
  817. if err := srv.ContainerCopy(name, copyData.Resource, w); err != nil {
  818. utils.Debugf("%s", err.Error())
  819. return err
  820. }
  821. return nil
  822. }
  823. func optionsHandler(srv *Server, version float64, w http.ResponseWriter, r *http.Request, vars map[string]string) error {
  824. w.WriteHeader(http.StatusOK)
  825. return nil
  826. }
  827. func writeCorsHeaders(w http.ResponseWriter, r *http.Request) {
  828. w.Header().Add("Access-Control-Allow-Origin", "*")
  829. w.Header().Add("Access-Control-Allow-Headers", "Origin, X-Requested-With, Content-Type, Accept")
  830. w.Header().Add("Access-Control-Allow-Methods", "GET, POST, DELETE, PUT, OPTIONS")
  831. }
  832. func makeHttpHandler(srv *Server, logging bool, localMethod string, localRoute string, handlerFunc HttpApiFunc) http.HandlerFunc {
  833. return func(w http.ResponseWriter, r *http.Request) {
  834. // log the request
  835. utils.Debugf("Calling %s %s", localMethod, localRoute)
  836. if logging {
  837. log.Println(r.Method, r.RequestURI)
  838. }
  839. if strings.Contains(r.Header.Get("User-Agent"), "Docker-Client/") {
  840. userAgent := strings.Split(r.Header.Get("User-Agent"), "/")
  841. if len(userAgent) == 2 && userAgent[1] != VERSION {
  842. utils.Debugf("Warning: client and server don't have the same version (client: %s, server: %s)", userAgent[1], VERSION)
  843. }
  844. }
  845. version, err := strconv.ParseFloat(mux.Vars(r)["version"], 64)
  846. if err != nil {
  847. version = APIVERSION
  848. }
  849. if srv.enableCors {
  850. writeCorsHeaders(w, r)
  851. }
  852. if version == 0 || version > APIVERSION {
  853. w.WriteHeader(http.StatusNotFound)
  854. return
  855. }
  856. if err := handlerFunc(srv, version, w, r, mux.Vars(r)); err != nil {
  857. utils.Debugf("Error: %s", err)
  858. httpError(w, err)
  859. }
  860. }
  861. }
  862. func createRouter(srv *Server, logging bool) (*mux.Router, error) {
  863. r := mux.NewRouter()
  864. m := map[string]map[string]HttpApiFunc{
  865. "GET": {
  866. "/events": getEvents,
  867. "/info": getInfo,
  868. "/version": getVersion,
  869. "/images/json": getImagesJSON,
  870. "/images/viz": getImagesViz,
  871. "/images/search": getImagesSearch,
  872. "/images/{name:.*}/history": getImagesHistory,
  873. "/images/{name:.*}/json": getImagesByName,
  874. "/containers/ps": getContainersJSON,
  875. "/containers/json": getContainersJSON,
  876. "/containers/{name:.*}/export": getContainersExport,
  877. "/containers/{name:.*}/changes": getContainersChanges,
  878. "/containers/{name:.*}/json": getContainersByName,
  879. "/containers/{name:.*}/top": getContainersTop,
  880. "/containers/{name:.*}/attach/ws": wsContainersAttach,
  881. },
  882. "POST": {
  883. "/auth": postAuth,
  884. "/commit": postCommit,
  885. "/build": postBuild,
  886. "/images/create": postImagesCreate,
  887. "/images/{name:.*}/insert": postImagesInsert,
  888. "/images/{name:.*}/push": postImagesPush,
  889. "/images/{name:.*}/tag": postImagesTag,
  890. "/containers/create": postContainersCreate,
  891. "/containers/{name:.*}/kill": postContainersKill,
  892. "/containers/{name:.*}/restart": postContainersRestart,
  893. "/containers/{name:.*}/start": postContainersStart,
  894. "/containers/{name:.*}/stop": postContainersStop,
  895. "/containers/{name:.*}/wait": postContainersWait,
  896. "/containers/{name:.*}/resize": postContainersResize,
  897. "/containers/{name:.*}/attach": postContainersAttach,
  898. "/containers/{name:.*}/copy": postContainersCopy,
  899. },
  900. "DELETE": {
  901. "/containers/{name:.*}": deleteContainers,
  902. "/images/{name:.*}": deleteImages,
  903. },
  904. "OPTIONS": {
  905. "": optionsHandler,
  906. },
  907. }
  908. for method, routes := range m {
  909. for route, fct := range routes {
  910. utils.Debugf("Registering %s, %s", method, route)
  911. // NOTE: scope issue, make sure the variables are local and won't be changed
  912. localRoute := route
  913. localFct := fct
  914. localMethod := method
  915. // build the handler function
  916. f := makeHttpHandler(srv, logging, localMethod, localRoute, localFct)
  917. // add the new route
  918. if localRoute == "" {
  919. r.Methods(localMethod).HandlerFunc(f)
  920. } else {
  921. r.Path("/v{version:[0-9.]+}" + localRoute).Methods(localMethod).HandlerFunc(f)
  922. r.Path(localRoute).Methods(localMethod).HandlerFunc(f)
  923. }
  924. }
  925. }
  926. return r, nil
  927. }
  928. func ListenAndServe(proto, addr string, srv *Server, logging bool) error {
  929. log.Printf("Listening for HTTP on %s (%s)\n", addr, proto)
  930. r, err := createRouter(srv, logging)
  931. if err != nil {
  932. return err
  933. }
  934. l, e := net.Listen(proto, addr)
  935. if e != nil {
  936. return e
  937. }
  938. if proto == "unix" {
  939. if err := os.Chmod(addr, 0660); err != nil {
  940. return err
  941. }
  942. groups, err := ioutil.ReadFile("/etc/group")
  943. if err != nil {
  944. return err
  945. }
  946. re := regexp.MustCompile("(^|\n)docker:.*?:([0-9]+)")
  947. if gidMatch := re.FindStringSubmatch(string(groups)); gidMatch != nil {
  948. gid, err := strconv.Atoi(gidMatch[2])
  949. if err != nil {
  950. return err
  951. }
  952. utils.Debugf("docker group found. gid: %d", gid)
  953. if err := os.Chown(addr, 0, gid); err != nil {
  954. return err
  955. }
  956. }
  957. }
  958. httpSrv := http.Server{Addr: addr, Handler: r}
  959. return httpSrv.Serve(l)
  960. }