Browse code

Updated Vagrantfile and documentation to reflect new installation path using Ubuntu's PPA, also switched everything to use Ubuntu 12.04 by default.

Thatcher Peskens authored on 2013/04/23 05:10:32
Showing 4 changed files
... ...
@@ -8,7 +8,6 @@ def v10(config)
8 8
   # Install ubuntu packaging dependencies and create ubuntu packages
9 9
   config.vm.provision :shell, :inline => "echo 'deb http://ppa.launchpad.net/dotcloud/lxc-docker/ubuntu precise main' >>/etc/apt/sources.list"
10 10
   config.vm.provision :shell, :inline => 'export DEBIAN_FRONTEND=noninteractive; apt-get -qq update; apt-get install -qq -y --force-yes lxc-docker'
11
-
12 11
 end
13 12
 
14 13
 Vagrant::VERSION < "1.1.0" and Vagrant::Config.run do |config|
... ...
@@ -45,8 +44,8 @@ Vagrant::VERSION >= "1.1.0" and Vagrant.configure("2") do |config|
45 45
   end
46 46
 
47 47
   config.vm.provider :virtualbox do |vb|
48
-    config.vm.box = "quantal64_3.5.0-25"
49
-    config.vm.box_url = "http://get.docker.io/vbox/ubuntu/12.10/quantal64_3.5.0-25.box"
48
+    config.vm.box = 'precise64'
49
+    config.vm.box_url = 'http://files.vagrantup.com/precise64.box'
50 50
   end
51 51
 end
52 52
 
... ...
@@ -76,7 +75,8 @@ Vagrant::VERSION >= "1.2.0" and Vagrant.configure("2") do |config|
76 76
   end
77 77
 
78 78
   config.vm.provider :virtualbox do |vb|
79
-    config.vm.box = "quantal64_3.5.0-25"
80
-    config.vm.box_url = "http://get.docker.io/vbox/ubuntu/12.10/quantal64_3.5.0-25.box"
79
+    config.vm.box = 'precise64'
80
+    config.vm.box_url = 'http://files.vagrantup.com/precise64.box'
81 81
   end
82
+
82 83
 end
... ...
@@ -1,7 +1,9 @@
1 1
 Docker on Ubuntu
2 2
 ================
3 3
 
4
-Docker is now available as a Ubuntu PPA (Personal Package Archive), which makes installing Docker on Ubuntu super easy!
4
+Docker is now available as a Ubuntu PPA (Personal Package Archive),
5
+`hosted on launchpad  <https://launchpad.net/~dotcloud/+archive/lxc-docker>`_
6
+which makes installing Docker on Ubuntu very easy.
5 7
 
6 8
 **The Requirements**
7 9
 
... ...
@@ -17,14 +19,14 @@ Add the custom package sources to your apt sources list. Copy and paste both the
17 17
    >> /etc/apt/sources.list"
18 18
 
19 19
 
20
-Update your sources. You will see a warning that GPG signatures cannot be verified
20
+Update your sources. You will see a warning that GPG signatures cannot be verified.
21 21
 
22 22
 .. code-block:: bash
23 23
 
24 24
    sudo apt-get update
25 25
 
26 26
 
27
-Now install it, you will see another warning that the package cannot be authenticated.
27
+Now install it, you will see another warning that the package cannot be authenticated. Confirm install.
28 28
 
29 29
 .. code-block:: bash
30 30
 
... ...
@@ -3,7 +3,8 @@
3 3
 Upgrading
4 4
 ============
5 5
 
6
-   We assume you are upgrading from within the operating system which runs your docker daemon.
6
+These instructions are for upgrading your Docker binary for when you had a custom (non package manager) installation.
7
+If you istalled docker using apt-get, use that to upgrade.
7 8
 
8 9
 
9 10
 Get the latest docker binary:
... ...
@@ -4,32 +4,28 @@
4 4
 Install using Vagrant
5 5
 =====================
6 6
 
7
-  Please note this is a community contributed installation path. The only 'official' installation is using the :ref:`ubuntu_linux` installation path. This version
8
-  may be out of date because it depends on some binaries to be updated and published
7
+  Please note this is a community contributed installation path. The only 'official' installation is using the
8
+  :ref:`ubuntu_linux` installation path. This version may sometimes be out of date.
9 9
 
10 10
 **requirements**
11
-This guide will setup a new virtual machine on your computer. This works on most operating systems,
12
-including MacOX, Windows, Linux, FreeBSD and others. If you can
13
-install these and have at least 400Mb RAM to spare you should be good.
11
+This guide will setup a new virtual machine with docker installed on your computer. This works on most operating
12
+systems, including MacOX, Windows, Linux, FreeBSD and others. If you can install these and have at least 400Mb RAM
13
+to spare you should be good.
14 14
 
15 15
 
16
-Install Vagrant, Virtualbox and Git
17
-
18
-We currently rely on some Ubuntu-linux specific packages, this will change in the future, but for now we provide a
19
-streamlined path to install Virtualbox with a Ubuntu 12.10 image using Vagrant.
16
+Install Vagrant and Virtualbox
17
+------------------------------
20 18
 
21 19
 1. Install virtualbox from https://www.virtualbox.org/ (or use your package manager)
22 20
 2. Install vagrant from http://www.vagrantup.com/ (or use your package manager)
23 21
 3. Install git if you had not installed it before, check if it is installed by running
24 22
    ``git`` in a terminal window
25 23
 
26
-We recommend having at least about 2Gb of free disk space and 2Gb RAM (or more).
27 24
 
28 25
 Spin up your machine
29 26
 --------------------
30 27
 
31
-1. Fetch the docker sources
28
+1. Fetch the docker sources (this includes the instructions for machine setup).
32 29
 
33 30
 .. code-block:: bash
34 31
 
... ...
@@ -43,21 +39,16 @@ Spin up your machine
43 43
 
44 44
 Vagrant will:
45 45
 
46
-* Download the Quantal64 base ubuntu virtual machine image from get.docker.io/
46
+* Download the 'official' Precise64 base ubuntu virtual machine image from vagrantup.com
47 47
 * Boot this image in virtualbox
48
-
49
-Then it will use Puppet to perform an initial setup in this machine:
50
-
51
-* Download & untar the most recent docker binary tarball to vagrant homedir.
52
-* Debootstrap to /var/lib/docker/images/ubuntu.
53
-* Install & run dockerd as service.
54
-* Put docker in /usr/local/bin.
55
-* Put latest Go toolchain in /usr/local/go.
48
+* Add the `Docker PPA sources <https://launchpad.net/~dotcloud/+archive/lxc-docker>`_ to /etc/apt/sources.lst
49
+* Update your sources
50
+* Install lxc-docker
56 51
 
57 52
 You now have a Ubuntu Virtual Machine running with docker pre-installed.
58 53
 
59 54
 To access the VM and use Docker, Run ``vagrant ssh`` from the same directory as where you ran
60
-``vagrant up``. Vagrant will make sure to connect you to the correct VM.
55
+``vagrant up``. Vagrant will connect you to the correct VM.
61 56
 
62 57
 .. code-block:: bash
63 58
 
... ...
@@ -69,5 +60,4 @@ Now you are in the VM, run docker
69 69
 
70 70
     docker
71 71
 
72
-
73 72
 Continue with the :ref:`hello_world` example.