Kaynağa Gözat

Merge pull request #588 from kencochrane/rackspace-docs

+ Documentation: Added install instructions for RackSpace cloud using Ubuntu 12.04, 12.10, 13.04 and fixed a few minor issues with the ubuntu install docs.
Ken Cochrane 12 yıl önce
ebeveyn
işleme
01cecfe2f3

+ 1 - 1
docs/sources/contributing/devenvironment.rst

@@ -16,7 +16,7 @@ Instructions that have been verified to work on Ubuntu 12.10,
 
     mkdir -p $GOPATH/src/github.com/dotcloud
     cd $GOPATH/src/github.com/dotcloud
-    git clone git@github.com:dotcloud/docker.git
+    git clone git://github.com/dotcloud/docker.git
     cd docker
 
     go get -v github.com/dotcloud/docker/...

+ 1 - 0
docs/sources/installation/index.rst

@@ -18,4 +18,5 @@ Contents:
    vagrant
    windows
    amazon
+   rackspace
    upgrading

+ 221 - 0
docs/sources/installation/rackspace.rst

@@ -0,0 +1,221 @@
+===============
+Rackspace Cloud
+===============
+
+.. contents:: Table of Contents
+
+Ubuntu 12.04
+------------
+
+1. Build an Ubuntu 12.04 server using the "Next generation cloud servers", with your desired size. It will give you the password, keep that you will need it later.
+2. When the server is up and running ssh into the server.
+
+    .. code-block:: bash
+
+        $ ssh root@<server-ip>
+
+3. Once you are logged in you should check what kernel version you are running.
+
+    .. code-block:: bash
+
+        $ uname -a
+        Linux docker-12-04 3.2.0-38-virtual #61-Ubuntu SMP Tue Feb 19 12:37:47 UTC 2013 x86_64 x86_64 x86_64 GNU/Linux
+
+4. Let's update the server package list
+
+    .. code-block:: bash
+
+        $ apt-get update
+
+5. Now lets install Docker and it's dependencies. To keep things simple, we will use the Docker install script. It will take a couple of minutes.
+
+    .. code-block:: bash
+
+        $ curl get.docker.io | sudo sh -x
+
+6. Docker runs best with a new kernel, so lets use 3.8.x
+
+    .. code-block:: bash
+        
+        # install the new kernel
+        $ apt-get install linux-generic-lts-raring
+        
+        # update grub so it will use the new kernel after we reboot
+        $ update-grub
+        
+        # update-grub doesn't always work so lets make sure. ``/boot/grub/menu.lst`` was updated.
+        $ grep 3.8.0- /boot/grub/menu.lst
+        
+        # nope it wasn't lets manually update ``/boot/grub/menu.lst``  (make sure you are searching for correct kernel version, look at initial uname -a results.)
+        $ sed -i s/3.2.0-38-virtual/3.8.0-19-generic/ /boot/grub/menu.lst
+        
+        # once again lets make sure it worked.
+        $ grep 3.8.0- /boot/grub/menu.lst
+        title          Ubuntu 12.04.2 LTS, kernel 3.8.0-19-generic
+        kernel          /boot/vmlinuz-3.8.0-19-generic root=/dev/xvda1 ro quiet splash console=hvc0
+        initrd          /boot/initrd.img-3.8.0-19-generic
+        title          Ubuntu 12.04.2 LTS, kernel 3.8.0-19-generic (recovery mode)
+        kernel          /boot/vmlinuz-3.8.0-19-generic root=/dev/xvda1 ro quiet splash  single
+        initrd          /boot/initrd.img-3.8.0-19-generic
+        
+        # much better.
+
+7. Reboot server (either via command line or console)
+8. login again and check to make sure the kernel was updated
+
+    .. code-block:: bash
+        
+        $ ssh root@<server_ip>
+        $ uname -a
+        Linux docker-12-04 3.8.0-19-generic #30~precise1-Ubuntu SMP Wed May 1 22:26:36 UTC 2013 x86_64 x86_64 x86_64 GNU/Linux
+        
+        # nice 3.8.
+
+9. Make sure docker is running and test it out.
+
+    .. code-block:: bash
+        
+        $ start dockerd
+        $ docker pull busybox
+        $ docker run busybox /bin/echo hello world
+        hello world
+
+Alternate install
+^^^^^^^^^^^^^^^^^
+If you don't want to run the get.docker.io script and want to use packages instead, you can use the docker PPA. Here is how you use it. Replace step 5 with the following 3 steps.
+
+1. Add the custom package sources to your apt sources list. Copy and paste the following lines at once.
+
+.. code-block:: bash
+
+   $ sudo sh -c "echo 'deb http://ppa.launchpad.net/dotcloud/lxc-docker/ubuntu precise main' >> /etc/apt/sources.list"
+
+
+2. Update your sources. You will see a warning that GPG signatures cannot be verified.
+
+.. code-block:: bash
+
+   $ sudo apt-get update
+
+
+3. Now install it, you will see another warning that the package cannot be authenticated. Confirm install.
+
+.. code-block:: bash
+
+    $ apt-get install lxc-docker
+
+
+Ubuntu 12.10
+------------
+
+1. Build an Ubuntu 12.10 server using the "Next generation cloud servers", with your desired size. It will give you the password, keep that you will need it later.
+2. When the server is up and running ssh into the server.
+
+    .. code-block:: bash
+
+        $ ssh root@<server-ip>
+
+3. Once you are logged in you should check what kernel version you are running.
+
+    .. code-block:: bash
+
+        $ uname -a
+        Linux docker-12-10 3.5.0-25-generic #39-Ubuntu SMP Mon Feb 25 18:26:58 UTC 2013 x86_64 x86_64 x86_64 GNU/Linux
+
+4. Let's update the server package list
+
+    .. code-block:: bash
+
+        $ apt-get update
+
+5. Now lets install Docker and it's dependencies. To keep things simple, we will use the Docker install script. It will take a couple of minutes.
+
+    .. code-block:: bash
+
+        $ curl get.docker.io | sudo sh -x
+
+6. Docker runs best with a new kernel, so lets use 3.8.x
+
+    .. code-block:: bash
+        
+        # add the ppa to get the right kernel package
+        $ echo deb http://ppa.launchpad.net/ubuntu-x-swat/q-lts-backport/ubuntu quantal main > /etc/apt/sources.list.d/xswat.list
+        
+        # add the key for the ppa
+        $ sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-keys 3B22AB97AF1CDFA9
+        
+        # update packages again
+        $ apt-get update
+        
+        # install the new kernel
+        $ apt-get install linux-image-3.8.0-19-generic
+
+        # make sure grub has been updated.
+        $ grep 3.8.0- /boot/grub/menu.lst
+        title   Ubuntu 12.10, kernel 3.8.0-19-generic
+        kernel  /boot/vmlinuz-3.8.0-19-generic root=/dev/xvda1 ro quiet splash console=hvc0
+        initrd  /boot/initrd.img-3.8.0-19-generic
+        title   Ubuntu 12.10, kernel 3.8.0-19-generic (recovery mode)
+        kernel  /boot/vmlinuz-3.8.0-19-generic root=/dev/xvda1 ro quiet splash  single
+        initrd  /boot/initrd.img-3.8.0-19-generic
+        
+        # looks good. If it doesn't work for you, look at the notes for 12.04 to fix.
+
+7. Reboot server (either via command line or console)
+8. login again and check to make sure the kernel was updated
+
+    .. code-block:: bash
+        
+        $ ssh root@<server_ip>
+        $ uname -a
+        Linux docker-12-10 3.8.0-19-generic #29~precise2-Ubuntu SMP Fri Apr 19 16:15:35 UTC 2013 x86_64 x86_64 x86_64 GNU/Linux
+        
+        # nice 3.8.
+
+9. Make sure docker is running and test it out.
+
+    .. code-block:: bash
+        
+        $ start dockerd
+        $ docker pull busybox
+        $ docker run busybox /bin/echo hello world
+        hello world
+
+Ubuntu 13.04
+------------
+
+1. Build an Ubuntu 13.04 server using the "Next generation cloud servers", with your desired size. It will give you the password, keep that you will need it later.
+2. When the server is up and running ssh into the server.
+
+    .. code-block:: bash
+
+        $ ssh root@<server-ip>
+
+3. Once you are logged in you should check what kernel version you are running.
+
+    .. code-block:: bash
+
+        $ uname -a
+        Linux docker-1304 3.8.0-19-generic #29-Ubuntu SMP Wed Apr 17 18:16:28 UTC 2013 x86_64 x86_64 x86_64 GNU/Linux
+
+4. Let's update the server package list
+
+    .. code-block:: bash
+
+        $ apt-get update
+
+5. Now lets install Docker and it's dependencies. To keep things simple, we will use the Docker install script. It will take a couple of minutes.
+
+    .. code-block:: bash
+
+        $ curl get.docker.io | sudo sh -x
+
+6. Make sure docker is running and test it out.
+
+    .. code-block:: bash
+        
+        $ start dockerd
+        $ docker pull busybox
+        $ docker run busybox /bin/echo hello world
+        hello world
+ 

+ 1 - 2
docs/sources/installation/ubuntulinux.rst

@@ -48,8 +48,7 @@ Now install it, you will see another warning that the package cannot be authenti
 
 .. code-block:: bash
 
-    curl get.docker.io | sudo sh -x
-
+    apt-get install lxc-docker
 
 Verify it worked