server.go 26 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967
  1. package server
  2. import (
  3. "bufio"
  4. "bytes"
  5. "encoding/json"
  6. "errors"
  7. "fmt"
  8. "github.com/dotcloud/docker"
  9. "github.com/dotcloud/docker/future"
  10. "github.com/dotcloud/docker/image"
  11. "github.com/dotcloud/docker/rcli"
  12. "io"
  13. "io/ioutil"
  14. "net/url"
  15. "os"
  16. "path"
  17. "strconv"
  18. "strings"
  19. "sync"
  20. "text/tabwriter"
  21. "time"
  22. )
  23. const VERSION = "0.0.1"
  24. func (srv *Server) ListenAndServe() error {
  25. go rcli.ListenAndServeHTTP("127.0.0.1:8080", srv)
  26. // FIXME: we want to use unix sockets here, but net.UnixConn doesn't expose
  27. // CloseWrite(), which we need to cleanly signal that stdin is closed without
  28. // closing the connection.
  29. // See http://code.google.com/p/go/issues/detail?id=3345
  30. return rcli.ListenAndServe("tcp", "127.0.0.1:4242", srv)
  31. }
  32. func (srv *Server) Name() string {
  33. return "docker"
  34. }
  35. func (srv *Server) Help() string {
  36. help := "Usage: docker COMMAND [arg...]\n\nA self-sufficient runtime for linux containers.\n\nCommands:\n"
  37. for _, cmd := range [][]interface{}{
  38. {"run", "Run a command in a container"},
  39. {"ps", "Display a list of containers"},
  40. {"pull", "Download a tarball and create a container from it"},
  41. {"put", "Upload a tarball and create a container from it"},
  42. {"port", "Lookup the public-facing port which is NAT-ed to PRIVATE_PORT"},
  43. {"rm", "Remove containers"},
  44. {"kill", "Kill a running container"},
  45. {"wait", "Wait for the state of a container to change"},
  46. {"stop", "Stop a running container"},
  47. {"start", "Start a stopped container"},
  48. {"restart", "Restart a running container"},
  49. {"logs", "Fetch the logs of a container"},
  50. {"diff", "Inspect changes on a container's filesystem"},
  51. {"commit", "Save the state of a container"},
  52. {"attach", "Attach to the standard inputs and outputs of a running container"},
  53. {"wait", "Block until a container exits, then print its exit code"},
  54. {"info", "Display system-wide information"},
  55. {"tar", "Stream the contents of a container as a tar archive"},
  56. {"web", "Generate a web UI"},
  57. {"images", "List images"},
  58. } {
  59. help += fmt.Sprintf(" %-10.10s%s\n", cmd...)
  60. }
  61. return help
  62. }
  63. // 'docker wait': block until a container stops
  64. func (srv *Server) CmdWait(stdin io.ReadCloser, stdout io.Writer, args ...string) error {
  65. cmd := rcli.Subcmd(stdout, "wait", "[OPTIONS] NAME", "Block until a container stops, then print its exit code.")
  66. if err := cmd.Parse(args); err != nil {
  67. cmd.Usage()
  68. return nil
  69. }
  70. if cmd.NArg() < 1 {
  71. cmd.Usage()
  72. return nil
  73. }
  74. for _, name := range cmd.Args() {
  75. if container := srv.containers.Get(name); container != nil {
  76. fmt.Fprintln(stdout, container.Wait())
  77. } else {
  78. return errors.New("No such container: " + name)
  79. }
  80. }
  81. return nil
  82. }
  83. // 'docker info': display system-wide information.
  84. func (srv *Server) CmdInfo(stdin io.ReadCloser, stdout io.Writer, args ...string) error {
  85. fmt.Fprintf(stdout, "containers: %d\nversion: %s\nimages: %d\n",
  86. len(srv.containers.List()),
  87. VERSION,
  88. len(srv.images.ById))
  89. return nil
  90. }
  91. func (srv *Server) CmdStop(stdin io.ReadCloser, stdout io.Writer, args ...string) error {
  92. cmd := rcli.Subcmd(stdout, "stop", "[OPTIONS] NAME", "Stop a running container")
  93. if err := cmd.Parse(args); err != nil {
  94. cmd.Usage()
  95. return nil
  96. }
  97. if cmd.NArg() < 1 {
  98. cmd.Usage()
  99. return nil
  100. }
  101. for _, name := range cmd.Args() {
  102. if container := srv.containers.Get(name); container != nil {
  103. if err := container.Stop(); err != nil {
  104. return err
  105. }
  106. fmt.Fprintln(stdout, container.Id)
  107. } else {
  108. return errors.New("No such container: " + name)
  109. }
  110. }
  111. return nil
  112. }
  113. func (srv *Server) CmdRestart(stdin io.ReadCloser, stdout io.Writer, args ...string) error {
  114. cmd := rcli.Subcmd(stdout, "restart", "[OPTIONS] NAME", "Restart a running container")
  115. if err := cmd.Parse(args); err != nil {
  116. cmd.Usage()
  117. return nil
  118. }
  119. if cmd.NArg() < 1 {
  120. cmd.Usage()
  121. return nil
  122. }
  123. for _, name := range cmd.Args() {
  124. if container := srv.containers.Get(name); container != nil {
  125. if err := container.Restart(); err != nil {
  126. return err
  127. }
  128. fmt.Fprintln(stdout, container.Id)
  129. } else {
  130. return errors.New("No such container: " + name)
  131. }
  132. }
  133. return nil
  134. }
  135. func (srv *Server) CmdStart(stdin io.ReadCloser, stdout io.Writer, args ...string) error {
  136. cmd := rcli.Subcmd(stdout, "start", "[OPTIONS] NAME", "Start a stopped container")
  137. if err := cmd.Parse(args); err != nil {
  138. cmd.Usage()
  139. return nil
  140. }
  141. if cmd.NArg() < 1 {
  142. cmd.Usage()
  143. return nil
  144. }
  145. for _, name := range cmd.Args() {
  146. if container := srv.containers.Get(name); container != nil {
  147. if err := container.Start(); err != nil {
  148. return err
  149. }
  150. fmt.Fprintln(stdout, container.Id)
  151. } else {
  152. return errors.New("No such container: " + name)
  153. }
  154. }
  155. return nil
  156. }
  157. func (srv *Server) CmdUmount(stdin io.ReadCloser, stdout io.Writer, args ...string) error {
  158. cmd := rcli.Subcmd(stdout, "umount", "[OPTIONS] NAME", "umount a container's filesystem (debug only)")
  159. if err := cmd.Parse(args); err != nil {
  160. cmd.Usage()
  161. return nil
  162. }
  163. if cmd.NArg() < 1 {
  164. cmd.Usage()
  165. return nil
  166. }
  167. for _, name := range cmd.Args() {
  168. if container := srv.containers.Get(name); container != nil {
  169. if err := container.Filesystem.Umount(); err != nil {
  170. return err
  171. }
  172. fmt.Fprintln(stdout, container.Id)
  173. } else {
  174. return errors.New("No such container: " + name)
  175. }
  176. }
  177. return nil
  178. }
  179. func (srv *Server) CmdMount(stdin io.ReadCloser, stdout io.Writer, args ...string) error {
  180. cmd := rcli.Subcmd(stdout, "umount", "[OPTIONS] NAME", "mount a container's filesystem (debug only)")
  181. if err := cmd.Parse(args); err != nil {
  182. cmd.Usage()
  183. return nil
  184. }
  185. if cmd.NArg() < 1 {
  186. cmd.Usage()
  187. return nil
  188. }
  189. for _, name := range cmd.Args() {
  190. if container := srv.containers.Get(name); container != nil {
  191. if err := container.Filesystem.Mount(); err != nil {
  192. return err
  193. }
  194. fmt.Fprintln(stdout, container.Id)
  195. } else {
  196. return errors.New("No such container: " + name)
  197. }
  198. }
  199. return nil
  200. }
  201. func (srv *Server) CmdCat(stdin io.ReadCloser, stdout io.Writer, args ...string) error {
  202. cmd := rcli.Subcmd(stdout, "cat", "[OPTIONS] CONTAINER PATH", "write the contents of a container's file to standard output")
  203. if err := cmd.Parse(args); err != nil {
  204. cmd.Usage()
  205. return nil
  206. }
  207. if cmd.NArg() < 2 {
  208. cmd.Usage()
  209. return nil
  210. }
  211. name, path := cmd.Arg(0), cmd.Arg(1)
  212. if container := srv.containers.Get(name); container != nil {
  213. if f, err := container.Filesystem.OpenFile(path, os.O_RDONLY, 0); err != nil {
  214. return err
  215. } else if _, err := io.Copy(stdout, f); err != nil {
  216. return err
  217. }
  218. return nil
  219. }
  220. return errors.New("No such container: " + name)
  221. }
  222. func (srv *Server) CmdWrite(stdin io.ReadCloser, stdout io.Writer, args ...string) error {
  223. cmd := rcli.Subcmd(stdout, "write", "[OPTIONS] CONTAINER PATH", "write the contents of standard input to a container's file")
  224. if err := cmd.Parse(args); err != nil {
  225. cmd.Usage()
  226. return nil
  227. }
  228. if cmd.NArg() < 2 {
  229. cmd.Usage()
  230. return nil
  231. }
  232. name, path := cmd.Arg(0), cmd.Arg(1)
  233. if container := srv.containers.Get(name); container != nil {
  234. if f, err := container.Filesystem.OpenFile(path, os.O_WRONLY|os.O_CREATE, 0600); err != nil {
  235. return err
  236. } else if _, err := io.Copy(f, stdin); err != nil {
  237. return err
  238. }
  239. return nil
  240. }
  241. return errors.New("No such container: " + name)
  242. }
  243. func (srv *Server) CmdLs(stdin io.ReadCloser, stdout io.Writer, args ...string) error {
  244. cmd := rcli.Subcmd(stdout, "ls", "[OPTIONS] CONTAINER PATH", "List the contents of a container's directory")
  245. if err := cmd.Parse(args); err != nil {
  246. cmd.Usage()
  247. return nil
  248. }
  249. if cmd.NArg() < 2 {
  250. cmd.Usage()
  251. return nil
  252. }
  253. name, path := cmd.Arg(0), cmd.Arg(1)
  254. if container := srv.containers.Get(name); container != nil {
  255. if files, err := container.Filesystem.ReadDir(path); err != nil {
  256. return err
  257. } else {
  258. for _, f := range files {
  259. fmt.Fprintln(stdout, f.Name())
  260. }
  261. }
  262. return nil
  263. }
  264. return errors.New("No such container: " + name)
  265. }
  266. func (srv *Server) CmdInspect(stdin io.ReadCloser, stdout io.Writer, args ...string) error {
  267. cmd := rcli.Subcmd(stdout, "inspect", "[OPTIONS] CONTAINER", "Return low-level information on a container")
  268. if err := cmd.Parse(args); err != nil {
  269. cmd.Usage()
  270. return nil
  271. }
  272. if cmd.NArg() < 1 {
  273. cmd.Usage()
  274. return nil
  275. }
  276. name := cmd.Arg(0)
  277. var obj interface{}
  278. if container := srv.containers.Get(name); container != nil {
  279. obj = container
  280. } else if image := srv.images.Find(name); image != nil {
  281. obj = image
  282. } else {
  283. return errors.New("No such container or image: " + name)
  284. }
  285. data, err := json.Marshal(obj)
  286. if err != nil {
  287. return err
  288. }
  289. indented := new(bytes.Buffer)
  290. if err = json.Indent(indented, data, "", " "); err != nil {
  291. return err
  292. }
  293. if _, err := io.Copy(stdout, indented); err != nil {
  294. return err
  295. }
  296. return nil
  297. }
  298. func (srv *Server) CmdPort(stdin io.ReadCloser, stdout io.Writer, args ...string) error {
  299. cmd := rcli.Subcmd(stdout, "port", "[OPTIONS] CONTAINER PRIVATE_PORT", "Lookup the public-facing port which is NAT-ed to PRIVATE_PORT")
  300. if err := cmd.Parse(args); err != nil {
  301. cmd.Usage()
  302. return nil
  303. }
  304. if cmd.NArg() != 2 {
  305. cmd.Usage()
  306. return nil
  307. }
  308. name := cmd.Arg(0)
  309. privatePort := cmd.Arg(1)
  310. if container := srv.containers.Get(name); container == nil {
  311. return errors.New("No such container: " + name)
  312. } else {
  313. if frontend, exists := container.NetworkSettings.PortMapping[privatePort]; !exists {
  314. return fmt.Errorf("No private port '%s' allocated on %s", privatePort, name)
  315. } else {
  316. fmt.Fprintln(stdout, frontend)
  317. }
  318. }
  319. return nil
  320. }
  321. // 'docker rmi NAME' removes all images with the name NAME
  322. func (srv *Server) CmdRmi(stdin io.ReadCloser, stdout io.Writer, args ...string) error {
  323. cmd := rcli.Subcmd(stdout, "rmimage", "[OPTIONS] IMAGE", "Remove an image")
  324. fl_regexp := cmd.Bool("r", false, "Use IMAGE as a regular expression instead of an exact name")
  325. if err := cmd.Parse(args); err != nil {
  326. cmd.Usage()
  327. return nil
  328. }
  329. if cmd.NArg() < 1 {
  330. cmd.Usage()
  331. return nil
  332. }
  333. for _, name := range cmd.Args() {
  334. var err error
  335. if *fl_regexp {
  336. err = srv.images.DeleteMatch(name)
  337. } else {
  338. image := srv.images.Find(name)
  339. if image == nil {
  340. return errors.New("No such image: " + name)
  341. }
  342. err = srv.images.Delete(name)
  343. }
  344. if err != nil {
  345. return err
  346. }
  347. }
  348. return nil
  349. }
  350. func (srv *Server) CmdRm(stdin io.ReadCloser, stdout io.Writer, args ...string) error {
  351. cmd := rcli.Subcmd(stdout, "rm", "[OPTIONS] CONTAINER", "Remove a container")
  352. if err := cmd.Parse(args); err != nil {
  353. return nil
  354. }
  355. for _, name := range cmd.Args() {
  356. container := srv.containers.Get(name)
  357. if container == nil {
  358. return errors.New("No such container: " + name)
  359. }
  360. if err := srv.containers.Destroy(container); err != nil {
  361. fmt.Fprintln(stdout, "Error destroying container "+name+": "+err.Error())
  362. }
  363. }
  364. return nil
  365. }
  366. // 'docker kill NAME' kills a running container
  367. func (srv *Server) CmdKill(stdin io.ReadCloser, stdout io.Writer, args ...string) error {
  368. cmd := rcli.Subcmd(stdout, "kill", "[OPTIONS] CONTAINER [CONTAINER...]", "Kill a running container")
  369. if err := cmd.Parse(args); err != nil {
  370. return nil
  371. }
  372. for _, name := range cmd.Args() {
  373. container := srv.containers.Get(name)
  374. if container == nil {
  375. return errors.New("No such container: " + name)
  376. }
  377. if err := container.Kill(); err != nil {
  378. fmt.Fprintln(stdout, "Error killing container "+name+": "+err.Error())
  379. }
  380. }
  381. return nil
  382. }
  383. func (srv *Server) CmdPull(stdin io.ReadCloser, stdout io.Writer, args ...string) error {
  384. cmd := rcli.Subcmd(stdout, "pull", "[OPTIONS] NAME", "Download a new image from a remote location")
  385. if err := cmd.Parse(args); err != nil {
  386. return nil
  387. }
  388. name := cmd.Arg(0)
  389. if name == "" {
  390. return errors.New("Not enough arguments")
  391. }
  392. if strings.Contains(name, ":") {
  393. return errors.New("Invalid image name: " + name)
  394. }
  395. u, err := url.Parse(name)
  396. if err != nil {
  397. return err
  398. }
  399. if u.Scheme == "" {
  400. u.Scheme = "http"
  401. }
  402. // FIXME: hardcode a mirror URL that does not depend on a single provider.
  403. if u.Host == "" {
  404. u.Host = "s3.amazonaws.com"
  405. u.Path = path.Join("/docker.io/images", u.Path)
  406. }
  407. fmt.Fprintf(stdout, "Downloading from %s\n", u.String())
  408. resp, err := future.Download(u.String(), stdout)
  409. // FIXME: Validate ContentLength
  410. archive := future.ProgressReader(resp.Body, int(resp.ContentLength), stdout)
  411. if err != nil {
  412. return err
  413. }
  414. fmt.Fprintf(stdout, "Downloading and unpacking to %s\n", name)
  415. img, err := srv.images.Import(name, archive, nil)
  416. if err != nil {
  417. return err
  418. }
  419. fmt.Fprintln(stdout, img.Id)
  420. return nil
  421. }
  422. func (srv *Server) CmdPut(stdin io.ReadCloser, stdout io.Writer, args ...string) error {
  423. cmd := rcli.Subcmd(stdout, "put", "[OPTIONS] NAME", "Import a new image from a local archive.")
  424. if err := cmd.Parse(args); err != nil {
  425. return nil
  426. }
  427. name := cmd.Arg(0)
  428. if name == "" {
  429. return errors.New("Not enough arguments")
  430. }
  431. img, err := srv.images.Import(name, stdin, nil)
  432. if err != nil {
  433. return err
  434. }
  435. fmt.Fprintln(stdout, img.Id)
  436. return nil
  437. }
  438. func (srv *Server) CmdImages(stdin io.ReadCloser, stdout io.Writer, args ...string) error {
  439. cmd := rcli.Subcmd(stdout, "images", "[OPTIONS] [NAME]", "List images")
  440. limit := cmd.Int("l", 0, "Only show the N most recent versions of each image")
  441. quiet := cmd.Bool("q", false, "only show numeric IDs")
  442. cmd.Parse(args)
  443. if cmd.NArg() > 1 {
  444. cmd.Usage()
  445. return nil
  446. }
  447. var nameFilter string
  448. if cmd.NArg() == 1 {
  449. nameFilter = cmd.Arg(0)
  450. }
  451. w := tabwriter.NewWriter(stdout, 20, 1, 3, ' ', 0)
  452. if !*quiet {
  453. fmt.Fprintf(w, "NAME\tID\tCREATED\tPARENT\n")
  454. }
  455. for _, name := range srv.images.Names() {
  456. if nameFilter != "" && nameFilter != name {
  457. continue
  458. }
  459. for idx, img := range *srv.images.ByName[name] {
  460. if *limit > 0 && idx >= *limit {
  461. break
  462. }
  463. if !*quiet {
  464. id := img.Id
  465. if !img.IdIsFinal() {
  466. id += "..."
  467. }
  468. for idx, field := range []string{
  469. /* NAME */ name,
  470. /* ID */ id,
  471. /* CREATED */ future.HumanDuration(time.Now().Sub(img.Created)) + " ago",
  472. /* PARENT */ img.Parent,
  473. } {
  474. if idx == 0 {
  475. w.Write([]byte(field))
  476. } else {
  477. w.Write([]byte("\t" + field))
  478. }
  479. }
  480. w.Write([]byte{'\n'})
  481. } else {
  482. stdout.Write([]byte(img.Id + "\n"))
  483. }
  484. }
  485. }
  486. if !*quiet {
  487. w.Flush()
  488. }
  489. return nil
  490. }
  491. func (srv *Server) CmdPs(stdin io.ReadCloser, stdout io.Writer, args ...string) error {
  492. cmd := rcli.Subcmd(stdout,
  493. "ps", "[OPTIONS]", "List containers")
  494. quiet := cmd.Bool("q", false, "Only display numeric IDs")
  495. fl_all := cmd.Bool("a", false, "Show all containers. Only running containers are shown by default.")
  496. fl_full := cmd.Bool("notrunc", false, "Don't truncate output")
  497. if err := cmd.Parse(args); err != nil {
  498. return nil
  499. }
  500. w := tabwriter.NewWriter(stdout, 12, 1, 3, ' ', 0)
  501. if !*quiet {
  502. fmt.Fprintf(w, "ID\tIMAGE\tCOMMAND\tCREATED\tSTATUS\tCOMMENT\n")
  503. }
  504. for _, container := range srv.containers.List() {
  505. comment := container.GetUserData("comment")
  506. if !container.State.Running && !*fl_all {
  507. continue
  508. }
  509. if !*quiet {
  510. command := fmt.Sprintf("%s %s", container.Path, strings.Join(container.Args, " "))
  511. if !*fl_full {
  512. command = docker.Trunc(command, 20)
  513. }
  514. for idx, field := range []string{
  515. /* ID */ container.Id,
  516. /* IMAGE */ container.GetUserData("image"),
  517. /* COMMAND */ command,
  518. /* CREATED */ future.HumanDuration(time.Now().Sub(container.Created)) + " ago",
  519. /* STATUS */ container.State.String(),
  520. /* COMMENT */ comment,
  521. } {
  522. if idx == 0 {
  523. w.Write([]byte(field))
  524. } else {
  525. w.Write([]byte("\t" + field))
  526. }
  527. }
  528. w.Write([]byte{'\n'})
  529. } else {
  530. stdout.Write([]byte(container.Id + "\n"))
  531. }
  532. }
  533. if !*quiet {
  534. w.Flush()
  535. }
  536. return nil
  537. }
  538. func (srv *Server) CmdLayers(stdin io.ReadCloser, stdout io.Writer, args ...string) error {
  539. cmd := rcli.Subcmd(stdout,
  540. "layers", "[OPTIONS]",
  541. "List filesystem layers (debug only)")
  542. if err := cmd.Parse(args); err != nil {
  543. return nil
  544. }
  545. for _, layer := range srv.images.Layers.List() {
  546. fmt.Fprintln(stdout, layer)
  547. }
  548. return nil
  549. }
  550. func (srv *Server) CmdCp(stdin io.ReadCloser, stdout io.Writer, args ...string) error {
  551. cmd := rcli.Subcmd(stdout,
  552. "cp", "[OPTIONS] IMAGE NAME",
  553. "Create a copy of IMAGE and call it NAME")
  554. if err := cmd.Parse(args); err != nil {
  555. return nil
  556. }
  557. if newImage, err := srv.images.Copy(cmd.Arg(0), cmd.Arg(1)); err != nil {
  558. return err
  559. } else {
  560. fmt.Fprintln(stdout, newImage.Id)
  561. }
  562. return nil
  563. }
  564. func (srv *Server) CmdCommit(stdin io.ReadCloser, stdout io.Writer, args ...string) error {
  565. cmd := rcli.Subcmd(stdout,
  566. "commit", "[OPTIONS] CONTAINER [DEST]",
  567. "Create a new image from a container's changes")
  568. if err := cmd.Parse(args); err != nil {
  569. return nil
  570. }
  571. containerName, imgName := cmd.Arg(0), cmd.Arg(1)
  572. if containerName == "" || imgName == "" {
  573. cmd.Usage()
  574. return nil
  575. }
  576. if container := srv.containers.Get(containerName); container != nil {
  577. // FIXME: freeze the container before copying it to avoid data corruption?
  578. rwTar, err := image.Tar(container.Filesystem.RWPath, image.Uncompressed)
  579. if err != nil {
  580. return err
  581. }
  582. // Create a new image from the container's base layers + a new layer from container changes
  583. parentImg := srv.images.Find(container.GetUserData("image"))
  584. img, err := srv.images.Import(imgName, rwTar, parentImg)
  585. if err != nil {
  586. return err
  587. }
  588. fmt.Fprintln(stdout, img.Id)
  589. return nil
  590. }
  591. return errors.New("No such container: " + containerName)
  592. }
  593. func (srv *Server) CmdTar(stdin io.ReadCloser, stdout io.Writer, args ...string) error {
  594. cmd := rcli.Subcmd(stdout,
  595. "tar", "CONTAINER",
  596. "Stream the contents of a container as a tar archive")
  597. fl_sparse := cmd.Bool("s", false, "Generate a sparse tar stream (top layer + reference to bottom layers)")
  598. if err := cmd.Parse(args); err != nil {
  599. return nil
  600. }
  601. if *fl_sparse {
  602. return errors.New("Sparse mode not yet implemented") // FIXME
  603. }
  604. name := cmd.Arg(0)
  605. if container := srv.containers.Get(name); container != nil {
  606. data, err := container.Filesystem.Tar()
  607. if err != nil {
  608. return err
  609. }
  610. // Stream the entire contents of the container (basically a volatile snapshot)
  611. if _, err := io.Copy(stdout, data); err != nil {
  612. return err
  613. }
  614. return nil
  615. }
  616. return errors.New("No such container: " + name)
  617. }
  618. func (srv *Server) CmdDiff(stdin io.ReadCloser, stdout io.Writer, args ...string) error {
  619. cmd := rcli.Subcmd(stdout,
  620. "diff", "CONTAINER [OPTIONS]",
  621. "Inspect changes on a container's filesystem")
  622. if err := cmd.Parse(args); err != nil {
  623. return nil
  624. }
  625. if cmd.NArg() < 1 {
  626. return errors.New("Not enough arguments")
  627. }
  628. if container := srv.containers.Get(cmd.Arg(0)); container == nil {
  629. return errors.New("No such container")
  630. } else {
  631. changes, err := container.Filesystem.Changes()
  632. if err != nil {
  633. return err
  634. }
  635. for _, change := range changes {
  636. fmt.Fprintln(stdout, change.String())
  637. }
  638. }
  639. return nil
  640. }
  641. func (srv *Server) CmdReset(stdin io.ReadCloser, stdout io.Writer, args ...string) error {
  642. cmd := rcli.Subcmd(stdout,
  643. "reset", "CONTAINER [OPTIONS]",
  644. "Reset changes to a container's filesystem")
  645. if err := cmd.Parse(args); err != nil {
  646. return nil
  647. }
  648. if cmd.NArg() < 1 {
  649. return errors.New("Not enough arguments")
  650. }
  651. for _, name := range cmd.Args() {
  652. if container := srv.containers.Get(name); container != nil {
  653. if err := container.Filesystem.Reset(); err != nil {
  654. return errors.New("Reset " + container.Id + ": " + err.Error())
  655. }
  656. }
  657. }
  658. return nil
  659. }
  660. func (srv *Server) CmdLogs(stdin io.ReadCloser, stdout io.Writer, args ...string) error {
  661. cmd := rcli.Subcmd(stdout, "logs", "[OPTIONS] CONTAINER", "Fetch the logs of a container")
  662. if err := cmd.Parse(args); err != nil {
  663. return nil
  664. }
  665. if cmd.NArg() != 1 {
  666. cmd.Usage()
  667. return nil
  668. }
  669. name := cmd.Arg(0)
  670. if container := srv.containers.Get(name); container != nil {
  671. if _, err := io.Copy(stdout, container.StdoutLog()); err != nil {
  672. return err
  673. }
  674. if _, err := io.Copy(stdout, container.StderrLog()); err != nil {
  675. return err
  676. }
  677. return nil
  678. }
  679. return errors.New("No such container: " + cmd.Arg(0))
  680. }
  681. func (srv *Server) CreateContainer(img *image.Image, ports []int, user string, tty bool, openStdin bool, comment string, cmd string, args ...string) (*docker.Container, error) {
  682. id := future.RandomId()[:8]
  683. container, err := srv.containers.Create(id, cmd, args, img.Layers,
  684. &docker.Config{Hostname: id, Ports: ports, User: user, Tty: tty, OpenStdin: openStdin})
  685. if err != nil {
  686. return nil, err
  687. }
  688. if err := container.SetUserData("image", img.Id); err != nil {
  689. srv.containers.Destroy(container)
  690. return nil, errors.New("Error setting container userdata: " + err.Error())
  691. }
  692. if err := container.SetUserData("comment", comment); err != nil {
  693. srv.containers.Destroy(container)
  694. return nil, errors.New("Error setting container userdata: " + err.Error())
  695. }
  696. return container, nil
  697. }
  698. func (srv *Server) CmdAttach(stdin io.ReadCloser, stdout io.Writer, args ...string) error {
  699. cmd := rcli.Subcmd(stdout, "attach", "[OPTIONS]", "Attach to a running container")
  700. fl_i := cmd.Bool("i", false, "Attach to stdin")
  701. fl_o := cmd.Bool("o", true, "Attach to stdout")
  702. fl_e := cmd.Bool("e", true, "Attach to stderr")
  703. if err := cmd.Parse(args); err != nil {
  704. return nil
  705. }
  706. if cmd.NArg() != 1 {
  707. cmd.Usage()
  708. return nil
  709. }
  710. name := cmd.Arg(0)
  711. container := srv.containers.Get(name)
  712. if container == nil {
  713. return errors.New("No such container: " + name)
  714. }
  715. var wg sync.WaitGroup
  716. if *fl_i {
  717. c_stdin, err := container.StdinPipe()
  718. if err != nil {
  719. return err
  720. }
  721. wg.Add(1)
  722. go func() { io.Copy(c_stdin, stdin); wg.Add(-1) }()
  723. }
  724. if *fl_o {
  725. c_stdout, err := container.StdoutPipe()
  726. if err != nil {
  727. return err
  728. }
  729. wg.Add(1)
  730. go func() { io.Copy(stdout, c_stdout); wg.Add(-1) }()
  731. }
  732. if *fl_e {
  733. c_stderr, err := container.StderrPipe()
  734. if err != nil {
  735. return err
  736. }
  737. wg.Add(1)
  738. go func() { io.Copy(stdout, c_stderr); wg.Add(-1) }()
  739. }
  740. wg.Wait()
  741. return nil
  742. }
  743. // Ports type - Used to parse multiple -p flags
  744. type ports []int
  745. func (p *ports) String() string {
  746. return fmt.Sprint(*p)
  747. }
  748. func (p *ports) Set(value string) error {
  749. port, err := strconv.Atoi(value)
  750. if err != nil {
  751. return fmt.Errorf("Invalid port: %v", value)
  752. }
  753. *p = append(*p, port)
  754. return nil
  755. }
  756. func (srv *Server) CmdRun(stdin io.ReadCloser, stdout io.Writer, args ...string) error {
  757. cmd := rcli.Subcmd(stdout, "run", "[OPTIONS] IMAGE COMMAND [ARG...]", "Run a command in a new container")
  758. fl_user := cmd.String("u", "", "Username or UID")
  759. fl_attach := cmd.Bool("a", false, "Attach stdin and stdout")
  760. fl_stdin := cmd.Bool("i", false, "Keep stdin open even if not attached")
  761. fl_tty := cmd.Bool("t", false, "Allocate a pseudo-tty")
  762. fl_comment := cmd.String("c", "", "Comment")
  763. var fl_ports ports
  764. var img *image.Image
  765. cmd.Var(&fl_ports, "p", "Map a network port to the container")
  766. if err := cmd.Parse(args); err != nil {
  767. return nil
  768. }
  769. name := cmd.Arg(0)
  770. var img_name string
  771. //var img_version string // Only here for reference
  772. var cmdline []string
  773. if len(cmd.Args()) >= 2 {
  774. cmdline = cmd.Args()[1:]
  775. }
  776. // Choose a default image if needed
  777. if name == "" {
  778. name = "base"
  779. }
  780. // Separate the name:version tag
  781. if strings.Contains(name, ":") {
  782. parts := strings.SplitN(name, ":", 2)
  783. img_name = parts[0]
  784. //img_version = parts[1] // Only here for reference
  785. } else {
  786. img_name = name
  787. }
  788. // Choose a default command if needed
  789. if len(cmdline) == 0 {
  790. *fl_stdin = true
  791. *fl_tty = true
  792. *fl_attach = true
  793. cmdline = []string{"/bin/bash", "-i"}
  794. }
  795. // Find the image
  796. img = srv.images.Find(name)
  797. if img == nil {
  798. stdin_noclose := ioutil.NopCloser(stdin)
  799. if err := srv.CmdPull(stdin_noclose, stdout, img_name); err != nil {
  800. return err
  801. }
  802. img = srv.images.Find(name)
  803. if img == nil {
  804. return errors.New("Could not find image after downloading: " + name)
  805. }
  806. }
  807. // Create new container
  808. container, err := srv.CreateContainer(img, fl_ports, *fl_user, *fl_tty, *fl_stdin, *fl_comment, cmdline[0], cmdline[1:]...)
  809. if err != nil {
  810. return errors.New("Error creating container: " + err.Error())
  811. }
  812. if *fl_stdin {
  813. cmd_stdin, err := container.StdinPipe()
  814. if err != nil {
  815. return err
  816. }
  817. if *fl_attach {
  818. future.Go(func() error {
  819. _, err := io.Copy(cmd_stdin, stdin)
  820. cmd_stdin.Close()
  821. return err
  822. })
  823. }
  824. }
  825. // Run the container
  826. if *fl_attach {
  827. cmd_stderr, err := container.StderrPipe()
  828. if err != nil {
  829. return err
  830. }
  831. cmd_stdout, err := container.StdoutPipe()
  832. if err != nil {
  833. return err
  834. }
  835. if err := container.Start(); err != nil {
  836. return err
  837. }
  838. sending_stdout := future.Go(func() error {
  839. _, err := io.Copy(stdout, cmd_stdout)
  840. return err
  841. })
  842. sending_stderr := future.Go(func() error {
  843. _, err := io.Copy(stdout, cmd_stderr)
  844. return err
  845. })
  846. err_sending_stdout := <-sending_stdout
  847. err_sending_stderr := <-sending_stderr
  848. if err_sending_stdout != nil {
  849. return err_sending_stdout
  850. }
  851. if err_sending_stderr != nil {
  852. return err_sending_stderr
  853. }
  854. container.Wait()
  855. } else {
  856. if err := container.Start(); err != nil {
  857. return err
  858. }
  859. fmt.Fprintln(stdout, container.Id)
  860. }
  861. return nil
  862. }
  863. func New() (*Server, error) {
  864. future.Seed()
  865. images, err := image.New("/var/lib/docker/images")
  866. if err != nil {
  867. return nil, err
  868. }
  869. containers, err := docker.New()
  870. if err != nil {
  871. return nil, err
  872. }
  873. srv := &Server{
  874. images: images,
  875. containers: containers,
  876. }
  877. return srv, nil
  878. }
  879. func (srv *Server) CmdMirror(stdin io.ReadCloser, stdout io.Writer, args ...string) error {
  880. _, err := io.Copy(stdout, stdin)
  881. return err
  882. }
  883. func (srv *Server) CmdDebug(stdin io.ReadCloser, stdout io.Writer, args ...string) error {
  884. for {
  885. if line, err := bufio.NewReader(stdin).ReadString('\n'); err == nil {
  886. fmt.Printf("--- %s", line)
  887. } else if err == io.EOF {
  888. if len(line) > 0 {
  889. fmt.Printf("--- %s\n", line)
  890. }
  891. break
  892. } else {
  893. return err
  894. }
  895. }
  896. return nil
  897. }
  898. func (srv *Server) CmdWeb(stdin io.ReadCloser, stdout io.Writer, args ...string) error {
  899. cmd := rcli.Subcmd(stdout, "web", "[OPTIONS]", "A web UI for docker")
  900. showurl := cmd.Bool("u", false, "Return the URL of the web UI")
  901. if err := cmd.Parse(args); err != nil {
  902. return nil
  903. }
  904. if *showurl {
  905. fmt.Fprintln(stdout, "http://localhost:4242/web")
  906. } else {
  907. if file, err := os.Open("dockerweb.html"); err != nil {
  908. return err
  909. } else if _, err := io.Copy(stdout, file); err != nil {
  910. return err
  911. }
  912. }
  913. return nil
  914. }
  915. type Server struct {
  916. containers *docker.Docker
  917. images *image.Store
  918. }