launchpad development|
Size: 7002
Comment:
|
Size: 1764
Comment: Rewrite to use the new make install LISTEN_ADDRESS var
|
| Deletions are marked like this. | Additions are marked like this. |
| Line 4: | Line 4: |
| These instructions assume that you already have Launchpad working for local access, and now you want it to be accessible from other machines on the same LAN. == IP Addresses == A full Launchpad development setup requires two IP addresses on the local machine, on which to run two HTTPS listeners - one for main Launchpad, and one for Loggerhead (code browsing) of private branches. As most developer workstations have only one non-local IP address, and as the second one is only required for Loggerhead on '''private''' branches, you may well not bother to set up an additional IP address. If you do want to do this, identify a suitable IP address, and add it to your machine's network configuration now. |
These instructions assume that you already have Launchpad working for local access, and now you want it to be accessible from other machines on the same LAN, or perhaps the virtual machine or LXC host. |
| Line 10: | Line 7: |
| These instructions assume that you are using the Ubuntu packaged Apache 2.2 in Intrepid or later. Hardy users see the "Notes for Hardy" subsection. The file to edit is `/etc/apache2/sites-available/local-launchpad` unless mentioned otherwise. * Delete the `NameVirtualHost 127.0.0.88:80` line * We are assuming that the line `NameVirtualHost *:80` appears precisely once elsewhere in your Apache configuration - it should be present in `/etc/apache2/ports.conf` by default, check this is true * Change all `<VirtualHost 127.0.0.88:80>` lines to `<VirtualHost *:80>` * Change the `<VirtualHost 127.0.0.88:443>` line to `<VirtualHost _default_:443>` * If, as mentioned above, you are opting for the simple option of just using one IP address: * Change the `<VirtualHost 127.0.0.99:80>` line to `<VirtualHost *:80>` too * Comment out the entire `<VirtualHost 127.0.0.99:443>` block (prefix each line with a `#`) * Or, if you did allocate a suitable second IP address: * Change the `<VirtualHost 127.0.0.99:80>` line to `<VirtualHost a.b.c.d:80>` * Change the `<VirtualHost 127.0.0.99:443>` line to `<VirtualHost a.b.c.d:443>` * Change all the `Allow from ...` lines to admit whatever address range you want Restart your Apache server. === Notes for Hardy === * The `NameVirtualHost *:80` line does not appear in `/etc/apache2/ports.conf` but instead `NameVirtualHost *` appears in `/etc/apache2/sites-available/default`. Delete it from there and add `NameVirtualHost *:80` to `ports.conf`. As a consequence of doing so you'll probably have to update any other `<VirtualHost *>` sections in your config to say `<VirtualHost *:80>`. === Diff of local-launchpad for a single IP address === |
Launchpad's default development Apache config (`/etc/apache2/sites-available/local-launchpad`) only listens on 127.0.0.88. This can be overriden with the LISTEN_ADDRESS environment variable when running `make install`. You probably want to make it listen on everything: |
| Line 32: | Line 9: |
| --- Documents/local-launchpad 2010-08-09 13:57:15.653110046 -0700 +++ /etc/apache2/sites-enabled/local-launchpad 2010-08-09 14:01:51.673118491 -0700 @@ -1,8 +1,6 @@ -NameVirtualHost 127.0.0.88:80 - RewriteLock /var/tmp/rewrite-lock -<VirtualHost 127.0.0.88:80> +<VirtualHost *:80> ServerName xmlrpc-private.launchpad.dev ServerName xmlrpc.launchpad.dev <Proxy *> @@ -14,7 +12,7 @@ RewriteLock /var/tmp/rewrite-lock ProxyPass / http://localhost:8087/ retry=1 </VirtualHost> -<VirtualHost 127.0.0.88:80> +<VirtualHost *:80> ServerName lists.launchpad.dev Alias / /var/tmp/mailman/mhonarc/ <Directory /var/tmp/mailman/mhonarc> @@ -23,7 +21,7 @@ RewriteLock /var/tmp/rewrite-lock </Directory> </VirtualHost> -<VirtualHost 127.0.0.99:80> +<VirtualHost *:80> ServerName bazaar.launchpad.dev LogLevel debug @@ -54,35 +52,35 @@ RewriteLock /var/tmp/rewrite-lock </Location> </VirtualHost> -<VirtualHost 127.0.0.99:443> - ServerName bazaar.launchpad.dev - LogLevel debug - - SSLEngine On - SSLProxyEngine On - SSLCertificateFile /etc/apache2/ssl/launchpad.crt - SSLCertificateKeyFile /etc/apache2/ssl/launchpad.key - - ProxyRequests off - <Proxy *> - Order deny,allow - Allow from localhost 127.0.0.0/255.0.0.0 - </Proxy> - ProxyTimeout 20 - - RewriteEngine On - - RequestHeader add X-Forwarded-Scheme https - - RewriteRule ^/$ http://launchpad.dev [L] - RewriteRule ^/(.*)$ http://localhost:8080/$1 [L,P] - - <Location /> - ProxyPassReverse http://localhost:8080/ - </Location> -</VirtualHost> +#<VirtualHost 127.0.0.99:443> +# ServerName bazaar.launchpad.dev +# LogLevel debug +# +# SSLEngine On +# SSLProxyEngine On +# SSLCertificateFile /etc/apache2/ssl/launchpad.crt +# SSLCertificateKeyFile /etc/apache2/ssl/launchpad.key +# +# ProxyRequests off +# <Proxy *> +# Order deny,allow +# Allow from localhost 127.0.0.0/255.0.0.0 +# </Proxy> +# ProxyTimeout 20 +# +# RewriteEngine On +# +# RequestHeader add X-Forwarded-Scheme https +# +# RewriteRule ^/$ http://launchpad.dev [L] +# RewriteRule ^/(.*)$ http://localhost:8080/$1 [L,P] +# +# <Location /> +# ProxyPassReverse http://localhost:8080/ +# </Location> +#</VirtualHost> -<VirtualHost 127.0.0.88:80> +<VirtualHost *:80> ServerName bazaar-internal.launchpad.dev LogLevel debug @@ -97,7 +95,7 @@ RewriteLock /var/tmp/rewrite-lock </Directory> </VirtualHost> -<VirtualHost 127.0.0.88:80> +<VirtualHost *:80> ServerName ppa.launchpad.dev ServerAlias private-ppa.launchpad.dev LogLevel debug @@ -112,7 +110,7 @@ RewriteLock /var/tmp/rewrite-lock </Directory> </VirtualHost> -<VirtualHost 127.0.0.88:80> +<VirtualHost *:80> ServerName archive.launchpad.dev LogLevel debug @@ -125,7 +123,7 @@ RewriteLock /var/tmp/rewrite-lock </Directory> </VirtualHost> -<VirtualHost 127.0.0.88:443> +<VirtualHost _default_:443> ServerName launchpad.dev ServerAlias *.launchpad.dev ServerAlias shipit.edubuntu.dev @@ -157,7 +155,7 @@ RewriteLock /var/tmp/rewrite-lock </VirtualHost> -<VirtualHost 127.0.0.88:80> +<VirtualHost *:80> ServerName launchpad.dev ServerAlias *.launchpad.dev ServerAlias shipit.edubuntu.dev |
sudo make LISTEN_ADDRESS=* install |
| Line 165: | Line 13: |
| You shouldn't need to update the /etc/hosts file of the container or VM on which Launchpad is running. Doing so will break things in subtle ways, since much of the security options in the Apache configs are left geared towards 127.0.0.0/24. | Launchpad makes extensive use of virtual hosts, so you'll need to add entries to `/etc/hosts` on any machine from which you want to access the Launchpad instance. You'll see the relevant hostnames in `/etc/hosts` on the machine running the instance -- they need to be added to the remote machine, mapped to the server machine or container's external IP address. |
| Line 167: | Line 15: |
| You'll need to copy the relevant `/etc/hosts` lines into the `/etc/hosts` file of every other machine you want to access the development Launchpad instance and change the IP addresses in them to match the external IP of the container. If some of those other machines run Windows, it may be helpful to know that the Windows equivalent of `/etc/hosts` is located at `C:\WINDOWS\system32\drivers\etc\hosts`. |
If some of those other machines run Windows, it may be helpful to know that the Windows equivalent of `/etc/hosts` is located at `C:\WINDOWS\system32\drivers\etc\hosts`. Note that Windows' version has a line length limit, so you might have to split it across multiple lines or only include the hostnames that you need. |
This page tells you how to modify a development Launchpad so you can access it from other machines. Ask for help right away if you run into problems. |
These instructions assume that you already have Launchpad working for local access, and now you want it to be accessible from other machines on the same LAN, or perhaps the virtual machine or LXC host.
Amending the Apache configuration
Launchpad's default development Apache config (/etc/apache2/sites-available/local-launchpad) only listens on 127.0.0.88. This can be overriden with the LISTEN_ADDRESS environment variable when running make install. You probably want to make it listen on everything:
sudo make LISTEN_ADDRESS=* install
Amending the hosts file
Launchpad makes extensive use of virtual hosts, so you'll need to add entries to /etc/hosts on any machine from which you want to access the Launchpad instance. You'll see the relevant hostnames in /etc/hosts on the machine running the instance -- they need to be added to the remote machine, mapped to the server machine or container's external IP address.
If some of those other machines run Windows, it may be helpful to know that the Windows equivalent of /etc/hosts is located at C:\WINDOWS\system32\drivers\etc\hosts. Note that Windows' version has a line length limit, so you might have to split it across multiple lines or only include the hostnames that you need.
That's it!
If you did everything above, you should new be able to access https://launchpad.dev/ in a web browser on a suitably configured remote computer.
