commands.go 27 KB

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