commands.go 27 KB

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