commands.go 28 KB

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