api.go 33 KB

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